📘 תיעוד 110

הסלמת החלטות קשות באמצעות כלי היועץ

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

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

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

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

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

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

היועץ מתאים למשימות ארוכות ומרובות שלבים שבהן רוב התורות שגרתיים, אך איכות התוכנית קובעת את התוצאה. דוגמאות כוללות שינויי מבנה קוד (refactors) גדולים, הפעלות ניפוי שגיאות שבהן שגיאה חוזרת על עצמה שוב ושוב, ומשימות שברצונך שייבדקו באופן עצמאי לפני ש-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 בהגדרות המשתמש שלך ונשמרת בין הפעלות.

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

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

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

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

{
  "advisorModel": "opus"
}

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

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

claude --advisor opus

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

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

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

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

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

Fable 5.1 דורש את Claude Code בגרסה v2.1.255 או מאוחרת יותר ו-Fable 5 דורש גרסה v2.1.170 או מאוחרת יותר, בתוספת גישה ל-Fable.

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

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

Claude Code מאמת את הצימוד לפני שליחת בקשה:

• אם היועץ בעל יכולת נמוכה יותר מהמודל הראשי, היועץ אינו מצורף לבקשות של המודל הראשי. פלט פקודת /advisor והודעה מציגים זאת. תת-סוכנים שהמודל שלהם מקיים את תנאי הצימוד עשויים עדיין להשתמש ביועץ.
• אם המודל הראשי או היועץ הוא מודל ש-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 כדי לקרוא אותה.

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

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

#עלות

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

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

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

#השפעה על שמירת הנחיות במטמון

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

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

#דרישות

כלי ה-advisor דורש את כל הדברים הבאים:

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

#כיבוי היועץ

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

/advisor off

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

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

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

#ראה גם

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