מדריך פרומפטים ל-Claude Opus 5.5: רמת effort, סוכנים, סירובים ותבניות

כדי לכתוב פרומפטים טובים ל-Claude Opus 5.5, השאירו את הפרומפטים שבהם השתמשתם עם Claude Opus 5, קבעו את רמת ה-effort לפני שאתם משנים את הניסוח, ואז הוסיפו לפרומפט המערכת שורה ממוקדת לכל התנהגות שאתם רוצים לשנות. המדריך של Anthropic אומר שהפרומפטים הקיימים ל-Claude Opus 5 "אמורים לעבוד היטב ללא שינויים", וש-effort הוא "ההגדרה הראשונה שכדאי לכוונן כדי לאזן בין אינטליגנציה, זמן תגובה ועלות". רוב ההמלצות החדשות עוסקות בסוכנים: איך להשאיר ריצה ללא השגחה בתנועה, איך לקבל עדכוני התקדמות בתורות ארוכים ואיך לקבוע קצב לצוות של סוכנים. כל מה שלמטה לקוח מהמדריך "Prompting Claude Opus 5.5" של Anthropic ומתיעוד ה-API של המודל, ונבדק ב-3 באוקטובר 2026.

כללי הבקשה המשותפים ל-Claude Fable 5.1, כמו איסור על מילוי מראש של תשובת העוזר ועל temperature מותאם אישית, מוסברים במדריך הפרומפטים ל-Claude Fable 5.1. המאמר הזה עוסק במה שייחודי ל-Claude Opus 5.5.

האם פרומפטים של Claude Opus 5 עובדים ב-Claude Opus 5.5?

כן. Anthropic אומרת שהם "אמורים לעבוד היטב ללא שינויים", ושדפוסי הפרומפטים של Claude Opus 5 "נשארים נקודת פתיחה סבירה". מה שמשתנה הוא האופן שבו המודל מחלק את המאמץ שלו. Claude Opus 5.5 מפיק טוקנים של פלט מהר יותר מ-Claude Opus 5 ביותר מ-30 אחוז, ובדרך כלל מסיים את אותה משימה עם פחות טוקנים.

Anthropic מציינת ארבעה תחומים שבהם המודל השתפר, והם שקובעים אילו חלקים במדריך הזה רלוונטיים לכם:

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

אם הפרומפטים שלכם מיועדים בעיקר לצ'אט, קראו את הסעיפים על effort ועל צ'אט. אם אתם מריצים סוכנים, ההמלצות החדשות נמצאות בסעיפים על סוכנים.

באיזו רמת effort להשתמש ב-Claude Opus 5.5?

התחילו ב-medium, ערך ברירת המחדל ב-Claude Opus 5.5 (ב-Claude Opus 5 ברירת המחדל היא high). הגדירו אותו במפורש ובדקו כמה רמות על המשימות שלכם, במקום להעביר את הערך שבו השתמשתם עם Claude Opus 5. שמות רמות ה-effort לא מייצגים את אותה כמות חשיבה בכל המודלים: בבדיקות של Anthropic, Claude Opus 5.5 ב-medium "משתווה ל-Claude Opus 5 ב-high או עולה עליו בהערכות תכנות ועבודת ידע", ובכמה הערכות תכנות low מתקרב לכך בעלות נמוכה בהרבה.

הגדרה מפורשת של medium מתנהגת בדיוק כמו השמטת effort.

באותה רמה, Claude Opus 5.5 נוטה לחשוב בכל תור יותר מ-Claude Opus 5, במיוחד ב-xhigh וב-max. זכרו שלושה דברים:

• השאירו מרווח ב-max_tokens. החשיבה נספרת ב-max_tokens גם כשאתם לא רואים אותה, ולכן מגבלה שהוגדרה ל-Claude Opus 5 כשהחשיבה כבויה עלולה לקטוע תשובות. בתורות ארוכים של תכנות סוכני, Anthropic מצאה ש-max_tokens של 128,000, המקסימום של המודל, עובד היטב.
• הורידו את ה-effort לפני שאתם כותבים "תחשוב פחות". הורדת ה-effort מצמצמת חשיבה, עלות וזמן תגובה באופן אמין יותר מהוראות בפרומפט.
• השאירו את ה-effort קבוע אם אתם נשענים על מטמון פרומפטים. שינוי ערך ה-effort ברמה העליונה בין בקשות מבטל את מטמון הפרומפטים.

ה-effort מוגדר ב-output_config:

{
  "model": "claude-opus-5-5",
  "max_tokens": 128000,
  "output_config": {"effort": "medium"},
  "messages": [{"role": "user", "content": "Review this pull request for bugs and explain each one."}]
}

אפשר לכבות את החשיבה ב-Claude Opus 5.5?

לא. Claude Opus 5 קיבל "thinking": {"type": "disabled"} ברמת effort high ומטה; Claude Opus 5.5 לא מקבל את זה, ובקשה כזו מחזירה שגיאה 400. החשיבה אדפטיבית ופעילה תמיד. אם האינטגרציה שלכם רצה כשהחשיבה כבויה, Anthropic ממליצה על ארבעה שינויים:

1. התחילו ב-effort low ומדדו. ב-low המודל חושב בקצרה. אם הזמן עד הטוקן הראשון עדיין חשוב, שורה בפרומפט המערכת כמו "Answer directly without deliberating." יכולה לצמצם את החשיבה עוד יותר, אבל בדקו את האיכות אחרי שהוספתם אותה.
2. מחקו הוראות שהחליפו את החשיבה. אם הפרומפט שלכם ביקש מהמודל לכתוב את ההנמקה שלו בתשובה, מחקו את השורה הזו וקראו את ההנמקה מתקציר החשיבה. פרומפט שדוחף את המודל לשחזר את ההנמקה שלו בתשובה עלול עכשיו להיענות בסירוב (ראו את סעיף הסירובים בהמשך).
3. בדקו מחדש עקיפות ישנות. כללים שהוספתם כדי להימנע מתקלות של ריצה ללא חשיבה אולי כבר לא נחוצים. מחקו כל כלל שאומר למודל לא לחשוב.
4. קראו את התגובה לפי סוג הבלוק. תגובה עשויה להתחיל בבלוק thinking או לא, ולכן בדקו את הסוג של כל בלוק במקום להניח שהראשון הוא טקסט.

כדי לראות את ההנמקה, בקשו את תקציר החשיבה:

{
  "model": "claude-opus-5-5",
  "max_tokens": 16000,
  "thinking": {"type": "adaptive", "display": "summarized"},
  "output_config": {"effort": "low"},
  "messages": [{"role": "user", "content": "Which of these three invoices has a total that does not match its line items?"}]
}

איך למנוע מסוכן Claude Opus 5.5 שרץ ללא השגחה לעצור מוקדם מדי?

במשימות ארוכות, Claude Opus 5.5 מעדכן את המשתמש תוך כדי עבודה, וחלק מהעדכונים האלה מסיימים את התור בטקסט ולא בקריאה לכלי (stop_reason: "end_turn"). לולאת סוכן שמתייחסת לכל תור כזה כ"משימה הושלמה" עוצרת באמצע הדרך. הפתרון של Anthropic כולל חלק במעטפת ההרצה (harness) וחלק בפרומפט.

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

Your task list still has open items: migrate the remaining two endpoints and update their tests. Continue with them. If one is blocked, say what is blocking it.

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

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

A standing instruction from the user, the person you are working for. It is about how your turns end. A message with no tool call in it ends your turn, and the work stops there until you are asked to continue. The user has seen you end turns in four ways while work they asked for was still owed, and does not want any of them. One: a long summary of what was done that closes by announcing the next step and has no tool call, so the next thing never starts. Two: an offer to carry on with something unless the user would prefer otherwise, which stops to wait for an answer the user was not going to give. Three: a list of decisions for the user when, by your own account, none of them blocks the rest of the work. Four: deciding that this is a good place to report, because the turn has been long or a milestone is done. Status notes are welcome, and so are your recommendations on open decisions, but put them in the same message as your next tool call and carry on with whatever does not depend on the user's answer. If you notice yourself inviting the user to redirect you or offering to wait, delete it and do the next thing. The stops the user does want are the ones where nothing can move without them, or where the thing blocking you is deliberately protected from you. This does not override the need for confirmation on risky or destructive actions.

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

איך מקבלים עדכוני התקדמות מסוכן Claude Opus 5.5 בריצות ארוכות?

בין קריאה לכלי לקריאה הבאה, Claude Opus 5.5 כותב הערות התקדמות קצרות: מה הוא מצא עכשיו ומה יעשה אחר כך. במודל הזה ההערות האלה חוזרות כבלוקים מסוג thinking ולא text, והטקסט שלהן ריק כברירת מחדל, ולכן לקוח שמציג רק בלוקים מסוג text עלול להיראות שקט לאורך תור ארוך. Anthropic מתעדת מצב תצוגה בגרסת בטא שמחזיר תקציר של כל הערה; ערכי thinking.display שמתועדים לנקודת הקצה מופיעים בתיעוד ה-API של Claude Opus 5.5.

שלושה מנופים ברמת הפרומפט ומעטפת ההרצה עובדים בלי שום הגדרה מיוחדת:

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

The user hasn't heard from you in a while — say in a few words what you're doing, then continue.

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

איך גורמים לסוכן Claude Opus 5.5 לבדוק את ההקשר לפני שהוא פועל?

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

Before taking any action, explore broadly with tool calls: list and open the emails, documents, spreadsheet tabs and records across the available apps that could be relevant to this task, including ones the task does not explicitly mention, and use what you find.

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

איך גורמים לצוות של סוכני Claude Opus 5.5 לסיים מהר יותר?

Claude Opus 5.5 שם לב מאוד לזמן שחלף. במבנה שבו סוכן מוביל מחלק עבודה לסוכני משנה, תנו לו תקציב זמן: גרמו למעטפת ההרצה להוסיף שורה קצרה בסוף כל הודעה שהיא מחזירה למודל, כמו elapsed 340s / 1200s. המודל מתאים את הקצב כדי לסיים בתוך התקציב ובדרך כלל מסיים הרבה לפניו, ולכן קבעו תקציב מעט גבוה מהזמן שאתם באמת רוצים להשקיע. אם אי אפשר להעריך תקציב, הציגו רק את הזמן שחלף והוסיפו את המשפט הזה לפרומפט המערכת:

Time matters here: do not spend time that can be avoided, and the earlier a correct result is obtained, the better.

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

האם פרומפט מערכת לצ'אט צריך לבקש מ-Claude Opus 5.5 לחשוב בזהירות?

לא. Anthropic מציעה להסיר מפרומפטי מערכת לצ'אט שורות כמו "think carefully before answering" (חשוב בזהירות לפני שאתה עונה): המודל מחליט בעצמו כמה לחשוב, ואמצעי השליטה בזה הוא ה-effort. בבדיקות של Anthropic במוצר צ'אט, הסרת שורה כזו גרמה לתשובות להתחיל מוקדם יותר בלי ירידה ברורה באיכות.

יש עוד שתי שורות לצ'אט שכדאי להכיר. אחת גורמת למודל להתייחס לתשובות קודמות כסגורות, כך שהתורות הבאים מתחילים מהר יותר. השנייה מסמנת טקסט שהמשתמש הדביק, כדי שהמודל לא יבצע הוראות שמוסתרות בהודעת דוא"ל או בדף אינטרנט. שתי השורות, מילה במילה, נמצאות בסעיף על Claude Opus 5.5 במדריך של Fable 5.1. אל תשתמשו בשורה על "תשובות סגורות" בניתוחים ארוכים או במשימות סוכניות, שבהן שלב מאוחר יכול לחשוף טעות בשלב מוקדם.

איך מקבלים תשובות טובות יותר על תרשימים, דיאגרמות וצילומי מסך?

קודם כול בדקו מחדש. בלי כלים נוספים, Claude Opus 5.5 קורא תרשימים צפופים, תרשימי זרימה וצילומי מסך של יומן בדיוק רב בהרבה מ-Claude Opus 5; בבדיקות של Anthropic, גם ברמת ה-effort הנמוכה ביותר הוא קרא ערכים מתרשימים צפופים בדיוק רב יותר מ-Claude Opus 5 ברמה הגבוהה ביותר. פיגומים שבניתם למודלים קודמים אולי כבר לא נחוצים.

בקלטים הצפופים ביותר, שני דברים עדיין עוזרים:

• תמונות ברזולוציה גבוהה יותר, במיוחד בשרטוטים טכניים.
• כלים לעיבוד תמונה. הריצו את המודל כסוכן עם קונטיינר שמכיל את התמונות המקוריות ומותקנים בו PIL או OpenCV, כדי שיוכל לחתוך, להגדיל ולמדוד. אם זה כבד מדי, גם כלי חיתוך בלבד עוזר. המודל משתמש בכלים האלה טוב יותר ברמות effort גבוהות יותר.

בלי כלים, העלאת ה-effort משפרת את קריאת השרטוטים הטכניים אבל כמעט לא עוזרת בתרשימים. תמונות נכנסות לתור של המשתמש כבלוקים מסוג image עם מקור URL; תיעוד ה-API מציג את הפורמט.

איך מונעים מפלט הפרונטאנד של Claude Opus 5.5 להיראות גנרי?

ציינו את הדפוסים שאתם לא רוצים. בלי כיוון עיצובי, Claude Opus 5.5 חוזר לכמה סגנונות ברירת מחדל, והוראה כללית כמו "הימנע ממראה AI גנרי" בדרך כלל רק מחליפה ברירת מחדל אחת באחרת. הדוגמה של Anthropic מפרטת דברים קונקרטיים שיש להימנע מהם:

Output a vanilla HTML/CSS personal website with placeholder data. Do not use a cream or off-white background, italic accent words in headlines, numbered "01/02/03" section labels, monospace labels, or pill-shaped buttons.

עבדו באיטרציות: בדקו באילו סגנונות השתמשה התוצאה הראשונה במקומם, והוסיפו אותם לרשימה.

למה Claude Opus 5.5 מחזיר stop_reason "refusal"?

מסווג בטיחות דחה את הבקשה. Claude Opus 5.5 מפעיל מסווגים לביולוגיה, לאבטחת סייבר ולחילוץ הנמקה, והסירוב מגיע כתגובה רגילה עם stop_reason: "refusal" ואובייקט stop_details שמציין את הקטגוריה.

על סירובים לבקשות תמימות באופן כללי, ראו למה Claude מסרב לבקשה תמימה במדריך של Fable 5.1.

שאלות נפוצות

האם יש מדריך פרומפטים רשמי ל-Claude Opus 5.5?

כן. Anthropic מפרסמת את "Prompting Claude Opus 5.5" בתיעוד למפתחים, לצד עמוד כללי של שיטות עבודה מומלצות שחל על כל מודלי Claude הנוכחיים. המאמר הזה מסכם את המדריך של Opus 5.5 נכון ל-3 באוקטובר 2026 ומצטט את התבניות מילה במילה.

מהי רמת ה-effort המוגדרת כברירת מחדל ב-Claude Opus 5.5?

medium. ב-Claude Opus 5 ברירת המחדל היא high. הרמות הן low, medium, high, xhigh ו-max, והן מוגדרות ב-output_config.effort.

כמה טוקנים של פלט Claude Opus 5.5 יכול לכתוב?

עד 128,000 טוקנים לבקשה, כולל החשיבה. חלון ההקשר הוא 1M טוקנים.

אפשר למלא מראש את התשובה של Claude Opus 5.5 או להגדיר temperature?

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

מה עדיף לסוכנים: Claude Opus 5.5 או Claude Fable 5.1?

זה תלוי במשימה ובתקציב; השוואת מודלי Claude מסבירה איזה לבחור. ההמלצות לכתיבת פרומפטים נבדלות בעיקר בערכי ברירת המחדל: Claude Opus 5.5 מתחיל ב-effort medium, ו-Claude Fable 5.1 ב-high.

נסו את הפרומפטים

הריצו את התבניות האלה על Claude Opus 5.5 עם מפתח SeedRouter, דרך Anthropic SDK או הפורמטים Chat Completions ו-Responses של OpenAI. תיעוד ה-API של Claude Opus 5.5 מפרט את כל הפרמטרים, ודף המודל מציג את המחירים הנוכחיים לטוקן. SeedRouter פועל בתשלום לפי שימוש: טוענים פעם אחת, הקרדיטים אף פעם לא פגים, ובקשות שנכשלו לא מחויבות.