מדריך מעבר ל-Claude Sonnet 5.5: 5 שינויים ששוברים קוד שעובד
החלפת מחרוזת המודל היא לא כל השדרוג. Claude Sonnet 5.5 דוחה thinking כבוי ושימוש כפוי בכלים, ומשנה איפה טקסט התקדמות מופיע. צ'ק-ליסט מהתיעוד של Anthropic.
אם הקוד שלכם רץ על Claude Sonnet 5, החלפת מזהה המודל ל-claude-sonnet-5-5 היא לא שדרוג בטוח של שורה אחת. לפי מדריך המעבר של Anthropic, חמישה שינויים יכולים להחזיר שגיאת 400, ושינוי שישי משנה את צורת התשובה בלי להפיל אף בקשה.
שני השינויים שהכי סביר שיפגעו באפליקציה עובדת הם thinking: {"type": "disabled"} ושימוש כפוי בכלים. שניהם מחזירים עכשיו שגיאה ב-Sonnet 5.5.
המאמר הזה עובר על מה השתנה, מה לשלוח במקום, ואיך לבדוק את המעבר לפני שהוא מגיע למשתמשים. כל התנהגות למטה מגיעה מהתיעוד של Anthropic נכון ל-2 באוקטובר 2026. בדקו את התיעוד העדכני לפני שאתם משיקים, כי פרטי API זזים מהר.
למה המעבר הזה שונה מהחלפת מודל רגילה?
רוב שדרוגי המודלים משנים איכות, מהירות ומחיר. Sonnet 5.5 משנה גם את אימות הבקשות.
ההכרזה מ-28 בספטמבר של Anthropic אומרת ש-Sonnet 5.5 מתומחר כמו Sonnet 5, ב-2 דולר למיליון טוקני קלט ו-10 דולר למיליון טוקני פלט, וש-Anthropic מדדה עד 30% עלות נמוכה יותר למשימה בבדיקות שלה. כיסיתי את טענת העלות ואיך לבדוק אותה במאמר עלות-למשימה של Sonnet 5.5.
שוויון המחיר הוא הסיבה שצוותים ירצו לזוז מהר. שינויי האימות הם הסיבה לא לעשות את זה בעיוורון.
מדריך המעבר אומר שכל מודל מוצא צריך את שינויי Sonnet 5, ואז מונה עבודה נוספת לצוותים שבאים מ-Sonnet 4.6 ומטה. דף מה חדש מסכם את אותם חמישה שינויים שוברים.
מה קורה ל-thinking: {"type": "disabled"}?
ב-Sonnet 5.5 הוא מחזיר שגיאת 400 מסוג invalid_request_error.
Sonnet 5.5 מריץ adaptive thinking כברירת מחדל, גם כשלבקשה אין שדה thinking. זה שונה מ-Sonnet 4.6 ומטה, שם בקשה בלי השדה רצה בלי thinking.
כדי לשמור על ההתנהגות הישנה של בלי thinking מראש, Anthropic אומרת לשלוח:
{
"thinking": { "type": "between_tools" },
"output_config": { "effort": "high" }
}
כמה כללים מהמדריך חשובים בפרקטיקה:
between_toolsהיא הגדרת ה-thinking הנמוכה ביותר ב-Sonnet 5.5. היא לא צריכה כותרת בטא.- היא עובדת ב-effort של
low,mediumו-high. ב-xhighאוmaxהיא מחזירה שגיאת 400. - היא לא מקבלת שום שדה thinking אחר. שליחה של
display,budget_tokensאוblock_bindingאיתה גם מחזירה שגיאת 400. - אי אפשר לשנות effort באמצע שיחה איתה.
output_config.effortלכל הודעה ששונה מהרמה שבתוקף מחזיר שגיאת 400.
שני האחרונים קל לפספס. בונה בקשות משותף שתמיד מוסיף ערך display, או router שבוחר effort לכל תור, יכולים להישבר רק בנתיב של between_tools.
עוד פרט: המדריך אומר שבקשת between_tools שמגיעה ל-Sonnet 5 דרך fallback בצד שרת רצה שם עם thinking: {"type": "disabled"}. זו התנהגות מתוכננת, לא אי-התאמה לדבג.
אם ה-SDK שלכם קדום לערך החדש, המדריך מציין שדוגמאות Python ו-TypeScript עלולות להיכשל בבדיקת טיפוסים עד שתעדכנו את ה-SDK. אפשר גם להעביר את הערך כ-JSON גולמי.
מה מחליף שימוש כפוי בכלים?
Sonnet 5.5 דוחה tool_choice מסוג any או tool עם שגיאת 400, כולל ב-endpoint של ספירת טוקנים.
התחליף המתועד הוא tool_choice: {"type": "auto"} ועוד strict: true על הכלי, כך שהקלט מתאים לסכמה שלכם. שימוש strict בכלים תומך בתת-קבוצה של JSON Schema ודורש additionalProperties: false על כל אובייקט.
יש מלכוד התנהגותי, והמדריך אומר אותו ישירות: עם auto, המודל יכול לענות בלי לקרוא לכלי. הפרומפט שלכם צריך עכשיו לומר מתי צריך להשתמש בכלי.
Amazon Bedrock שונה. המדריך אומר ש-structured outputs, שכוללים שימוש strict בכלים, לא זמינים ל-Sonnet 5.5 שם. ב-Bedrock הוא ממליץ על auto בלי strict, פרומפט שאומר מתי לקרוא לכלי, ואימות של קלט הכלי בקוד שלכם.
זה השינוי שהייתי בודק ראשון. שימוש כפוי בכלי הוא דרך נפוצה לקבל חילוץ מובנה אמין. המעבר ל-auto הופך הבטחה להסתברות, גם עם סכמה strict. הוסיפו בדיקה למקרה שקריאת כלי לא חוזרת, והחליטו מה האפליקציה עושה אז: מנסה שוב, שואלת שוב עם הוראה נחושה יותר, או נכשלת בצורה גלויה.
למה בלוקים של thinking יכולים לשבור לולאת כלים?
שני כללים נפרדים חלים כאן.
ראשית, בלוקים של thinking קשורים למודל. המדריך אומר ש-Sonnet 5.5 קורא בלוקים מ-Sonnet 5, Opus 4.8, Haiku 4.5 ומודלים מוקדמים יותר. הוא לא קורא בלוקים מ-Opus 5, Opus 5.5, או כל מודל Fable או Mythos. ה-API משמיט בלוקים שהמודל לא יכול לקרוא, עדיין מחזיר 200, ולא מחייב על בלוקים שהושמטו. אם אתם מחליפים מודלים באמצע שיחה, רציפות ההיגיון יכולה להשתנות בשקט בלי שגיאה.
שנית, כל בלוק thinking של Sonnet 5.5 חתום על השיחה שלפניו. לחשבונות שנוצרו ב-31 באוגוסט 2026, 00:00 UTC ואילך, ה-API אוכף את זה כברירת מחדל ב-Claude API, ב-Amazon Bedrock וב-Google Cloud. בקשה שמשדרת מחדש בלוק אחרי שההיסטוריה המוקדמת נערכה מחזירה שגיאת 400.
הכלל המעשי הוא לשמור שיחות כ-append-only. אם האפליקציה שלכם חותכת, משכתבת או מסכמת תורים מוקדמים תוך שמירת בלוקי thinking ישנים, בדקו את הנתיב הזה. המדריך אומר לשנות הוראות או כלים עם הודעות system באמצע השיחה במקום.
המדריך גם אומר להעביר בלוקי thinking חזרה ללא שינוי בלולאות שימוש בכלים, כולל ריקים. וקראו תוכן תשובה לפי type של הבלוק, כי תשובה יכולה עכשיו להתחיל בבלוק thinking. קוד שקורא content[0].text נשבר.
מה עם computer use וכלי היועץ?
שני השינויים האלה משפיעים על פחות צוותים, אבל שניהם נכשלים בקול.
עבור computer use ב-Claude API וב-Google Cloud, Sonnet 5.5 תומך שם רק ב-toolset computer_toolset_20260801. computer_20251124 מחזיר שגיאת 400. computer_20250124 לא מתקבל באף פלטפורמה. ב-Amazon Bedrock, המדריך אומר לשלוח computer_20251124.
אם אתם שולחים את כותרת הבטא fine-grained-tool-streaming-2025-05-14, הסירו אותה במעבר ל-toolset. המדריך אומר שהיא מחזירה שגיאת 400 לצד ערך toolset, ושצריך להגדיר eager_input_streaming: true על כל כלי שצריך את זה.
לכלי היועץ, מבצע Sonnet 5.5 צריך יועץ מהרשימה הזאת: Opus 5, Opus 5.5, Sonnet 5.5, Fable 5, Fable 5.1, Mythos 5 או Mythos 5.1. יועצים מסוג Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 5 ו-Sonnet 4.6 מחזירים שגיאת 400. העצה חוזרת מוצפנת, כך שהטקסט שלה לא קריא בתשובה.
מה משתנה בלי לזרוק שגיאה?
טקסט בין קריאות כלים.
ב-Sonnet 5.5, הערות ארוכות ממשפט-שניים שהמודל כותב בין קריאות כלים חוזרות כבלוקי thinking של עדכוני התקדמות. הם ריקים בערך display ברירת המחדל. הערות קצרות יותר נשארות כ-text.
המדריך אומר שאף בקשה לא נכשלת. אבל ממשק שמציג את ההערות האלה למשתמשים משתתק בזמן קריאות כלים.
אם ה-UI שלכם מסטרים עדכונים בסגנון "מחפש בבסיס הנתונים", זה השינוי שייראה כמו באג פרונט. לפי המדריך, עם adaptive thinking אפשר להגדיר display כ-"updates" (פיצ'ר בטא עם כותרת משלו) כדי לקבל את העדכונים לבדם, או "summarized" כדי לקבל אותם מעורבים בהיגיון. עם between_tools, הטקסט חוזר בלי display.
כדאי גם לבחון מחדש את max_tokens. הוא מכסה thinking ועוד טקסט, והמדריך אומר שטוקני thinking מחוייבים כטוקני פלט.
באיזו התנהגות בטיחות ו-fallback כדאי לתכנן?
Sonnet 5.5 יכול לסרב בקטגוריות רבות יותר מ-Sonnet 5. סירוב מחזיר stop_reason: "refusal", ו-stop_details יכול לתת שם לקטגוריה: cyber, bio, frontier_llm, reasoning_extraction או general_harms. המדריך מציין שגם עבודה תמימה יכולה להפעיל general_harms.
ההכרזה של Anthropic אומרת ש-Sonnet 5.5 הוא מודל Sonnet הראשון שמשיק עם אמצעי סייבר ו-fallbacks כמו אלה שמשמשים את המודלים המסוגלים ביותר שלה, ושאמצעי הסייבר מכוונים לקבוצה צרה של בקשות בסיכון גבוה. פיתוח תוכנה שגרתי ורוב עבודת מדעי החיים מתוארים כלא מושפעים.
Fallback בצד שרת, פיצ'ר בטא ב-Claude API בלבד, מנסה שוב סירובים מסוג cyber ו-frontier_llm על Sonnet 5. הוא לא מנסה שוב סירובים מסוג bio, reasoning_extraction או general_harms.
לכלי אבטחה, המדריך אומר להגיש בקשה ל-Cyber Verification Program של Anthropic. אם המוצר שלכם עושה עבודת פרצות, התייחסו לזה כמשימת השקה, לא תיקון אחרי השקה.
איך כדאי לבדוק את המעבר?
זו דוגמה היפותטית, לא דיווח מפריסה אמיתית. נניח עוזר תמיכה פנימי שמחלץ קטגוריית פנייה בכפיית קריאת כלי, מסתיר היגיון של מודל, ומסטרים טקסט התקדמות קצר למסך.
לפני החלפת תעבורה, הייתי מריץ את הבדיקות האלה מול מפתח staging:
1. שדרו מחדש את בוני הבקשות שלכם. שלחו בקשה אחת לכל נתיב קוד עם מזהה המודל החדש. כל שגיאת 400 מ-disabled, tool_choice כפוי, או כלי computer-use ישן מופיעה מיד.
2. חפשו אינדקסים קשיחים של תוכן. חפשו content[0] והנחות דומות. פרסרו לפי סוג בלוק.
3. בדקו דילוג על כלים. אחרי המעבר ל-auto, שלחו קלטים שצריכים ולא צריכים לקרוא לכלי. ספרו כמה פעמים קריאת הכלי חסרה, וטפלו בזה.
4. בדקו שיחה ארוכה. ערכו או חתכו היסטוריה מוקדמת ב-staging, ואז המשיכו את השרשור. זה תופס כשלים של בלוקים חתומים.
5. עקבו אחרי ה-UI. הריצו משימה עמוסת כלים ובדקו אם טקסט התקדמות עדיין מופיע.
6. סרקו מחדש effort. המדריך אומר שהרמות כוילו מחדש, כך שאותה רמה לא מייצרת אותה כמות thinking כמו ב-Sonnet 5. Anthropic מציעה להתחיל ב-high אלא אם עומס העבודה סוכנותי או רגיש ל-latency, וב-medium לעבודה סוכנותית מוגדרת היטב.
7. כיילו מחדש עלות. השוו עלות למשימה שהושלמה, לא רק מחיר לטוקן.
עבור Sonnet 4.6 ומטה, הוסיפו את הפריטים הנוספים מהמדריך: צפו thinking בבקשות בלי שדה thinking, החליפו תקציבי thinking ברמת effort, והסירו ערכי temperature, top_p ו-top_k שאינם ברירת מחדל.
Anthropic גם אומרת שהסקיל /claude-api migrate ב-Claude Code יכול ליישם את החלפת מזהה המודל ואת שינויי הפרמטרים השוברים, ואז לייצר צ'ק-ליסט לאימות ידני. אני עדיין הייתי קורא את ה-diff שהוא מייצר. זו נקודת התחלה, ורשימת האימות היא החלק שמגן עליכם.
מה הייתי עושה קודם
לנעוץ את המודל הישן בייצור, להעביר ענף staging, ולתקן שגיאות בסדר הזה: thinking, tool_choice, פרסור תוכן, ואז היסטוריית לולאת כלים. אלה הכשלים שעוצרים בקשות. טקסט התקדמות, effort ועלות באים אחר כך כי הם משנים איכות וחוויית משתמש במקום.
המודל זול יותר למשימה בבדיקות של Anthropic. זה לא אומר כלום על אם קוד ה-wrapper של האפליקציה שלכם מוכן אליו.
שאלות נפוצות
אפשר פשוט לשנות את מזהה המודל ל-claude-sonnet-5-5?
רק אם הבקשות שלכם נמנעות מהשינויים במדריך המעבר של Anthropic. המדריך מונה שינויי מזהה מודל ועוד כמה שינויי פרמטרים שוברים. בדקו כל נתיב בקשה לפני הזזת תעבורת ייצור.
מה מחליף את thinking: {"type": "disabled"} ב-Sonnet 5.5?
Anthropic מתעדת thinking: {"type": "between_tools"}. הוא עובד ב-effort של low, medium ו-high ומחזיר שגיאת 400 ב-xhigh או max. Sonnet 5 ומודלים מוקדמים יותר עדיין משתמשים בדרך הישנה לכבות thinking.
למה קריאת הכלי הכפויה שלי מחזירה שגיאת 400?
Sonnet 5.5 לא תומך ב-tool_choice מסוג any או tool. התחליף המתועד הוא auto עם כלי strict, ועוד פרומפט שאומר מתי להשתמש בכלי. ב-Amazon Bedrock, השתמשו ב-auto בלי strict ואמתו את הקלט בעצמכם.
למה ה-UI שלי הפסיק להראות טקסט התקדמות בין קריאות כלים?
לפי מדריך המעבר, הערות ארוכות יותר בין קריאות כלים חוזרות עכשיו כבלוקי thinking, שהם ריקים בערך display ברירת המחדל. הגדירו ערך display נתמך עם adaptive thinking, או השתמשו ב-between_tools, שם הטקסט חוזר בלי display.
האם Sonnet 5.5 עולה פחות מ-Sonnet 5?
Anthropic מציינת את אותם מחירי טוקנים ואומרת שמדדה עד 30% עלות נמוכה יותר למשימה בבדיקות שלה. התוצאה שלכם תלויה בפרומפטים, רמת ה-effort, שימוש ב-thinking ושיעור הכשלים שלכם. מדדו עלות למשימה שהושלמה.
אפשר להחליף בין מודלי Claude בתוך שיחה אחת?
אולי, אבל בלוקי thinking קשורים למודל. המדריך אומר ש-Sonnet 5.5 לא יכול לקרוא בלוקים מ-Opus 5, Opus 5.5, או מודלי Fable ו-Mythos. ה-API משמיט אותם ועדיין מחזיר 200, אז בדקו איכות כשאתם מחליפים.
האם סקיל המעבר של Claude Code מספיק?
הוא יכול לעשות את העריכות המכניות ולייצר צ'ק-ליסט, לפי Anthropic. הוא לא מחליף בדיקות מול הפרומפטים, הכלים, ה-UI והיסטוריית השיחות שלכם.
קריאה נוספת
- Self-hosted Claude Managed Agents: שירות הסוכנים של Anthropic רץ עכשיו על התשתית שלך
Anthropic פתחה את self-hosted Claude Managed Agents בבטא פרטית: אתה מארח את שירות הסוכנים, את מסד הנתונים ואת ארגזי החול, וקריאות המודל הולכות ל-Claude API או לספק שאתה בוחר. מה רץ איפה, אילו הרשאות קיימות, מה עדיין יוצא מהרשת שלך, ומה כדאי לבדוק לפני שמתחייבים.
- המדריך של Anthropic לסוכני always-on: חמישה פרימיטיבים מאחורי סוכנים שלא יושבים בחינם
Anthropic פרסמה מדריך לבניית סוכני always-on: סוכנים שומרי-מצב ופרואקטיביים שמנהלים קונטקסט בין סשנים. הרעיון המרכזי הוא שהסוכן לא באמת רץ כל הזמן - הוא ישן בין ריצות, וחמישה פרימיטיבים ארכיטקטוניים מחליטים מתי הוא מתעורר, מה הוא זוכר, ומה מגיע אליך.
- Claude Fable 5.2 ו-Mythos 5.2: דגמי השיא של Anthropic זולים יותר, מהירים ב-30%, ועם מצב מהיר פי 2.5
Anthropic שחררה את Claude Fable 5.2 ו-Mythos 5.2 ב-9 בנובמבר: אותו מודל בסיסי, $8/$40 למיליון טוקנים, מצב מהיר אופציונלי פי 2.5, ו-benchmarks שמובילים על Opus 5.5 בערך בחצי מהעלות לכל משימה. מה שוגר, מתי להשתמש, והקאצ'ים.
יומן הבנייה
לעקוב אחרי העבודה.
מאמרים ואבטיפוסים חדשים, ישר לקורא ה-RSS שלכם. מנויי המייל בהשהיה זמנית, עד שאחבר שירות משלוח עובד. לא נאסף כאן אימייל.
עקבו ב-RSS