תיעוד 111

סגנונות פלט

התאמת Claude Code לשימושים מעבר להנדסת תוכנה

סגנונות פלט משנים את האופן שבו Claude מגיב, ולא את מה ש-Claude יודע. הם משנים את ה-system prompt כדי להגדיר תפקיד, טון ופורמט פלט. השתמש באחד מהם כאשר אתה מוצא את עצמך מבקש שוב ושוב את אותו סגנון דיבור או פורמט בכל פנייה, או כאשר אתה רוצה ש-Claude יפעל בתור משהו אחר שאינו מהנדס תוכנה.

סגנון פלט מותאם אישית מוסיף את ההנחיות שלך ל-system prompt ומאפשר לך לבחור האם לשמור על הנחיות הנדסת התוכנה המובנות של Claude Code. שמור עליהן כאשר אתה משנה את אופן התקשורת של Claude אך עדיין כותב קוד, כמו למשל מענה שתמיד כולל דיאגרמה. השמט אותן כאשר Claude אינו עוסק כלל בהנדסת תוכנה, למשל בעבודה כעוזר כתיבה או כאנליסט נתונים.

עבור הנחיות לגבי הפרויקט שלך, המוסכמות או בסיס הקוד, השתמש במקום זאת ב-CLAUDE.md.

#סגנונות פלט מובנים

סגנון הפלט Default של Claude Code הוא ה-system prompt הקיים, שתוכנן לעזור לך להשלים משימות הנדסת תוכנה ביעילות.

קיימים ארבעה סגנונות פלט מובנים נוספים:

Proactive: Claude מבצע פעולות באופן מיידי, מניח הנחות סבירות במקום לעצור עבור החלטות שגרתיות, ומעדיף פעולה על פני תכנון. זוהי הנחיית ביצוע עצמאי חזקה יותר מזו שחלה ב-auto mode, והיא פועלת בלי לשנות את מצב ההרשאות שלך, כך שמצב ההרשאות שלך עדיין קובע מה רץ בלי לשאול אותך.
Concise: Claude פותח בתוצאה, מדלג על הקדמות ועל תיאור הפעולות, ושומר על תגובות קצרות כברירת מחדל, תוך כדי ביצוע עבודת ההנדסה ביסודיות זהה לזו של סגנון ה-Default. כאשר אתה מבקש הסבר או פירוט נוסף, Claude עונה במלואו. Claude תמיד שומר על התוכן המלא של דיווחי שגיאות, אזהרות אבטחה ואישורים עבור פעולות הרסניות. דורש את Claude Code בגרסה v2.1.237 ומעלה.
Explanatory: מספק "תובנות" (Insights) לימודיות בין שלבי העזרה בהשלמת משימות הנדסת תוכנה. עוזר לך להבין בחירות מימוש ודפוסים בבסיס הקוד.
Learning: מצב שיתופי של למידה תוך כדי עשייה שבו Claude לא רק ישתף תובנות בזמן כתיבת קוד, אלא גם יבקש ממך לתרום בעצמך קטעי קוד קטנים ואסטרטגיים. Claude Code יוסיף בקוד שלך סימוני TODO(human) כדי שתוכל לממש אותם.

#שינוי סגנון הפלט שלך

בחר סגנון באחת מהדרכים הבאות:

טרמינל: הרץ /config ובחר ב-Output style כדי לבחור סגנון מתוך תפריט. Claude Code שומר את הבחירה שלך בקובץ .claude/settings.local.json ברמת הפרויקט המקומית.
הרחבה ל-VS Code: פתח את תפריט הפקודות בעזרת / ובחר ב-Output styles כדי לבחור סגנון, כולל הסגנונות המותאמים אישית שלך. Claude Code שומר את הבחירה שלך בקובץ .claude/settings.local.json, אותו קובץ שתפריט הטרמינל כותב אליו. דורש את Claude Code בגרסה v2.1.257 ומעלה.
אפליקציית שולחן עבודה: הגדר את השדה outputStyle בקובץ הגדרות, למשל .claude/settings.local.json, הקובץ שתפריט הטרמינל כותב אליו. כאשר אתה מריץ /config שם, Claude Code פותח את Settings > Claude Code במקום תפריט.

הערה: הפקודה הנפרדת /output-style הוגדרה כלא מומלצת לשימוש בגרסה v2.1.73 והוסרה בגרסה v2.1.91. השתמש ב-/config או ערוך ישירות את ההגדרה outputStyle.

כדי להגדיר סגנון ללא התפריט, ערוך ישירות את השדה outputStyle בקובץ הגדרות:

{
  "outputStyle": "Explanatory"
}

סגנון הפלט הוא חלק מה-system prompt, שאותו Claude Code קורא פעם אחת בתחילת הפעלה (session). שינויים נכנסים לתוקף לאחר /clear או בהפעלה חדשה. ראה כיצד Claude Code משתמש ב-prompt caching למידע על מה ששינוי סגנון פלט גורם למטמון (cache).

#יצירת סגנון פלט מותאם אישית

סגנון פלט מותאם אישית הוא קובץ Markdown: כותרת קדמית (frontmatter) עבור מטא-נתונים, ולאחר מכן ההנחיות שיש להוסיף ל-system prompt.

צור קובץ Markdown: שמור אותו באחת משלוש רמות. שם הקובץ הופך לשם הסגנון, אלא אם תגדיר name ב-frontmatter.
- משתמש: ~/.claude/output-styles
- פרויקט: .claude/output-styles
- מדיניות מנוהלת: .claude/output-styles בתוך ספריית ההגדרות המנוהלות
סגנונות פלט ברמת הפרויקט נטענים מכל ספריית .claude/output-styles/ שבין ספריית העבודה לשורש המאגר (repository root). כאשר יותר מספרייה מקוננת אחת כזו מגדירה סגנון בעל אותו שם, Claude Code משתמש בסגנון הקרוב ביותר לספריית העבודה.
הוסף frontmatter והנחיות: החלט האם לשמור על הנחיות הנדסת התוכנה של Claude Code. הגדר keep-coding-instructions: true אם אתה משנה את האופן שבו Claude מתקשר אך עדיין רוצה שהוא יכתוב קוד באותו אופן. השמט זאת אם Claude לא יעסוק בהנדסת תוכנה.

דוגמה זו פותחת כל הסבר בדיאגרמה תוך שמירה על התנהגות כתיבת הקוד של Claude:
```
---
name: Diagrams first
description: Lead every explanation with a diagram
keep-coding-instructions: true
---

When explaining code, architecture, or data flow, start with a Mermaid diagram showing the structure, then explain in prose.
```

#Diagram conventions

Use flowchart TD for control flow and sequenceDiagram for request paths. Keep diagrams under 15 nodes.


3. עבור לסגנון שלך:
הרץ `/config` בטרמינל ובחר את הסגנון שלך תחת **Output style**, או הגדר את `outputStyle` בקובץ הגדרות לשם של הסגנון. השינוי נכנס לתוקף לאחר `/clear` או בפעם הבאה שתתחיל הפעלה.

תוספים ([Plugins](/docs/en/plugins-reference)) יכולים גם כן לכלול סגנונות פלט בתוך ספריית `output-styles/`.

### Frontmatter

קבצי סגנון פלט תומכים בשדות ה-frontmatter הבאים:

| Frontmatter | מטרה | ברירת מחדל |
| :--- | :--- | :--- |
| `name` | שם סגנון הפלט, אם אינו שם הקובץ | יורש משם הקובץ |
| `description` | תיאור סגנון הפלט, מוצג בבוחר של `/config` | ללא |
| `keep-coding-instructions` | שמירה על הנחיות הנדסת התוכנה המובנות של Claude Code | `false` |
| `force-for-plugin` | סגנונות פלט של תוספים בלבד: החלת סגנון זה באופן אוטומטי בכל פעם שהתוסף מופעל, מבלי לחייב משתמשים לבחור בו. עוקף את הגדרת ה-`outputStyle` של המשתמש. אם מספר תוספים מופעלים מגדירים זאת, Claude Code משתמש בראשון שנטען. | `false` |

## כיצד סגנונות פלט עובדים

סגנונות פלט משנים ישירות את ה-system prompt של Claude Code.

* Claude Code מוסיף את ההנחיות המותאמות אישית של סגנון הפלט ל-system prompt.
* כאשר אתה [בוחר סגנון שאינו Default](#change-your-output-style), Claude Code גם מזכיר ל-Claude את הסגנון במהלך השיחה.
* סגנונות פלט מותאמים אישית משמיטים את הנחיות הנדסת התוכנה המובנות של Claude Code, כגון כיצד לתחם שינויים, לכתוב הערות ולאמת עבודה, אלא אם `keep-coding-instructions` מוגדר כ-`true`.

סגנונות פלט חלים על השיחה הראשית בלבד: [סוכן משנה (subagent) מריץ system prompt משלו](/docs/en/sub-agents#what-loads-at-startup), כך שסגנונות אינם משנים את האופן שבו סוכני משנה מגיבים. פיצול שיחה ([fork](/docs/en/sub-agents#fork-the-current-conversation)) הוא החריג, מכיוון שהוא יורש את ה-system prompt המלא של שיחת המקור.

השימוש באסימונים (tokens) תלוי בסגנון. הוספת הנחיות ל-system prompt מגדילה את אסימוני הקלט (input tokens), אם כי שמירת פרומפטים במטמון (prompt caching) מפחיתה עלות זו לאחר הבקשה הראשונה בהפעלה. סגנונות ה-Explanatory וה-Learning המובנים מייצרים תגובות ארוכות יותר מ-Default כחלק מעיצובם, מה שמגדיל את אסימוני הפלט (output tokens), בעוד שסגנון ה-Concise עושה את ההפך בכך שהוא מנחה את Claude לשמור על תגובות קצרות כברירת מחדל. בסגנונות מותאמים אישית, השימוש באסימוני פלט תלוי במה שההנחיות שלך מורות ל-Claude לייצר.

## השוואות לתכונות קשורות

מספר תכונות מתאימות אישית את אופן הפעולה של Claude Code. סגנונות פלט משנים את ה-system prompt ישירות וחלים על כל תגובה. התכונות האחרות מוסיפות הנחיות מבלי לשנות את ברירת המחדל של ה-system prompt, או תוחמות אותן למשימה מסוימת.

| תכונה | כיצד היא עובדת | מתי להשתמש בה |
| :--- | :--- | :--- |
| סגנונות פלט | משנה את ה-system prompt | אתה רוצה תפקיד, טון או פורמט תגובה כברירת מחדל שונים בכל פנייה |
| [CLAUDE.md](/docs/en/memory) | מוסיף הודעת משתמש אחרי ה-system prompt | Claude צריך תמיד להכיר את מוסכמות הפרויקט והקשר בסיס הקוד שלך |
| `--append-system-prompt` | משרשר לסוף ה-system prompt מבלי להסיר דבר | אתה רוצה תוספת חד-פעמית עבור הפעלה בודדת |
| [סוכנים](/docs/en/sub-agents) | מריץ סוכן משנה עם system prompt, מודל וכלים משלו | אתה רוצה עוזר מתוחם בנפרד למשימה ממוקדת |
| [מיומנויות](/docs/en/skills) | טוען הנחיות ספציפיות למשימה בעת הפעלה או כאשר הן רלוונטיות | יש לך תהליך עבודה לשימוש חוזר |

## משאבים קשורים

* [הגדרות](/docs/en/settings): היכן השדה `outputStyle` נמצא וכיצד פועלת קדימות ההגדרות
* [מצבי הרשאה](/docs/en/permission-modes): כיצד סגנון Proactive משתווה ל-auto mode
* [תוספים](/docs/en/plugins): אריזה והפצה של סגנונות פלט לצד מיומנויות, hooks וסוכנים
* [ניפוי באגים של התצורה שלך](/docs/en/debug-your-config): אבחון הסיבה לכך שסגנון פלט אינו נכנס לתוקף