📘 תיעוד 147

הסלמת החלטות קשות עם כלי היועץ

צמדו את המודל הראשי שלכם למודל יועץ חזק יותר, שבו Claude מתייעץ ברגעים מרכזיים במהלך משימה.

[!NOTE]

כלי היועץ הוא ניסיוני ודורש את Anthropic API. הוא אינו זמין ב-Amazon Bedrock, ב-Claude Platform on AWS, ב-Google Cloud's Agent Platform, או ב-Microsoft Foundry. התנהגות, תמחור וזמינות עשויים להשתנות.

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

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

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

#מתי להשתמש ביועץ

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

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

#הפעלת היועץ

אפשר להגדיר את מודל היועץ בשלוש דרכים:

• פקודת /advisor: הגדרה או שינוי של היועץ באמצע הסשן ושמירה כברירת המחדל שלכם
• הגדרת advisorModel: הגדרת ברירת מחדל קבועה בקובץ ההגדרות שלכם
• דגל --advisor: הגדרת היועץ לסשן יחיד בהפעלה

כל אחת מאלה מפעילה את היועץ לסשנים שהמודל הראשי שלהם תומך בו. אחרי שהסשן מתחיל, Claude Code מציג התראה Advisor Tool (experimental) is on and may use more tokens · /advisor. כדי להפסיק להשתמש ביועץ, ראו כיבוי היועץ.

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

#שימוש בפקודת /advisor

הריצו /advisor בלי ארגומנטים כדי לפתוח בורר שמציג את מודלי היועץ הזמינים, או העבירו את המודל ישירות:

/advisor opus

הפקודה מאשרת עם Advisor set to ואחריו שם מודל היועץ. הבחירה שלכם נשמרת ב-advisorModel בהגדרות המשתמש ונשמרת בין סשנים, למעט במקרים שרשומת advisorModel מציינת כחלים על הסשן הנוכחי בלבד.

הפקודה עובדת גם במקום שאין בו בורר טרמינל: במצב לא אינטראקטיבי עם -p, ב-Agent SDK, באפליקציית שולחן העבודה, ומעל Remote Control. זה דורש Claude Code v2.1.260 או חדש יותר. במשטחים האלה:

• הריצו /advisor בלי ארגומנט כדי להדפיס את מודל היועץ הנוכחי ואת הכינויים שהוא מקבל.
• הריצו /advisor עם מודל, כמו /advisor opus, כדי להגדיר אותו.
• הריצו /advisor off כדי לכבות אותו.

Claude Code לא מפעיל יועץ שמור שרשימת ההיתר availableModels של הארגון מחריגה. כדי להשתמש ביועץ, בחרו מודל מותר עם /advisor.

Claude Code עדיין שומר יועץ שהמודל הראשי הנוכחי לא תומך בו. היועץ הזה מופעל אחרי שעוברים למודל ראשי תואם עם /model. אם ה-API כבר סירב ליועץ השמור בשיחה הנוכחית, הוא נשאר כבוי עד /clear או /compact, גם אחרי החלפת מודלים.

בחלק מהתוכניות, Fable כיועץ דורש גם את ההסכמה החד פעמית שלכם לחייב שימוש ב-Fable לקרדיטי שימוש. למה ש-/advisor fable עושה לפני שנתתם את ההסכמה הזו, ראו יועץ Fable וקרדיטי שימוש.

#הגדרת advisorModel בהגדרות

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

{
  "advisorModel": "opus"
}

#שימוש בדגל --advisor

כדי להגדיר את היועץ לסשן יחיד בלי לשנות את ההגדרה השמורה, הפעילו עם הדגל:

claude --advisor opus

Claude Code משתמש בדגל במקום בהגדרת advisorModel עבור הסשן הזה. הוא לא מציג את --advisor ב-claude --help. Claude Code יוצא עם שגיאה בהפעלה אם:

• המודל הראשי של הסשן לא תומך ביועץ
• המודל המבוקש, כמו Haiku 4.5, לא יכול לשמש כיועץ
• רשימת ההיתר availableModels של הארגון מחריגה את המודל המבוקש
• ביקשתם Fable והחשבון שלכם עדיין דורש את הסכמת קרדיטי השימוש

אם אתם מתחילים סשן רקע עם --advisor ואחד מאלה חל, Claude Code מתחיל את הסשן בלי היועץ במקום לצאת.

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

#בחירת מודל יועץ

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

Fable 5.1 דורש Claude Code v2.1.257 או חדש יותר. מודלי Fable דורשים גישת Fable. Sonnet 5.5 כיועץ למודל ראשי Opus 4.7 או Opus 4.8 דורש Claude Code v2.1.287 או חדש יותר. Haiku 5.5 כמודל הראשי או כיועץ דורש Claude Code v2.1.293 או חדש יותר.

הגדירו את היועץ כ-fable, opus, או sonnet. הכינויים האלה נפתרים לגרסת ברירת המחדל המובנית של Claude Code לכל משפחת מודלים, והיא מתקדמת עם מהדורות חדשות של Claude Code. אפשר גם להעביר מזהה מודל מלא כמו claude-opus-5-5 או claude-haiku-5-5. Haiku 4.5 יכול לקרוא ליועץ אבל לא יכול לשמש כאחד.

סוכני משנה יורשים את היועץ המוגדר ומחילים את אותה בדיקת צירוף מול המודל שלהם.

Claude Code מאמת את הצירוף לפני שליחת בקשה, וה-API מאמת אותו שוב:

• ליועץ שמדרג מתחת למודל הראשי, Claude Code לא מצרף אותו לבקשות של המודל הראשי. פלט הפקודה /advisor והתראה מציגים את זה. ראו Advisor is less capable than the current main model. סוכני משנה שהמודל שלהם עומד בצירוף עשויים עדיין להשתמש ביועץ.
• אם ה-API מסרב לצירוף של יועץ ש-Claude Code צירף, Claude Code שולח מחדש את הבקשה הזו בלי היועץ. השיחה ממשיכה בלי יועץ, כך שלא רואים שגיאה ולא מקבלים קריאות יועץ. אם אחר כך בוחרים יועץ אחר עם /advisor, זה נכנס לתוקף אחרי /clear או /compact ובסשנים חדשים.
• אם המודל הראשי או היועץ הוא מודל ש-Claude Code לא מזהה, היועץ לא מצורף.

#יועץ Fable וקרדיטי שימוש

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

לפני שקיבלתם אותה, Claude Code לא שומר את Fable כיועץ כשאתם מקלידים /advisor fable או בוחרים Fable בבורר /advisor. הוא מפנה אתכם אל /model fable. עם claude --advisor fable, Claude Code יוצא בהפעלה עם הודעה שמפנה אל /model fable. בסשן רקע, הוא מתחיל את הסשן בלי היועץ במקום לצאת. כש-Fable כבר שמור כ-advisorModel שלכם, Claude Code שולח בקשות בלי היועץ. בסשן אינטראקטיבי שהמודל הראשי שלו תומך ביועץ, הוא גם מציג התראה שמפנה אל /model fable.

כדי לקבל את ההסכמה, הריצו /model fable ובחרו להמשיך על Fable. Claude Code רושם את ההסכמה ושומר את Fable כמודל הנבחר שלכם. אחר כך בחרו את Fable כיועץ.

#צירופי מודלים נפוצים

כל צירוף מתקבל עובד. השילובים האלה מאזנים עלות מול יכולת בדרכים שונות:

#מתי Claude מתייעץ עם היועץ

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

אפשר לבקש התייעצות בפרומפט באותו אופן שבו מבקשים כל כלי, למשל consult the advisor before you continue. אין הגדרה להגביל או לכפות קריאות יועץ. אם אתם רוצים ש-Claude יתייעץ יותר או פחות במהלך משימה, אמרו זאת בהוראות שלכם.

#מה רואים במהלך סשן

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

• Reviewed: השורה מאשרת שהיועץ סקר את השיחה. כשהיועץ החזיר הנחיה קריאה, לחצו Ctrl+O כדי לקרוא אותה.
• Declined: השורה היא Advisor declined to advise on this request. אם היועץ נתן סיבה, לחצו Ctrl+O כדי לקרוא אותה.
• Unavailable: קריאת היועץ נכשלה, והשורה היא Advisor unavailable (<error_code>), כאשר <error_code> הוא הקוד שהקריאה החזירה.

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

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

#עלות

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

• חיוב API: אתם משלמים את תעריפי הקלט והפלט של מודל היועץ עבור טוקני היועץ
• תוכניות מנוי: שימוש ביועץ נספר למגבלות השימוש של התוכנית, חוץ מיועץ Fable שמחויב לקרדיטי שימוש בתוכניות שבהן שימוש ב-Fable מחויב כך

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

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

לאופן הדיווח על טוקני יועץ בתשובות API, ראו Usage and billing בתיעוד Claude API.

#השפעה על מטמון פרומפט

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

הקריאה של מודל היועץ עצמו את השיחה לא נשמרת במטמון. כל קריאת יועץ מעבדת את התמליל המלא מחדש, בלי שימוש חוזר בין קריאות.

#דרישות

כלי היועץ דורש את כל אלה:

• Anthropic API בלבד: היועץ הוא כלי שמופעל בשרת. הוא אינו זמין ב-Amazon Bedrock, ב-Claude Platform on AWS, ב-Google Cloud's Agent Platform, או ב-Microsoft Foundry. דרך שער LLM שמוגדר עם ANTHROPIC_BASE_URL, הזמינות תלויה בשאלה אם השער מעביר את הבקשה בשלמותה אל Anthropic API. אם השער או ה-upstream שלו לא מזהים את כלי היועץ, ראו Automatic retry and error forwarding לאופן התגובה של Claude Code.
• מודל ראשי נתמך: Fable, Opus 4.6 או חדש יותר, Sonnet 4.6 או חדש יותר, Haiku 4.5, או Haiku 5.5. ראו בחירת מודל יועץ לאילו יועצים כל אחד מקבל.
• שליפת דגל תכונה: Claude Code מפעיל את היועץ דרך דגל תכונה שהוא שולף מ-Anthropic. בסשן שבו מוגדר משתנה שמכבה שליפת דגלים, כמו DISABLE_TELEMETRY, היועץ נשאר כבוי. ראו תכונות שצריכות שליפת דגל תכונה.

#כיבוי היועץ

כדי להפסיק להשתמש ביועץ, הריצו /advisor off או בחרו No advisor בבורר /advisor:

/advisor off

כדי להשבית את כלי היועץ לגמרי, הגדירו CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1. הפקודה /advisor הופכת ללא זמינה וכל advisorModel מוגדר מתעלמים ממנו. הדגל --advisor מתקבל אבל אין לו השפעה. ראו משתני סביבה.

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

היועץ הוא אחת מכמה דרכים לשלב חוזקות של מודלים. בחרו לפי מתי אתם רוצים שמודל שני יהיה מעורב.

#ראו גם

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