מגבלות השימוש ב-Claude: מה עושים כשהן נגמרות?

מהן מגבלות השימוש של Claude?

מגבלות השימוש של Claude פועלות בשתי מערכות נפרדות, והצעד הראשון הוא לזהות איזו מהן עצרה אתכם. מינוי Claude מסוג Pro, Max, Team או Enterprise המבוסס על מושבים מקנה מכסת שימוש מתגלגלת המשותפת לכל המודלים, למעט כמה תקרות החלות על משפחות מודלים מסוימות, ומשותפת גם ל־Claude chat. כאשר המכסה מסתיימת, מתקבלת הודעה כגון You've hit your session limit · resets 3:45pm. תוכניות Enterprise העדכניות המבוססות על שימוש הן החריגות: אין בהן מכסה כלולה, וכל השימוש מחויב לפי תעריפי API החל מהטוקן הראשון. Claude API מודד דבר אחר: את קצב שליחת הבקשות והטוקנים, לפי דקה. כאשר חורגים מהמגבלה, מתקבלת שגיאת HTTP 429 מסוג rate_limit_error, בדרך כלל עם כותרת retry-after המציינת כמה שניות יש להמתין.

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

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

באיזו מגבלה נתקלתם? קראו את ההודעה המדויקת

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

• You've hit your session limit · resets 3:45pm היא מגבלת מינוי. המכסה המתגלגלת של התוכנית שלכם לחלון הזמן הזה נוצלה.
• You've hit your weekly limit · resets Mon 12:00am היא אותה מערכת בחלון הזמן הארוך יותר.
• You've hit your Opus limit · resets 3:45pm היא מגבלת מינוי שחלה רק על בקשות ל־Opus. מעבר למודל שאינו ממשפחת Opus יאפשר לכם להמשיך לעבוד.
• You've hit your Sonnet limit · resets 3:45pm היא אותה מגבלה של משפחת מודלים, אך היא חלה רק על בקשות ל־Sonnet. מעבר למודל שאינו ממשפחת Sonnet יאפשר לכם להמשיך לעבוד.
• הודעה שמתחילה ב־Fable limit reached פירושה שניצלתם את החלק מהמכסה השבועית שלכם שמודלי Fable רשאים לצרוך. המשך העבודה במודלי Fable מחייב שימוש בקרדיטים, ולכן Claude Code מבקש מכם לאשר זאת תחילה. בחרו מודל אחר באמצעות /model כדי להישאר במסגרת התוכנית שלכם.
• API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com. היא מגבלת קצב של API. חרגתם מהמגבלה שהוגדרה עבור מפתח ה־API שלכם, או עבור הפרויקט שלכם ב־Amazon Bedrock או ב־Google Cloud. הגורם הרלוונטי תלוי ב־אופן שבו הלקוח מבצע אימות, משום שלקוח Bedrock או Vertex נמדד מול המכסה של פרויקט הענן שלכם ולא מול ארגון Anthropic.
• API Error: Server is temporarily limiting requests (not your usage limit) היא הגבלת קצב זמנית וקצרת־טווח, שאינה קשורה למכסת התוכנית שלכם. Claude Code מנסה שוב באופן אוטומטי עם השהיה הולכת וגדלה לפני שהוא מציג לכם את השורה הזו.

מגבלות המנוי: חלון session, חלון שבועי וחלון Opus

תוכנית Pro, Max, Team או Enterprise המבוססת על seats כוללת מכסת שימוש מתחדשת. כאשר המכסה מנוצלת במלואה, Claude Code חוסם בקשות נוספות עד למועד האיפוס שמופיע בהודעה. שני מאפיינים של המכסה גורמים לרוב הבלבול.

• המכסה משותפת עם Claude chat. עבודה שאתם מבצעים ב־claude.ai מנצלת את אותה מכסה כמו עבודה בטרמינל, ולכן אחר צהריים עמוס בצ'אט מקצר את ערב הקידוד. כל ממשק שאליו אתם נכנסים באמצעות אותו חשבון משתמש באותה מכסה. לכן, ב־Linux אפליקציית desktop בגרסת beta ו־CLI של Claude Code משתמשים במכסה אחת במשותף, ולא במכסה נפרדת לכל אחד.
• המכסה משותפת בין המודלים. מגבלות ה־session והמגבלות השבועיות משתמשות במכסה אחת עבור כל המודלים. החריגים הם תקרות לפי משפחת מודלים בתוך אותה מכסה: מגבלות Opus ו־Sonnet, וכן הקצאת Fable של עד 50% מהמגבלות השבועיות בתוכניות Max וב־seats מסוג Premium. ב־seats מסוג Pro ו־Standard, Fable אינו כלול במגבלות התוכנית כלל, והחיוב מתבצע מול קרדיטי שימוש כבר מהבקשה הראשונה.

ב־Claude for Teams וב־Enterprise המבוסס על seats, המבנה המתועד הוא מכסה לכל seat שמתאפסת בחלון מתגלגל של חמש שעות ובחלון שבועי, משותפת עם Claude chat ו־Cowork, ונקבעת לפי רמת ה־seat ‏(Standard או Premium). תוכניות Enterprise הנוכחיות המבוססות על שימוש פועלות אחרת: אין בהן מכסה כלולה שאפשר לנצל, השימוש מחויב לפי תעריפי API, והתקרה היא כל מגבלת ההוצאה שהמנהלים הגדירו ברמת הארגון ולמשתמשים יחידים. בתוכנית הנתמכת על ידי צוות מכירות, שימוש שנעצר בגלל מגבלת הוצאה יתחדש בתחילת תקופת החיוב הבאה, אלא אם owner יגדיל את המגבלה קודם לכן. בתוכנית בשירות עצמי, השימוש נעצר גם כאשר יתרת הקרדיט ששולמה מראש מתרוקנת, עד ש־owner ירכוש קרדיטים נוספים. ב־Pro וב־Max, מועד האיפוס שמודפס בהודעה וה־/usage bars שלכם הם הנתונים האמינים, ולא נתון שהועתק מפוסט בבלוג. אם אתם עדיין בוחרים tier, איזו תוכנית Claude אתם צריכים משווה בין ההגבלות של כל תוכנית.

מדוע מעבר בין מודלים באמצעות /model אינו משחזר סשן או מכסה שבועית

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

החריגים הם המכסות המרביות של משפחות המודלים. אם ההודעה היא You've hit your Opus limit או You've hit your Sonnet limit, אז /model הוא התיקון הנכון. עברו למודל שאינו שייך למשפחה זו והמשיכו לעבוד, משום שרק הבקשות של אותה משפחה נחסמו. מגבלת Fable במנויי Max ו־Premium פועלת באותו אופן: עברו למודל אחר כדי להמשיך לעבוד במסגרת התוכנית, או המשיכו להשתמש ב־Fable באמצעות קרדיטי שימוש. עם זאת, Fable מנצל את המאגר השבועי המשותף מהר יותר ממודלים אחרים, ולכן מעבר לאחר הגעה למגבלת Fable לעולם לא יאפשר לעבור את המכסה השבועית הכוללת.

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

מה לעשות כאשר מגיעים למגבלת שימוש

1. קראו את מועד האיפוס. חלון של סשן קצר. חלון שבועי אינו דבר שממתינים לו ליד השולחן. ב־Claude Code v2.1.234 ואילך, /rate-limit-options יכול להמתין לאיפוס ולהמשיך אוטומטית את המשימה שנקטעה.
2. אם מדובר במגבלה של Opus, Sonnet או Fable, הריצו /model ובחרו מודל שאינו שייך למשפחה זו.
3. הריצו /usage כדי לראות את מגבלות התוכנית, את פסי השימוש ואת מועד האיפוס שלהם. /cost הוא כינוי לאותו מסך.
4. בדקו את Settings > Usage באתר claude.ai או ב־Claude Desktop, וחפשו את המקטע Resets. לעיתים מוצע לתוכניות זכאיות איפוס מגבלה ללא תשלום. לחיצה על "Reset for free" מחזירה מיד למלואה את מגבלת הסשן לחמש שעות או את המגבלה השבועית, בהתאם למגבלה שעליה חל המבצע. הכפתור אינו זמין ב־Claude Code בתוך טרמינל או IDE, או ב־Claude Mobile, וכל הצעה פגה לאחר זמן.
5. הריצו /usage-credits כדי להמשיך לעבוד מעבר לתקרה. ב־Pro וב־Max הפקודה פותחת את הגדרות החיוב שלכם. ב־Team וב־Enterprise היא פותחת את הגדרות השימוש של הארגון, או שולחת בקשה למנהלי המערכת אם אין לכם גישה לחיוב.
6. אם אתם נתקלים באותה מגבלה מדי שבוע, התוכנית אינה מתאימה להיקף העבודה שלכם. כדאי לשקול פעם אחת את הדרכים לצאת ממגבלת שימוש, במקום לעשות זאת בכל איפוס.

/usage-credits דורש מינוי ל־claude.ai עם התחברות באמצעות /login. הוא אינו זמין עם אימות באמצעות מפתח API, משום שלמפתח API אין מכסת תוכנית שאפשר להרחיב.

לקרדיטים לשימוש יש תופעת לוואי שכדאי להכיר מראש. כברירת מחדל, Claude Code מספק לשיחה הראשית מטמון prompt למשך שעה אחת בזמן שאתם נמצאים במסגרת השימוש הכלול במינוי. לאחר שמתחילים להשתמש בקרדיטים, הוא מקצר את משך המטמון לחמש דקות. כתוצאה מכך, יותר סבבים מתחילים ללא מטמון, ו־צריכת האסימונים של Claude Code עולה עבור אותה עבודה. Subagents נמצאים מחוץ למכסת השיחה הראשית, ולכן הם מקבלים חמש דקות גם במסגרת השימוש של התוכנית. הגדרה עצמאית של ה־TTL, באמצעות ההגדרה promptCacheTtl או CLAUDE_CODE_PROMPT_CACHE_TTL ב־Claude Code v2.1.242 ואילך, שומרת על משך החיים של שעה אחת גם בזמן שימוש בקרדיטים.

הודעות שנראות כמו מגבלות שימוש, אך אינן כאלה

ארבע שגיאות של Claude Code מדווחות כמגבלות שימוש, אך אף אחת מהן אינה כזאת.

• אזהרה על הקשר או על כיווץ אוטומטי אינה מגבלת שימוש. /context מדפיס שורה כגון Context exceeds the 200k-token limit by 94k tokens ולאחריה את הפקודה שמפנה מקום, לאחר שהשיחה חורגת מחלון ההקשר של המודל. הכיווץ מסכם את ההיסטוריה הישנה כדי לפנות מקום, אך הוא אינו חינמי: /compact קורא את השיחה שאותה הוא מסכם, ולכן כיווץ של הקשר גדול הוא בעצמו בקשה גדולה מול המכסה בתוכנית שלכם. כאשר אתם רוצים להתחיל מחדש במקום לשמור על רציפות, /clear אינו עולה דבר.
• Prompt is too long · automatic compaction failed: <the underlying error> פירושו שהכיווץ האוטומטי עצמו נכשל, בהתאם לשגיאה המצוינת בו. /compact ימשיך להיכשל עם אותה שגיאה עד שתפתרו אותה.
• Credit balance is too low פירושו שלארגון שלכם ב־Console אזלו הקרדיטים ששולמו מראש, או ש־Claude Code שולח את הבקשות של מנוי דרך מפתח API של Console; /status מציג איזה פרטי אימות פעילים. הוסיפו קרדיטים ב־platform.claude.com/settings/billing, שמציע גם טעינה אוטומטית.
• API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context הוא בדיקת הרשאה, ולא מכסה שהסתיימה. אם בחרתם וריאנט [1m] של Opus 4.6 או Sonnet 4.6, בחרו בווריאנט ללא הסיומת [1m], או הגדירו את CLAUDE_CODE_DISABLE_1M_CONTEXT=1. אם הודעה זו מופיעה במהלך שיחה משום שההקשר חרג מ־200K טוקנים, Claude Code מכווץ אותו בעצמו אל מתחת למגבלה הרגילה. Sonnet 5 ואילך, Opus 4.7 ואילך, Haiku 5.5 ומודלי Fable פועלים עם חלון טבעי של 1M ואינם כוללים סיומת שיש להסיר; המשתנה הזה הוא שמגביל אותם ל־200K.

שגיאה נוספת מגיעה מה־API. שגיאת 413 request_too_large היא מגבלת גודל על בקשה יחידה, ולא מגבלת קצב.

מגבלות קצב API: מה באמת נספר בתגובת 429

ה־Messages API מודד שלושה מדדים, בנפרד לכל מחלקת מודל.

• בקשות לדקה (RPM)
• טוקני קלט לדקה (ITPM)
• טוקני פלט לדקה (OTPM)

לארגון שלכם יש גם מגבלת הוצאה. זהו מדד נפרד: עלות חודשית מרבית עבור השימוש ב־API. לאחר שמגיעים לתקרת ההוצאה של השכבה, השימוש ב־API מושהה עד לחודש הבא, אלא אם מבקשים להגדיל את המגבלה. גם במקרה זה מתקבלת תגובת 429 rate_limit_error, אך ללא כותרת retry-after ועם enforced_spend_limit_reached בתוך error.details.error_code. שום לולאת ניסיון חוזר לא תפתור זאת. מגבלת הוצאה נמוכה יותר שהגדרתם בעצמכם ב־Console מופיעה באופן שונה: הבקשות מחזירות HTTP 400 invalid_request_error עם הודעה שמתחילה ב־You have reached your specified API usage limits, והגדלה או הסרה של המגבלה מחזירה את הגישה.

ארבעה מנגנונים קובעים מתי מתקבלת תגובת 429.

• המגבלות חלות על מחלקת המודל. הן נאכפות בנפרד לכל מודל, ולכן אפשר להשתמש בו־זמנית במודלים שונים עד למגבלה של כל אחד מהם. משפחות מסוימות חולקות מכסה: מגבלת הקצב של Opus היא סך הכול עבור Claude Opus 4.8, Opus 4.7, Opus 4.6 ו־Opus 4.5, ואילו ל־Claude Sonnet 5 יש מכסה משלו.
• הקיבולת מתמלאת מחדש ברציפות. ה־API משתמש באלגוריתם token bucket, ולכן הקיבולת מתחדשת ברציפות במקום להתאפס ברגע קבוע. מגבלה של 60 בקשות לדקה עשויה להיאכף כבקשה אחת בשנייה, ולכן גם 60 בקשות שנשלחות בבת אחת עדיין ייכשלו.
• ברוב המודלים רק קלט שאינו שמור במטמון נספר עבור ITPM. input_tokens ו־cache_creation_input_tokens נספרים. cache_read_input_tokens אינו נספר ברוב מודלי Claude, כאשר Claude Haiku 3.5 הוא החריג המתועד. לכן שמירה במטמון מספקת מרווח נוסף מול מגבלת הקצב, בנוסף להנחה בעלות. בצד הפלט, ערך max_tokens גבוה אינו נספר מול OTPM, משום ש־OTPM סופר רק את הטוקנים שהופקו בפועל.
• המגבלות חלות ברמת הארגון. אפשר להקצות ל־workspace מגבלה נמוכה יותר, ומגבלות ברמת הארגון חלות תמיד גם אם סכום מגבלות ה־workspace גבוה יותר. מגבלה שלא שונתה עבור workspace יורשת את ערכה מהארגון ואינה נחשבת ללא הגבלה.

השכבות Start, Build, Scale ו־Custom קובעות את הערכים בפועל. השכבה מוקצית אוטומטית לפי היסטוריית השימוש ומצב החשבון. ארגונים חדשים וארגונים עם היסטוריית שימוש מצומצמת עשויים להתחיל בשכבת Evaluation, שמתחת למגבלות הסטנדרטיות שפורסמו. לכן תגובת 429 הראשונה עשויה להגיע מוקדם יותר מהצפוי לפי הטבלה. עלייה חדה בשימוש מפעילה מגבלות האצה, שמחזירות 429 גם כאשר אתם עדיין בתוך המגבלה של השכבה. לכן יש להגדיל את התעבורה בהדרגה. כל נתון שפורסם הוא תקרה: המגבלות המתועדות הן שימוש מרבי מותר, ולא מינימום מובטח. כדי לבקש הגדלה, השתמשו באפשרות "Request tier increase" בדף Rate limits בתוך Claude Console.

פענוח שגיאת 429: retry-after, הכותרות וניסיונות החזרה ב־SDK

כל שגיאת API מחזירה אותה מעטפת: אובייקט error מקונן שמכיל את הסוג ואת ההודעה, וכן request_id ברמה העליונה.

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "<names the rate limit you exceeded>"
  },
  "request_id": "req_011CSHoEeqs5C35K2UUqR7Fy"
}

הכותרות מכילות את שאר המידע.

• retry-after הוא מספר השניות שיש להמתין עד שניתן לנסות שוב את הבקשה. ניסיונות מוקדמים יותר ייכשלו. לא כל שגיאת 429 כוללת אותו, ושגיאת 429 מסוג spend-cap אף פעם אינה כוללת אותו.
• anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining ו־anthropic-ratelimit-requests-reset מתארים את מכסת הבקשות שלכם.
• anthropic-ratelimit-input-tokens-* ו־anthropic-ratelimit-output-tokens-* עושים זאת עבור ITPM ו־OTPM, עם אותן סיומות של limit, remaining ו־reset.
• anthropic-ratelimit-tokens-* מציג את הערכים של המכסה המגבילה ביותר שתקפה כרגע.

כותרות reset הן חותמות זמן בפורמט RFC 3339. כותרות remaining של טוקנים מעוגלות לאלף הקרוב ביותר, ולכן יש לקרוא אותן כמדד. ל־Fast mode יש מאגר משלו וכותרות anthropic-fast-* משלו. קראו את כולן מכל קריאה מוצלחת:

curl -s -D - -o /dev/null https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}' \
  | grep -i 'ratelimit\|retry-after\|request-id'

כל תגובה כוללת גם כותרת request-id ייחודית, כגון req_018EeWyXxfu5pfWkrYcMdjWG. בגופי שגיאה היא מופיעה כ־request_id, ובתגובות של SDK עבור Python ו־TypeScript היא מופיעה כ־_request_id. ציינו אותה כאשר אתם פונים לתמיכה.

בדקו אם אתם זקוקים בכלל ללולאת backoff לפני שאתם כותבים אחת. ה־SDK הרשמיים מנסים שוב באופן אוטומטי לאחר כשלים זמניים, כולל שגיאות חיבור, מגבלות קצב ושגיאות שרת מסוג 5xx, עם backoff מעריכי, פעמיים כברירת מחדל, ומכבדים את כותרת retry-after כאשר היא קיימת. כל לקוח מקבל אפשרות maximum-retries לשינוי ההתנהגות הזו או לביטולה.

import anthropic

client = anthropic.Anthropic(max_retries=5)  # the SDK default is 2

try:
    msg = client.messages.create(
        model="claude-sonnet-5",
        max_tokens=1024,
        messages=[{"role": "user", "content": "hello"}],
    )
except anthropic.RateLimitError as err:
    headers = err.response.headers
    print("still limited after retries; wait", headers.get("retry-after"), "seconds")
    print("request id:", headers.get("request-id"))

529 שגיאת עומס אינה באשמתך

שגיאת 429 מציינת שביצעת פעולות מהר מדי. שגיאת 529 overloaded_error מציינת שה-API עמוס באופן זמני, והיא עלולה להתרחש כאשר ה-API חווה עומס תעבורה גבוה מצד כלל המשתמשים. שום דבר במפתח ה-API שלך או בקוד שלך לא גרם לכך. בצע ניסיון חוזר עם exponential backoff, פעולה שה-SDKs כבר מבצעים עבור תגובות מסוג 5xx, ובדוק את status.claude.com אם המצב אינו מסתדר. שגיאת 500 api_error היא שגיאה פנימית שעבורה יש לבצע ניסיון חוזר באותו אופן, ואף אחת מהן אינה מהווה מגבלת קצב (rate limit).

קריאת המגבלות שלכם במקום הסתמכות על טבלה

במינוי, /usage הוא המסך החשוב. הוא מציג את פסי השימוש של התוכנית שלכם ואת פירוט המשאבים שצרכו אותם, ו־d או w מאפשרים לעבור בין 24 השעות האחרונות לבין 7 הימים האחרונים. יש שתי הסתייגויות. המקטע Session מציג שימוש באסימוני API ומיועד למשתמשי API, לכן מנויים יכולים להתעלם מהסכום בדולרים שמופיע בו. הנתונים נלקחים מהיסטוריית הפעלות המקומית במחשב הזה, ולכן שימוש ממכשיר אחר או מ־claude.ai אינו נכלל.

בצד ה־API, הדף Usage ב־Claude Console מציג שני תרשימים: "Rate Limit - Input Tokens" ו־"Rate Limit - Output Tokens". תרשים הקלט מציג את המקסימום השעתי של אסימוני קלט שאינם נמצאים במטמון לדקה, בהשוואה למגבלת ה־ITPM הנוכחית שלכם, ולצדו את שיעור הפגיעות במטמון. כך אפשר לעקוב אחר התקרבות למגבלה, במקום לגלות את החריגה בסביבת הייצור.

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

curl -s https://api.anthropic.com/v1/organizations/rate_limits \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

נדרשות הרשאות Admin API: מפתח Admin API, אסימון OAuth עם ההיקף org:admin, או מפתח אישי או מפתח של חשבון שירות שאינו מוגבל ל־workspace. מפתחות API של workspace אינם פועלים. GET /v1/organizations/workspaces/{workspace_id}/rate_limits מבצע את אותה פעולה עבור workspace יחיד. שתי הפעולות הן לקריאה בלבד. כדי לשנות מגבלה, השתמשו בדף Rate limits ב־Console.

שימוש מופחת ב־less כדי לעמוד במגבלות במספר קטן יותר

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

• השתמשו בפחות טוקנים בכל סבב. רצפים רציפים שומרים את המטמון חם, ו־/clear בין משימות שאינן קשורות אינו עולה דבר. שימוש בטוקנים של Claude Code מכסה את המנגנונים האלה במלואם.
• הפחיתו את רמת המאמץ. הרמות הן low, medium, high, xhigh ו־max. התפריט /effort מציע גם ultracode, שמגדיל את הצריכה במקום להפחית אותה. הסקת מסקנות מעמיקה עבור שינוי שם מכני אינה מועילה.
• הפחיתו את המקביליות לאחר שגיאת 429. הורידו את CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY והימנעו מהפעלת subagents רבים במקביל. הפעילו גם את /status: ערך ANTHROPIC_API_KEY שנשאר בטעות מנתב בקשות דרך מפתח ברמה נמוכה במקום דרך המינוי שלכם.
• העבירו עבודה שאינה אינטראקטיבית ל־Message Batches API. הוא מעבד כמויות גדולות באופן אסינכרוני, בהנחה של 50% על טוקני הקלט והפלט, ובכפוף למגבלות קצב נפרדות. כך משימת לילה אינה מתחרה בסשן שלכם.

הקושי הזה מורגש במיוחד בעבודה שמזרימה נתונים להקשר: אם אתם מנתחים מניות ואופציות מול נתוני שוק חיים, שליפת התת־קבוצה המצומצמת הדרושה לכל שאלה עולה חלקיק מהעלות של הדבקת טבלאות מלאות של ציטוטים ושרשראות אופציות. עבודה מתפרצת שמופעלת על ידי תוכנית ולא על ידי אדם מתאימה מלכתחילה למפתח API. המעבר משנה גם את אופן התשלום וגם את אופן המדידה, משום של־Claude API אין שכבת שימוש חינמית. תוכניות Max ו־Team כוללות קרדיטי API חודשיים להפעלת יישומים ו־agents משלכם לאחר קישור ארגון Console. קרדיטים אלה אינם מכסים את Claude Code ואינם משנים את מגבלות השימוש של התוכנית שלכם. היישום הראשון שלכם ב־Claude API על VPS מסביר כיצד לטפל במפתחות ובניסיונות חוזרים, והרצה ארוכה של agent ממשיכה לפעול גם לאחר ניתוק חיבור כאשר אתם משאירים את Claude Code פועל על VPS בתוך tmux.

FAQ

מדוע מעבר בין מודלים אינו פותר את מגבלת השימוש שלי ב־Claude?

משום שמגבלות הפעלה ומגבלות שבועיות משותפות לכל המודלים. המכסה שייכת לתוכנית, לא למודל, ולכן /model משנה באיזה מודל תיענה הבקשה, אך לא כמה מכסה נשארה. החריגים הם המגבלות לפי משפחת מודלים: You've hit your Opus limit ו־You've hit your Sonnet limit חלות רק על אותה משפחה, ומגבלת Fable במנויי Max ו־Premium מגבילה את Fable בלבד. במקרים אלה, מעבר למודל אחר הוא הפתרון המתועד.

מה המשמעות של השגיאה 429 rate_limit_error, וכמה זמן צריך להמתין?

המשמעות היא שהחשבון הגיע למגבלת קצב עבור סוג המודל הזה: מספר בקשות בדקה, מספר אסימוני קלט בדקה או מספר אסימוני פלט בדקה. התגובה כוללת בדרך כלל כותרת retry-after עם מספר השניות שיש להמתין, וניסיונות חוזרים מוקדמים ייכשלו. ערכות ה־SDK הרשמיות מנסות שוב באופן אוטומטי לאחר מגבלות קצב ושגיאות 5xx, עם השהיה מעריכית, פעמיים כברירת מחדל, ותוך כיבוד הכותרת כאשר היא קיימת. שגיאת 429 שמתקבלת בזמן שאתם עדיין נמצאים בתוך המגבלות של הרמה שלכם מצביעה על מגבלת האצה שנגרמה מעלייה חדה בקצב. שגיאת 429 עם enforced_spend_limit_reached בתוך error.details.error_code, שאינה כוללת לעולם כותרת retry-after, היא מגבלת ההוצאה החודשית, והמתנה של כמה דקות לא תסיר אותה.

כיצד אפשר לראות את מגבלות השימוש שלי ב־Claude ומתי הן מתאפסות?

ב־Claude Code, הריצו /usage כדי לראות את מכסות התוכנית, את זמני האיפוס ופירוט השימוש; /cost הוא כינוי חלופי, ו־d או w מחליף בין 24 השעות האחרונות לבין 7 הימים האחרונים. הנתונים האלה מגיעים מהיסטוריית ההפעלות המקומית, ולכן אינם כוללים שימוש ממכשירים אחרים או מ־claude.ai. ב־API, ה־Console מציג את מגבלות הקצב שלכם, ו־GET /v1/organizations/rate_limits מחזיר את המגבלות שהוגדרו עבורכם באמצעות פרטי גישה של Admin API, כגון מפתח Admin API.

האם אפשר להמשיך לעבוד לאחר הגעה למגבלת התוכנית שלי ב־Claude?

לפעמים. הריצו /usage-credits כדי לרכוש שימוש מעבר למכסה ב־Pro וב־Max, או כדי לבקש שימוש כזה ממנהל מערכת ב־Team וב־Enterprise; נדרשת התחברות ל־claude.ai באמצעות /login, והאפשרות אינה זמינה בעת אימות באמצעות מפתח API. אחרת, המתינו למועד האיפוס, השתמשו באיפוס מכסה ללא תשלום אם Settings > Usage ב־claude.ai או ב־Claude Desktop מציע אפשרות כזאת, עברו למודל אחר אם זו הייתה המגבלה של Opus, Sonnet או Fable, או העבירו את העבודה למפתח API, שבו המדידה מתבצעת לפי דקה ולא לפי חלון זמן.