מדריך מיגרציה ל-Claude Sonnet 5: מה לתקן בקוד לפני ספטמבר

אנת'רופיק הפכה את Claude Sonnet 5 לברירת המחדל בכל תוכניות Claude ב-30 ביוני 2026, עם תמחור היכרות מפתה של 2 דולר למיליון טוקנים בקלט ו-10 דולר בפלט. אבל מי שינסה להצביע על המודל החדש בקוד קיים עלול לחטוף שגיאות 400 בפרודקשן: קריאות שמגדירות temperature או top_p לערך שאינו ברירת המחדל פשוט נדחות. הנה מדריך מעשי לעדכון הקוד לפני שהתמחור קופץ ל-3/15 דולר ב-1 בספטמבר.

01מה השתנה: התמחור, המזהה והדדליין האמיתי

Sonnet 5 זמין תחת מזהה ה-API claude-sonnet-5 בכל התוכניות, כולל Claude Code, ומשמש כברירת המחדל למשתמשי Free ו-Pro. תמחור ההיכרות של 2 דולר למיליון טוקנים בקלט ו-10 דולר בפלט תקף עד 31 באוגוסט 2026, ואחריו נכנס לתוקף תמחור סטנדרטי של 3 דולר בקלט ו-15 דולר בפלט. במילים אחרות: חודש וחצי של הנחה של כשליש על מודל שממילא צפוי להחליף את Sonnet 4.6 אצל רוב הצוותים.

חשוב לדייק: אין כאן דדליין כפוי. Sonnet 4.6 נשאר פעיל, עם פרישה משוערת לא לפני 17 בפברואר 2027. הלחץ היחיד הוא כלכלי, ולצוות ישראלי שמריץ עומסי LLM משמעותיים זה לחץ אמיתי: מיגרציה שמסתיימת באוגוסט נהנית מהמחיר המוזל, ומי שמתעכב משלם את המחיר המלא מיום ראשון.

02המוקש הראשון: temperature ו-top_p נחסמים

השינוי השובר המרכזי: ב-Sonnet 5, הגדרת temperature, top_p או top_k לערך שאינו ברירת המחדל מחזירה שגיאת 400. הפרמטרים לא נעלמו מה-API לגמרי, אבל בפועל כל ערך מותאם אישית ייחסם. זו מגבלה שאנת'רופיק הציגה לראשונה ב-Opus 4.7 וכעת מגיעה למשפחת Sonnet. ההמלצה הרשמית: להסיר את הפרמטרים מהקריאות, ולהעביר את השליטה בסגנון הפלט להנחיות ב-system prompt.

בפועל זה אומר לעבור על כל נקודה בקוד שבונה בקשה ל-Messages API. קריאה טיפוסית שצריך לתקן נראית כך:

# לפני (Sonnet 4.6) - יחזיר 400 ב-Sonnet 5
response = client.messages.create(
    model="claude-sonnet-5",
    temperature=0.3,
    top_p=0.9,
    max_tokens=2048,
    messages=messages,
)

# אחרי - מסירים פרמטרי דגימה, מנחים ב-system prompt
response = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=2048,
    system="Answer concisely and deterministically. Avoid creative variation.",
    messages=messages,
)

03המוקש השני: extended thinking הופך ל-adaptive thinking

שינוי שובר נוסף שפחות מדובר: מנגנון ה-extended thinking הידני, זה שהוגדר עם thinking מסוג enabled ותקציב budget_tokens, הוסר ומחזיר שגיאת 400. במקומו מגיע adaptive thinking עם פרמטר effort, שמקבל אחת מחמש רמות: low, medium, high, xhigh או max, כאשר ברירת המחדל היא high. המודל מחליט בעצמו כמה לחשוב בתוך התקציב שהרמה מגדירה, במקום שתנהלו טוקנים ידנית.

# לפני - יחזיר 400 ב-Sonnet 5
thinking={"type": "enabled", "budget_tokens": 8000}

# אחרי - adaptive thinking עם רמת effort
thinking={"type": "adaptive", "effort": "high"}

ההיגיון בהמרה: תקציבים קטנים שהגדרתם בעבר מתאימים בדרך כלל ל-low או medium, עומסי ברירת מחדל נשארים על high, ומשימות reasoning כבדות במיוחד עוברות ל-xhigh או max. שווה למדוד את איכות התוצאות ואת העלות בכל רמה לפני שקובעים סטנדרט צוותי.

04העלות הנסתרת: טוקנייזר חדש שמנפח ספירות ב-30%

גם אחרי שהקוד מתקמפל ורץ, מחכה הפתעה בחשבונית: Sonnet 5 משתמש בטוקנייזר חדש שמפיק כ-30 אחוז יותר טוקנים עבור אותו טקסט בהשוואה ל-Sonnet 4.6. המשמעות כפולה. ראשית, אל תשתמשו שוב בספירות טוקנים שנשמרו ממודלים קודמים, בין אם במטמון, בחישובי תקציב או במנגנוני chunking. שנית, מגבלות max_tokens שכוונו בקפידה ל-4.6 עלולות פתאום לקטוע פלט באמצע משפט.

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

05צ'ק-ליסט מיגרציה למפתח הישראלי

כך נראית מיגרציה מסודרת, צעד אחר צעד:

1. עדכנו את מזהה המודל ל-claude-sonnet-5 בסביבת staging בלבד, לא ישר בפרודקשן.
2. הסירו כל הגדרה של temperature, top_p ו-top_k מהקריאות, מהקונפיגורציה ומשכבות התיווך, והעבירו הנחיות סגנון ל-system prompt.
3. החליפו כל שימוש ב-extended thinking ידני ב-adaptive thinking עם רמת effort מתאימה (ברירת מחדל: high).
4. מדדו מחדש ספירות טוקנים על דגימה מייצגת של הפרומפטים שלכם, והעלו את ערכי max_tokens בהתאם לניפוח של כ-30 אחוז.
5. אם אתם עובדים עם Claude Code, הריצו את הפקודה /claude-api migrate שמפעילה skill רשמי לביצוע תיקוני המיגרציה בקוד באופן אוטומטי.
6. הריצו סוויטת רגרסיה על התוצרים, השוו איכות ועלות מול Sonnet 4.6, ורק אז דחפו לפרודקשן.

06מה הלאה: חלון של חודש וחצי

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