📘 תיעוד 148

סגנונות פלט

שנו את התפקיד, הטון ופורמט התגובה של Claude Code באמצעות סגנון פלט מובנה כמו Concise או Explanatory, או כתבו סגנון מותאם אישית.

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

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

• כדי להשתמש בסגנון מובנה, בחרו אחד מסגנונות הפלט המובנים ועברו אליו.
• כדי לכתוב הוראות משלכם, צרו סגנון פלט מותאם אישית.

[!NOTE]

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

• למה ש-Claude צריך לדעת על הפרויקט שלכם, השתמשו ב-CLAUDE.md.
• למשהו שחייב לקרות בכל פעם, כמו עיצוב אחרי כל עריכה או חסימת פקודה, השתמשו ב-hook.
• ל-skills, ל-subagents ולאפשרויות האחרות, ראו בחירה בין סגנון פלט לבין יכולות אחרות.

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

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

הטבלה הזו מראה מה כל סגנון משנה בסשן ומתי הוא מתאים:

#Default

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

default מופיע ברשימת /output-style עם שאר הסגנונות, כך שבוחרים אותו באותה דרך.

#Proactive

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

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

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

#Concise

בסגנון Concise, המשפט הראשון בתגובה מציין מה קרה או מה התשובה. Claude משמיט את הפתיח, את התיאור צעד אחר צעד ואת הסיכום הסוגר, ועונה על שאלה פשוטה במשפט אחד עד שלושה. הוא מבצע את עבודת ההנדסה ביסודיות כמו בסגנון Default. נדרש Claude Code v2.1.237 או חדש יותר.

Claude עדיין כותב באורך מלא במקרים האלה:

• כל מה שאתם מבקשים: כשאתם מבקשים הסבר או פירוט נוסף, Claude עונה במלואו.
• כל מה שאתם צריכים כדי לפעול בבטחה: דוחות שגיאה, פלט של בדיקות שנכשלו, אזהרות אבטחה ואישורים לפעולות הרסניות שומרים על התוכן המלא שלהם.

#Explanatory

בסגנון Explanatory, Claude מבצע את המשימה כמו בסגנון Default ומוסיף הסברים קצרים למה בחר בבחירות שבחר. כל הסבר מופיע בשיחה, לפני הקוד שהוא עליו או אחריו, בבלוק שמסומן Insight. ההסברים לא נכתבים לתוך הקבצים שלכם כהערות.

בלוק Insight נושא שתיים או שלוש נקודות על בסיס הקוד שלכם או על הקוד ש-Claude כתב, כמו זה אחרי הוספת נקודת קצה של API:

★ Insight ─────────────────────────────────────
- Every route in this repo goes through the withAuth wrapper, so the new endpoint gets session checks without its own middleware.
- Rate limits are set per route in limits.ts, which is why this change adds an entry there rather than a global default.
─────────────────────────────────────────────────

#Learning

בסגנון Learning, Claude מוסיף את אותם בלוקי Insight כמו בסגנון Explanatory וגם מבקש מכם לכתוב חלק מהקוד. Claude מטפל בעצמו ביישום שגרתי. כשהוא מגיע לקטע עם החלטת עיצוב אמיתית, כמו טיפול בשגיאות, מבנה נתונים, או לוגיקה עסקית עם יותר מגישה תקינה אחת, הוא משאיר כמה שורות עבורכם.

Claude מסמן את המקום בהערת TODO(human) בקובץ, ואז שולח בקשה שאומרת מה כבר נבנה, מה לכתוב, ומה לשקול:

● Learn by Doing

Context: The upload form is in place and calls validateFile() before accepting a file. Size and type checks work for images, but the switch statement has no handling for documents yet.

Your Task: In upload.js, implement the case "document" branch inside validateFile(). Look for TODO(human).

Guidance: Decide on a size limit for documents and whether the file extension has to match the MIME type. Return {valid: boolean, error?: string}.

Claude אז עוצר ומחכה. כתבו את הקוד שלכם בהערת TODO(human) ואמרו ל-Claude כשסיימתם. Claude מגיב ב-Insight אחד על הקוד שלכם וממשיך את המשימה.

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

בחרו סגנון באמצעות הפקודה, תפריט, או קובץ הגדרות. הפקודה ושני התפריטים שומרים את הבחירה שלכם ב-.claude/settings.local.json ברמה המקומית של הפרויקט.

• פקודת /output-style: הריצו /output-style <style> כדי לעבור, לדוגמה /output-style concise. בלי ארגומנט, הפקודה מפרטת את הסגנונות שאפשר לבחור ומסמנת את הנוכחי.

  הפקודה עובדת גם במצב לא אינטראקטיבי ובסשנים של Agent SDK, ומהאפליקציה לנייד או מהרשת דרך Remote Control, שם אפשר לרשום ולבחור רק סגנונות מובנים. נדרש Claude Code v2.1.269 או חדש יותר.

• תפריט טרמינל: הריצו /config ובחרו Output style כדי לבחור סגנון מתפריט.

• תוסף VS Code: פתחו את תפריט הפקודות עם / ובחרו Output styles כדי לבחור סגנון, כולל הסגנונות המותאמים אישית שלכם. נדרש Claude Code v2.1.257 או חדש יותר.

• אפליקציית שולחן העבודה: הגדירו את השדה outputStyle בקובץ הגדרות, לדוגמה .claude/settings.local.json, הקובץ שתפריט הטרמינל כותב. כשמריצים שם /config, Claude Code פותח את Settings > Code או Settings > Claude Code במקום תפריט.

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

{
  "outputStyle": "Explanatory"
}

הערך תלוי רישיות, לכן כתבו את השמות המובנים כ-Proactive, Concise, Explanatory ו-Learning. ערך שלא תואם שם סגנון במדויק, כמו explanatory, נותן את סגנון Default. פקודת /output-style מתעלמת מרישיות.

כדי להפוך סגנון לברירת המחדל שלכם בכל הפרויקטים, הגדירו outputStyle ב-~/.claude/settings.json. קובצי ההגדרות של פרויקט גוברים על הערך הזה.

כשמחליפים סגנון באמצע סשן, Claude משתמש בסגנון החדש החל מההודעה הבאה שלכם. למה שההודעה הראשונה הזו עולה בשמירה במטמון של הפרומפט, ראו Changing output style. לפני v2.1.251, הסגנון החדש חל רק אחרי שהרצתם /clear או התחלתם סשן חדש.

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

סגנון פלט מותאם אישית הוא קובץ Markdown: frontmatter למטא נתונים, ואחר כך ההוראות ל-Claude.

בתוסף VS Code אפשר גם ליצור את הקובץ מתפריט Output styles במקום לכתוב אותו ידנית. זה דורש Claude Code v2.1.261 או חדש יותר.

1. צרו קובץ Markdown

שמרו אותו באחת משלוש רמות. שם הקובץ הופך לשם הסגנון אלא אם מגדירים name ב-frontmatter.

• משתמש: ~/.claude/output-styles
• פרויקט: .claude/output-styles
• מדיניות מנוהלת: .claude/output-styles בתוך ספריית ההגדרות המנוהלות

סגנונות פלט של פרויקט נטענים מכל .claude/output-styles/ בין ספריית העבודה לשורש המאגר. כשיותר מאחת מהספריות המקוננות האלה מגדירה סגנון עם אותו שם, Claude Code משתמש בזה הקרוב ביותר לספריית העבודה.

2. הוסיפו 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. עברו לסגנון שלכם

הריצו /output-style <style> בטרמינל, או הריצו /config ובחרו את הסגנון שלכם תחת Output style. Claude משתמש בסגנון החדש החל מההודעה הבאה שלכם. בטרמינל, Claude Code קורא קובצי סגנון כשהוא מתחיל, כך שאם יוצרים או עורכים קובץ במהלך סשן פעיל, הפעילו מחדש את Claude Code כדי לקלוט את השינוי.

תוספים יכולים גם לספק סגנונות פלט בספריית output-styles/.

#עיון ב-frontmatter

הגדירו סגנון פלט באמצעות frontmatter ב-YAML בין סמני --- בראש הקובץ. כל השדות אופציונליים, ושמות השדות משתמשים במילים באותיות קטנות שמופרדות במקפים. שדה עם איות שגוי מתעלמים ממנו בלי שגיאה. אם ה-YAML לא מנותח, הסגנון עדיין נטען תחת שם הקובץ שלו בלי שדות מוגדרים. הריצו claude --debug כדי לראות את שגיאת הניתוח.

#בחירה בין סגנון פלט לבין יכולות אחרות

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

הטבלה הזו מתאימה את מה שאתם רוצים ליכולת שעושה את זה:

היכולות האלה משתלבות. לדוגמה, אפשר להשתמש ב-CLAUDE.md למה ש-Claude צריך לדעת, בסגנון פלט לאופן שבו הוא מגיב, וב-hook לכל דבר שחייב להיות מובטח. Extend Claude Code משווה את שאר יכולות ההרחבה.

#איך סגנונות פלט עובדים

סגנון פלט משנה את ההוראות ש-Claude Code נותן ל-Claude.

• Claude Code שולח את ההוראות של הסגנון הפעיל עם כל בקשה.
• בהנחיית המערכת המלאה, סגנונות פלט מותאמים אישית משמיטים את המקטע של Claude Code עם הוראות הנדסת התוכנה המובנות, כמו איך לתחום שינויים, לכתוב הערות ולאמת עבודה, אלא אם keep-coding-instructions מוגדר ל-true. הנחיית המערכת הקצרה לא כוללת את המקטע הזה, ולכן לשדה אין השפעה שם. כדי להסתמך על השדה, הגדירו את CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT ל-0, וזה בוחר את ההנחיה המלאה בכל מודל.

סגנונות פלט חלים על השיחה הראשית ועל fork, שיורש את כל השיחה והנחיית המערכת של ההורה. subagents אחרים מריצים הנחיית מערכת משלהם, כך שסגנונות לא משנים את האופן שבו הם מגיבים.

השימוש בטוקנים תלוי בסגנון. ההוראות של סגנון מוסיפות טוקני קלט, אם כי שמירה במטמון של הפרומפט מפחיתה את העלות הזו אחרי הבקשה הראשונה בסשן.

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

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

• Settings: איפה השדה outputStyle נמצא ואיך עובדת קדימות ההגדרות
• Permission modes: איך סגנון Proactive משתווה ל-auto mode
• Plugins: אריזה והפצה של סגנונות פלט לצד skills, hooks ו-agents
• Debug your configuration: אבחון למה סגנון פלט לא נכנס לתוקף