📘 תיעוד 61

הפניה לשגיאות

חפשו הודעות שגיאת זמן ריצה של Claude Code, מה כל אחת אומרת ואיך לתקן אותה.

הדף הזה מפרט שגיאות זמן ריצה ש-Claude Code מציג ואיך להתאושש מכל אחת, וגם מה לבדוק כשתשובות נראות לא תקינות בלי שגיאה. לשגיאות התקנה כמו command not found או כשלי TLS במהלך ההגדרה, ראו פתרון בעיות התקנה והתחברות.

מלבד שגיאות מעטפת ו-IDE, שהתוכנית המפעילה מדפיסה ולא Claude Code עצמו, השגיאות האלה ופקודות ההתאוששות חלות על ה-CLI, על אפליקציית שולחן העבודה, ועל הפעלות ענן, כי שלושתן עוטפות את אותו CLI של Claude Code. לבעיות אחרות שספציפיות למשטח, ראו את מקטע פתרון הבעיות בדף של אותו משטח.

[!NOTE]

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

#מצאו את השגיאה שלכם

התאימו את ההודעה שאתם רואים למקטע למטה.

#ניסיונות חוזרים אוטומטיים

Claude Code מנסה שוב כשלים חולפים עד 10 פעמים עם exponential backoff לפני שהוא מציג שגיאה. הוא לא תמיד מנסה שוב כשל שמגיע באמצע התשובה של Claude. כשרואים אחת מהשגיאות בדף הזה, Claude Code כבר ביצע את כל הניסיונות החוזרים שחלים על הכשל הזה.

Claude Code מנסה שוב את הכשלים האלה:

• שגיאות שרת, תשובות של עומס יתר, ופקיעות זמן של בקשות שמגיעות לפני שחלק כלשהו מהתשובה של Claude זרם.
• שגיאת שרת או תשובת עומס יתר שמגיעה אחרי ש-Claude סיים לחשוב אבל לפני שהתחיל טקסט או קריאת כלי כלשהי. Claude Code מנסה שוב שגיאת שרת בנקודה הזו עד פעמיים. לפני v2.1.284, Claude Code סיים את הסבב עם השגיאה בנקודה הזו.
• חיבורים שנפלו. כשחיבור נופל באמצע בקשה לפני ש-Claude השלים חלק כלשהו מהתשובה שלו, כולל החשיבה שלו, Claude Code שולח את הבקשה מחדש עם אותו backoff והסבב ממשיך, גם אם טקסט כלשהו כבר התחיל לזרום. כשהוא נופל אחרי ש-Claude סיים לחשוב אבל לפני שהתחיל טקסט או קריאת כלי כלשהי, Claude Code שולח במקום זאת את הבקשה מחדש עד פעמיים ברצף מהיר, ומסיים את הסבב עם Connection lost before a response was produced אם החיבור ממשיך ליפול בנקודה הזו.
• חיבור ש-Claude Code מזהה שנשבר כי המחשב עבר למצב שינה באמצע בקשה. Claude Code סופר אותו כחיבור שנפל לפי הכללים שלמעלה. ברגע שתווית הניסיון החוזר מציינת את הסיבה המסוימת, היא נקראת Connection lost while your computer was asleep, ואם הסבב מסתיים אחרי ש-Claude סיים לחשוב אבל לפני טקסט או קריאת כלי כלשהי, ההודעה נקראת Your computer went to sleep before a response was produced.
• זרם תשובה שנתקע, כשכותרות התשובה הגיעו אבל אף חלק מהתשובה של Claude לא הגיע, או כש-Claude סיים לחשוב אבל לא התחיל טקסט או קריאת כלי כלשהי: Claude Code מפסיק את החיבור התקוע ומזרים את הבקשה שוב לכל היותר פעם אחת. אם התשובה נתקעת פעם שנייה אחרי ש-Claude סיים לחשוב אבל לפני טקסט או קריאת כלי כלשהי, Claude Code מסיים את הסבב עם The response stalled before a response was produced.
• בקשת streaming שה-API לא עונה לה עם כותרות תשובה, בחיבור שבו דדליין הבייט הראשון רץ. בדדליין, Claude Code מפסיק את הבקשה ושולח אותה מחדש בתוך תקציב הניסיונות החוזרים. אם הדדליין מופעל גם לשליחה מחדש, הסבב מסתיים עם No response from API. כשמגדירים CLAUDE_CODE_RETRY_WATCHDOG, Claude Code ממשיך לשלוח מחדש בתוך התקציב.
• תשובת streaming שמסנן תוכן הפלט של ה-API עוצר לפני ש-Claude סיים לחשוב או התחיל טקסט או קריאת כלי כלשהי. Claude Code שולח את הבקשה מחדש פעם אחת, בתוך תקציב הניסיונות החוזרים, ומציג Output blocked by content filtering policy אם המסנן עוצר גם את התשובה השנייה.
• הגבלות קצב 429 זמניות, אבל לא 429 של מגבלת הוצאה של שער, שאינה הגבלת קצב. ראו Spend limit reached.
  • כשמחוברים עם מנוי claude.ai, זה כולל הגבלות קצב 429 שלא נושאות את כותרות המכסה של התוכנית. לפני v2.1.199, Claude Code ניסה שוב את ההגבלות האלה רק לכניסות עם מפתח API ו-Enterprise.
• בקשה שנדחתה כי הקלט יחד עם max_tokens חורג ממגבלת ההקשר. שליחה מחדש ללא שינוי הייתה נכשלת באותו אופן, ולכן Claude Code מנסה שוב עם max_tokens מוקטן, ומפסיק לנסות שוב ודוחס בשני מקרים:
  • כשאף הקטנה לא יכולה להתאים, למשל כשהשיחה עצמה כמעט ממלאת את חלון ההקשר.
  • כשניסיון חוזר לא יכול לכווץ את max_tokens עוד. לפני v2.1.218, Claude Code יכול היה לשלוח מחדש בקשה מוקטנת שעדיין לא התאימה, למשל כשתקציב החשיבה המורחבת חרג מההקשר שנותר, עד שתקציב הניסיונות החוזרים אזל.
• תשובה שאומרת ש-Claude קורא לכלי אבל לא מכילה קריאת כלי. Claude Code מנסה שוב על ידי בקשה מ-Claude לקריאת הכלי, עד פעמיים. אם שני הניסיונות החוזרים נכשלים באותו אופן, רואים The model's tool call could not be parsed (retry also failed). והסבב מסתיים. כדי לנסות שוב, שלחו הודעה נוספת. לפני v2.1.307, Claude Code ניסה פעם אחת לפני סיום הסבב.
• אישור Google Cloud שפג תוקפו או חסר ב-Google Cloud's Agent Platform, או אישורי AWS שנכשלים בטעינה במכונה. Claude Code משליך את האישורים השמורים במטמון ומנסה שוב עד פעמיים, ואז מדווח על השגיאה כדי שאפשר לאמת מחדש מיד, כמתואר תחת Could not load AWS or Google Cloud credentials. לפני v2.1.228, Claude Code ניסה שוב אישור Google Cloud שנכשל דרך כל תקציב הניסיונות החוזרים לפני הצגת השגיאה.
• 401 או 403 מ-Anthropic API, ישירות או דרך LLM gateway, בזמן שסקריפט apiKeyHelper מספק את האישור. Claude Code מריץ את הסקריפט מחדש ומנסה שוב עם הפלט הטרי שלו, בתוך כל תקציב הניסיונות החוזרים. כשהסקריפט עצמו נכשל בהרצה מחדש, Claude Code מציג Your apiKeyHelper script is failing.

לפני v2.1.227, Connection lost before a response was produced נקרא Connection closed while thinking, before producing a response ו-The response stalled before a response was produced נקרא Response stalled while thinking, before producing a response.

Claude Code לא מנסה שוב את הכשלים האלה:

• כשל באימות אישור TLS, כמו פרוקסי שבודק TLS, חבילת NODE_EXTRA_CA_CERTS חסרה, או אישור שפג תוקפו. Claude Code מדווח על השגיאה בניסיון הראשון, כדי שאפשר לתקן את הגדרת האישור מיד. ראו SSL certificate errors. Claude Code עדיין מנסה שוב מצבי TLS חולפים כמו פקיעת זמן של לחיצת יד. לפני v2.1.199, Claude Code ניסה שוב כשלי אישורים דרך כל תקציב הניסיונות החוזרים לפני הצגת השגיאה.
• שגיאת שרת, חיבור שנפל, או זרם שנתקע שמגיע אחרי ש-Claude השלים בלוק טקסט או קריאת כלי, או התחיל אחד אחרי שסיים את החשיבה, אבל לפני שסיים את התשובה. Claude Code לא מריץ את הבקשה מחדש, כי זה עלול להריץ את אותן קריאות כלי פעמיים. הוא שומר את מה ש-Claude השלים, מריץ כל קריאות כלי ש-Claude סיים, וממשיך את הסבב מהתוצאות שלהן. למה שרואים בסשן אינטראקטיבי ובסשן לא אינטראקטיבי, קראו The response above may be incomplete. לפני v2.1.199, Claude Code השליך את הפלט החלקי ודיווח על כל הסבב כשגיאה כששגיאת שרת הגיעה באמצע הזרם.
• כשל שמגיע אחרי ש-Claude סיים את התשובה: אין מה לנסות שוב, ולכן Claude Code שומר את התשובה המלאה ומסיים את הסבב כרגיל.
• תשובת streaming של Amazon Bedrock עם content-type לא צפוי, כי השער או הפרוקסי שמשכתב את התשובה היה משכתב את הניסיון החוזר באותו אופן. דורש Claude Code v2.1.208 או מאוחר יותר.
• ניסיון חוזר שאינו streaming של בקשת streaming שנכשלה שמקבל סטטוס הצלחה אבל אין הודעת Claude API בגוף. Claude Code מסיים את הסבב עם השגיאה הזו.
• בקשה שבדיקת המדיניות של הארגון דחתה, שמופיעה כשורת API Error: שנושאת את הודעת הדחייה. מנהלי הארגון מגדירים את הבדיקה עם Inference hooks, תכונה של Claude Enterprise, וההודעה מסתיימת בהוראות שהם הגדירו, או כברירת מחדל אומרת ליצור איתם קשר. Claude Code לא שולח מחדש את הבקשה שנדחתה לאותו מודל או ל-מודל גיבוי, כי הדחייה היא על תוכן הבקשה ולא על המודל. לפני v2.1.239, Claude Code יכול היה לשלוח מחדש בקשה שנדחתה, בלי streaming או על מודל גיבוי מוגדר, לפני הצגת הדחייה.

#מה רואים בזמן ש-Claude Code מנסה שוב או ממתין

בזמן ניסיון חוזר, הספינר מציג ספירה לאחור Retrying in Ns · attempt x/y אחרי תווית שגיאה. התווית מציינת את הסיבה המסוימת מהניסיון הראשון לכשלים שאפשר לטפל בהם מיד: הרשת למטה, לחיצת יד TLS נכשלה, או פגעתם במגבלת קצב. לשגיאות אחרות היא נקראת API error בהתחלה. החל מ-v2.1.198 היא עוברת לסיבה המסוימת מהניסיון השלישי, או בניסיון האחרון כש-CLAUDE_CODE_MAX_RETRIES מאפשר פחות משלושה. גרסאות קודמות עוברות רק בניסיון האחרון.

החל מ-v2.1.198, טיפ הספינר הרגיל מוסתר בזמן ניסיונות חוזרים. ברגע שסיבת השגיאה נחשפת, אם הכשל הוא עומס יתר 529 השורה מתחת לספירה לאחור גם מציינת איפה לבדוק את סטטוס השירות: status.claude.com ב-Anthropic API, או מארח הספק או השער שמופיע בהודעה בתצורות אחרות.

#המתנה לתשובת API

הבאנר Waiting for API response · will retry in … · check your network אומר ש-Claude Code המתין לפחות 20 שניות בלי לקבל נתונים כלשהם לבקשה. הבקשה עדיין לא נכשלה: הספירה לאחור רצה עד הנקודה שבה Claude Code מפסיק את החיבור התקוע. אם ההפסקה מתרחשת:

• לפני ש-Claude השלים בלוק טקסט או קריאת כלי, או התחיל אחד אחרי שסיים את החשיבה, Claude Code מנסה שוב את הבקשה או מסיים את הסבב עם שגיאה. ניסיונות חוזרים אוטומטיים אומר אילו תקיעות הוא מנסה שוב וכמה פעמים.
• אחרי ש-Claude השלים בלוק טקסט או קריאת כלי, או התחיל אחד אחרי שסיים את החשיבה, אבל לפני ש-Claude סיים את התשובה, Claude Code שומר את מה ש-Claude השלים, ממשיך את הסבב מקריאות כלי ש-Claude סיים, ומציג The response above may be incomplete. בסשן לא אינטראקטיבי, ולתשובה של subagent בכל סשן, Claude Code עשוי קודם לבקש מ-Claude להמשיך את התשובה. הערך הזה אומר מתי הוא עושה זאת ומתי עדיין רואים את ההודעה שם.
• אחרי ש-Claude סיים את התשובה, Claude Code מסיים את הסבב כרגיל.

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

#באנר ההמתנה מופיע ונעלם מאחורי שער

אם הבאנר Waiting for API response מופיע ונעלם בזמן ש-Claude חושב ואתם מתחברים דרך שער, עדכנו את Claude Code ל-v2.1.309 או מאוחר יותר. הבאנר מופיע אחרי 45 שניות בלי נתונים בחיבורים האלה:

• ANTHROPIC_BASE_URL מוגדר למארח שאינו Anthropic API, כמו LLM gateway
• סשן של Claude apps gateway
• Claude Platform on AWS עם ANTHROPIC_AWS_BASE_URL מוגדר

לפני v2.1.309, הבאנר הופיע אחרי 20 שניות בחיבורים האלה.

#כוונון התנהגות הניסיונות החוזרים

אפשר לכוונן את התנהגות הניסיונות החוזרים עם משתני הסביבה האלה:

#שגיאות שרת

רוב השגיאות האלה מגיעות מספק ההסקה: השירות של Anthropic ב-Anthropic API, והשירות שמאחורי נקודת הקצה של הספק הזה ב-Amazon Bedrock, ב-Google Cloud's Agent Platform, ב-Microsoft Foundry, או בשער מותאם. Auto mode cannot determine the safety of an action ו-Agent terminated early due to an API error מכסים גם סיבות בצד שלכם, כמו חשבון Amazon Bedrock שלא יכול להפעיל את מודל המסווג או subagent שפגע במגבלת שימוש.

#שגיאת API: 500 Internal server error

Claude Code מציג את קוד הסטטוס ואת הודעת השגיאה של ה-API לכל תגובת 5xx. הדוגמה למטה מציגה תגובת 500 ב-API של Anthropic:

API Error: 500 Internal server error. This is a server-side issue, usually temporary , try again in a moment. If it persists, check https://status.claude.com.

המשפט הסוגר מציין איפה לבדוק את תקינות השירות, והוא משתנה לפי הספק. תצורות של Amazon Bedrock, Google Cloud's Agent Platform ו-Microsoft Foundry מציינות את סטטוס השירות של אותו ספק. ANTHROPIC_BASE_URL מותאם אישית מציין את מארח השער.

5xx מה-API עצמו מציין כשל בלתי צפוי בתוך ה-API. הוא לא נגרם מההנחיה, מההגדרות או מהחשבון שלך.

כשפרוקסי, מאזן עומסים או שער עונים בדף שגיאת HTML, ההודעה מציגה את קוד הסטטוס ואת כותרת הדף, לדוגמה API Error: 502 Bad Gateway. בדף בלי כותרת, ההודעה מציגה במקום זאת את קוד הסטטוס ואת שמו התקני. לפני v2.1.281, קוד הסטטוס הושמט כשלדף הייתה כותרת, והסימון הגולמי של הדף הודפס כשלא הייתה לו כותרת.

מה לעשות:

• בדוק ב-status.claude.com, או בדף סטטוס הספק שמופיע בהודעה, אם יש תקריות פעילות
• המתן דקה, ואז שלח את ההודעה שוב. ההודעה המקורית עדיין בשיחה, ולכן בהנחיה ארוכה אפשר להקליד try again במקום להדביק את כולה.
• אם ANTHROPIC_BASE_URL מצביע על שער LLM וכל בקשה נכשלת כך, בדוק שהשער וה-upstream שלו מקבלים שדות tool search. כברירת מחדל, Claude Code שולח שדות כלי defer_loading ובלוקי tool_reference, עם כותרת anthropic-beta שמפעילה אותם. לפני v2.1.304, tool search היה כבוי מאחורי שער, אלא אם הפעלת אותו עם ENABLE_TOOL_SEARCH.
• אם השגיאה נמשכת ואין תקרית שפורסמה, הרץ /feedback כדי ש-Anthropic תוכל לחקור עם פרטי הבקשה שלך. ראה דיווח על שגיאה אם /feedback לא זמין בסביבה שלך.

#שגיאת API: Repeated 529 Overloaded errors

ה-API נמצא זמנית בקיבולת מלאה אצל כל המשתמשים. Claude Code כבר ניסה שוב כמה פעמים לפני הצגת ההודעה הזו:

API Error: Repeated 529 Overloaded errors. The API is at capacity , this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

המשפט הסוגר משתנה לפי הספק באותו אופן כמו בשגיאת 500 למעלה.

529 אינו מגבלת השימוש שלך ואינו נספר במכסה שלך.

מה לעשות:

• בדוק ב-status.claude.com, או בדף סטטוס הספק שמופיע בהודעה, אם יש הודעות קיבולת

• נסה שוב בעוד כמה דקות

• הרץ /model ועבור למודל אחר כדי להמשיך לעבוד, כי הקיבולת נמדדת לפי מודל. Claude Code מנחה אותך לעשות זאת כשמודל אחד נמצא בעומס גבוה במיוחד, לדוגמה Opus is experiencing high load, please use /model to switch to Sonnet. במודלי Fable ההודעה מציינת את Fable.

  בסשן שהאפליקציה Claude Desktop מריצה, כמו לשונית Code או Cowork, ההודעה היא Opus is experiencing high load. Switch to Sonnet. ומחליפים מודל בבורר המודלים של האפליקציה.

#Request timed out

ה-API לא הגיב לפני מועד סיום החיבור.

Request timed out

זמן הקצוב המוגדר לבקשה הוא 10 דקות. אם מגדירים את API_TIMEOUT_MS ל-0, הזמן הקצוב הזה של הבקשה כבוי. מועד הבייט הראשון והזמן הקצוב לסרק של הגוף לא נכבים כשמגדירים 0, ולכן בקשת סטרימינג עדיין רצה לפי אלה מביניהם שחלים על החיבור שלך. ניסיון בלי סטרימינג שומר על מגבלה של 300 שניות בסשן מקומי, ועדיין יכול להסתיים בהודעה הזו.

מה לעשות:

• אם כל בקשה נכשלת בהודעה הזו והגדרת את API_TIMEOUT_MS ל-0, בדוק את claude --version. בגרסה שלפני v2.1.305, עדכן את Claude Code או הגדר ערך חיובי.
• נסה את הבקשה שוב
• אם רשת איטית או פרוקסי הם הסיבה, העלה את API_TIMEOUT_MS כמתואר בניסיונות חוזרים אוטומטיים
• אם פקיעות זמן תכופות והרשת שלך תקינה מלבד זאת, ראה שגיאות רשת וחיבור למטה

#אין תגובה מה-API

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

אם מגדירים את CLAUDE_CODE_RETRY_WATCHDOG, Claude Code ממשיך לנסות שוב במסגרת התקציב המתואר בכוונון התנהגות ניסיונות חוזרים במקום לסיים את הסבב.

API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.

Claude Code מגדיר בנפרד את ההמתנה של הניסיון הראשון לכותרות תגובה ואת ההמתנה של הניסיון החוזר:

• ניסיון ראשון: CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS כשמגדירים אותו ל-1 או יותר, מוגבל לטווח שבין 10 שניות ל-30 דקות. אחרת Claude Code משתמש בזמן הקצוב של שומר הבייטים שמופיע בשומרי סרק לסטרימינג, ולכן המשתנים שמשנים את הזמן הקצוב הזה משנים גם את ההמתנה הזו. בכל מקרה, Claude Code מוסיף שנייה אחת על כל 32KB של גוף הבקשה.

• ניסיון חוזר: שנייה אחת פחות מ-API_TIMEOUT_MS, מעט פחות מ-10 דקות כברירת מחדל, כדי שהניסיון החוזר יוכל להחזיק מעמד יותר זמן מפרוקסי או שער שמחזיק את התגובה עד שההפקה מסתיימת. ב-Amazon Bedrock, הניסיון החוזר משתמש באותו מועד כמו הניסיון הראשון, וההודעה מציגה משך אחד במקום שניים.

  למעט ב-Amazon Bedrock, אם מגדירים את API_TIMEOUT_MS ל-0, הניסיון החוזר ממתין 10 דקות ועוד שנייה לכל 32KB, או כמו הניסיון הראשון אם זה ארוך יותר.

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

בסשן של שער יישומי Claude, המועד הזה רץ רק כשמפעילים אותו על ידי הגדרת CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS ל-1 או יותר.

מה לעשות:

• שלח את ההודעה שוב. ההודעה המקורית עדיין בשיחה, ולכן בהנחיה ארוכה אפשר להקליד try again במקום להדביק את כולה.
• אם זה חוזר, התייחס לזה כבעיית רשת או פרוקסי.
• אם פרוקסי או שער ברשת שלך מחזיקים תגובות עד שהן מסתיימות, העלה את API_TIMEOUT_MS כדי שהניסיון החוזר ימתין יותר. ב-Amazon Bedrock, העלה גם את CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS.
• אם הניסיון הראשון ממשיך לפקוע והניסיון החוזר מצליח אחר כך, העלה את CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS כדי שגם הניסיון הראשון ימתין מספיק.

לפני v2.1.242, Claude Code המתין לזמן הקצוב המלא של הבקשה API_TIMEOUT_MS, 10 דקות כברירת מחדל, לפני שנכשל בבקשת סטרימינג שלא נענתה. לפני v2.1.261, הניסיון החוזר המתין לאותו מועד כמו הניסיון הראשון, וההודעה לא הציגה משכים. לפני v2.1.307, Claude Code התעלם מ-CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS בסשן של שער יישומי Claude.

#ייתכן שהתגובה למעלה לא שלמה

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

API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection lost mid-response. The response above may be incomplete.
API Error: Your computer went to sleep mid-response. The response above may be incomplete.
API Error: The response stopped arriving. The response above may be incomplete.
API Error: Part of the response never arrived. The response above may be incomplete.
API Error: The response stream was malformed. The response above may be incomplete.

• Server error mid-response: שגיאת שרת של עומס יתר (overloaded) או 5xx באמצע הזרם. הגרסה הזו דורשת Claude Code v2.1.199 או מאוחר יותר. לפני כן המקרה הזה זרק את הפלט החלקי ודיווח על כל הסבב כשגיאה.
• Connection lost mid-response: החיבור נותק. רואים את הגרסה הזו גם כשפרוקסי או שער מסיימים את גוף התגובה בצורה נקייה לפני שהתגובה הסתיימה.
• Your computer went to sleep mid-response: Claude Code זיהה שהמחשב נכנס לשינה בזמן שהתגובה זרמה. אחרי שהמחשב מתעורר, Claude Code מתייחס לחיבור כשבור ומפסיק לקרוא ממנו.
• Part of the response never arrived: אירוע זרם נשמט בין ה-API ל-Claude Code, ולכן אירוע מאוחר יותר הפנה לתוכן שמעולם לא הגיע. לפני v2.1.281, המקרה הזה סיים את הסבב ב-API Error: Content block not found.
• The response stream was malformed: הגיע אירוע לבלוק תוכן שכבר הסתיים, או שהגיע אירוע פגום. אירוע פגום הוא אירוע שהנתונים שלו אינם JSON תקין, שהתוכן שלו חסר, או שהתוכן שלו לא תואם לסוג האירוע. לפני v2.1.284, השגיאה הגולמית של המנתח, למשל אחת שמתחילה ב-API Error: JSON Parse error, הופיעה במקום זאת כשהגיע אירוע עם JSON לא תקין אחרי ש-Claude השלים את החשיבה, בלוק טקסט או קריאת כלי.
• The response stopped arriving: החיבור נשאר פתוח אבל הפסיק למסור נתונים, ולכן שומר הסרק של הסטרימינג ביטל אותו. לפני v2.1.222, Claude Code יכול היה גם לדווח על הכשל הזה בחיבורי שער שהגיעו דרך ANTHROPIC_BASE_URL או ANTHROPIC_AWS_BASE_URL בזמן שפינגים של keep-alive מהשרת עדיין הגיעו, כי הוא ספר שם רק אירועי תגובה שנותחו. שדרוג מפסיק את פקיעות הזמן השגויות האלה במסלולים האלה. שערים שהגיעו דרך כתובת בסיס של ספק כמו ANTHROPIC_BEDROCK_BASE_URL לא עטופים בשומר הבייטים. ראה שומרי סרק לסטרימינג.

לפני v2.1.227, Connection lost mid-response הופיע כ-Connection closed mid-response, ו-The response stopped arriving הופיע כ-Response stalled mid-stream.

כשמגיע אירוע זרם שנשמט, שוכפל או נפגם לפני ש-Claude התחיל טקסט או קריאת כלי כלשהם, לא רואים את ההודעה הזו:

• אם Claude השלים רק את החשיבה, Claude Code שולח את הבקשה מחדש. כשהזרמים שנשלחו מחדש נשברים באותו אופן, הסבב מסתיים ב-Part of the response never arrived and no response was produced. Try again. או ב-The response stream was malformed and no response was produced. Try again.
• אם שום דבר לא הושלם, Claude Code שולח את הבקשה מחדש בלי סטרימינג. אם כיבית את הגיבוי הזה עם CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK, הסבב מסתיים ב-API Error: Content block not found לאירוע שנשמט, או ב-API Error: Content block already closed לאירוע משוכפל. לאירוע פגום כשהגיבוי כבוי, הסבב מסתיים ב-API Error: Stream event unreadable או בשגיאה הגולמית של המנתח.

בארבעה מקרים, Claude Code מטפל בכשל בלי להציג את ההודעה הזו מיד:

• מוקדם יותר בתגובה, Claude Code מנסה שוב את הכשל או מסיים את הסבב בשגיאה אחרת. ראה ניסיונות חוזרים אוטומטיים.
• כשאחד מהכשלים האלה מגיע אחרי ש-Claude סיים את התגובה, Claude Code שומר את התגובה המלאה ומסיים את הסבב כרגיל, בלי ההודעה הזו. לפני v2.1.222, Claude Code הציג את ההודעה הזו כשהחיבור נותק או נתקע אחרי שהתגובה הסתיימה, ודיווח על הסבב כשגיאה אף שהתגובה הייתה מלאה.
• בסשן לא אינטראקטיבי, כמו הרצה של -p, הרצה של Agent SDK, או סשן ענן, אין צורך לשלוח continue בעצמך כשהתגובה שנקטעה נמצאת בשיחה הראשית ומכילה טקסט בלי קריאות כלים: Claude Code שומר את הפלט החלקי ומנחה את Claude להמשיך מהמקום שבו עצר, עד שלוש פעמים ברצף. רואים את ההודעה הזו לתגובה כזו רק אחרי ש-Claude Code מיצה את ההמשכים האלה. לפני v2.1.246, Claude Code סיים סבב לא אינטראקטיבי בהודעה הזו כבר בחיתוך הראשון.
• בsubagent, בין שהסשן אינטראקטיבי ובין שלא: כשהתגובה שנקטעה מכילה טקסט בלי קריאות כלים, Claude Code מנחה את ה-subagent להמשיך. ההודעה הופכת להודעה האחרונה של ה-subagent רק אחרי שההמשכים האלה מוצו. לפני v2.1.257, subagent הציג את ההודעה הזו כבר בחיתוך הראשון.

מה לעשות:

• בסשן אינטראקטיבי, קרא את התגובה שנשארת על המסך: Claude Code שומר כל בלוק ש-Claude השלים לפני השגיאה, אבל משליך בלוק אחרון שנקטע כשהסבב מסתיים, ולכן המשפטים האחרונים או קריאות הכלים עלולים לחסר. השב ב-continue כדי ש-Claude ימשיך מהבלוק האחרון שהושלם.
• במצב לא אינטראקטיבי (-p):
  • עם פלט הטקסט המוגדר, Claude Code מדפיס את בלוק הטקסט האחרון שהושלם שהוא עדיין מחזיק ממוקדם יותר בסבב, ואחריו את ההודעה הזו. כשהוא לא מחזיק אף אחד, Claude Code מדפיס את ההודעה הזו לבדה, למשל כי Claude Code דחס את השיחה באמצע הסבב וניקה את הטקסט הזה. לפני v2.1.219, Claude Code הדפיס רק את ההודעה הזו בפלט טקסט של -p והשמיט את התגובה שכבר יצר.
  • עם --output-format json או stream-json, Claude Code מדווח על ההודעה הזו בשדה result.
  • כדי להמשיך את הסבב אחרי שהחיבור יציב, חדש את הסשן ושלח continue כמתואר בהמשך שיחות.

#מצב אוטומטי לא יכול לקבוע את הבטיחות של פעולה

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

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

כשהמודל המסווג אינו זמין:

<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.

בסשן אינטראקטיבי, שורה מעומעמת Not run · auto mode's check had no usable answer מופיעה מתחת לקריאת הכלי במקום ההודעה הזו. השורה יכולה גם להחליף הודעה שאומרת השרת לא נתן פסק, או, מחוץ לסשן מרוחק, הודעה שמתחילה ב-Auto mode could not evaluate. לחצו על Ctrl+O כדי לקרוא את ההודעה שלה במציג התמליל. לפני v2.1.296, ההודעה הופיעה כשגיאה אדומה.

כש-Claude Code יכול לקבוע את קטגוריית הכשל, הוא מציין את הקטגוריה בסוגריים אחרי temporarily unavailable, לדוגמה <model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now. הקטגוריות הן (rate-limited), (overloaded), (server error), (timed out) ו-(connection failed). אם (timed out) או (connection failed) חוזרים, בדקו את החיבור שלכם. ראו לא ניתן להתחבר ל-API. לפני v2.1.229, ההודעה מעולם לא ציינה קטגוריה והנוסח שלה היה Wait briefly and then try this action again.

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

מה לעשות:

• נסו שוב אחרי כמה שניות. Claude רואה את אותה הודעה ובדרך כלל מנסה שוב בעצמו. כשל חולף אינו קשור לזכאות למצב אוטומטי. אין צורך לשנות הגדרות
• אם הניסיונות החוזרים ממשיכים להיכשל, המשיכו במשימות לקריאה בלבד וחזרו לפעולה החסומה מאוחר יותר
• ב-Amazon Bedrock, אם ההודעה חוזרת בכל ניסיון חוזר, בדקו שחשבון שלכם יכול להפעיל את המודל שהיא מציינת: עבור מודלים רגילים של Amazon Bedrock, אשרו שמדיניות IAM מאפשרת להפעיל אותו. עבור מזהי מודל של Mantle, פנו לצוות חשבון ה-AWS שלכם
• אם ההודעה חוזרת בכל ניסיון חוזר ומציינת את המודל שהגדרתם ב-CLAUDE_CODE_AUTO_MODE_MODEL, בדקו שה-API או ספק הענן שהסשן שלכם רץ עליו מגיש את מזהה המודל הזה. אם הוא לא מגיש אותו, הגדירו את המשתנה למזהה מודל שהוא מגיש, או בטלו את הגדרת המשתנה כדי להשתמש במודל המסווג המוגדר כברירת מחדל.

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

כשהמסווג החזיר תשובה שלא ניתן לנתח:

Auto mode could not evaluate this action and is blocking it for safety , run with --debug for details

מה לעשות:

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

כשבדיקת בטיחות נפרדת של ה-API חסמה את בקשת המסווג בגלל תוכן שיחה קודם:

Auto mode could not evaluate this action and is blocking it for safety , a safety check separate from auto mode blocked this request because of earlier conversation content , it isn't about the action itself , run with --debug for details

Claude Code דוחה את הפעולה אבל אומר ל-Claude שזו לא הערכה שהפעולה לא בטוחה, ולהמשיך במשימות אחרות במקום לנסות שוב. הדחיות האלה לא נספרות לקראת ספי ההשהיה של מצב אוטומטי. בהרצת -p לא אינטראקטיבית, Claude Code לא עוצר את ההרצה. מה ש-Claude מקבל תלוי במקום שבו הוא ביקש את הפעולה:

• לסוכן משנה ברקע בהרצת -p בלי --input-format stream-json, Claude Code מחזיר תוצאת שגיאה שמכילה Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode
• בכל מקום אחר, כולל סשנים אינטראקטיביים והשיחה הראשית של הרצת -p, Claude Code מחזיר את הדחייה הזו ל-Claude

לפני v2.1.225, Claude Code ספר את הסירובים האלה לקראת ספי ההשהיה והחזיר את אותה הודעת דחייה כמו חסימה אמיתית של המסווג.

מה לעשות:

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

כשהשיחה ארוכה מדי לבקשת המסווג של Claude Code ו-Claude Code לא יכול לדחוס אותה בעצמו:

Auto mode classifier transcript exceeded context window , falling back to manual approval (try /compact to reduce conversation size)

מה שקורה לפעולה תלוי במקום שבו Claude ביקש אותה:

• בסשן אינטראקטיבי, מצב אוטומטי חוזר לבקשת הרשאה רגילה עבור הפעולה הזו כדי שתוכלו לאשר או לדחות אותה ידנית
• לסוכן משנה ברקע בהרצת -p לא אינטראקטיבית בלי --input-format stream-json, Claude Code מחזיר תוצאת שגיאה שמכילה Agent aborted: auto mode classifier transcript exceeded context window in headless mode, וההרצה ממשיכה
• במקום אחר בהרצת -p בלי --permission-prompt-tool, אין בקשה לחזור אליה, ולכן הפעולה לא רצה וההרצה ממשיכה

מה לעשות:

• בסשן אינטראקטיבי, אשרו או דחו את הפעולה בבקשה שמופיעה
• בסשן אינטראקטיבי, הריצו /compact כדי להקטין את גודל השיחה כך שפעולות הבאות ייכנסו שוב לחלון המסווג

#השרת לא החזיר פסק בטיחות

תחת סקירת מסווג בצד השרת, מצב אוטומטי דוחה פעולה כשהשרת לא נותן לה פסק. הדחייה מציינת קטגוריה בסוגריים כש-Claude Code יכול לקבוע אחת, כמו (timed out):

The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.

שאר ההודעה אומר ל-Claude אם ניסיון חוזר אחד יכול לעזור. לפני חלק מהדחיות האלה, Claude Code ממתין כדי שהניסיון הבא של Claude לא יבוא מיד. במהלך ההמתנה בסשן אינטראקטיבי, הספינר מציג Auto mode check unavailable עם ספירה לאחור, ולחיצה על Esc קוטעת את התור.

אחרי עשר תשובות ברצף בלי פסק, מצב אוטומטי עוצר את התור:

Auto mode is unavailable , the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.

חלק מהדחיות לא נספרות לקראת העשר, כולל דחייה משינוי של hook או mod.

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

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

מה לעשות:

• בסשן אינטראקטיבי, לחצו על Ctrl+O כדי לקרוא את טקסט הדחייה במציג התמליל.
• אם הדחייה מציינת (the conversation is too long for the check), הריצו /compact בשורת Claude Code כדי לקצר את השיחה. עד שהשיחה תהיה קצרה יותר, שליחת הודעה נוספת מקבלת את אותה דחייה. אם כיביתם את דחיסה אוטומטית, הפעילו אותה שוב כדי ש-Claude Code ידחוס בעצמו בפעם הבאה.
• שלחו הודעה נוספת כדי ש-Claude ינסה שוב. ספירת התשובות מתחילה מחדש.
• אם העצירה חוזרת והבקשות שלכם עוברות דרך שער LLM או פרוקסי, בדקו אם הוא חותך תשובות סטרימינג באמצע או משכתב אותן. סקירת מסווג בצד השרת אומרת איזו התנהגות של שער גורמת לדחיות, ומדריך התאימות של השער מפרט מה להעביר בלי שינוי.
• הגדירו CLAUDE_CODE_AUTO_MODE_SERVER=0 לפני שאתם מפעילים את Claude Code כדי להשתמש בבקשות המסווג שלו במקום. לפני v2.1.281, Claude Code לא קרא את המשתנה בחיבור ישיר ל-API של Anthropic.
• כדי לאשר את הפעולות בעצמכם במקום זאת, צאו ממצב אוטומטי

לפני v2.1.280, Claude Code דחה מיד כל פעולה מתשובה בלי פסק ומעולם לא עצר את התור.

לפני v2.1.302, בחיבור ישיר ל-API של Anthropic, Claude Code לא דחס שיחה שגדלה יותר מדי עבור הבדיקה של השרת.

#a hook changed this call's input after auto mode reviewed it

הדחייה הזו אומרת ש-hook או mod שינו את הקלט של הקריאה אחרי שהשרת סקר אותה, ולכן הסקירה לא מכסה את מה שהיה רץ. זו לא הערכה שהפעולה לא בטוחה.

קריאות מאוחרות יותר באותה תשובה של Claude יכולות להידחות מהסיבה הזו:

another call in this response was changed by a hook after auto mode reviewed it, or could not be confirmed unchanged

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

• עצרו את השינוי: כבו את ה-hook או את ה-mod ששינה את הקריאה או קריאה קודמת באותה תשובה של Claude, או בקשו מהמנהל שלכם לכבות אותו. כדי לחפש hook, הריצו /hooks בשורת Claude Code. בסשן מסוף, הריצו /plugin כדי לראות את ה-mods הפעילים.
• אשרו את הקריאה בעצמכם: עברו למצב ידני

#לא נסקר ולא רץ

דחייה מסוג was not reviewed and did not run אומרת שהשיחה ארוכה מדי כדי שהמסווג של מצב אוטומטי יבדוק את הפעולה, ולכן הפעולה לא רצה. Claude Code מחזיר את ההודעה הזו ל-Claude:

<tool> was not reviewed and did not run: the conversation is too long for auto mode's classifier. Claude Code will try to compact the conversation before the next request; if this action is still needed after that, issue it again and it will be reviewed normally.

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

• דחייה gave no verdict (the conversation is too long for the check)
• ההודעה Auto mode classifier transcript exceeded context window

מה לעשות:

• אם הדחיסה שההודעה מכריזה עליה מצליחה, אין צורך לעשות שום דבר.
• אם אתם רואים אחת משתי ההודעות האלה, הריצו /compact בשורת Claude Code כדי לקצר את השיחה בעצמכם. אם כיביתם את דחיסה אוטומטית, הפעילו אותה שוב כדי ש-Claude Code ידחוס בעצמו בפעם הבאה.

#סוכן הסתיים מוקדם בגלל שגיאת API

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

Agent terminated early due to an API error: <error detail>

מה לעשות:

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

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

#מגבלות שימוש

רוב השגיאות בסעיף זה אומרות שמכסה הקשורה לחשבון או לתוכנית שלך מוצתה. שלוש מתנהגות אחרת: Server is temporarily limiting requests הוא ויסות מצד השרת שאינו קשור למכסת התוכנית שלך, Usage credits required for 1M context הוא בדיקת זכאות ולא מכסה שמוצתה, ו-The prompt to confirm went unanswered אומר שחלון הסכמה לקרדיטי שימוש נסגר בלי מענה, בין שהמכסה מוצתה ובין שלא.

#You've hit your session limit

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

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
You've hit your Sonnet limit · resets 3:45pm

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

בסשן אינטראקטיבי שמחובר עם מנוי claude.ai, Claude Code יכול גם להמתין בסשן הפתוח ולהמשיך את המשימה שהופסקה זמן קצר אחרי האיפוס. ראו Wait for a usage limit to reset לגבי מה שרואים, איך מתחילים או מבטלים המתנה, ואיך מכבים המשך אוטומטי. לפני גרסה v2.1.234, Claude Code לא הציע את ההמתנה הזו.

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

מה לעשות:

• המתינו לזמן האיפוס שמופיע בשגיאה
• בלשונית Code של אפליקציית Desktop, כרטיס מגבלת הסשן מציע תיבת סימון Auto-continue when limits reset. לכרטיס המגבלה השבועית אין תיבה כזו. כשהיא מסומנת, אפליקציית Desktop מנסה שוב את התור שהופסק אחרי האיפוס ומציגה את זמן הניסיון החוזר על הכרטיס. תיבת הסימון ב-Desktop וההגדרה Continue automatically at usage limit של ה-CLI ב-/config נפרדות, ולכן יש לכבות כל אחת בנפרד.
• עבור מגבלת Opus או Sonnet, הריצו /model ועברו למודל מחוץ למשפחה הזו כדי להמשיך לעבוד. לכל מודל יש מטמון פרומפט משלו, ולכן הבקשה הבאה קוראת מחדש את כל השיחה בלי פגיעות מטמון. ראו Switching models
• הריצו /usage כדי לראות את מגבלות התוכנית ומתי הן מתאפסות
• הריצו /usage-credits כדי לקנות שימוש נוסף ב-Pro, ב-Max וב-Ultra, או כדי לבקש אותו מהמנהל ב-Team וב-Enterprise. ראו usage credits for paid plans לגבי אופן החיוב.
• כדי לשדרג את התוכנית למגבלות בסיס גבוהות יותר, ראו claude.com/pricing

לפני שחלון נגמר, Claude Code יכול להזהיר שניצלתם את רובו, בהודעה כמו You've used 85% of your session limit · resets 3:45pm. כדי לעקוב אחרי ההקצאה שנשארה, הוסיפו את שדות rate_limits ל-שורת סטטוס מותאמת, או באפליקציית Desktop לחצו על טבעת השימוש.

#Usage credits required for 1M context

המודל שנבחר משתמש בחלון ההקשר המורחב של מיליון טוקנים, והתוכנית שלך כוללת אותו רק דרך קרדיטי שימוש.

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

בסשן שאפליקציית Claude Desktop מריצה, הרמז לא מציין פקודות: הוא מפנה לדף הגדרות השימוש ב-claude.ai, או בתוכניות Team ו-Enterprise אומר להפעיל קרדיטי שימוש ב-claude.ai/admin-settings/usage או לבקש מהמנהל.

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

כשהשגיאה הזו מופיעה באמצע שיחה כי ההקשר עבר 200K טוקנים, Claude Code דוחס אוטומטית את השיחה חזרה מתחת למגבלת ההקשר הרגילה ושומר את הסשן במגבלה הזו אחר כך, כך שאין צורך בפעולה. בגרסאות שלפני v2.1.172, השגיאה חזרה בכל בקשה הבאה, כולל /compact. הריצו /clear בגרסאות האלה כדי להתאושש. השלבים למטה חלים כשבחרתם במפורש מודל [1m].

מה לעשות:

• הריצו /model ובחרו את הגרסה בלי הסיומת [1m] כדי לחזור לחלון ההקשר הרגיל
• כשההודעה מציינת /usage-credits, הריצו אותה כדי להפעיל חיוב לפי שימוש לגרסת 1M ב-Pro, ב-Max וב-Ultra, או כדי לבקש קרדיטי שימוש מהמנהל ב-Team וב-Enterprise. אחרי שקרדיטי השימוש פעילים, הפעילו מחדש את Claude Code או התחילו סשן חדש, לפי מה שההודעה אומרת. עד אז, הסשן נשאר במגבלת ההקשר הרגילה.
• אם השגיאה נמשכת אחרי /model, ייתכן שמזהה מודל 1M מוגדר במקום אחר. ראו Setting your model לגבי מיקומי ההגדרה לבדיקה לפי סדר עדיפות.
• כדי להסיר גרסאות 1M מבורר המודלים לגמרי, הגדירו CLAUDE_CODE_DISABLE_1M_CONTEXT=1

לפני v2.1.268, ההודעה הסתיימה ב-run /usage-credits to turn them on, or /model to switch to standard context ולא הזכירה הפעלה מחדש.

#The prompt to confirm went unanswered

כש-חלון ההסכמה לקרדיטי שימוש של Fable נסגר בלי שאיש ענה, Claude Code מסיים את התור באחת מההודעות האלה:

Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered , nothing was sent · answer it where this session is running, or /model to change
Fable 5.1 now uses usage credits · the prompt to confirm went unanswered , nothing was sent · answer it where this session is running, or /model to change

ההודעות מציינות את מודל Fable של הסשן, ולכן ב-Fable 5 הן אומרות continuing on Fable 5 ו-Fable 5 now uses usage credits. לפני v2.1.257, ההודעה הראשונה התחילה ב-Fable 5 limit reached.

זה קורה בסשנים של Remote Control, ב-סשני רקע, בסשני חבר צוות של agent team, ובסשנים שאפליקציה אחרת מארחת דרך Agent SDK. לגבי מתי Claude Code סוגר את החלון, ראו Fable and usage credits.

מה לעשות:

• במקום שבו הסשן רץ, בטרמינל או באפליקציה שמארחת אותו, שלחו פרומפט נוסף וענו לחלון ההסכמה כשהוא מופיע שוב. עבור סשן רקע, התחברו אליו קודם מ-תצוגת הסוכנים. שליחה חוזרת מלקוח Remote Control מציגה את ההודעה הזו שוב, כי הלקוח לא יכול להציג את החלון.
• הריצו /model כדי לעבור למודל שלא מחייב קרדיטי שימוש
• כדי לתת לעצמכם יותר זמן, הגדירו dialogExpiry לערך ארוך יותר או ל-"never"

לפני v2.1.236, ההודעה הזו לא הופיעה: בזמן שלקוח Remote Control היה מחובר, Claude Code המתין 60 שניות לתשובה ואז המשיך את התור על מודל ברירת המחדל שלכם.

#Server is temporarily limiting requests

ה-API הפעיל ויסות קצר טווח שאינו קשור למכסת התוכנית שלכם.

API Error: Server is temporarily limiting requests (not your usage limit)

Claude Code מבחין בין אלה לבין מגבלת התוכנית לפי היעדר כותרות המכסה המאוחדות שתגובת מגבלה אמיתית נושאת. החל מ-v2.1.199 זה מנוסה שוב אוטומטית עם backoff לפני ההצגה, בכל דרך שבה מאמתים. בגרסאות מוקדמות יותר, סשן שמחובר עם מנוי claude.ai נכשל בתור כבר בהופעה הראשונה. רק התחברויות עם מפתח API ועם Enterprise ניסו שוב.

מה לעשות:

• המתינו מעט ונסו שוב
• בדקו את status.claude.com אם זה נמשך

#Request rejected (429)

הגעתם למגבלת הקצב שהוגדרה למפתח ה-API, לפרויקט Amazon Bedrock, או לפרויקט Google Cloud.

API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.

המשפט הסוגר מציין איפה לבדוק את תקינות השירות ומשתנה לפי הספק. תצורות של Amazon Bedrock, Agent Platform של Google Cloud, ו-Microsoft Foundry מציינות את סטטוס השירות של הספק הזה במקום דף הסטטוס של Anthropic. ANTHROPIC_BASE_URL מותאם מציין את מארח השער.

כשפרוקסי, מאזן עומסים, או שער בין Claude Code ל-API עונים בדף HTML 429 משלהם, הטקסט אחרי · הוא כותרת הדף כשיש לו כותרת, כמו Too Many Requests. לפני v2.1.281, כל סימון הדף הודפס אחרי ·.

מה לעשות:

• הריצו /status ואשרו שהאישור הפעיל הוא זה שציפיתם לו. ANTHROPIC_API_KEY תועה בסביבה יכול לנתב בקשות דרך מפתח ברמה נמוכה במקום דרך המנוי.
• בדקו בקונסולת הספק את המגבלות הפעילות ובקשו רמה גבוהה יותר אם צריך
• עבור מפתחות API של Anthropic, ראו את rate limits reference לגבי איך הרמות עובדות ואיך מגדירים תקרות לכל סביבת עבודה
• הפחיתו מקביליות: הימנעו מהרצת תת-סוכנים מקבילים רבים, או עברו למודל קטן יותר עם /model עבור הרצות סקריפט בנפח גבוה

#You've hit your monthly spend limit

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

You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message
You've hit your individual spend limit · ask your admin for a higher limit
You've hit your org's monthly spend limit · visit https://claude.ai/admin-settings/usage to raise it
You've hit your team's shared budget · ask your admin to raise it at https://claude.ai/admin-settings/usage
You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings

team's shared budget הוא תקציב משותף שמנהל הקצה לקבוצה שאתם שייכים אליה. ההודעה לא מציינת את שם הקבוצה. channel's monthly spend limit הוא התקציב של ערוץ Slack היחיד שבו הסשן רץ, ולכן לארגון עדיין יכול להיות תקציב מחוץ לערוץ.

כשאחד מחלונות התוכנית הוא מה שנגמר, ההודעה גם אומרת מתי החלון מתאפס, למשל · your session limit resets 3:45pm, והגישה חוזרת אז בלי שאיש מעלה את המגבלה. בארגונים עם חיוב לפי שימוש, ההודעה אומרת usage limit במקום spend limit, כמו ב-You've hit your individual usage limit.

אם אתם מתחברים דרך שער אפליקציות Claude ורואים spend limit reached באותיות קטנות, זו תקרת מפעיל השער. ראו Spend limit reached.

מה לעשות:

• ב-Pro, ב-Max וב-Ultra, העלו את מגבלת ההוצאה החודשית ב-Settings > Usage ב-claude.ai, או הריצו /usage-credits
• ב-Team וב-Enterprise, העלו את המגבלה ב-Organization settings > Usage אם אתם מנהלים את החיוב, או בקשו ממנהל. /usage-credits שולח את הבקשה הזו למנהל עבורכם
• עבור מגבלה של ערוץ, בקשו מבעל הארגון או ממנהל הערוץ להעלות אותה ב-claude.ai. ראו Per-channel limits בתיעוד Claude Tag
• אם ההודעה מציינת זמן איפוס לחלון התוכנית, אפשר להמתין לו
• הריצו /usage כדי לראות את חלונות התוכנית ומתי כל אחד מתאפס

#Spend limit reached

אתם מתחברים דרך שער אפליקציות Claude ועברתם תקרת הוצאה שמפעיל השער הגדיר. השער חוסם את הבקשות עד שהתקופה שצוינה מתאפסת או עד שהמפעיל מעלה את התקרה. הוא מסמן כל תגובת 429 חסומה ב-x-should-retry: false, ולכן Claude Code מציג את ההודעה הזו בלי לנסות שוב.

spend limit reached (daily; resets 2026-08-09 00:00 UTC)

ההודעה מציינת את תקופת התקרה ואת זמן האיפוס, וכשהמפעיל הגדיר blocked_message, ההנחיות שלו באות אחריה. לפני v2.1.225, ההודעה אמרה רק spend limit reached. שער בגרסה ישנה יותר עדיין שולח את הצורה הקצרה הזו.

מה לעשות:

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

הודעה קשורה, spend limit unavailable, אומרת שהשער לא הצליח לקרוא את רשומות ההוצאה וחסם את הבקשה כאמצעי זהירות, ולא כי עברתם את התקרה. בדרך כלל זה מתפנה מעצמו. אם זה נמשך, עדכנו את מפעיל השער.

#Credit balance is too low

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

Credit balance is too low

מה לעשות:

• אם יש לכם תוכנית Pro, Max, Ultra, Team, או Enterprise ואתם רואים את זה, הריצו /status ובדקו את שורת API key. ANTHROPIC_API_KEY שאושר בסביבה מנתב בקשות דרך המפתח הזה במקום דרך המנוי. בטלו אותו במעטפת הנוכחית והסירו אותו מפרופיל המעטפת, ואז הפעילו מחדש את claude. הריצו /login אם עדיין לא התחברתם עם המנוי.
• הוסיפו קרדיטים ב-platform.claude.com/settings/billing, ושקלו להפעיל שם טעינה אוטומטית כדי שהיתרה תתמלא לפני שהיא מגיעה לאפס
• הגדירו תקרות הוצאה לכל סביבת עבודה ב-Console כדי למנוע מפרויקט יחיד לרוקן את יתרת הארגון. ראו Manage costs effectively.

#Could not update your spend limit

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

Could not update your spend limit: <reason from the server>

כשהשרת מסביר את הדחייה, ההודעה מסתיימת בסיבה הזו, וניסיון חוזר עם אותו ערך נכשל שוב. כשלכשל אין סיבה שהשרת סיפק, כמו חיבור שנפל, ההודעה היא Could not update your spend limit. Press Enter to retry. וניסיון חוזר יכול להצליח. לפני v2.1.216, Claude Code הציג את הצורה הכללית לכל כשל.

מה לעשות:

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

#שגיאות אימות

השגיאות האלה אומרות ש-Claude Code לא יכול להוכיח ל-API מי אתם. הריצו /status בכל עת כדי לראות איזה אישור פעיל כרגע.

#לא מחובר

אין אישור גישה תקף זמין להפעלה הזו.

Not logged in · Please run /login

בהפעלה שהאפליקציה Claude Desktop מריצה, כמו הלשונית Code או Cowork, ההודעה היא Authentication required · Sign in again to continue, ואתה מתחבר שוב מתוך האפליקציה.

אם אתה מתחבר עם חשבון claude.ai שלך בחלון אחר של Claude Code שמשתמש באותה תיקיית תצורה, הפעלה אינטראקטיבית שמציגה את ההודעה הזו מתחילה להשתמש בהתחברות הזו מעצמה. אין צורך להפעיל אותה מחדש.

לפני v2.1.286 ב-macOS, ההפעלה יכלה להמשיך להציג את ההודעה אחרי שהתחברת מחלון אחר. בגרסאות האלה, הפעל מחדש את ההפעלה שמציגה את ההודעה.

מה לעשות:

• הרץ /login כדי לאמת עם מנוי Claude או עם חשבון Console
• אם ציפית שמשתנה סביבה יאמת אותך, אשר ש-ANTHROPIC_API_KEY מוגדר ומיוצא במעטפת שבה הפעלת את claude
• עבור CI או אוטומציה שבהם התחברות אינטראקטיבית אינה אפשרית, הגדר סקריפט apiKeyHelper שמביא מפתח בעת ההפעלה
• אם משימות claude -p יוצאות עם ההודעה הזו כשמישהו מתחבר שוב לאותו חשבון claude.ai ולאותו ארגון, עדכן את Claude Code במקום שבו ההתחברות הזו רצה. לפני v2.1.318, Claude Code הסיר את ההתחברות השמורה במהלך ההתחברות הזו, לפני ששמר את החדשה.
• ראה קדימות אימות כדי להבין באיזה אישור גישה Claude Code משתמש כשיש כמה

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

#לא ניתן היה לקבוע שיטת אימות

ההפעלה הגיעה ללקוח ה-API בלי שום אישור גישה. הפעלות רקע והפעלות ענן מציגות את ההודעה הזו כשה-worker מתחיל בלי אישור גישה. הרצות אינטראקטיביות, -p, ו-Agent SDK מדווחות על אותו מצב כמו לא מחובר וכותבות את המחרוזת הזו רק ליומן הניפוי שלהן, כך שאם מצאת אותה שם, פעל לפי הערך ההוא במקום.

Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

בגרסאות הנוכחיות השגיאה אומרת שלא היה אישור גישה זמין לתהליך ה-worker. לפני v2.1.174, הפעלת רקע שהוקצתה ל-worker שהותחל מראש והיה במצב המתנה יכלה להיכשל כך גם כשאישורי גישה תקפים הוגדרו. לפני v2.1.176, הפעלת ענן שישבה בהמתנה לפני שנלקחה יכלה גם היא. שדרג כדי להתאושש.

מה לעשות:

• שדרג ל-v2.1.176 או חדשה יותר אם זה מופיע בהפעלת רקע או ענן ואישורי הגישה שלך כבר מוגדרים
• אשר ש-ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN, או אישורי הגישה של ספק הענן שלך מוגדרים בסביבה שמפעילה את ה-worker, ולא רק במעטפת האינטראקטיבית שלך
• עבור Agent SDK, ראה הגדרת אימות במדריך המהיר
• הרץ /status בהפעלה אינטראקטיבית באותה סביבה כדי לאשר איזה מקור אישור גישה נפתר

#מפתח API לא תקין

משתנה הסביבה ANTHROPIC_API_KEY או הסקריפט apiKeyHelper החזיר מפתח שה-API דחה, או ש-Claude Code חסם מפתח מ-ANTHROPIC_API_KEY לפני ששלח אותו.

Invalid API key · Fix external API key

כשההודעה ממשיכה אחרי Fix external API key עם תיאור כמו Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines)., ה-API מעולם לא ראה את המפתח. Claude Code מצא תו שכותרות HTTP לא יכולות לשאת ועצר את הבקשה לפני השליחה. ראה ערך כותרת בקשה לא תקין לאופן קריאת התיאור ולתיקון הערך.

מה לעשות:

• בדוק שגיאות הקלדה ואשר שהמפתח לא בוטל ב-Console
• באותה מעטפת, הרץ env | grep ANTHROPIC, או ב-PowerShell את Get-ChildItem Env:ANTHROPIC*. כלים כמו direnv, תוספי מעטפת של dotenv ומסופי IDE יכולים לטעון מפתח ישן מקובץ .env בפרויקט שלך בלי שהגדרת אותו במפורש.
• בטל את ANTHROPIC_API_KEY והרץ /login כדי להשתמש באימות מנוי במקום
• אם המפתח מגיע מסקריפט apiKeyHelper, הרץ את הסקריפט ישירות כדי לאשר שהוא מדפיס מפתח תקף ל-stdout
• הרץ /status כדי לאשר באיזה מקור אישור גישה Claude Code באמת משתמש

#הסקריפט apiKeyHelper שלך נכשל

Claude Code הריץ את הפקודה בהגדרת apiKeyHelper שלך ולא קיבל מפתח בחזרה. בלי מפתח, הבקשה מגיעה ל-API עם אישור גישה ממלא מקום, וה-API דוחה אותה עם 401. לוח Authentication במסוף מראה איזה מאלה קרה:

• הפקודה יצאה עם שגיאה או שתם הזמן שלה
• הפקודה לא הדפיסה כלום ל-stdout
• הפקודה הדפיסה משהו מלבד המפתח, כמו באנר התחברות או שורת יומן. הלוח מציג returned output that cannot be used as an API key ואומר מה לא בסדר, בלי לחזור על הפלט. לפני v2.1.227, Claude Code שלח את כל מה שהפקודה הדפיסה, אחרי חיתוך רווח לבן מסביב.

Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output

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

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

הרצת /login לא עוזרת כאן: הפלט של ה-helper קודם להתחברות שמורה כל עוד ההגדרה קיימת.

מה לעשות:

• הרץ ישירות במעטפת שלך את הפקודה שמוגדרת ב-apiKeyHelper כדי לשחזר את הכשל
• אם הפקודה מדווחת על הפעלה שפג תוקפה, אמת מחדש מול ספק אישורי הגישה שלך, למשל על ידי התחברות מחדש ל-SSO או לכספת הסודות
• תקן את הפקודה כך שתדפיס רק את המפתח ל-stdout, כאסימון יחיד של ASCII להדפסה עד 16,384 תווים, ותצא עם קוד 0. ראה סיבוב אישורי גישה עם apiKeyHelper להגדרה עובדת.
• הרץ /status כדי לראות את הכשל ולאשר ש-apiKeyHelper הוא מקור אישור הגישה הפעיל. שורת apiKeyHelper מציגה Failing עם פירוט הכשל האחרון, כמו קוד היציאה ופלט השגיאה של הפקודה, ונעלמת אחרי ההרצה המוצלחת הבאה. לפני v2.1.274, /status הציג רק את מקור אישור הגישה, לא את הכשל.
• בכל פעם שהפקודה נכשלת, קוד היציאה ופלט השגיאה שלה מופיעים גם בלוח Authentication במסוף. לפני v2.1.212, הלוח נקרא Cloud authentication.

#Claude Code לא שלח את ההתחברות שלך ל-claude.ai

ההודעות האלה אומרות ש-Claude Code סירב לבקשה שלך ולא שלח את ההתחברות שלך ל-claude.ai:

Your organization's settings need an update. Ask your administrator to fix the API key helper configuration.
Couldn't load your organization's settings. Check your connection, then restart Claude Code.
Restart Claude Code to finish signing in.

מה לעשות:

• Your organization's settings need an update: בקש ממנהל המערכת שלך לתקן את תצורת ה-API key helper
  • כדי לומר למנהל המערכת אילו מקורות מנוהלים יש למכונה שלך, הרץ /status בשורת Claude Code והעתק את שורת Setting sources. אם מופיעה שורת Skipped sources, העתק גם אותה
  • אם אתה מנהל את ההגדרות וה-helper נמצא בקובץ ההגדרות המנוהלות של המכונה או במדיניות MDM, ראה כאשר apiKeyHelper של מכונה אינו בתוקף
• Couldn't load your organization's settings: בדוק את החיבור שלך, ואז הפעל מחדש את Claude Code. אם ההודעה חוזרת אחרי הפעלה מחדש, אמור למנהל המערכת שלך
• Restart Claude Code to finish signing in: הפעל מחדש את Claude Code

לפני v2.1.315, הנחיה שנדחתה או העלאת קובץ הדפיסו הודעה אחת שהתחילה ב-Claude Code didn't send your claude.ai login.

#ערך כותרת בקשה לא תקין

ערך ש-Claude Code עמד לשלוח ככותרת בקשה מכיל תו שכותרות HTTP לא יכולות לשאת: מעבר שורה, בית NUL, או תו מעל U+00FF, כמו מירכאות מסולסלות או רווח ברוחב אפס. Claude Code עוצר את הבקשה לפני שנשלח דבר ומציין את שם המשתנה או ההגדרה שצריך לתקן. הסיבה הרגילה היא אישור גישה שהודבק ממסמך או מצ'אט שנשא תו בלתי נראה או מעבר שורה תועה.

Claude Code מריץ את הבדיקה הזו כשהוא שולח בקשות ל-API של Claude ישירות או דרך שער LLM. אצל ספק ענן צד שלישי כמו Amazon Bedrock, Claude Code לא מריץ אותה לפני השליחה.

Invalid auth token · Fix external auth token
Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable
Invalid request header from the environment · Fix the environment variable

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

• Invalid auth token: אסימון bearer מ-ANTHROPIC_AUTH_TOKEN או מ-CLAUDE_CODE_OAUTH_TOKEN
• Invalid ANTHROPIC_CUSTOM_HEADERS: שם כותרת או ערך שהגדרת ב-ANTHROPIC_CUSTOM_HEADERS. התיאור סופר איזה זוג Name: Value אשם, כמו distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS, בלי לחזור על השם או הערך, כי אתה בחרת את שניהם.
• Invalid request header from the environment: ערך ש-Claude Code מעתיק לכותרת בקשה ממשתנה סביבה אחר, כמו CLAUDE_AGENT_SDK_CLIENT_APP. התיאור מציין את שם המשתנה שצריך לתקן.

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

אחרי ה-· השני, ההודעה מתארת את הבעיה, כמו בדוגמה המלאה הזו:

Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).

המיקומים סופרים תווים החל מאחד. התיאור בנוי מביטויים קבועים ומספרי תווים, כך שהוא אף פעם לא כולל את הערך עצמו. הוא מציין את שם התו הפוגע רק כשהוא תו בלתי נראה או טיפוגרפי מוכר היטב, כמו סימן סדר בתים, רווח ברוחב אפס, או מירכאות מסולסלות, ומדווח על כל דבר אחר כ-a non-ASCII character.

מה לעשות:

• הגדר מחדש את המשתנה או ההגדרה שההודעה מציינת, והקלד מחדש את התווים סביב המיקום שדווח במקום להדביק שוב מאותו מקור
• עבור ANTHROPIC_CUSTOM_HEADERS, שמור זוג Name: Value אחד בכל שורה וכתוב מחדש את הזוג שההודעה סופרת
• הרץ /status כדי לאשר איזה מקור אישור גישה פעיל

#הארגון הזה הושבת

Claude Code משתמש ב-ANTHROPIC_API_KEY ישן מארגון Console מושבת. כשיש לך התחברות מנוי שמורה, המפתח דורס אותה.

Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
Your ANTHROPIC_API_KEY belongs to a disabled organization · Update or unset the environment variable
API Error: 400 ... This organization has been disabled.

הרמז אחרי ה-· תלוי באישורי הגישה השמורים שלך: הצורה הראשונה מופיעה כשהתחברות /login שמורה יכולה להיכנס לפעולה אחרי שתבטל את המפתח, והשנייה כשהמפתח הוא אישור הגישה היחיד שלך.

אם אתה מייצא מפתח בפרופיל המעטפת שלך או טוען אחד מ-.env, Claude Code משתמש בו במקום ב-/login, גם עם מנוי Pro, Max או Ultra שעובד. במצב לא אינטראקטיבי (-p), המפתח תמיד בשימוש כשהוא קיים.

מה לעשות:

• בטל את ANTHROPIC_API_KEY במעטפת הנוכחית והסר אותו מפרופיל המעטפת שלך, ואז הפעל מחדש את claude
• אם ההודעה אומרת Update or unset, אין לך התחברות שמורה שאפשר לחזור אליה. בטל את המפתח והרץ /login, או החלף את המפתח במפתח מארגון Console פעיל.
• הרץ /status אחר כך כדי לאשר שאישור הגישה הפעיל הוא המנוי שלך
• אם לא מוגדר משתנה סביבה והשגיאה נמשכת, פנה לתמיכה או התחבר עם חשבון אחר.

#הארגון שלך השבית אימות במפתח API

ההודעה הזו דורשת Claude Code בגרסה v2.1.169 או חדשה יותר. מנהל ארגון ה-Console שלך כיבה אימות במפתח API, ולכן ה-API דוחה את המפתח ש-Claude Code שולח. רמז ההתאוששות אחרי ה-· משתנה לפי המקום שממנו הגיע המפתח:

Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Sign in again with your claude.ai account

הצורה האחרונה מופיעה בהפעלה שהאפליקציה Claude Desktop מריצה, כמו הלשונית Code או Cowork, שבה אתה מתחבר שוב מתוך האפליקציה.

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

מה לעשות:

• אם ההודעה מציינת את ANTHROPIC_API_KEY, בטל אותו במעטפת הנוכחית והסר אותו מפרופיל המעטפת או מקובץ .env, ואז הפעל מחדש את claude
• אם ההודעה מציינת את apiKeyHelper, הסר את הגדרת apiKeyHelper מ-settings.json שלך
• הרץ /login כדי להתחבר עם חשבון claude.ai שלך
• הרץ /status אחר כך כדי לאשר שאישור הגישה הפעיל הוא המנוי שלך ולא מפתח API
• אם אתה צריך אימות במפתח API לאוטומציה, בקש ממנהל הארגון שלך להפעיל אותו מחדש ב-Console

#הארגון שלך השבית גישת מנוי ל-Claude

ארגון Claude שלך לא מאפשר להתחבר ל-Claude Code עם התחברות מנוי. הרצת /login שוב עם אותו חשבון מחזירה את אותה שגיאה.

Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

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

ה-Agent SDK ומצב לא אינטראקטיבי -p מציגים את זה כקוד השגיאה oauth_org_not_allowed.

מה לעשות:

• בקש מהמנהל שלך להפעיל גישת Claude Code לארגון שלך
• אמת עם מפתח API של Console במקום המנוי שלך. ראה אימות Claude Console להגדרה.
• אם אתה המנהל ואינך רואה אפשרות להפעיל גישה, פנה ל-תמיכת Anthropic

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

משימות מתוזמנות בענן כבויות עבור הארגון שלך, כך שאי אפשר ליצור או להריץ אותן. ההודעה מ-claude.ai קוראת להן scheduled tasks או routines, ומשפט על המנהל שלך בא אחריהן:

Scheduled tasks are off for your organization. …
Routines are off for your organization. …

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

מה לעשות:

• שאל את ה-Team Owner או ה-Enterprise Owner שלך אם הם יכולים להפעיל את המתג שתוויתו Scheduled tasks (Was Routines) או Routines ב-Organization settings > Capabilities > Remote sessions

#Remote Control דורש את ה-API של Anthropic

הסשן לא מדבר ישירות עם ה-API של Anthropic, וזה מה ש-Remote Control דורש.

Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock , unset it (or run in a shell without it) to use Remote Control.

משפט שני מסביר מה ניתב את הסשן הרחק מה-API של Anthropic. לפני v2.1.219 ההודעה הייתה המשפט הראשון בלבד. לפי הסיבה, ההודעה מציינת:

• משתנה ספק CLAUDE_CODE_USE_*, כמו CLAUDE_CODE_USE_BEDROCK עבור Amazon Bedrock או CLAUDE_CODE_USE_VERTEX עבור Google Cloud's Agent Platform
• ANTHROPIC_BASE_URL שמצביע על מארח שאינו api.anthropic.com, כמו LLM gateway או proxy, גם כשמתחברים עם claude.ai. לפני v2.1.196, כתובת בסיס מותאמת אישית לא חסמה את Remote Control
• ANTHROPIC_UNIX_SOCKET מוגדר, ולכן הסשן שולח את הבקשות דרך socket מקומי ולא אל api.anthropic.com
• כניסה ארגונית דרך cloud gateway שנעשתה באמצעות /login, שאינה תומכת ב-Remote Control ואין משתנה שאפשר לבטל

מה לעשות:

• בטל את הגדרת המשתנה שההודעה מציינת, כמו CLAUDE_CODE_USE_BEDROCK או ANTHROPIC_BASE_URL, והפעל מחדש את הסשן, או התחל Remote Control מסשן שמדבר ישירות עם ה-API של Anthropic
• אם המשתנה לא מוגדר ב-shell, בדוק את המפתח env ב-קובצי ההגדרות, שמחיל משתני סביבה על כל סשן
• עבור הודעה זו ושאר הודעות ההפעלה של Remote Control, ראה Troubleshoot Remote Control

#Remote Control לא הצליח לרענן את ההתחברות שלך

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

כש-Claude Code מבקש משירות ההתחברות לרענן את ההתחברות השמורה ולא מקבל תשובה, הוא משאיר את Remote Control פעיל ומנסה את הרענון שוב כל עוד האישור הנוכחי של החיבור עדיין תקף. רענון לא מקבל תשובה כש-Claude Code לא מצליח להגיע לשירות ההתחברות, כשזמן הבקשה פג, או כשהשירות נכשל בלי לדחות את ההתחברות. אם שירות ההתחברות עדיין לא עונה כשהאישור הזה פג, Claude Code עוצר את Remote Control ומדווח OAuth token refresh failed.

כש-Claude Code עוצר את Remote Control, הוא מציג את הסיבה באזהרה ובשורת תמליל שמתחילה ב-Remote Control disconnected. הסשן המקומי ממשיך לרוץ בלי Remote Control. הסעיף הזה מכסה את השורות האלה:

Remote Control disconnected , Claude.ai login expired , run /login to restore Remote Control
Remote Control disconnected , Claude.ai login expired , run /login, then /remote-control
Remote Control disconnected , Claude.ai login was rejected , run /login, then /remote-control
Remote Control disconnected , OAuth token unavailable , run /login to restore Remote Control
Remote Control disconnected , OAuth token refresh failed , run /login to re-authenticate
Remote Control disconnected , JWT refresh failed: no OAuth token , run /login
Remote Control disconnected , Signed out of Claude , run /login, then /remote-control

Claude Code מציין את הסיבה באמצע ההודעה:

• Claude.ai login expired ו-Claude.ai login was rejected: claude.ai כבר לא מקבל את אסימון ההתחברות השמור, כי הוא פג או בוטל
• OAuth token unavailable: ל-Claude Code לא היה אסימון התחברות שמור כשהגיע מועד החידוש של אישור החיבור
• OAuth token refresh failed: claude.ai דחה את אסימון ההתחברות השמור בזמן ש-Claude Code התחבר מחדש, ורענון האסימון לא הפיק אסימון חדש
• JWT refresh failed: no OAuth token: Claude Code לא מצא אסימון התחברות שמור לחידוש
• Signed out of Claude: התנתקת במחשב הזה, למשל על ידי הרצת /logout בטרמינל אחר, ולכן לא נשארה ל-Claude Code התחברות שמורה לחידוש החיבור

מה לעשות:

• הרץ /login כדי להתחבר מחדש
• הרץ /remote-control כדי לחבר מחדש את הסשן. הודעות שמסתיימות ב-run /login to restore Remote Control לא צריכות את השלב הזה: Claude Code מתחבר מחדש מעצמו אחרי שמתחברים.

לפני v2.1.224, OAuth token refresh failed , run /login to re-authenticate נקרא OAuth token refresh failed , re-authenticate, then re-enable Remote Control, ו-JWT refresh failed: no OAuth token , run /login נקרא no OAuth token available for recovery (code <N>). ההודעות Claude.ai login expired, Claude.ai login was rejected ו-OAuth token unavailable נוספו ב-v2.1.225.

לפני v2.1.238, Claude Code דיווח על המקרים שעכשיו אומרים Signed out of Claude בתור JWT refresh failed: no OAuth token , run /login, ועצר את Remote Control עם Claude.ai login expired , run /login to restore Remote Control ברגע שרענון התחברות אחד לא קיבל תשובה.

#Remote Control לא הצליח לחדש את החיבור של המחשב הזה

האזהרה הזו מופיעה בטרמינל שמריץ claude remote-control כשהשרת לא יכול להשתמש בהתחברות claude.ai כדי לחדש את האישור של החיבור לפני שהוא פג. המשפט האחרון באזהרה אומר כמה זמן האישור הנוכחי עדיין עובד, או שהוא כבר פג:

Remote Control could not renew this computer's connection: claude.ai did not accept the sign-in it uses. Run `claude /login` to sign in again. The connection keeps working for about 26 hours; if it still cannot sign in then, it stops.

מה לעשות:

• אם האזהרה אומרת להריץ claude /login, פתח טרמינל נוסף במכונה שמריצה את השרת, הרץ שם claude /login, והתחבר עם חשבון claude.ai
• אם השרת עדיין לא מצליח להתחבר אחרי שפג האישור של החיבור, הוא מדפיס שגיאה שמכילה Poll: Authentication failed (401) ועוצר. התחבר מחדש כמו שאומר המשפט השני של האזהרה, ואז הרץ claude remote-control שוב בטרמינל שבו השרת נעצר.

#Remote Control נעצר כי החשבון המחובר השתנה

Claude Code מציג את השורה הזו במהלך סשן Remote Control כשמתחברים לחשבון או לארגון claude.ai אחר במחשב הזה. המעבר נעשה מחוץ לסשן Claude Code, למשל על ידי הרצת /login בטרמינל אחר.

סשן Remote Control שהתחלת בזמן שהיית מחובר דרך /login שייך לחשבון ולארגון claude.ai שהיו מחוברים באותו זמן.

Remote Control disconnected , signed-in claude.ai account or organization changed on this machine , run /remote-control to start a session for the current account, or /login to switch back, then /remote-control

Claude Code עוצר את סשן Remote Control ברגע ש-claude.ai מאשר שהחשבון או הארגון השתנה. הסשן המקומי ממשיך לרוץ בלי Remote Control.

מה לעשות:

• הרץ /remote-control כדי להתחיל סשן Remote Control חדש תחת החשבון או הארגון הנוכחי
• כדי לחזור, הרץ /login והתחבר שוב לחשבון או לארגון הקודם. אחר כך הרץ /remote-control.

לפני v2.1.234, Claude Code לא הבחין כשעברת לחשבון או לארגון אחר מחוץ לסשן Claude Code. Claude Code השאיר את סשן Remote Control מחובר עד שבקשה מאוחרת יותר לשרת Remote Control נכשלה עם Remote Control server rejected the request (HTTP 404). הכשל הזה יכול היה להגיע שעות אחרי המעבר.

#Remote Control נעצר כי האפליקציה שמריצה את הסשן התנתקה או החליפה חשבונות

כשאפליקציית Claude לשולחן העבודה או IDE מארחים את הסשן, Claude Code מקבל את אסימון ההתחברות מהאפליקציה ולא מ-/login. כש-claude.ai דוחה את האסימון, Claude Code מבקש מהאפליקציה אסימון חדש. אם האפליקציה עונה שהיא מנותקת, או שהיא מחוברת עכשיו לחשבון Claude אחר, Claude Code מסיים את סשן Remote Control ושולח לאפליקציה אחת מהשורות האלה:

Remote Control stopped , the app running this session is now signed in to a different Claude account
Remote Control stopped , the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on

הסשן המקומי ממשיך לרוץ בלי Remote Control.

מה לעשות:

• אם האפליקציה מנותקת, התחבר אליה מחדש, ואז הפעל שוב את Remote Control באפליקציה
• אם האפליקציה החליפה חשבונות, Claude Code לא יכול להמשיך את הסשן שהסתיים תחת החשבון החדש. התחל סשן Remote Control חדש תחת החשבון הזה.

לפני v2.1.238, Claude Code שלח לאפליקציה את הודעות run /login שמפורטות תחת Remote Control לא הצליח לרענן את ההתחברות שלך בשני המקרים.

#אסימון OAuth בוטל או פג

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

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

OAuth token revoked · Please run /login
Please run /login · API Error: 401 OAuth token has expired ...

ב-מצב לא אינטראקטיבי (-p) וב-Agent SDK, ההודעות נקראות כך, וקוד השגיאה המובנה הוא authentication_failed:

Failed to authenticate: OAuth token revoked. Please log in again or contact your administrator.
Failed to authenticate. API Error: 401 OAuth token has expired ...

לפני v2.1.287, במצב לא אינטראקטיבי וב-Agent SDK, הודעת הביטול נקראה Your account does not have access to Claude. Please login again or contact your administrator.

מה לעשות:

• הרץ /login בשורת Claude Code כדי להתחבר מחדש
• אם פקודת -p או תוכנית Agent SDK משתמשת בהתחברות שמורה, הרץ claude באותה סביבה, השלם /login, ואז הרץ שוב את הפקודה או התוכנית. לאוטומציה שלא יכולה להתחבר באופן אינטראקטיבי, אמת עם ANTHROPIC_API_KEY או צור אסימון ארוך טווח עם claude setup-token.
• אם מאמתים עם משתנה הסביבה CLAUDE_CODE_OAUTH_TOKEN, Claude Code ממשיך לשלוח את הערך שהגדרת אחרי שבקשה נכשלת עם 401, במקום לעבור לאסימון של התחברות שמורה. /status מציג את האישור הזה כשורת Auth token שקוראת CLAUDE_CODE_OAUTH_TOKEN. צור אסימון חדש עם claude setup-token והפעל מחדש איתו, או בטל את הגדרת המשתנה והרץ /login. לפני v2.1.225, Claude Code יכול היה להחליף את ערך המשתנה באמצע הסשן באסימון הגישה קצר המועד מהתחברות שמורה, והסשן נכשל שוב בשגיאות 401 אחרי שפג האסימון הזה.
• לבקשות חוזרות להתחבר בין הפעלות, ראה את בדיקות שעון המערכת ואת שלבי השחזור של אחסון האישורים ב-macOS ב-Troubleshooting
• לכשלים אחרים, כולל 403 Forbidden ובעיות OAuth בדפדפן, ראה Login and authentication

#API Error: 401 Invalid authentication credentials

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

Please run /login · API Error: 401 Invalid authentication credentials

מה לעשות:

• אם /status מציג שורת API key שאינה מסומנת כ-not in use, ANTHROPIC_API_KEY מאושר הוא האישור הפעיל וקודם להתחברות, ולכן /login לא מחליף אותו. סובב את המפתח ב-Claude Console, או חזור למנוי על ידי הרצת unset ANTHROPIC_API_KEY, או ב-PowerShell Remove-Item Env:ANTHROPIC_API_KEY.
• אם /status מציג רק את ההתחברות, הרץ /login פעם אחת. אם האישור בוטל, התחברות חדשה מחליפה אותו.
• אם אותה הודעה חוזרת לאותו חשבון התחברות, החשבון או הארגון כבר לא פעיל. בדוק את החשבון ואת הארגון ש-/status מדווח, ובקש ממנהל הארגון לשחזר גישה.
• אם ANTHROPIC_BASE_URL מצביע על LLM gateway, הטקסט אחרי 401 הוא ההודעה של ה-gateway ולא של Anthropic, ו-/login לא משנה אותו. תקן את האישור שה-gateway מצפה לו.
• אם כל בקשה נכשלת עם 401 אחרי של-gateway יש את האישור שהוא מצפה לו, בדוק שה-gateway וה-upstream שלו מקבלים שדות tool search. כברירת מחדל, Claude Code שולח שדות כלי defer_loading ובלוקי tool_reference, עם כותרת anthropic-beta שמאפשרת אותם. לפני v2.1.304, tool search היה כבוי מאחורי gateway אלא אם הפעלת אותו עם ENABLE_TOOL_SEARCH.

#ההתחברות פגה

Claude Code ניסה לחדש את התחברות claude.ai השמורה ושירות OAuth דחה את אסימון הרענון השמור, ולכן Claude Code ניקה את האישורים השמורים. אחרי זה, כל בקשת מודל נעצרת מקומית עם ההודעה הזו לפני שהיא מגיעה ל-API, כי רק /login יכול ליצור אישורים חדשים.

לפני v2.1.206, Claude Code שלח בכל זאת את בקשת המודל עם כל אישור שנשאר בסביבה, וכל מודל נכשל עם יש בעיה במודל שנבחר או עם 401, במקום בקשה להתחבר.

Login expired · Please run /login

ב-מצב לא אינטראקטיבי (-p) וב-Agent SDK, ההודעה נקראת כך, וקוד השגיאה המובנה הוא authentication_failed:

Failed to authenticate: OAuth session expired and could not be refreshed

להודעת Login expired שמסתיימת ב-or re-authenticate your Anthropic profile, ראה התחברות פרופיל Anthropic פגה.

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

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

אפשר לבדוק את המצב הזה לפני שבקשה נכשלת: /status מציג שורת Login שקוראת Expired , log in again, וגם את הארגון ואת האימייל השמורים להתחברות שפגה. השורה מופיעה רק כשההתחברות השמורה היא האישור הפעיל וכבר אי אפשר לרענן אותה. סשנים שמאומתים בדרך אחרת לא מציגים את השורה, גם אם התחברות שפגה נשארת שמורה. לפני v2.1.210, /status לא נתן שום סימן במצב הזה שהייתה אי פעם התחברות, כי האישור שנוקה לא השאיר מה לדווח.

מה לעשות:

• הרץ /login כדי להתחבר מחדש. ניסיון חוזר בלי להתחבר מציג את אותה הודעה בכל בקשה.
• אם מתחברים עם חשבון claude.ai בחלון Claude Code אחר, ראה לא מחובר לגבי מתי הסשן הזה מתחיל להשתמש בהתחברות הזו מעצמו.
• במצב לא אינטראקטיבי, הרץ claude באותה סביבה, השלם /login, ואז הרץ שוב את הפקודה. לאוטומציה שלא יכולה להתחבר באופן אינטראקטיבי, אמת עם ANTHROPIC_API_KEY או צור אסימון ארוך טווח עם claude setup-token.
• אם ההתחברות ממשיכה להיכשל, ראה Login and authentication

#לא ניתן היה לרענן את ההתחברות כי תהליך אחר של Claude Code מרענן אותה

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

Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login

במצב לא אינטראקטיבי (-p) וב-Agent SDK, ההודעה נקראת כך, וקוד השגיאה המובנה הוא server_error:

Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again

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

מה לעשות:

• נסה שוב בעוד דקה. אם תהליך אחר משלים את הרענון קודם, הסשן הזה משתמש בהתחברות המחודשת.
• אם ההודעה ממשיכה לחזור, סגור חלונות ותהליכים אחרים של Claude Code, ואז נסה שוב.
• אם היא חוזרת כשאין תהליך אחר של Claude Code שרץ, הרץ את /login. התחברות מחדש לא ממתינה לנעילת הרענון.

#לא ניתן היה לשמור את ההתחברות

התחברת עם claude.ai, אבל Claude Code לא הצליח לשמור את ההתחברות במאגר האישורים שלו, ולכן ההתחברות לא הושלמה. ב-macOS זה יכול לקרות כשמחזיק המפתחות של ההתחברות ננעל, למשל בשינה או בחוסר פעילות, אחרי ש-Claude Code כבר קרא או שמר אישורים בו במהלך אותו סשן.

Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.
Couldn't save your login. Try logging in again.

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

מה לעשות:

• ב-macOS, בטל את נעילת מחזיק המפתחות של ההתחברות, ואז הרץ את /login שוב
• בפלטפורמות אחרות, הרץ את /login שוב
• אם ההתחברות עדיין לא נשמרת, ראה לא מחובר או שהאסימון פג לפקודת ביטול נעילת מחזיק המפתחות ולשלבים נוספים לשחזור אחסון האישורים

#התחבר שוב כדי להסיר את החשבון הקודם או את מפתח ה-API מקובץ התצורה

האזהרה הזו אחרי ההתחברות אומרת שכל חשבון שהיית מחובר איתו קודם עדיין עשוי להיות שמור ב-~/.claude.json:

Sign in again to take your previous account or API key off the config file.

מפתח API עדיין עשוי להיות ב-~/.claude.json גם אם התחברות ל-Console יצרה אחד ב-Linux או ב-Windows.

מה לעשות:

• הרץ את claude auth login במעטפת כדי להתחבר שוב. Claude Code מנסה שוב את השמירה שמסירה את החשבון או מפתח ה-API שהוחלפו מהקובץ.

#החשבון או מפתח ה-API עדיין עשויים להיות בקובץ התצורה

הרצת את /logout או את claude auth logout, ו-Claude Code ניתק את התהליך הזה אבל לא הצליח לאשר ש-~/.claude.json כבר לא מחזיק את החשבון. או שהשמירה לא נקלטה, או שלא ניתן היה לקרוא את הקובץ בחזרה כדי לבדוק.

Your account or API key may still be in the config file. Run claude auth logout.

מפתח API עדיין עשוי להיות ב-~/.claude.json גם אם התחברות ל-Console יצרה אחד ב-Linux או ב-Windows.

מה לעשות:

• הרץ את claude auth logout במעטפת כדי לנסות את השמירה שוב. כשהשמירה עוברת, הפקודה מדפיסה Successfully logged out from your Anthropic account.

#לא ניתן היה להפעיל את המאזין המקומי שמקבל את ההתחברות מהדפדפן

כל אחת מההודעות האלה מ-/login, מ-claude auth login, או מ-claude setup-token אומרת ש-Claude Code לא הצליח לפתוח את הפורט ב-127.0.0.1 שאליו הדפדפן מחזיר את תוצאת ההתחברות.

עם ההודעה שמתחילה ב-The browser can't return the sign-in to Claude Code automatically, ההתחברות ממשיכה בלי הפורט הזה. לא נפתח דפדפן, וההודעה מופיעה מעל כתובת URL שבה מתחברים במקום זאת:

The browser can't return the sign-in to Claude Code automatically. After you sign in, paste the code shown.

עם ההודעה שכוללת Couldn't start the local listener, ההתחברות נעצרה. זה קורה, למשל, כשמזרימים קלט אל claude auth login:

Couldn't start the local listener that receives the browser sign-in. Try again.

מה לעשות:

• The browser can't return the sign-in to Claude Code automatically: אין צורך לתקן דבר קודם. פתח בדפדפן את כתובת ה-URL שמוצגת מתחת להודעה והתחבר. הדפדפן מציג אז קוד: הדבק אותו ב-Claude Code בהנחיה Paste code here >, וההתחברות ממשיכה משם.
• Couldn't start the local listener that receives the browser sign-in: הרץ את אותה פקודה שוב. אם היא נעצרת באותו אופן, התחבר עם אסימון או מפתח API במקום הדפדפן. או, אם הזרמת קלט אל claude auth login, הרץ אותו במסוף כדי שיוכל לקבל קוד מודבק.
• כדי להתחבר עם אסימון או מפתח API במקום הדפדפן: אם משתמשים במנוי claude.ai, הרץ את claude setup-token במכונה שבה ההתחברות עובדת. אחר כך הגדר את האסימון שהפקודה מדפיסה כמשתנה הסביבה CLAUDE_CODE_OAUTH_TOKEN במכונה הזו. אחרת הגדר את משתנה הסביבה ANTHROPIC_API_KEY למפתח מ-Claude Console. עדיפות אימות מסבירה איך Claude Code בוחר בין אישורים.
• כדי להחזיר את ההחזרה האוטומטית מהדפדפן: Claude Code חייב להיות מסוגל להאזין ב-127.0.0.1. אם הוא רץ בתוך ארגז חול, בדוק שמדיניות ארגז החול מאפשרת האזנה בפורטים מקומיים, ואז התחבר שוב. אם ההאזנה אמורה לעבוד שם וההודעה עדיין מופיעה, הרץ את /feedback כדי שהדיווח יכלול את פרטי הסביבה.

לפני v2.1.305, ההתחברות נעצרה ברגע שלא ניתן היה לפתוח את הפורט ולא הציגה כתובת URL להתחברות. ההודעה נקראה, למשל, Failed to start OAuth callback server: Failed to start server. Is port 0 in use?. בגרסאות האלה, עדכן את Claude Code והתחבר שוב, או התחבר עם אסימון או מפתח API במקום הדפדפן.

#ההתחברות ל-Claude לא התקבלה

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

החלק הראשון של השורה הוא הסיבה של השרת עצמו כשהוא נותן אחת. אחרת השורה נקראת:

Claude login not accepted · Run /login, then try again

מה לעשות:

• הרץ את /login, השלם את ההתחברות, ואז התחל את הסשן שוב

#ל-Artifacts נדרשת התחברות ל-claude.ai

Claude Code סירב לפרסום או לקריאה של artifact כי לסשן אין התחברות ל-claude.ai שאפשר להשתמש בה ל-artifacts.

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

Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry , the "Anthropic Console account" option does not provide claude.ai credentials.

מה לעשות:

• הרץ את /login ובחר Claude account with subscription. האפשרות Anthropic Console account לא מספקת אישורי claude.ai.
• כשההודעה מציינת אישור שיש לו עדיפות, כמו ANTHROPIC_API_KEY, הגדרת apiKeyHelper, או מפתח Console שנשמר על ידי /login קודם, הסר אותו באופן שההודעה אומרת, ואז הרץ את /login
• כשההודעה אומרת שהסשן המרוחק הזה מאומת דרך המכונה שהפעילה אותו, התחבר ל-claude.ai במכונה הזו, ואז חבר מחדש את הסשן
• כשההודעה אומרת שהאישור מוזרק על ידי סביבת המארח של הסשן, אי אפשר לשנות אותו בסשן הזה. התחל סשן שמחובר ל-claude.ai
• ראה זמינות לדרישות האחרות שיש ל-artifacts, כמו תוכנית, ספק מודל ומדיניות ארגון

#מדיניות מנהל דורשת התחברות ל-Cloud gateway

הגדרות מנוהלות של מנהל במכונה הזו קבעו את forceLoginMethod ל-"gateway" או קבעו את forceLoginGatewayUrl. אלא אם בוחרים ספק ענן דרך משתנה כמו CLAUDE_CODE_USE_BEDROCK, Claude Code מקבל אז רק את התחברות ה-Claude apps gateway. רואים אחת משתי הודעות:

Not signed in to the Cloud gateway , run /login.

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

אם המכונה גם מחזיקה אישור שהונפק על ידי Anthropic וההגדרות המנוהלות קובעות את forceLoginMethod או את forceLoginOrgUUID, Claude Code יוצא בהפעלה במקום זאת. האישור הזה יכול להיות משתנה ANTHROPIC_API_KEY או ANTHROPIC_AUTH_TOKEN, הגדרת apiKeyHelper, או מפתח API שנשמר על ידי התחברות קודמת ל-Claude Console.

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

Administrator policy requires a Cloud gateway sign-in on this machine, but this session is configured with an API key from ANTHROPIC_API_KEY, which a gateway machine does not accept.

To continue: unset ANTHROPIC_API_KEY (or run in a shell without it), then run claude and sign in with /login.

מה לעשות:

• עבור Not signed in to the Cloud gateway, הרץ את /login והשלם את ההתחברות במסך Cloud gateway
• עבור הודעת ההפעלה, הסר את האישור לפי השלבים בסוף ההודעה
• אם לדעתך המכונה לא אמורה לדרוש את ה-gateway, בקש מהמנהל שמנהל אותה להסיר את forceLoginMethod ואת forceLoginGatewayUrl מההגדרות המנוהלות שלה

לפני v2.1.284, הודעת ההפעלה פירטה את האישורים האפשריים במקום לציין את האישור המוגדר. היא התחילה ב-Administrator policy requires a Cloud gateway sign-in on this machine; the Anthropic-issued credential configured here (ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used. אם רואים את הניסוח הזה ואי אפשר לדעת איזה אישור להסיר, עדכן ל-v2.1.284 או מאוחר יותר והפעל את claude שוב.

ב-v2.1.265, רגרסיה הציגה גם את ההודעה הראשונה בחלק מתצורות LLM-gateway ופרוקסי שמאמתות עם מפתח API, apiKeyHelper, או כותרות מותאמות, גם בלי דרישת מנהל במכונה. עדכן ל-v2.1.266 או מאוחר יותר. אין צורך לשנות את התצורה.

לפני v2.1.261, במכונות שקבעו את forceLoginMethod ל-"gateway", Claude Code השתמש בהתחברות שמורה שנשארה במקום לכשל בקשות מודל, ודיווח על אישור סביבה מוגדר עם This machine's managed settings require a first-party login במקום הודעת ההפעלה.

#החשבון שלך מושהה

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

Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted

התחברות מחדש עם אותו חשבון לא מנקה את ההודעה, כי ההשהיה חלה על החשבון ולא על ההתחברות. במצב לא אינטראקטיבי (-p) וב-Agent SDK, קוד השגיאה המובנה הוא account_on_hold. לפני v2.1.235, Claude Code דיווח על חשבון מושהה כ-Login expired · Please run /login, ששלבי השחזור שלו לא יכולים לנקות השהיה.

מה לעשות:

• פתח את הקישור בהודעה כדי לראות את פרטי ההשהיה או לערער עליה
• אם יש לך חשבון Claude אחר או מפתח API שההשהיה לא משפיעה עליהם, אפשר להמשיך לעבוד בזמן שההשהיה נפתרת: הרץ את /login עם החשבון הזה, או הגדר את המפתח עם ANTHROPIC_API_KEY

#ההתחברות של פרופיל Anthropic פגה

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

Anthropic profile login expired · Re-authenticate your Anthropic profile
Login expired · Run /login to sign in again, or re-authenticate your Anthropic profile

מה לעשות:

• אם ההודעה מתחילה ב-Login expired, הרץ את /login כדי להתחבר שוב
• כדי לחדש פרופיל שהתחברות Console בלי מפתח או ant auth login של Claude Platform CLI כתבו, הרץ את /login במכונה שמציעה את ההתחברות בלי מפתח. בחר את חשבון Anthropic Console, ואז Sign in with your Console account. Claude Code מחליף את האישור שפג בפרופיל הזה
• כדי לחדש פרופיל שכלי אחר יצר, התחבר שוב עם הכלי הזה. אם בוחרים Sign in with your Console account ב-/login במקום זאת, Claude Code משאיר את הפרופיל כפי שהוא ויוצר מפתח API
• אם מנהל הנפיק את האישור של הפרופיל, בקש ממנו להנפיק אחד חדש
• הרץ את /status כדי לאשר את מקור האישור הפעיל ואת שם הפרופיל
• כדי להפסיק להשתמש בפרופיל, בטל את ההגדרה של ANTHROPIC_PROFILE אם הגדרת אותו, ואז אמת בדרך אחרת, כמו /login או ANTHROPIC_API_KEY

האופן שבו ההודעה מתחילה אומר איך Claude Code מצא את הפרופיל:

• כש-Claude Code גילה את הפרופיל מתיקיית התצורה ומצב האימות שלו הוא user_oauth, ההודעה מתחילה ב-Login expired ומציעה את /login קודם. Claude Code נותן ל-/login שעובד עדיפות על הפרופיל שהתגלה ואז מאמת עם חשבון claude.ai במקום זאת. מ-v2.1.234 עד v2.1.277, הצורה הזו נקראה Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile. לפני v2.1.234, Claude Code הציג את הצורה Re-authenticate your Anthropic profile גם במקרה הזה.
• כשבחרת את הפרופיל עם ANTHROPIC_PROFILE, ההודעה מתחילה ב-Anthropic profile login expired.

זה מופיע רק כשהאישור הפעיל מגיע מפרופיל אישורים של Anthropic, אחד שבוחרים עם משתנה הסביבה ANTHROPIC_PROFILE, ש-Claude Code מגלה כפרופיל הפעיל בתיקיית התצורה של Anthropic, או ש-Claude Code כתב כשהתחברת בלי מפתח API. סשנים שמאמתים עם מפתח API, אסימון bearer כמו ANTHROPIC_AUTH_TOKEN, או ספק צד שלישי לעולם לא רואים את ההודעה הזו.

#דרישת היקף OAuth

האסימון השמור קודם להיקף הרשאה שתכונה חדשה יותר צריכה:

OAuth token does not meet scope requirement: user:profile

מה לעשות:

• הרץ את /login כדי לקבל אסימון חדש עם ההיקפים הנוכחיים. אין צורך להתנתק קודם.

#claude.ai דחה את אסימון הסשן

בקשת מחבר claude.ai נכשלה כי claude.ai דחה את האסימון מהתחברות Claude Code. האסימון שנדחה הוא ההתחברות שלך, לא ההרשאה של המחבר עצמו ב-claude.ai, ולכן הרשאה מחדש של המחבר לא פותרת את זה. ב-/mcp, המחבר מוצג כ-session token rejected ותצוגת הפרטים שלו נקראת:

claude.ai rejected the session token. Run /login, then reconnect.

מה לעשות:

• הרץ את /login כדי להתחבר שוב
• חבר מחדש את המחבר מ-/mcp, או הרץ את /mcp reconnect <server>. חיבור מחדש לפני שמתחברים שוב משאיר את המחבר באותו מצב. האפשרות Reconnect בלוח /mcp מדווחת your claude.ai session token was rejected. הצורה המוקלדת /mcp reconnect <server> מדווחת על חיבור מחדש מוצלח גם כשהאסימון עדיין נדחה.

לפני v2.1.222, Claude Code סימן את המחבר כזקוק לאימות במקום זאת, מה שהפנה אל זרימת ההרשאה של המחבר גם כשהשלמתה לא פתרה את המצב.

#שרת MCP צריך שתיכנס שוב

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

עבור שרת שאליו נכנסים מתוך Claude Code, כולל מחבר claude.ai, הכניסה פגה או בוטלה:

MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)

הרץ את /mcp, בחר את השרת, והיכנס שוב מהתפריט שלו.

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

MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)

בדוק שהעוזר מחזיר אישור שהשרת מקבל, ואז התחבר מחדש מ-/mcp, מה שמריץ את העוזר שוב.

עבור שרת עם כותרת Authorization סטטית בהגדרה שלו:

MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)

עדכן את ערך הכותרת במקום שבו השרת מוגדר, ואז התחבר מחדש מ-/mcp.

בסשן Cowork במחשב שלך באפליקציית Claude Desktop, ההודעות האלה אומרות ששרת ה-MCP דחה אישור שניתן לו. תקן את מה שההודעה מציינת, ואז התחל משימה או צ'אט חדשים ב-Cowork:

MCP server "<name>" rejected the credential from its headersHelper (check the helper, then start a new task or chat)
MCP server "<name>" rejected the Authorization header in its config (update it, then start a new task or chat)

• אישור headersHelper נדחה: בדוק שהעוזר מחזיר אישור שהשרת מקבל, ואז התחל משימה או צ'אט חדשים ב-Cowork
• כותרת Authorization נדחתה: עדכן את ערך Authorization תחת headers בהגדרה של השרת הזה, ואז התחל משימה או צ'אט חדשים ב-Cowork

לפני v2.1.302, סשן Cowork הציג במקום זאת את הסיומות run /mcp to reconnect, אף על פי ש-/mcp לא זמין שם. אם אתה רואה סיום כזה ב-Cowork, עדיין בדוק את העוזר או עדכן את הכותרת, ואז התחל משימה או צ'אט חדשים. לפני v2.1.273, מקרי הכניסה שפגה, headersHelper, וכותרת Authorization כולם הציגו MCP server "<name>" requires re-authorization (token expired).

שרת יכול גם לסרב לקריאת כלי עם HTTP 403 insufficient_scope כדי לבקש ממך לאשר scope, לפעמים אחד שהטוקן שלך כבר מציין. ההודעה מציינת את ה-scope הזה:

MCP server "<name>" needs additional permissions (scope: "<scope>") , run /mcp to re-authenticate

הרץ את /mcp, בחר את השרת, ואמת שוב מהתפריט שלו.

כשההגדרה של השרת לא קובעת לא את oauth.scopes ולא את authServerMetadataUrl, Claude Code מבקש את ה-scope שהשרת ציין. עם אחת מההגדרות האלה, Claude Code מבקש את ה-scopes של ההגדרה הזו. אם קיבעת את oauth.scopes, הוסף את ה-scope החסר לרשימה הזו לפני שתאמת שוב.

לפני v2.1.274, המקרה הזה הציג את ההודעה needs you to sign in again, ולפני v2.1.273 הוא הציג requires re-authorization (token expired) כמו המקרים האחרים.

#לא ניתן לקרוא את האישורים השמורים עבור שרת MCP

Claude Code שומר את הכניסות שלך לשרתי MCP של OAuth במאגר אישורים. ההודעה הזו אומרת ש-Claude Code לא הצליח לקרוא את המאגר הזה, ולכן בקשה לשרת לא רצה:

Couldn't read the stored credentials for MCP server "<name>", so the request didn't run. If your Mac's keychain is locked, unlock it, then try again.
Couldn't read the stored credentials for MCP server "<name>", so the request didn't run. Try again.

הכניסות השמורות שלך לא השתנו: נסה שוב ברגע שאפשר לקרוא את המאגר, והיכנס שוב רק אם השרת מבקש זאת אחר כך.

בהרצה של claude -p או Agent SDK ב-macOS, מחזיק המפתחות יכול להפוך לקריא אחרי שבקשה כבר יצאה בלי הכניסה השמורה. הבקשה הזו נכשלת עם:

A request to MCP server "<name>" was sent without your stored credentials, so the server rejected it. The credentials are available now. Try again.

מה לעשות:

• אם ההודעה מבקשת ממך לפתוח את מחזיק המפתחות של ה-Mac, הרץ את claude doctor בסשן המעטפת שממנו אתה מריץ את Claude Code, ובדוק בדוח אזהרת keychain:

  • אם הדוח מציין אזהרה שמתחילה ב-macOS Keychain is not writable, או שלמעטפת שלך אין פקודת claude, הרץ את פקודת הפתיחה הזו באותו סשן מעטפת:

    העתק

    security unlock-keychain ~/Library/Keychains/login.keychain-db

  • אם הדוח לא מציין אזהרת keychain, דלג על פקודת הפתיחה

• נסה שוב במקום שבו ראית את ההודעה:

  • עבור claude -p, הרץ את הפקודה שוב
  • בסשן אינטראקטיבי, התחבר מחדש לשרת מ-/mcp אם הוא מוצג שם כנכשל, ואז בקש מ-Claude לנסות שוב
  • באפליקציית Agent SDK שממשיכה לרוץ, קרא ל-reconnectMcpServer() ב-TypeScript או ל-ClaudeSDKClient.reconnect_mcp_server() ב-Python, או התחל סשן חדש

• אם השרת מדווח אחר כך שהוא צריך אימות, Claude Code לא מצא כניסה שאפשר להשתמש בה עבור השרת הזה. היכנס באופן אינטראקטיבי: הרץ את /mcp בסשן Claude Code, או את claude mcp login <name> במעטפת. באפליקציית Agent SDK, ראה אימות OAuth2 ב-Agent SDK.

לפני v2.1.307, הרצה של claude -p או Agent SDK ב-Mac עם login keychain נעול דיווחה שהשרת צריך אימות במקום להציג אחת משתי ההודעות.

#כתובת ה-URL של שרת MCP חסרה או אינה URL תקין

Claude Code סירב להתחיל כניסת OAuth לשרת MCP מרוחק כי ה-url המוגדר של השרת לא מנותח כ-URL. אלא אם ל-Claude Code יש בעיית הגדרה ספציפית יותר לדווח עבור השרת, הרצה של claude mcp login <name> במעטפת מדפיסה את הסירוב כך:

Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.

מה לעשות:

• קבע את url של הרשומה לנקודת הקצה האמיתית של השרת במקום שבו השרת מוגדר, או קבע את משתנה הסביבה שהפניית ${VAR} מציינת, ואז הרץ את הכניסה שוב.

#אי התאמה של מנפיק בתשובת ההרשאה

במהלך כניסת OAuth ל-MCP, שרת ההרשאה הפנה חזרה ל-Claude Code עם פרמטר iss שלא מציין את המנפיק ש-Claude Code ציפה לו ממטא-דאטת ה-OAuth של השרת. מנפיק שגוי בשלב הזה הוא איך נראית התקפת ערבוב של שרתי הרשאה, ולכן Claude Code נכשל בכניסה במקום להחליף את קוד ההרשאה. Claude Code מציג את השגיאה בתפריט השרת של /mcp אחרי כניסת הדפדפן:

Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"

expected הוא המנפיק ממטא-דאטת ה-OAuth של השרת, ו-received הוא ערך ה-iss שההפניה נשאה. כניסה שההפניה שלה לא נושאת פרמטר iss עוברת את הבדיקה, אלא אם המטא-דאטה של השרת קובעת את authorization_response_iss_parameter_supported, ובמקרה הזה Claude Code נכשל בכניסה.

מה לעשות:

• נסה את הכניסה שוב מ-/mcp
• אם השגיאה חוזרת, דווח עליה למפעיל השרת. התיקון הוא בצד השרת: שרת ההרשאה חייב להחזיר בפרמטר iss את אותו מנפיק שהוא מפרסם במטא-דאטה שלו
• כדי להתחבר בזמן שהשרת מתוקן, התחל את Claude Code עם MCP_SDK_GENERATION=v1, שה-runtime שלו לא מריץ את הבדיקה הזו. זה מסיר הגנה מפני התקפות ערבוב, ולכן עדיף התיקון בצד השרת

לפני v2.1.232, Claude Code השתמש ב-runtime של v2 רק בפריסה הדרגתית או כשקבעת MCP_SDK_GENERATION=v2.

#סירוב לשלוח אישורים לנקודת קצה של טוקן שאינה https

ב-runtime של v2, Claude Code שולח בקשת טוקן של OAuth ל-MCP רק לנקודת קצה של טוקן שמוגשת ב-HTTPS או ב-localhost, 127.0.0.1, או ::1. ההודעה הזו אומרת שנקודת הקצה של הטוקן של השרת אינה אף אחת מאלה, ולכן Claude Code עצר לפני שליחת הבקשה. זה קורה אחרי כניסת הדפדפן, כך ששלב הדפדפן מצליח קודם, ושוב בכל פעם ש-Claude Code מרענן את הטוקן של השרת.

בצורה המלאה שלה, ההודעה מגיעה מ-MCP SDK ומצטטת את נקודת הקצה של הטוקן שסירב לה. ביומן הדיבוג, היא באה אחרי Error during auth completion: עבור כניסה או Token refresh failed: עבור רענון. במעטפת, claude mcp login <name> מדפיס אותה אחרי Couldn't complete authentication for "<name>":, ובסשן, /mcp מציג אותה תחת תפריט השרת:

Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).

Claude Code מתייחס לכתובת URL של שרת שיש בה מחרוזת שאילתה או מקטע נתיב ארוך שנראה אקראי כאפשרות שהיא סוד. עבור שרת כזה, הוא מצנזר את שגיאות הכניסה ש-MCP SDK מעלה לפני שהוא מציג או רושם אותן. השגיאה הזו נקראת אז כשם קצר שיכול להשתנות בין גרסאות, כמו io, ואחריו from the MCP SDK for וכתובת ה-URL המצונזרת של השרת. שגיאות אחרות מ-MCP SDK מקבלות שם את אותה צורה. ההודעה המצונזרת יכולה להיות השגיאה הזו רק כשנקודת הקצה של הטוקן של השרת היא http:// רגיל בכתובת שאינה localhost, 127.0.0.1, או ::1.

מה לעשות:

• הגש את נקודת הקצה הזו של הטוקן ב-HTTPS, למשל על ידי הצבת השרת מאחורי reverse proxy או מנהרה שמסיימים TLS והגדרת השרת כך שיפרסם את כתובת https://
• כדי להתחבר בלי לשנות את השרת, התחל את Claude Code עם MCP_SDK_GENERATION=v1, שה-runtime שלו לא מחיל את הכלל הזה ושולח את בקשת הטוקן ב-HTTP רגיל. הבחירה הזו נמשכת עד שתצא וחלה על כל שרת. ה-runtime של v1 גם מדלג על בדיקת המנפיק, ולכן עדיף להגיש את נקודת הקצה ב-HTTPS

#אישורי AWS פגו או לא תקינים

טוקן הסשן של AWS שלך פג או נדחה. ההודעה הזו מופיעה על 401 מ-Claude Platform on AWS או מנקודת הקצה Mantle, וכך הספקים האלה מדווחים על טוקן אבטחה שפג.

רמז הפעולה באמצע משתנה לפי ההגדרה שלך. החלק היציב הוא הפתיח AWS credentials expired or invalid:

AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...

לפני v2.1.273, ההודעה הזו הופיעה רק כש-awsAuthRefresh היה מוגדר.

מה לעשות:

• אם הרמז אומר שהאישורים מנוהלים על ידי הסביבה הזו, האפליקציה שהפעילה את Claude Code היא הבעלים של האישור והשלבים האחרים כאן לא חלים: נסה שוב, או פנה למנהל המערכת
• אם awsAuthRefresh מוגדר, הרץ את הפקודה ששמה מופיע בהודעה, כמו aws sso login --profile myprofile, במסוף אחר והשלם את כניסת הדפדפן, ואז נסה שוב. אחרת רענן בעצמך את אישור ה-AWS שבו אתה משתמש: כניסת ה-SSO שלך, מפתחות גישה, מפתח API, או טוקן פרוקסי
• כש-awsAuthRefresh מוגדר בסשן אינטראקטיבי, אפשר להריץ את /login, לבחור 3rd-party platform, ואז לבחור Claude Platform on AWS · refresh credentials תחת Using 3rd-party platforms כדי להריץ את אותה פקודה בלי להפעיל מחדש את Claude Code. ראה הגדרת אישורי AWS
• אם השגיאה חוזרת אחרי שפקודת הרענון מצליחה, אשר שהזהות תקינה מחוץ ל-Claude Code עם aws sts get-caller-identity באותה מעטפת ובאותו פרופיל

#אימות AWS נכשל

ספק ה-AWS שלך החזיר 403, או Amazon Bedrock החזיר 401.

Amazon Bedrock מדווח על טוקן אבטחה שפג כ-403, אבל 403 הוא גם האופן שבו הוא מדווח על סירוב הרשאה, כמו AccessDeniedException מהרשאת IAM חסרה. Claude Code לא יכול להבחין בין שני הגורמים האלה.

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

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

AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...

רמז הפעולה באמצע משתנה לפי ההגדרה שלך. החלק היציב הוא הפתיח AWS authentication failed.

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

לפני v2.1.273, ההודעה הזו הופיעה רק כש-awsAuthRefresh היה מוגדר.

מה לעשות:

• אם הרמז אומר שהאישורים מנוהלים על ידי הסביבה הזו, האפליקציה שהפעילה את Claude Code היא הבעלים של האישור והשלבים האחרים כאן לא חלים: נסה שוב, או פנה למנהל המערכת
• רענן את אישורי ה-AWS למקרה שאישור שפג הוא הגורם: הרץ את פקודת awsAuthRefresh ששמה מופיע בהודעה כשאחת מוגדרת, או רענן בעצמך את כניסת ה-SSO, מפתחות הגישה, מפתח ה-API, או טוקן הפרוקסי
• אם האישורים שלך עדכניים, אשר שהרשאות ה-IAM בהגדרת IAM משויכות לזהות שבה אתה משתמש ושהמודל שנבחר מופעל עבור החשבון והאזור שלך
• הרץ את aws sts get-caller-identity כדי לאשר באיזו זהות הבקשות שלך משתמשות

#אישורי Google Cloud פגו או לא תקינים

אישורי Google Cloud שלך עבור Agent Platform של Google Cloud פגו או נדחו: הבקשה החזירה 401, וכך Agent Platform מדווח על תפוגת אישור.

רמז הפעולה באמצע משתנה לפי ההגדרה שלך. החלק היציב הוא הפתיח Google Cloud credentials expired or invalid:

Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...

מה לעשות:

• אם הרמז אומר שהאישורים מנוהלים על ידי הסביבה הזו, האפליקציה שהפעילה את Claude Code היא הבעלים של האישור והשלבים האחרים כאן לא חלים: נסה שוב, או פנה למנהל המערכת
• אם אתה מאמת עם application default credentials, הרץ את פקודת gcpAuthRefresh ששמה מופיע בהודעה, או את gcloud auth application-default login, והשלם את הכניסה, ואז נסה שוב
• אם אתה מנתב דרך LLM gateway עם CLAUDE_CODE_SKIP_VERTEX_AUTH מוגדר, רענן את טוקן ה-gateway ב-ANTHROPIC_AUTH_TOKEN או ב-ANTHROPIC_CUSTOM_HEADERS, ואז נסה שוב
• אם אתה מאמת עם קובץ מפתח של service account, אשר ש-GOOGLE_APPLICATION_CREDENTIALS מצביע על מפתח תקין. ראה הגדרת אישורי GCP
• אם השגיאה חוזרת אחרי רענון, אשר שהזהות עובדת מחוץ ל-Claude Code עם gcloud auth application-default print-access-token באותה מעטפת

לפני v2.1.273, 401 מ-Agent Platform הציג את ההודעה הגנרית Please run /login או Failed to authenticate, שאינה יכולה לרענן אישורי Google Cloud.

#אימות Google Cloud נכשל

Agent Platform של Google Cloud החזיר 403, קוד שהוא משתמש בו לדחיות הרשאה ולא לאישורים שפג תוקפם. בדרך כלל לזהות שאתם מאמתים איתה חסרה הרשאת IAM, או שהמודל לא מופעל עבור הפרויקט שלכם.

רמז הפעולה באמצע משתנה לפי ההגדרה שלכם. החלק היציב הוא הפתיח Google Cloud authentication failed:

Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...

מה לעשות:

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

לפני v2.1.273, תשובת 403 מ-Agent Platform הציגה את ההודעה הגנרית Please run /login או Failed to authenticate, שאינה יכולה לרענן אישורי Google Cloud.

#אימות Microsoft Foundry נכשל

Microsoft Foundry החזיר 401 או 403: אישור Azure שבבקשה נדחה, או שלזהות שמאחוריו אין גישה למשאב Foundry. /login לא יכול להנפיק אישורי Azure. רמז הפעולה באמצע משתנה לפי ההגדרה שלכם. החלק היציב הוא הפתיח Microsoft Foundry authentication failed:

Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...

מה לעשות:

• אם הרמז אומר שהאישורים מנוהלים על ידי סביבה זו, האפליקציה שהפעילה את Claude Code היא הבעלים של האישור והשלבים האחרים כאן לא חלים: נסו שוב, או פנו למנהל המערכת שלכם
• רעננו את האישור שהגדרתם בהגדרת אישורי Azure: בצעו רוטציה ל-ANTHROPIC_FOUNDRY_API_KEY, הנפיקו ANTHROPIC_FOUNDRY_AUTH_TOKEN חדש, או הריצו az login כדי ששרשרת אישורי Microsoft Entra כברירת מחדל תוכל להתחבר שוב
• אם האישור עדכני, אשרו שלזהות יש גישה למשאב Foundry. ראו הגדרת Azure RBAC

לפני v2.1.273, תשובת 401 או 403 מ-Microsoft Foundry הציגה את ההודעה הגנרית Please run /login או Failed to authenticate, שאינה יכולה לרענן אישורי Azure.

#לא ניתן היה לטעון אישורי AWS או Google Cloud

Claude Code לא הצליח לקבל אישורים שמישים משרשרת ספקי האישורים של AWS או מאישורי application default של Google במכונה שעליה הוא רץ, ולכן אף בקשה לא הגיעה לספק הענן שלכם. הפירוט שאחרי · מציין את הסיבה המסוימת, למשל סשן SSO שפג תוקפו, אישורי application default חסרים שמדווחים כ-Could not load the default credentials, או התחברות שנשללה שמדווחת כ-invalid_grant:

API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.

במצב לא אינטראקטיבי עם -p וב-Agent SDK, קוד השגיאה המובנה הוא cloud_credential_error. לפני v2.1.267, ההודעה הציגה רק את טקסט הפירוט שאחרי API Error:, והקוד המובנה היה server_error או unknown.

מה לעשות:

• הריצו את פקודת ההתחברות של הספק, למשל aws sso login --profile myprofile או gcloud auth application-default login, ואז נסו שוב. אישורי Bedrock, Agent Platform או Foundry לא נטענים מראה איך לוודא את האישורים מחוץ ל-Claude Code
• אם הפירוט הוא AWS default-chain credential resolve timed out, השרשרת נתקעה ולא נכשלה, ולכן עקבו אחרי פג הזמן לפתרון אישורי שרשרת ברירת המחדל של AWS במקום זאת

#פג הזמן לפתרון אישורי שרשרת ברירת המחדל של AWS

שרשרת ספקי אישורי ברירת המחדל של AWS לא הפיקה אישורים בתוך 60 שניות, ולכן Claude Code עצר את הפתרון והכשיל את הבקשה. פסק זמן זה הוא אחת הסיבות ללא ניתן היה לטעון אישורי AWS או Google Cloud. הכשל הוא פתרון אישורים מקומי: הבקשה מעולם לא הגיעה אל Amazon Bedrock, אל Claude Platform on AWS, או אל נקודת הקצה Mantle. Claude Code מנקה את מטמון האישורים שלו ומנסה שוב לפני שהשגיאה הזו מופיעה, כך שעד שאתם רואים אותה השרשרת נתקעה בניסיונות חוזרים.

API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.

סיבות נפוצות הן פקודת credential_process בפרופיל AWS שלכם שממתינה לקלט שהיא לא יכולה לקבל, ומכולה או מכונה וירטואלית ששירות המטא-דאטה של המופע (IMDS) שלה אף פעם לא עונה על הבדיקה של השרשרת.

לפני v2.1.267, ההודעה הייתה API Error: AWS default-chain credential resolve timed out. לפני v2.1.207, שרשרת שנתקעה השאירה את הבקשה ממתינה ללא הגבלת זמן במקום להיכשל.

מה לעשות:

• הריצו aws sts get-caller-identity באותה מעטפת עם אותו AWS_PROFILE. אם גם היא נתקעת, תקנו את הפרופיל. פקודת credential_process שמבקשת קלט באופן אינטראקטיבי היא סיבה נפוצה.
• השלימו את שלב ההתחברות לפני הפעלת Claude Code, למשל aws sso login --profile myprofile
• אם השרשרת שלכם מריצה התחברות אינטראקטיבית שזקוקה באופן לגיטימי ליותר מ-60 שניות, למשל SSO עם MFA דרך מעטפת כמו aws-vault, העלו את המגבלה באלפיות השנייה עם CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS

#אימות הגדרת Bedrock פג זמן בהמתנה ל-AWS

קריאה ל-AWS במהלך אימות האישורים של אשף הגדרת Bedrock, למשל איתור האישור או בדיקת הזהות, לא הסתיימה בתוך מגבלת 60 השניות. האשף מפסיק להמתין ומכשיל את שלב האימות:

Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.

המספר משקף את המגבלה שלכם: 60 שניות כברירת מחדל, או הערך שהגדרתם ב-CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.

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

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

A request to AWS timed out. Check your network and proxy settings, then try again.

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

מה לעשות:

• הריצו aws sts get-caller-identity באותה מעטפת. אם גם היא נתקעת, העצירה היא מחוץ ל-Claude Code, ברשת שלכם, בפרוקסי שלכם, או בעוזר האישורים בפרופיל AWS שלכם. תקנו זאת קודם.
• השלימו כל התחברות אינטראקטיבית לפני פתיחת האשף, למשל aws sso login --profile myprofile
• אם עוזר אישורים בפרופיל AWS שלכם זקוק באופן לגיטימי ליותר מ-60 שניות כדי לבקש מכם קלט, העלו את המגבלה באלפיות השנייה עם CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS

#פג תוקף סשן שער הענן

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

Cloud gateway session expired , run /login to reconnect.

אותה שורה יכולה להופיע באמצע הסשן כאשר אישור השער פג תוקף ו-Claude Code לא יכול לחדש אותו.

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

Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.

מה לעשות:

• הריצו /login בסשן והשלימו את ההתחברות בדפדפן
• להפעלה לא אינטראקטיבית, הפעילו את claude באותה סביבה, הריצו /login, ואז הריצו מחדש את הפקודה

#פג הזמן של ההתחברות בזמן ההמתנה שתמשיכו

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

Sign-in timed out while waiting for you to continue. Try again.

מה לעשות:

• הריצו /login שוב ואשרו את החשבון לפני שפג תוקף ההתחברות

#השער דחה את הבקשה

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

Gateway refused the request · signing in again won't change this , check with your gateway administrator · API Error: 403 ...

מה לעשות:

• בקשו ממנהל השער לאתר את הבקשה. הזנב API Error: נושא את הדחייה שהשער החזיר
• למנהלים: כלל בקרת גישה בשער מחזיר 403 שיומן הביקורת רושם עם הסיבה שלו, ודחיית הרשאה של מעלה הזרם עוברת הלאה לפי הודעות שגיאה ממעלה הזרם

לפני v2.1.273, תשובת 403 בסשן שער הציגה את ההודעה הגנרית Please run /login או Failed to authenticate, והתחברות מחדש לא הסירה את הדחייה.

#שגיאות רשת וחיבור

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

#לא ניתן להתחבר ל-API

חיבור ה-TCP אל ה-API נכשל או שמעולם לא הושלם. עבור קודי שגיאת החיבור הנפוצים, ההודעה מציינת את סוג הכשל ושומרת את הקוד בסוגריים:

Unable to connect to API. Check your internet connection
Connection refused , a firewall or proxy may be blocking it (ConnectionRefused)
Can't reach the API server , check your internet or DNS (ENOTFOUND)
No internet route , check your connection or VPN (EHOSTUNREACH)
Couldn't connect through your proxy (ERR_PROXY_TUNNEL) , the proxy refused the tunnel: check its credentials and that it allows this host
Connection dropped (ECONNRESET)
Request timed out. Check your internet connection and proxy settings

קוד ש-Claude Code לא מזהה מופיע כ-Unable to connect to API ואחריו הקוד בסוגריים. חלק מההודעות האלה יכולות להציג יותר מקוד אחד: Connection refused יכול להציג ConnectionRefused או ECONNREFUSED, למשל, ו-Can't reach the API server יכול להציג ENOTFOUND או FailedToOpenSocket.

לפני v2.1.227, כל אחת מההודעות המקודדות האלה נקראה Unable to connect to API ואחריה הקוד, למשל Unable to connect to API (ECONNREFUSED).

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

מה לעשות:

• אשרו שאתם יכולים להגיע אל מארח ה-API מאותה מעטפת באמצעות הרצת curl -I https://api.anthropic.com. ב-Windows PowerShell השתמשו ב-curl.exe -I https://api.anthropic.com כדי שלא ייעשה שימוש בכינוי המובנה Invoke-WebRequest.
• אם אתם מאחורי פרוקסי ארגוני, הגדירו HTTPS_PROXY לפני הפעלת Claude Code וראו הגדרת רשת
• אם אתם מנתבים דרך שער LLM או ממסר, הגדירו את ANTHROPIC_BASE_URL לכתובת שלו. ראו חיבור Claude Code לשער LLM להגדרה.
• אם ANTHROPIC_BASE_URL כבר מצביע על השער שלכם וכל בקשה מסתיימת ב-Connection dropped, בדקו שהשער ומעלה הזרם שלו מקבלים שדות חיפוש כלים. כברירת מחדל, Claude Code שולח שדות כלי defer_loading ובלוקי tool_reference, עם כותרת anthropic-beta שמפעילה אותם. לפני v2.1.304, חיפוש הכלים היה כבוי מאחורי שער אלא אם הפעלתם אותו עם ENABLE_TOOL_SEARCH.
• ודאו שחומת האש שלכם מתירה את המארחים המפורטים בדרישות גישת רשת
• כשלים לסירוגין מנוסים מחדש אוטומטית

אם curl מצליח אבל Claude Code עדיין נכשל, הסיבה בדרך כלל היא משהו בין סביבת הריצה לבין הרשת, ולא הרשת עצמה:

• בדקו אם ANTHROPIC_BASE_URL מוגדר באמצעות הרצת echo $ANTHROPIC_BASE_URL, או echo $env:ANTHROPIC_BASE_URL ב-PowerShell, וחפשו אותו בבלוק env של קובצי ההגדרות שלכם. כאשר הוא מוגדר, Claude Code שולח בקשות מודל לכתובת הזו במקום אל api.anthropic.com, כך שערך שנותר ומצביע על פרוקסי מקומי או שער שכבר לא רץ מייצר Connection refused אף ש-curl מגיע אל ה-API. הסירו אותו מפרופיל המעטפת או מההגדרות והפעילו את Claude Code ממסוף חדש.
• ב-Linux וב-WSL, בדקו ב-/etc/resolv.conf אם יש שרת שמות שאינו נגיש. WSL בפרט יכול לרשת resolver שבור מהמארח.
• ב-macOS, לקוח VPN שנותק או שהוסר יכול להשאיר אחריו ממשק מנהרה או כלל ניתוב. בדקו ב-ifconfig ממשקי utun ישנים והסירו את הרחבת הרשת של ה-VPN ב-System Settings.
• Docker Desktop וסביבות ריצה דומות של מכולות יכולים ליירט תעבורה יוצאת. צאו מהם ונסו שוב כדי לשלול זאת.

#אין אפשרות להתחבר לשירותי Anthropic

במהלך הגדרת ההפעלה הראשונה, Claude Code בודק שהוא יכול להגיע אל api.anthropic.com ואל platform.claude.com לפני שהוא מציג את שלב הכניסה. כשאחת הבדיקות נכשלת, Claude Code מדפיס את הסיבה ויוצא.

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ECONNREFUSED
Connection to api.anthropic.com timed out after 10 seconds
A proxy is configured via HTTPS_PROXY. Check that it allows connections to the host above.

Claude Code שולח את הבדיקה דרך אותה הגדרת פרוקסי כמו בקשות API, ונותן לכל בדיקה 10 שניות. כשהבדיקה שנכשלה עברה דרך פרוקסי, ההודעה מציינת את משתנה הסביבה שהגדיר אותו, למשל HTTPS_PROXY. לפני v2.1.222, הבדיקה השתמשה בהעברת פרוקסי אחרת בלי timeout: מאחורי כתובת פרוקסי עם הסכמה https://, היא יכלה להיתקע על Checking connectivity... בלי הגבלת זמן, ואז להיכשל, אף על פי שבקשות API דרך אותו פרוקסי מצליחות.

Claude Code מדלג על הבדיקה הזו כשקובץ הגדרות מנוהל, מדיניות MDM, או policy helper מגדיר את forceLoginMethod ל-"gateway", או מגדיר את forceLoginGatewayUrl בלי forceLoginMethod. עם כל אחת משתי ההגדרות, Claude Code פותח את שלב הכניסה במסך Cloud gateway במקום שיטת כניסה של Anthropic. Claude Code גם מדלג על הבדיקה כשמקור הגדרות מנוהלות קיים במחשב אבל אי אפשר לקרוא אותו, כי המקור הזה עשוי להחזיק את הגדרת ה-gateway. לפני v2.1.247, Claude Code הריץ את הבדיקה גם תחת ההגדרה הזו, ויצא עם השגיאה הזו כשנקודות הקצה של Anthropic לא היו נגישות.

Claude Code גם מדלג על הבדיקה במחשב בלי הגדרות מנוהלות, כשקובץ ~/.claude/settings.json שלכם מציין gateway עם forceLoginMethod ו-forceLoginGatewayUrl. לפני v2.1.295, Claude Code הריץ את הבדיקה במקרה הזה.

מה לעשות:

1. אם ההודעה מציינת משתנה פרוקסי, בדקו שהערך שלו מצביע על הפרוקסי הנכון, ובקשו מצוות הרשת לאפשר דרכו חיבורי HTTPS אל המארח שמופיע בהודעה. ראו הגדרת רשת.
2. עברו על הבדיקות באין אפשרות להתחבר ל-API. בדיקת curl וההנחיה על חומת האש שם חלות גם על הבדיקה הזו.
3. אם הרשת פתוחה והכישלון נמשך, ייתכן ש-Claude Code אינו זמין במדינה שלכם

#Socket is closed

Socket is closed אומר שהחיבור שנשא תשובת סטרימינג נסגר בזמן שהתשובה עדיין הגיעה. הסיבה הנפוצה ביותר היא פרוקסי ארגוני ב-Windows שמפיל מנהרה שכבר נפתחה באמצע התשובה.

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

לפני v2.1.214, Claude Code לא ניסה שוב את הכישלון הזה, והתור נעצר עם שגיאה שמכילה Socket is closed.

מה לעשות:

1. אם אתם רואים את השגיאה הזו, עדכנו ל-v2.1.214 או חדש יותר עם claude update, ואז שלחו שוב את ההודעה
2. אם תורים ממשיכים להיכשל מאחורי אותו פרוקסי אחרי העדכון, עברו על אין אפשרות להתחבר ל-API ובדקו את הגדרת הפרוקסי בהגדרת רשת

#ה-API החזיר תשובה ריקה או פגומה

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

API returned an empty or malformed response (HTTP 200) , check for a proxy or gateway intercepting the request.

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

• סעיף Response: עם סוג התוכן, סוג הגוף, למשל body is an HTML page או empty body, הגודל שלו בבתים, והאם התשובה נשאה מזהה בקשה של Anthropic. כשהתשובה מציינת שרת מוכר, למשל nginx או cloudflare, או נושאת כותרות של מתווך, למשל cf-ray או via, הסעיף מציין גם אותן.
• משפט שמציין את מזהה בקשת הסטרימינג שנכשלה ואת הכישלון שהפעיל את הניסיון החוזר. כשזרם נפתח לפני הכישלון, הוא גם מדווח כמה אירועי זרם הגיעו, ואם הגיעו, כמה זמן הזרם היה שקט כשהניסיון נכשל.

לפני v2.1.234, ההודעה הסתיימה אחרי intercepting the request.

לפני v2.1.271, תשובה שנשאה הודעת API תקינה תחת סוג תוכן שאינו JSON, למשל text/plain, גם סיימה את התור עם השגיאה הזו. חלק משערי LLM משתמשים בסוג התוכן הזה לתשובה בלי סטרימינג.

מה לעשות:

1. קראו את סעיף Response: כדי לראות איזו מערכת ענתה. גוף HTML, היעדר מזהה בקשה של Anthropic, או שרת בשם כמו nginx או cloudflare אומרים שמשהו בין Claude Code ל-API ענה במקומו
2. אם אתם מנתבים דרך LLM gateway, בדקו את המסלול בבקשה ישירה ותקנו את הקפיצה שמחזירה את התשובה שאינה מה-API
3. ברשת עם דף כניסה, למשל Wi-Fi לאורחים, השלימו את הכניסה בדפדפן, ואז נסו שוב
4. אם רק המסלול בלי סטרימינג דרך ה-gateway שלכם שבור, הגדירו CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1 כדי לכבות את ה-fallback הזה, חוץ מהמקרה שבו נקודת קצה הסטרימינג עצמה מחזירה 404, ובו Claude Code עדיין נופל חזרה

#תשובת הסטרימינג הסתיימה לפני שהתקבל נתון שלם כלשהו

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

Streaming response ended before any complete data was received. Retrying without streaming. If this keeps happening, check any proxy or gateway between Claude Code and your model provider.

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

מה לעשות:

1. הגדירו כל פרוקסי או gateway בין Claude Code לספק המודל שלכם כך שיעביר גופי תשובות סטרימינג ואת הכותרות שלהם בלי שינוי
2. ב-Amazon Bedrock, ראו שגיאות סטרימינג מאחורי gateway או פרוקסי לדרישות הכותרת והגוף

#לתשובת הסטרימינג של Bedrock יש content-type לא צפוי

gateway או פרוקסי בין Claude Code ל-Amazon Bedrock משנה את גוף תשובת הסטרימינג או את כותרת Content-Type שלו. Amazon Bedrock מזרים תשובות כ-application/vnd.amazon.eventstream. במקום לפענח גוף שהוא לא יכול לקרוא, Claude Code דוחה תשובת סטרימינג מוצלחת שמדווחת content-type אחר. Claude Code לא מנסה שוב את הבקשה.

Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body , Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.

לפני v2.1.208, אותה הגדרה שגויה הופיעה כ-API Error: Truncated event message received אחרי שכל התשובה נאגרה.

מה לעשות:

1. הגדירו את ה-gateway כך שיעביר את גוף התשובה של InvokeModelWithResponseStream ואת כותרת Content-Type שלו בלי שינוי. מתווך שפולט מחדש את הזרם כ-server-sent events הוא סיבה נפוצה.
2. הגדרת CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 מסתירה את השגיאה הזו, אבל Claude Code לא מפענח גוף בינארי תחת כותרת שנכתבה מחדש, ולכן הבקשות האלה נופלות למסלול איטי יותר בלי סטרימינג. ראו שגיאות סטרימינג מאחורי gateway או פרוקסי.

#שגיאות אישור SSL

פרוקסי או מכשיר אבטחה ברשת שלכם מיירט תעבורת TLS עם האישור שלו, ו-Claude Code לא סומך עליו.

Unable to connect to API: SSL certificate verification failed (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config
Unable to connect to API: Self-signed certificate detected (SELF_SIGNED_CERT_IN_CHAIN). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config

לפני v2.1.273, שתי ההודעות הסתיימו ב-Check your proxy or corporate SSL certificates, בלי קוד OpenSSL ובלי הרמז על NODE_EXTRA_CA_CERTS.

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

במהלך /login ובבדיקת הקישוריות בהפעלה, אותו כישלון מייצר הודעה אחרת:

SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.

ב-Amazon Bedrock, הבקשות ש-Claude Code עצמו שולח ל-AWS, למשל קריאות האישורים של תפקידי STS ו-SSO, גילוי מודלים, והבדיקות של אשף ההגדרה, תלויות באותה הגדרת אישורים. ראו שגיאות אישור מאחורי פרוקסי שמיירט TLS.

מה לעשות:

1. ייצאו את חבילת ה-CA של הארגון שלכם והפנו את Claude Code אליה עם NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
2. ראו הגדרת רשת להוראות הגדרה מלאות
3. אל תגדירו NODE_TLS_REJECT_UNAUTHORIZED=0, שמכבה את אימות האישורים לגמרי

#מארח אינו מותר בסשן ענן

בקשת HTTP יוצאת מסשן ענן או ממשימת ענן מתוזמנת נחסמה על ידי מדיניות הרשת של הסביבה.

HTTP 403
x-deny-reason: host_not_allowed

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

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

• תעבורת GitHub ומחברים: פעולות GitHub ותעבורת מחברי MCP משתמשות בערוצים נפרדים, ולכן הן יכולות להמשיך לעבוד בזמן שמארחים אחרים חסומים
• סביבת ברירת מחדל: סביבת Default משתמשת בגישת Trusted, שמתירה את רשימת ההיתר המוגדרת כברירת מחדל של מאגרי חבילות, API של ספקי ענן, מאגרי קונטיינרים, ודומיינים נפוצים לפיתוח, וחוסמת דומיינים אחרים במסלול הזה

מה לעשות:

השלבים האלה משנים אחת מהסביבות שלכם. סביבה משותפת לארגון נפתחת לקריאה בלבד בבורר, ולכן בקשו מ-Owner לשנות את גישת הרשת שלה מדף Cloud environments בהגדרות הניהול.

1. פתחו את הסביבה שלכם לעריכה, מהטופס של משימת הענן המתוזמנת או מבורר הסביבות שבו אתם מתחילים סשני ענן.
2. בתיבת הדו-שיח Edit cloud environment, שנו את Network access מ-Trusted ל-Custom, ואז הוסיפו את הדומיין החסום אל Allowed domains. הזינו דומיין אחד בכל שורה. סמנו Also include default list of common package managers כדי לשמור את רשימת ההיתר המוגדרת כברירת מחדל לצד הדומיינים המותאמים שלכם. בחרו Full במקום זאת אם אתם רוצים גישה בלי הגבלה.
3. לחצו Save changes. ההרצה הבאה משתמשת ברשימת ההיתר המעודכנת. לסשן ענן שכבר פתוח, ראו מתי שינוי בגישת רשת מגיע לסשנים קיימים.

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

#הפרוקסי סירב לחיבור

אתם רואים את ההודעה הזו כש-Claude קורא artifact דרך הפרוקסי שהגדרתם ב-HTTPS_PROXY או במשתנה פרוקסי קשור. תוכן artifact מגיע מ-*.frame.claudeusercontent.com, ולכן Claude Code שולח קודם לפרוקסי בקשת CONNECT שמבקשת ממנו לפתוח מנהרה אל המארח הזה. כשהפרוקסי מסרב, שום דבר לא מגיע אל המארח, וההודעה נושאת את סטטוס ה-HTTP של הפרוקסי:

artifact content fetch failed (proxy refused the connection: HTTP 407)
artifact content fetch failed (proxy refused the connection: HTTP 403)
the proxy refused the connection to the artifact's content host (HTTP 502)

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

• HTTP 407: הפרוקסי דורש פרטי גישה שלא קיבל. שימו אותם בכתובת הפרוקסי, כפי שאימות Basic מראה.
• HTTP 403: הפרוקסי מסרב לפתוח מנהרה אל *.frame.claudeusercontent.com. בקשו ממי שמפעיל את הפרוקסי לאפשר את המארח הזה, שדרישות גישת הרשת מציינות.
• כל סטטוס אחר, למשל HTTP 502: הפרוקסי לא פתח את המנהרה מסיבה משלו, למשל כישלון בהגעה אל המארח. חפשו את הסטטוס ביומני הפרוקסי.
• unreadable reply במקום סטטוס: מה שנמצא בכתובת הפרוקסי לא ענה עם שורת סטטוס HTTP. בדקו שהכתובת היא פרוקסי HTTP.

מה לעשות:

1. בדקו את הכתובת ואת פרטי הגישה במשתנה הפרוקסי, כפי שהגדרת פרוקסי מתארת, ואז הריצו curl -x http://proxy.example.com:8080 -I https://api.anthropic.com מהמעטפת שבה אתם מפעילים את Claude Code, עם כתובת הפרוקסי שלכם. ב-Windows PowerShell, הריצו curl.exe. אם הבדיקה הזו נכשלת באותו אופן, תקנו קודם את הגדרת הפרוקסי. אם היא מצליחה, הסירוב ספציפי למארח ה-artifact.
2. אם הרשת שלכם מאפשרת ל-Claude Code להגיע אל מארח ה-artifact ישירות, הוסיפו את .frame.claudeusercontent.com אל NO_PROXY. השאירו את הרשומה צרה: רשומה רחבה יותר של .claudeusercontent.com גם עוקפת את הפרוקסי עבור bridge.claudeusercontent.com, שארגונים עם רשימת היתר של IP צריכים להשאיר על הפרוקסי.

לפני v2.1.238, Claude Code דיווח על מנהרה שנדחתה כשגיאת רשת כללית.

#שירות סביבות הענן החזיר תשובה ריקה או לא צפויה

Claude Code מבקש את רשימת סביבות הענן שלך בכמה נקודות, למשל כשאתה יוצר סשן ענן מה-CLI או מריץ /remote-env. כשהוא לא מצליח לקרוא את תשובת השרת, הוא מציג אחת מההודעות האלה:

The cloud environments service returned an empty response (HTTP 200 with no body). This is usually temporary , try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 with a non-JSON body). This is usually temporary , try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 without a usable environments list). This is usually temporary , try again in a moment.

השרת קיבל את הבקשה אבל ענה בגוף שאינו רשימת הסביבות: ריק, לא JSON, או JSON בלי הרשימה. זה בדרך כלל מלווה שיבוש בצד השירות, וחולף מעצמו. לפי הממשק שביקש את הרשימה, Claude Code עשוי להוסיף קידומת, כמו couldn't list environments: בתיבת הדו-שיח של /remote-env.

מה לעשות:

• נסה שוב את הפעולה. Claude Code מבקש את הרשימה מחדש בכל פעם
• אם ההודעה ממשיכה להופיע, בדוק ב-status.claude.com אם יש תקריות פעילות

לפני v2.1.236, Claude Code הציג TypeError גולמי של JavaScript במקום ההודעות האלה.

#האחזור של הסשן מ-Sessions API נכשל

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

Failed to fetch session from Sessions API: Failed to fetch session logs

רואים אותה אחרי claude --teleport, /teleport, או בחירת הסשן ברשימת /tasks. claude --teleport <session-id> מדפיס אותה ויוצא עם קוד 1.

מה לעשות:

• הרץ שוב את אותו teleport. אם הוא נכשל באותו אופן, דווח על הבעיה

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

#לא ניתן היה להתחבר מחדש לסשן Remote Control שלך

Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

חידוש עם claude --resume או claude --continue מתחבר מחדש לסשן Remote Control שנרשם בשיחה הזו. ההודעה הזו אומרת שההתחברות מחדש נכשלה מסיבה שעשויה להיות זמנית, כמו הפסקת רשת או שגיאת שרת, ולכן Claude Code לא יכול לאשר אם הסשן המרוחק עדיין קיים. הסשן המקומי שלך ממשיך לרוץ בלי Remote Control.

מה לעשות:

• הרץ /remote-control כדי לנסות שוב את החיבור
• התחל סשן חדש עם claude --remote-control כדי ליצור סשן Remote Control חדש
• להודעות הפעלה אחרות של Remote Control, ראה פתרון בעיות ב-Remote Control

אם השרת מדווח במקום זאת שהסשן הקודם כבר לא קיים, לא רואים את ההודעה הזו. Claude Code מתחיל סשן חדש במקומו או מציג Previous session is unavailable , run /remote-control to start a new one.

#סשנים הסתיימו בזמן שהמכונה הזו הייתה לא מקוונת

Claude Code מציג את ההודעה הזו בטרמינל שמריץ claude remote-control אחרי שהמכונה שלך הייתה לא מקוונת מספיק זמן כך שהשרת ניקה את סביבת Remote Control שהמכונה שלך שירתה. הסשנים בסביבה הזו הסתיימו, ואי אפשר לחדש אותם. המספר הוא מספר הסשנים שהסתיימו.

2 sessions ended while this machine was offline , the environment was cleaned up on the server and can't be resumed.

מה לעשות:

• כש-Claude Code מפרט מתחת להודעה הזו worktrees שנשמרו, אסוף מהם כל עבודה שלא בוצע לה commit
• הרץ claude remote-control כדי להתחיל סביבה חדשה

#לא ניתן היה לשתף את התמליל

אחרי שאתה מסכים לשתף את תמליל הסשן שלך מהנחיית סקר, כמו סקר איכות הסשן, Claude Code מעלה אותו ל-Anthropic, או שומר במקום זאת ארכיון מקומי אצל ספקי צד שלישי, בסשנים של Claude apps gateway, וכשאין אישורי Anthropic זמינים. ההודעה הזו אומרת שהשיתוף לא הושלם.

Couldn't share the transcript.

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

מה לעשות:

• הרץ /feedback כדי לשלוח את התמליל עם תיאור של מה שקרה. ראה דיווח על שגיאה אם /feedback לא זמין בסביבה שלך
• אם גם בקשות אחרות נכשלות, בדוק את חיבור הרשת וראה לא ניתן להתחבר ל-API

#לא ניתן היה לשלוח משוב

הודעה שמתחילה ב-Couldn't send feedback אומרת ששירות המשוב לא אישר את הדיווח ששלחת מתיבת הדו-שיח של /feedback, /bug, או /share, או מטיוטת משוב שממתינה בתור. התייחס אליו כאל דיווח שלא התקבל. כשאחרי הנקודתיים בא משפט על הארגון שלך, הארגון שלך מסרב למשוב, ואותו דיווח מקבל את אותה תשובה.

הדוגמה השנייה מבין השתיים היא סירוב של ארגון:

Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.

Couldn't send feedback: Feedback has not been enabled for your organization. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.

מה לעשות:

• לא מחובר: ההודעה ממשיכה : not signed in. Run /login, then retry. הרץ /login, ואז שלח שוב
• סירוב של הארגון שלך: לדוגמה : Feedback has not been enabled for your organization. או : Feedback collection is not available for organizations with custom data retention policies. אם ההודעה מוסיפה To report a bug, open an issue, עשה זאת ב-github.com/anthropics/claude-code/issues. טיוטה שממתינה בתור נשארת בתור, ואפשר לזרוק אותה
• אישורים שנדחו: ההודעה ממשיכה : the sign-in this session uses is not allowed to send feedback או : the server did not accept the credentials this session uses. הרץ /status בהנחיה של Claude Code כדי לראות איזה login, token או מפתח API הסשן הזה שולח
• (request timed out) או (couldn't reach the service) מיד אחרי Couldn't send feedback: שלח שוב את הדיווח או את הטיוטה שבתור. תיבת הדו-שיח שומרת את הטקסט שלך, והודעה של טיוטה בתור אומרת The draft is still queued. אם גם בקשות אחרות נכשלות, בדוק את חיבור הרשת וראה לא ניתן להתחבר ל-API. אם זה ממשיך להיכשל, הגש את הדיווח ב-github.com/anthropics/claude-code/issues
• (server returned <status>), או בלי סיבה, מיד אחרי Couldn't send feedback: ה-status הוא קוד התשובה של השירות. ההודעה של השירות עצמו באה אחריו כשנשלחה הודעה, כמו ב-(server returned 403: Access Forbidden). אם זה ממשיך להיכשל, הגש את הדיווח ב-github.com/anthropics/claude-code/issues

Issues ב-github.com/anthropics/claude-code הם ציבוריים, לכן השמט קוד, תמלילים, וכל דבר אחר חסוי כשאתה פותח אחד.

לפני v2.1.281, כל שליחה נכשלה עם ההודעה הזו ברגע שהגיע Stop של Remote Control או הודעה דחופה בין סשנים בזמן שתיבת הדו-שיח הייתה פתוחה. בגרסאות האלה, סגור את תיבת הדו-שיח, פתח אותה מחדש, ושלח שוב.

#מטען המשוב גדול מדי

ההודעה הזו במסך הסקירה של טיוטת משוב אומרת של-Claude Code אין אישור שהשירות קיבל את הטיוטה. התייחס אליה כאל כזו שלא התקבלה. הטיוטה נשארת בתור /feedback שלך, כך שאפשר לשלוח אותה שוב.

Feedback payload too large. Try again without the transcript, or shorten the details.

מה לעשות:

• במסך הסקירה, הגדר את Send transcript ל-no, ואז שלח את הטיוטה שוב. קיצור הפרטים מסיר לכל היותר 10 KB של טקסט, וזה כל מה שפרטי טיוטה יכולים להכיל.

#פסק זמן בחיבור לשרת MCP במהלך שינה או שינוי שעון

ההודעה הזו אומרת שחיבור לשרת MCP עבר פסק זמן, ו-Claude Code מצא ששעון המערכת שלך קפץ קדימה במהלך הניסיון:

MCP server "<name>" connection timed out. Your computer went to sleep or its clock changed while connecting.

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

מה לעשות:

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

• בסשן אינטראקטיבי: הרץ /mcp, בחר את השרת, ובחר Reconnect
• במעטפת שלך: הרץ שוב את הפקודה claude -p, claude mcp list, או claude mcp get. אם השרת נכשל אחר כך עם הודעה שמתחילה ב-Skipping connection (recent failure cached, המתן 15 דקות והרץ את הפקודה שוב.
• ביישום Agent SDK: קרא ל-reconnectMcpServer() ב-TypeScript או ל-ClaudeSDKClient.reconnect_mcp_server() ב-Python
• אם השרת נכשל שוב: אם ההודעה שונה מזו, ראה מה לבדוק כששרת MCP לא מתחבר. אם ההודעה הזו חוזרת אף על פי שהמחשב שלך נשאר ער ושום דבר לא שינה את השעון שלו, ראה דיווח על שגיאה.

לפני v2.1.307, Claude Code הציג הודעת פסק זמן כמו MCP server "<name>" connection timed out after <N>ms במקום ההודעה הזו.

#שגיאות בקשה

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

#ההנחיה ארוכה מדי

השיחה יחד עם הקבצים המצורפים חורגת מחלון ההקשר של המודל.

Prompt is too long

בסשן אינטראקטיבי, Claude Code מציג את השגיאה הזו כך:

Context limit reached · /compact or /clear to continue

השורה מציינת רק את /clear כאשר DISABLE_COMPACT מוגדר. צורות ארוכות יותר של השגיאה, כמו הצורה של כשל בדחיסה למטה, שומרות על הניסוח Prompt is too long ·. בפלט של -p ובתמליל, הטקסט נשאר Prompt is too long.

כאשר כיבית את הדחיסה האוטומטית בהגדרות המשתמש שלך, השורה גם אומרת זאת:

Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on

מתג Auto-compact ב-/config כותב את autoCompactEnabled להגדרות המשתמש. הרמז מופיע רק כאשר שינוי ב-/config היה נכנס לתוקף. לדוגמה, הוא לא מופיע כאשר DISABLE_AUTO_COMPACT או DISABLE_COMPACT כיבו את הדחיסה האוטומטית. הוא גם לא מופיע כאשר היקף בעדיפות גבוהה יותר, כמו הגדרות פרויקט או הגדרות מנוהלות, הגדיר את autoCompactEnabled ל-false. לפני v2.1.235, השורה לא נשאה רמז על דחיסה אוטומטית.

Amazon Bedrock מדווח על מצב זה כ-Input is too long for requested model., ו-Claude Code מטפל בו באותו אופן. לפני v2.1.217, Claude Code לא זיהה את הניסוח של Bedrock, ולכן הדחיסה האוטומטית מעולם לא הופעלה עליו ו-/compact נכשל עם אותה שגיאה.

שער יישומי Claude מדווח על מצב זה כ-capability_rejected: prompt_too_long כאשר upstream בענן דוחה את הבקשה בצורת השגיאה של הספק עצמו. Claude Code מתייחס לטוקן כמו ל-Prompt is too long. לפני v2.1.228, Claude Code לא זיהה את הטוקן, ולכן הדחיסה האוטומטית לא הופעלה עליו.

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

Prompt is too long · automatic compaction failed: <the underlying error>

פתור קודם את השגיאה שצוינה. /compact נכשל על אותה שגיאה עד שתעשה זאת. לפני v2.1.229, דחיסה אוטומטית שנכשלה הציגה Prompt is too long בלי הסיבה.

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

• כאשר הוא לא יכול לסכם שום חילוף שלם, Claude Code שומר את ההנחיה החדשה ביותר שלך מילה במילה ומסכם את כל מה שלפניה.
• במקרה הזה, כאשר השיחה לא מסתיימת בהנחיה שלך, Claude Code מסכם את כל השיחה במקום זאת.

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

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

Prompt is too long · this conversation is a single exchange and cannot be compacted , the request size comes mostly from system prompt, tool definitions, or attachments.

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

Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) and this conversation's own content is most of it. A single-exchange conversation cannot be compacted; start with less content (smaller files or pasted text).

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

Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) but this conversation is only ~<conversation tokens> tokens , the rest is system prompt, tool definitions, and attachment content. A single-exchange conversation cannot be compacted; reduce attached files/tools or start with less context.

לפני v2.1.162, Claude Code ניסה את הדחיסה בכל מקרה והציג את Prompt is too long החשוף כאשר היא נכשלה.

מה לעשות:

• הרץ /compact כדי לסכם תורות קודמים ולפנות מקום, או /clear כדי להתחיל מחדש. אם /compact עונה Not enough messages to compact., השיחה היא חילוף יחיד בלי שום דבר מוקדם יותר לסכם, ולכן המקום תפוס על ידי ההנחיה האחת הזו ועל ידי מה ש-Claude Code שולח עם כל בקשה: הרץ /clear ושלח שוב עם פחות טקסט מודבק או קבצים מצורפים קטנים יותר, או צמצם את הגדרות הכלים וקבצי הזיכרון באמצעות השלבים למטה
• הרץ /context כדי לראות פירוט של מה שצורך את החלון: הנחיית מערכת, כלים, קבצי זיכרון והודעות
• השבת שרתי MCP שאינך משתמש בהם באמצעות /mcp disable <name> כדי להסיר את הגדרות הכלים שלהם מההקשר
• קצר קבצי זיכרון גדולים מסוג CLAUDE.md, או העבר הוראות אל כללים לפי נתיב שנטענים רק כאשר הם רלוונטיים
• הדחיסה האוטומטית פועלת כברירת מחדל ובדרך כלל מונעת את השגיאה הזו. אם כיבית אותה ב-/config או באמצעות DISABLE_AUTO_COMPACT, הפעל אותה מחדש. אם תשאיר אותה כבויה, הרץ /compact בעצמך לפני שהחלון מתמלא.
• אם השגיאה מופיעה ליד 200K טוקנים במודל שמקבל יותר, סיבה אחת היא מזהה מודל ש-Claude Code לא מזהה. Claude Code מניח חלון של 200K למזהה כזה, ולכן כדי להמשיך לעבוד מעבר לנקודה הזו, תן לו את חלון ההקשר האמיתי של המודל.
  • אם אתה משתמש ב-ANTHROPIC_BASE_URL מותאם והשגיאה מתחילה ב-Prompt is too long · automatic compaction failed, הגדר את חלון ההקשר של המודל או עדכן ל-v2.1.299 או מאוחר יותר. לפני v2.1.299, Claude Code סיים את התור עם ההודעה הזו ליד חלון 200K המשוער במקום לשלוח את הבקשה.
• אם השגיאה הופיעה מיד אחרי שעצרת את Claude בזמן שהוא דחס את השיחה, השיחה שלך לא השתנתה ועדיין גדולה מספיק כדי להזדקק לדחיסה. הרץ /compact ושלח את ההודעה שלך שוב. כדי שהשגיאה לא תחזור, עדכן את Claude Code ל-v2.1.304 או מאוחר יותר. לפני v2.1.304, עצירה ברגע הזה יכלה לסיים את התור עם השגיאה הזו.
• ב-v2.1.305, עם הרבה כלי MCP וחיבור ישיר ל-API של Anthropic, השגיאה הזו יכולה להסתיר שגיאת 400 או 422 לא קשורה מה-API. עדכן את Claude Code ל-v2.1.306 או מאוחר יותר כדי לראות את השגיאה המקורית.

ראה עיון בחלון ההקשר לתצוגה אינטראקטיבית של איך ההקשר מתמלא.

#ההקשר חורג ממגבלת הטוקנים

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

Context exceeds the 200k-token limit by 94k tokens , run /compact or /clear to continue.

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

Context is 94k tokens past the 200k-token compaction window , run /compact to reduce usage.

שתי הצורות מציינות /clear במקום /compact כאשר הגדרת DISABLE_COMPACT.

מה לעשות:

• בשיחה של כמה תורות, הרץ /compact כדי לסכם תורות קודמים ולפנות מקום. כדי להתחיל מחדש, הרץ /clear
• לדרכים נוספות לצמצם שימוש, ראה ההנחיה ארוכה מדי

לפני v2.1.216, /context הציג שימוש מעל 100% בלי שורת אזהרה שהסבירה מה זה אומר או איך להתאושש.

#הבקשה גדולה מדי

גוף הבקשה הגולמי חרג ממגבלת 32MB של ה-API לפני הטוקניזציה, בדרך כלל בגלל תוכן מודבק גדול, תוצאות כלים או קבצים מצורפים. המגבלה הזו נפרדת מחלון ההקשר.

Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.

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

• Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).: תמונות או מסמכים דחפו את הבקשה מעבר למגבלה. Claude Code מנסה שוב אחרי שהם הוסרו.
• Request too large for the API's 32MB request limit: ההודעות לבדן חורגות מהמגבלה, ולכן ההודעה אומרת compacting cannot make it fit ו-Claude Code לא מנסה שוב. במצב לא אינטראקטיבי, ההודעה אומרת לך לצמצם את הקלט או להתחיל סשן חדש.

לפני v2.1.212, שיחות עם מספיק תמונות שהצטברו נכשלו בכל תור עם Request too large (max 32MB). Double press esc to go back and try with a smaller file. לפני v2.1.229, Claude Code הציג את העצה על קבצים מצורפים לכל דחייה, גם כאשר דחיסה לא יכלה לעזור.

מה לעשות:

• אם ההודעה אומרת compacting cannot make it fit, לחץ על Esc פעמיים כדי לחזור אחורה מעבר לתור שהוסיף את התוכן הגדול, או הרץ /clear כדי להתחיל מחדש
• אחרת, הרץ /compact, שמסיר תמונות וקבצים מצורפים שהצטברו
• הפנה לקבצים גדולים לפי נתיב במקום להדביק את התוכן שלהם, כדי ש-Claude יוכל לקרוא אותם בחלקים
• לתמונות, ראה התמונה הייתה גדולה מדי למטה

#התמונה הייתה גדולה מדי

תמונה שהודבקה או צורפה חורגת ממגבלות הגודל או הממדים של ה-API.

Image was too large. Double press esc to go back and try again with a smaller image.
API Error: 400 ... image dimensions exceed max allowed size
API Error: an image in the conversation could not be processed and was removed.
An image in the conversation exceeds the dimension limit for many-image requests (3000px). Run /compact to remove old images from context, or start a new session.

השורה could not be processed and was removed אומרת שה-API סירב לתמונה בשיחה, כמו תמונה מעל מגבלות הגודל או הממדים.

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

• לפני v2.1.299, בשיחה ארוכה עם הרבה תמונות, Claude Code יכול היה להסיר את התמונות שצירפת אחרונות במקום את זו שמעל המגבלה. שורת was removed חזרה אז בכל תור, ו-Claude לא ראה את התמונות החדשות שלך.
• לפני v2.1.299, ב-VS Code, באפליקציית Desktop וב-Agent SDK, תמונות שצירפת בזמן ש-Claude עבד לא קיבלו את שינוי הגודל שתמונות מצורפות אחרות מקבלות. הן הגיעו ל-API בגודלן המקורי, מה שהוביל לשגיאות תמונה חוזרות בשיחות ארוכות.
• לפני v2.1.166, תמונה שהודבקה יכלה להישאר בשיחה, ואז אותה שגיאה חזרה בכל הודעה לאחר מכן

מה לעשות:

• שנה את גודל התמונה לפני ההדבקה. ה-API מקבל תמונות עד 8000 פיקסלים בצלע הארוכה ביותר לתמונה בודדת, או 3000 פיקסלים כאשר יותר מ-20 תמונות נמצאות בהקשר.
• צלם צילום מסך הדוק יותר של האזור הרלוונטי במקום את המסך המלא
• עבור הודעת dimension limit for many-image requests, הרץ /compact בהנחיית Claude Code אם ההודעה מציינת זאת, או התחל סשן חדש עם פחות תמונות

הודעת dimension limit for many-image requests מציגה את מגבלת הפיקסלים שצוינה בשגיאה של ה-API.

#לא ניתן לשנות את גודל התמונה

Claude Code לא הצליח להקטין תמונה מצורפת לפני שליחתה ל-API.

Unable to resize image , image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image , dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image , could not verify image dimensions are within the 2000x2000px API limit.
Unable to resize image , it is a CMYK JPEG, which Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Re-save it as an RGB PNG or JPEG and try again.
Unable to resize image , it is an animated WebP whose first frame Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Save its first frame as a PNG or JPEG and try again.
Unable to resize image , its pixels could not be decoded (the file may be damaged, or use an encoding Claude Code cannot read), and it is over the … API limit (… raw, … base64), so it cannot be sent. Re-save it as a PNG or JPEG and try again.

Claude Code בדרך כלל משנה גודל של תמונות גדולות באופן אוטומטי. השגיאות האלה אומרות שהתמונה לא ניתנה לפענוח או לשינוי גודל כך שתתאים למגבלות ה-API.

מה לעשות:

• אם ההודעה מבקשת ממך להמיר את התמונה, המר אותה ל-PNG, JPEG, GIF או WebP וצרף אותה שוב. Claude Code יכול לאמת ממדים לפורמטים האלה מכותרת הקובץ, בלי לפענח את התמונה.
• אם ההודעה מדווחת על מגבלת ממדים או גודל, שנה גודל או דחוס מחדש את התמונה מתחת למגבלה הזו לפני הצירוף.
• אם ההודעה מציינת סיבה, כמו JPEG ב-CMYK, WebP מונפש, או קובץ שאולי פגום, שמור מחדש את התמונה בפורמט שההודעה מציעה וצרף אותה שוב.

#הבקשה נדחתה כבלתי ניתנת לעיבוד על ידי המודל

ה-API סירב לבקשה כבקשה שהמודל לא יכול לעבד. ההודעה היא של ה-API עצמו.

API Error: 400 Request rejected as unprocessable by the model (too many or oversized images, or unsupported parameters)

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

מה לעשות:

• אם ההודעה ממשיכה להופיע בשיחה עם תמונות או מסמכים, הסר אותם בעצמך. לחץ על Esc פעמיים כדי לחזור אחורה מעבר לתורות שהוסיפו אותם, או הרץ /clear כדי להתחיל מחדש.

#שגיאות PDF

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

PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).
PDF is password protected. Try using a CLI tool to extract or convert the PDF.
The PDF file was not valid. Try converting it to text first (e.g., pdftotext).

מה לעשות:

• עבור קובצי PDF גדולים מדי, בקש מ-Claude לקרוא טווח עמודים עם כלי Read במקום לצרף את כל הקובץ, או חלץ טקסט עם כלי כמו pdftotext והפנה לקובץ הפלט לפי נתיב
• עבור קובצי PDF מוגנים או לא תקינים, הסר את הסיסמה או ייצא מחדש את הקובץ מיישום המקור שלו, ואז נסה שוב

כאשר Claude קורא טווח עמודים מ-PDF עם כלי Read, הקריאה יכולה להיכשל עם הודעה אחרת:

pdftoppm is not installed. Install poppler-utils (e.g. `brew install poppler` or `apt-get install poppler-utils`) to enable PDF page rendering.

קריאות של טווח עמודים מרנדרות עמודים עם pdftoppm. התקן את poppler-utils עם הפקודה שההודעה נותנת, או בפלטפורמות אחרות בילד של poppler שמציב את pdftoppm ב-PATH שלך. ראה התנהגות כלי Read לגבי אילו קובצי PDF נקראים לפי טווח עמודים.

#קלטים נוספים אינם מותרים

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

API Error: 400 ... context_management: Extra inputs are not permitted

Claude Code שולח שדות שזמינים רק בבטא, כמו context_management ו-defer_loading של חיפוש כלים, יחד עם כותרת anthropic-beta שמפעילה אותם. כששער מעביר את הגוף אבל משמיט את הכותרת, ה-API רואה שדות שהוא לא מזהה. כששער מעביר גוף בפורמט Anthropic למעלה הזרם עם סכמה שונה, המעלה הזרם הזה דוחה שדות כאלה. זוגות של כותרת בטא ושדה בגוף מכסה את שני המקרים.

מה לעשות:

• אם ההודעה מכילה context_management: Extra inputs are not permitted, עדכנו את Claude Code ל-v2.1.304 או חדש יותר. אחרי העדכון, Claude Code עונה על הדחייה הזו בשליחת הבקשה פעם נוספת בלי השדה. לפני v2.1.304, Claude Code לא ביצע ניסיון חוזר אחרי הדחייה הזו.
• אם ההודעה מציינת את defer_loading או tool_reference, עדכנו את Claude Code ל-v2.1.305 או חדש יותר. Claude Code אז עונה על הדחייה הזו בשליחת הבקשה פעם נוספת בלי שדות חיפוש כלים.
• אם השער שלכם משמיט את הכותרת, הגדירו אותו כך שיעביר את כותרת anthropic-beta. ראו העברת יכולות לגבי מה ששערים חייבים להעביר.
• כגיבוי, הגדירו CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 לפני ההפעלה. השבתת יכולות טרום פרסום מכסה את ההיקף המדויק.

לפני v2.1.302, השגיאה הזו יכלה גם לציין את השדה diagnostics בלי מעורבות של שער. היא הופיעה כשסשן שכבר השתמש ב-API של Anthropic עבר ל-Amazon Bedrock או ל-Agent Platform של Google Cloud בלי הפעלה מחדש. לדוגמה, סשן שהשארתם פתוח עובר ל-Bedrock כשמריצים /setup-bedrock בחלון אחר של Claude Code. בגרסאות האלה, הריצו /clear באותו סשן או הפעילו אותו מחדש.

#סכמת קלט של כלי אינה תקינה

כלי בבקשה הצהיר על input_schema שנכשל באימות JSON Schema של ה-API, ולכן ה-API דחה את כל הבקשה. המספר אחרי tools. הוא המיקום של הכלי הכושל ברשימת הכלים של הבקשה, לא שם שאפשר לחפש.

API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid
API Error: 400 ... tools.N.custom.input_schema.properties: Property keys should match pattern '^[a-zA-Z0-9_.-]{1,64}$'

הצורה הראשונה אומרת שהסכמה אינה JSON Schema תקין של טיוטה 2020-12. הצורה השנייה אומרת ששם של מאפיין ברמה העליונה לא תואם לתבנית שההודעה מצטטת.

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

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

השגיאה יכולה להתרחש גם עבור כלי שהסכמה שלו מצהירה על ניב JSON Schema שאינו טיוטה 2020-12 ב-$schema. Claude Code לא בודק את הסכמות האלה מול מטא-סכמת JSON Schema, אם כי בדיקת שמות המאפיינים ברמה העליונה עדיין חלה.

לפני v2.1.216, אף פריסה לא הריצה את בדיקות ההחרגה.

מה לעשות:

• אם גרסת Claude Code שלכם מוקדמת מ-v2.1.300, הריצו claude update במעטפת. לפני v2.1.300, Claude Code לא ניסה שוב את הבקשה בלי הפרמטרים של הכלי שנדחה, ולכן השגיאה הזו חזרה בכל בקשה שכללה את הכלי.
• הסירו או השביתו את שרת ה-MCP שמצהיר על הסכמה הלא תקינה. השגיאה מציינת את הכלי רק לפי מיקום. ב-v2.1.216 או חדש יותר, בדקו את היומן של כל שרת לשורה שמציינת כלי שסכמת הקלט שלו תידחה. אם אף יומן לא מציין כלי כזה, השביתו שרתים אחד אחד.
• אם אתם מתחזקים את השרת, תקנו את input_schema של הכלי. הסכמה חייבת להיות JSON Schema תקין, ושמות מאפיינים ברמה העליונה חייבים להיות באורך 1 עד 64 תווים ולהשתמש רק באותיות ASCII ובספרות, _, . ו--. ראו כלים עם סכמות קלט לא תקינות.

#שם כלי MCP ארוך מ-128 תווים

שרת MCP מציג כלי שהשם המלא שלו, כמו mcp__<server>__<tool>, ארוך מ-128 התווים שה-API מקבל. Claude Code משמיט את הכלי הזה מהכלים שהוא שולח ל-Claude, ושאר הכלים של השרת ממשיכים לעבוד. בסשן שמתחילים עם claude --debug מהמעטפת, Claude Code כותב את ההודעה הזו ליומן ניפוי השגיאות ב-~/.claude/debug/<session-id>.txt:

Tool "mcp__<server>__<tool>" is not sent to Claude: its name has <N> characters and the API accepts at most 128

מה לעשות:

• אם אתם מתחזקים את השרת, קצרו את שם הכלי.
• אם השרת נמצא בתצורת MCP שלכם, תנו לו שם קצר יותר שם, כמו db במקום analytics-database. אחר כך עדכנו את מה שמפנה לשרת או לכלים שלו לפי השם הישן, כמו כללי הרשאה ומתאמי הוקים.
• אם תוסף אורז את השרת, השם המלא של הכלי כולל גם את שם התוסף. בקשו מהמתחזק של התוסף לקצר את שם השרת או את שם הכלי.

לפני v2.1.292, Claude Code שלח את הכלי בכל זאת, וה-API דחה כל בקשה שכללה אותו עם API Error: 400 ... tools.N.custom.name: String should have at most 128 characters.

#tool_use.name ארוך מ-200 תווים

קריאת כלי בהיסטוריית השיחה נושאת שם ארוך מ-200 התווים שה-API מקבל בבקשה:

API Error: 400 ... tool_use.name: String should have at most 200 characters

Claude Code חותך שם כזה ל-200 תווים כשהתשובה מגיעה וכשהוא טוען שיחה שמורה, ולכן הקריאה נכשלת עם שגיאת כלי No such tool available והשיחה ממשיכה בלי שגיאת ה-API הזו.

מה לעשות:

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

לפני v2.1.281, השם הארוך מדי נשאר בהיסטוריה וה-API דחה כל בקשה ששלחה מחדש את השיחה, כולל /compact ו---resume, ולכן השגיאה הזו חזרה והשיחה הייתה תקועה.

#יש בעיה עם המודל שנבחר

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

There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.

מה לעשות:

• CLI אינטראקטיבי: הריצו /model כדי לבחור ממודלים שזמינים לחשבון שלכם.
• מצב לא אינטראקטיבי (-p): העבירו --model עם כינוי או מזהה תקין, או הגדירו ANTHROPIC_MODEL. טקסט השגיאה מציג Run --model בממשק הזה.
• Agent SDK: טקסט השגיאה משמיט את הרמז כי המודל מוגדר באופן תכנותי. הגדירו model ב-Options ב-TypeScript או ClaudeAgentOptions(model=...) ב-Python, וטפלו בשגיאה המובנית model_not_found כדי להציג ניסיון חוזר או בוחר מודל משלכם.
• השתמשו בכינוי כמו sonnet או opus במקום מזהה מלא עם גרסה. כינויים נפתרים לברירת מחדל מתוחזקת כך שהם לא מתיישנים. ראו הגדרת מודל.
• אם המודל הלא נכון חוזר שוב ושוב ב-CLI, מזהה מיושן מוגדר במקום כלשהו. בדקו את המקומות שבהם אפשר להגדיר מודל לפי סדר עדיפות והסירו את הערך המיושן.
• Claude Code מדווח על התחברות claude.ai שפגה כההתחברות פגה, לא כשגיאה הזו. לפני v2.1.206, התחברות שפגה ושכבר לא היה אפשר לרענן אותה נכשלה בכל מודל עם השגיאה הזו. הריצו /login אם אתם רואים את זה בגרסה ישנה יותר.
• אם ANTHROPIC_BASE_URL מצביע על שער LLM וכל מודל נכשל כך, בדקו שהשער שלכם והמעלה הזרם שלו מקבלים שדות חיפוש כלים. כברירת מחדל, Claude Code שולח שדות כלי defer_loading ובלוקים tool_reference, עם כותרת anthropic-beta שמפעילה אותם. לפני v2.1.304, חיפוש כלים היה כבוי מאחורי שער אלא אם הפעלתם אותו עם ENABLE_TOOL_SEARCH.
• לפריסות Agent Platform של Google Cloud, ראו פתרון בעיות של Agent Platform של Google Cloud.

#המודל אינו מזהה מודל מזוהה

המחרוזת שהעברתם למעבר מודל אינה מחרוזת ש-Claude Code יכול להשתמש בה כמודל, ולכן הוא סירב למעבר בלי לשלוח בקשה והסשן שומר על המודל הנוכחי שלו. אפשר לקבל את השגיאה הזו כשמודל מוגדר דרך המתודה setModel() של Agent SDK, על ידי אפליקציה שמריצה את ה-CLI של Claude Code עבורכם, כמו אפליקציית Desktop, או כשבוחרים מודל ממכשיר שמחובר דרך Remote Control. לפני v2.1.200, Claude Code שמר את המחרוזת ונכשל בבקשה הבאה עם יש בעיה עם המודל שנבחר.

Model "Sonnet5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

בדוגמה הזו אפליקציה שלחה את שם התצוגה Sonnet 5, שההודעה חוזרת עליו בלי הרווח. הרמז בסוף מציין את הכינוי או מזהה המודל הקרוב ביותר. כשאין התאמה קרובה מספיק, הוא אומר Run /model to see available models. במקום זאת. בסשן שאפליקציית Desktop מתחילה עבורכם, רמז אי ההתאמה אומר Switch to a different model.

כשעוברים דרך Agent SDK או אפליקציה ב-API של Anthropic, רק מחרוזת שלא יכולה להיות מזהה מודל מקבלת את השגיאה הזו, כמו שם תצוגה או מחרוזת ריקה.

כשבוחרים מודל ממכשיר Remote Control, Claude Code בודק את המחרוזת באופן מקומי. כל מחרוזת שאינה כינוי מודל, מודל ש-Claude Code מציג או שהגדרתם, או מזהה שמתחיל ב-claude- מקבלת את השגיאה הזו, כולל מזהה עם שגיאת הקלדה כמו claud-sonnet-5. לפני v2.1.260, הבדיקה הזו לא כיסתה בחירות Remote Control, ולכן מחרוזת לא מזוהה הוחלה ונכשלה בבקשה הבאה.

מה לעשות:

• הריצו /model בלי ארגומנט כדי לפתוח את הבוחר ולבחור מהמודלים הזמינים לחשבון שלכם, ואז העבירו את הכינוי או המזהה שמוצג שם
• אם השתמשתם בכינוי שרק גרסה חדשה יותר של Claude Code תומכת בו, הריצו claude update, או העבירו את המזהה המלא של המודל במקום זאת. השרת עדיין יכול לדרוש גרסת Claude Code מינימלית עבור המודל הזה. ראו Claude Code אינו תומך במודל הזה.
• מודל שנשמר לפני v2.1.200 לא מתוקן על ידי הבדיקה הזו. אם ערך מיושן חוזר, הסירו אותו מהמיקומים שרשומים תחת הגדרת המודל.
• בכל ספק שאינו ה-API של Anthropic, או מאחורי שער או ANTHROPIC_BASE_URL מותאם, רק מחרוזת ריקה מקבלת את השגיאה הזו. Claude Code עדיין יכול לכתוב את שורת האבחון של מודל לא מזוהה בזמן הבקשה, בכל ספק.

#המודל לא נמצא

עברתם למודל לפי שם ו-Claude Code לא הצליח לאשר שקיים מודל בשם הזה. כשהשם אינו כינוי מודל או איות אחר ש-Claude Code מקבל באופן מקומי, Claude Code מאמת אותו בבקשת API מינימלית, והשגיאה הזו היא בדרך כלל התשובה של נקודת הקצה של ה-API שלכם. עם /model <name>, שם שלא יכול להיות מזהה מודל בכלל, כמו שם שמכיל רווחים, מקבל את אותה הודעה.

Model 'claude-opus-9' not found

בספקים עם מזהי מודל ייחודיים לספק, ההודעה עשויה להוסיף הצעת Try '...' instead שמציינת את המזהה של הספק שלכם למודל גיבוי.

מה לעשות:

• הריצו /model בלי ארגומנט ובחרו מהמודלים הזמינים לחשבון שלכם, או השתמשו בכינוי מודל כמו sonnet, שנפתר לברירת מחדל מתוחזקת
• אם הקלדתם מזהה מלא, בדקו אותו מול קטלוג המודלים של הספק שלכם. מודל שהושק לאחרונה יכול להיות זמין ב-API של Anthropic לפני שהספק או האזור שלכם מציעים אותו.
• ב-Agent SDK, setModel() נכשל עם ההודעה הזו והסשן ממשיך לרוץ על המודל הקודם שלו. ב-SDK של TypeScript, קראו ל-supportedModels() כדי לרשום את המודלים שאפשר לעבור אליהם.
• לפני v2.1.265, /model גם דחה את איות הכינוי opusplan[1m] עם השגיאה הזו. בגרסאות האלה, עדכנו את Claude Code, או הגדירו את המודל בהגדרות או עם --model במקום זאת.

#לא ניתן היה לאשר את המודל עם ה-API

עברתם מודלים דרך המתודה setModel() של Agent SDK או אפליקציה שמריצה את ה-CLI של Claude Code עבורכם, כמו אפליקציית Desktop, והבקשה שמאשרת את מזהה המודל מול נקודת הקצה של ה-API שלכם לא קיבלה תשובה בתוך 15 שניות. הסשן שומר על המודל הנוכחי שלו.

Couldn't confirm model "claude-sonnet-5" with the API. Try again, or run /model to see available models.

בסשן שאפליקציית Desktop מתחילה עבורכם, ההודעה מסתיימת ב-Try again.

מה לעשות:

• עברו למודל שוב
• אם המעבר ממשיך להיכשל, בדקו ש-Claude Code יכול להגיע לנקודת הקצה של ה-API שלכם. ראו שגיאות רשת וחיבור

#שגיאת API בבדיקת המודל שנבחר

בחרתם מודל עם /model <name>, או שאפליקציה שמחוברת לסשן ביקשה את המעבר. ה-API סירב לבקשה המינימלית ש-Claude Code שולח כדי לאמת את המודל, מסיבה שאין לה ערך משלה, כמו מגבלת קצב או שגיאת שרת. הסשן שומר על המודל הנוכחי שלו, וההודעה מסתיימת באמירה על כך:

API error: 429 <the server's explanation> · model not changed

אמצע ההודעה הוא סטטוס ה-HTTP וההסבר של השרת עצמו.

מה לעשות:

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

#Claude Opus אינו זמין עם תוכנית Claude Pro

תוכנית המנוי הפעילה שלכם אינה כוללת את המודל שבחרתם.

Claude Opus is not available with the Claude Pro plan. If you have updated your subscription plan recently, run /logout and /login for the plan to take effect.

בסשן שאפליקציית Claude Desktop מריצה, ההודעה אומרת sign out and sign in again במקום לציין את הפקודות.

מה לעשות:

• הריצו /model ובחרו מודל שהתוכנית שלכם כוללת
• אם שדרגתם את התוכנית לאחרונה ועדיין רואים את זה, הריצו /logout ואז /login. האסימון השמור משקף את התוכנית שלכם בזמן ההתחברות, ולכן שדרוג ב-claude.ai לא נכנס לתוקף בסשן קיים עד שמתאמתים מחדש.
• ראו claude.com/pricing לגבי אילו מודלים כל תוכנית כוללת

#Claude Code לא תומך במודל הזה

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

API Error: 400 Claude Code 2.1.219 does not support this model; version 2.1.255 or newer is required. Run 'claude update', or update the Claude desktop app, then try again.

ניסוח מדיניות הארגון הוא:

API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.

הגרסה שה-API בודק היא זו שמדווחת על ידי הבינארי של Claude Code שביצע את הבקשה.

מה לעשות:

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

• אם אתה מריץ claude update בערוץ השחרור היציב, זה לא מעביר אותך מעבר לשחרור היציב החדש ביותר, שעדיין יכול להיות מתחת למינימום הנדרש. עבור לערוץ latest, ואז עדכן שוב. אם הארגון שלך נועל את הערוץ או הגרסה דרך הגדרות מנוהלות, בקש ממנהל המערכת לשנות את זה
• לניסוח לפי מודל, אפשר להמשיך לעבוד בסשן הנוכחי על ידי מעבר למודל אחר: הרץ /model ב-CLI, קרא ל-setModel() על אובייקט Query של TypeScript SDK במצב קלט זורם, או קרא ל-set_model() על ClaudeSDKClient של Python SDK
• לניסוח מדיניות הארגון, עדכן לפני שתמשיך

#המודל מוגבל בהגדרות הארגון שלך

מנהל הארגון השבית את המודל הזה בקונסולת הניהול של claude.ai, או שהגדרות מנוהלות מוציאות אותו דרך רשימת היתר availableModels או רשימת deniedModels. ההודעה מופיעה בהפעלה כש---model, ANTHROPIC_MODEL, או הגדרת model ציינו את המודל המוגבל, והיא מציינת את המודל שהסשן משתמש בו במקום. אם הגדרות מנוהלות לא משאירות מודל מותר שהסשן יכול להשתמש בו, ראה הגדרות מנוהלות חוסמות את מודל ברירת המחדל. הודעת ההחלפה יכולה להופיע גם באמצע סשן אחרי שמנהל משבית בקונסולת הניהול של claude.ai את המודל שסשן רץ עליו.

Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

הקלדת /model <name> למודל מוגבל נדחית והסשן שומר על המודל הנוכחי שלו. למודל שהושבת בקונסולת הניהול, הדחייה היא Model '<name>' is restricted by your organization's settings. Run /model to choose a different model. למודל שהגדרות מנוהלות מוציאות, הנוסח הוא Model '<name>' is not available. Your organization restricts model selection.

הודעה עם קידומת של שם סוכן, skill או פקודה אומרת שההגבלה חלה על המודל שהתבקש עבור אותו subagent: ה-subagent רץ על המודל החלופי ומודל הסשן שלך לא משתנה. לפני v2.1.223, Claude Code הציג את ההודעה רק עבור subagents שהושקו עם כלי Agent.

Claude Code מתייחס לכינוי משפחת מודלים, אחד מ-opus, sonnet, haiku או fable, כבקשה למשפחה הזאת ולא לגרסה החדשה ביותר שלה. ב-Anthropic API וב-Claude Platform on AWS, כינוי משפחה מוגבל נפתר לגרסה החדשה ביותר של המשפחה שהגדרות הארגון מתירות, והודעת ההחלפה מציינת את הגרסה הזאת. Claude Code דוחה /model <alias> רק כשכל גרסה של המשפחה מוגבלת. לפני v2.1.205, כינוי משפחה הוחלף או נדחה לפי הגרסה החדשה ביותר בלבד, גם כשגרסה ישנה יותר של אותה משפחה הותרה.

מה לעשות:

• הרץ /model כדי לבחור מהמודלים שהארגון מתיר. מודלים מוגבלים מוסתרים מהבורר.
• אם המודל המוגבל הוגדר ב---model, ב-ANTHROPIC_MODEL, בשדה model של קובץ הגדרות, או ב-frontmatter של model של subagent, skill או פקודה, הסר או עדכן את הערך כדי שההודעה לא תחזור
• אם אתה צריך גישה למודל המוגבל, בקש ממנהל הארגון להפעיל אותו. ראה הגבלות מודל של הארגון.

#אי אפשר לעבור למודל ברירת המחדל

בחרת את מודל Default, למשל על ידי בחירת השורה Default בבורר /model או הקלדת /model default. Claude Code סירב למעבר, אז הסשן שומר על המודל הנוכחי שלו.

Can't switch to the default model: your organization's managed settings block it (claude-opus-4-6) in "deniedModels", and none of the models they allow can be used as the default instead. Ask your administrator to update "deniedModels" or "availableModels".

הניסוח אחרי הנקודתיים מציין מה חסם את המעבר:

• your organization's managed settings block it ... in "deniedModels": רשימת חסימה מנוהלת חוסמת את המודל שאליו אפשרות Default נפתרת
• your organization allows only the models listed in "availableModels": רשימת היתר מנוהלת availableModels עם availableModelsMatch שמוגדר ל-"exact" משמיטה את המודל שאליו אפשרות Default נפתרת
• Claude Code couldn't read your organization's managed settings to check which models they allow: לא היה אפשר לקרוא את ההגדרות המנוהלות, ו-Claude Code מסרב למעבר במקום להחיל אותו בלי בדיקה

מה לעשות:

• לניסוחים של deniedModels ו-availableModels, הרץ /model ובחר לפי שם מודל שהארגון מתיר
• בקש ממנהל המערכת לעדכן את ההגדרה המנוהלת שההודעה מציינת
• לניסוח couldn't read, הפעל מחדש את Claude Code. אם זה ממשיך לקרות, בקש ממנהל המערכת לבדוק את ההגדרות המנוהלות

אם סשן במקום זה נכשל בהפעלה עם הודעת Claude Code can't start תחת ההגדרות המנוהלות האלה, ראה הגדרות מנוהלות חוסמות את מודל ברירת המחדל.

#מעבר מודל נחסם על ידי hook מסוג PreModelSwitch

hook מסוג PreModelSwitch לא אישר את מעבר המודל שאתה או לקוח ביקשתם, אז הסשן שומר על המודל הנוכחי שלו. כשהמעבר הגיע ממארח Agent SDK או מ-Remote Control ולא מפקודה שהקלדת, ההודעה היא Model switch blocked by a PreModelSwitch hook בלי לציין את מודל היעד.

Model switch to Opus 4.6 was blocked by a PreModelSwitch hook: Opus 4.6 is retired for this project. Use a newer model.

הסיבה אחרי הנקודתיים אומרת מה סירב למעבר:

• סיבה ש-hook כתב: hook מסוג PreModelSwitch סיפק את הסיבה הזאת כשדחה את המעבר או ביקש אישור. טפל במה שהוא מבקש, או בחר מודל שה-hooks שלך מתירים.
• PreModelSwitch hook <name> did not respond before its timeout: hook שלא עונה לפני ה-timeout שלו חוסם את המעבר. תקן את הפקודה שנתקעת או העלה את timeout של ה-hook הזה, ואז עבור שוב.
• confirmation required, and this session cannot ask: hook ענה ask בלי סיבה, ולבקשת בקרה אין דרך להציג את בקשת האישור. פקודת /model בהרצה עם -p מדווחת על אותו מצב עם (run /model interactively to confirm) אחרי הסיבה. בצע את המעבר מסשן אינטראקטיבי, או שנה את ההחלטה של ה-hook עבור המודל הזה.
• so organization-managed PreModelSwitch hooks could not be checked: Claude Code לא יכול היה לדעת אילו hooks מסוג PreModelSwitch התוספים המנוהלים של הארגון מספקים, למשל כי תוסף מנוהל נכשל בטעינה. אחד מה-hooks האלה עלול לחסום את המעבר, אז Claude Code מסרב במקום להחיל את המעבר בלי בדיקה. תחילת הסיבה מציינת מה נכשל. Claude Code בודק מחדש בכל ניסיון מעבר, אז כשל שכבר נפתר מפסיק לחסום. אם זה ממשיך להיכשל, הרץ claude --debug ועבור שוב כדי לתפוס את הפרטים, ואז תקן את התוסף או בקש מהמנהל לתקן אותו.
• a PreModelSwitch hook failed before answering או PreModelSwitch hooks were cancelled (the control stream closed) before answering: הרצת ה-hook הסתיימה בלי פסיקה, ו-Claude Code לא מתייחס לזה כאישור. הרץ claude --debug כדי לראות מה נכשל, ואז עבור שוב.

לפני v2.1.260, סירוב התוסף המנוהל היה plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log. Claude Code ניסה שוב לטעון את התוסף פעם אחת ואז סירב למעברים מאוחרים יותר בסשן, גם כשהארגון לא ניהל תוספים. הפעל מחדש את הסשן כדי להריץ את טעינת התוסף שוב בגרסאות האלה.

#לא היה אפשר לשמור את זה כברירת המחדל שלך

בחרת מודל לשמור כברירת המחדל שלך, למשל עם /model <name> או Enter בבורר /model, ו-Claude Code לא יכול היה לכתוב את הבחירה לקובץ הגדרות המשתמש שלך, ~/.claude/settings.json. המעבר עצמו חל, אז הסשן הנוכחי רץ על המודל שבחרת, אבל ברירת המחדל שלך לא השתנתה והסשן הבא מתחיל על הערך הישן.

Set model to Fable 5.1 for this session only · couldn't save it as your default: ~/.claude/settings.json can't be written (EROFS)

הסיבה אחרי נתיב הקובץ אומרת מה נכשל:

• can't be written (<code>): הכתיבה נכשלה עם קוד שגיאת מערכת ההפעלה בסוגריים, כמו EROFS כשהקובץ, או הקובץ שהוא מקשר אליו, נמצא על מערכת קבצים שמסרבת לכתיבות. הפוך את הקובץ לניתן לכתיבה ועבור שוב. אם כלי אחר מייצר את הקובץ, הגדר את המפתח model בכלי הזה במקום. ראה שינוי שעשית ב-Claude Code אובד בסשנים חדשים.
• isn't valid JSON: הקובץ בדיסק לא עובר פענוח, ו-Claude Code משאיר אותו בלי שינוי במקום לדרוס תוכן שהוא לא יכול לקרוא בחזרה. תקן את שגיאת התחביר, ואז עבור שוב. ראה תיקון קובץ הגדרות שבור.

הודעה שמסתיימת ב-couldn't confirm it was saved as your default (~/.claude/settings.json is still being written) אומרת שהכתיבה לא הסתיימה אחרי שלוש שניות. היא ממשיכה ברקע, אז ברירת המחדל עדיין עשויה להישמר. בדוק על איזה מודל הסשן הבא שלך מתחיל, או הרץ /model <name> שוב.

לפני v2.1.265, ההודעה אמרה שהמודל saved as your default for new sessions גם כשהכתיבה נכשלה.

#ה-advisor פחות מסוגל מהמודל הראשי הנוכחי

מודל ה-advisor שלך מדורג מתחת למודל הראשי של הסשן, אז Claude Code שומר על הבחירה אבל לא מחבר את ה-advisor לבקשות של המודל הראשי.

Advisor set to Opus 4.8
Note: Opus 4.8 is less capable than the current main model (Sonnet 5.5), so the advisor will not activate. Choose a more capable advisor, or switch to a smaller main model.

הודעות אחרות מדווחות על אותו מצב:

• בסשן אינטראקטיבי, התראה היא Advisor will not activate on the main model (advisor is less capable); subagents may still use it and may use more tokens · /advisor.
• כשאתה מפעיל עם הדגל --advisor במצב לא אינטראקטיבי, וההרצה אינה סשן רקע, אזהרה יוצאת ל-stderr וההרצה מתחילה בכל זאת. הנוסח הוא "<advisor>" cannot advise "<main model>" (the advisor must be at least as capable as the main model). The advisor will not be used for the main model. סשן אינטראקטיבי כותב את האזהרה הזאת רק ליומן הדיבוג.

מה לעשות:

• בחר advisor בדירוג גבוה יותר או מודל ראשי בדירוג נמוך יותר. בחירת מודל advisor מציגה את הדירוג ומפרטת את ה-advisors המתקבלים לכל מודל ראשי.
• השאר את ה-advisor מוגדר אם אתה רוצה ש-subagents שהמודל שלהם הוא יכול לייעץ להם ימשיכו להשתמש בו

לפני v2.1.287, Claude Code דירג כמה צירופים אחרת. הוא הציג את ההערה הזאת עבור advisor מסוג Sonnet 5.5 עם מודל ראשי Opus 4.7 או Opus 4.8, צירוף שהוא מקבל עכשיו. הוא גם חיבר כמה advisors שעכשיו מייצרים את ההערה הזאת, כמו advisor מסוג Opus 4.8 עם מודל ראשי Sonnet 5.5.

#thinking.type.enabled לא נתמך עבור המודל הזה

גרסת Claude Code שלך ישנה מהמינימום עבור המודל שנבחר. ה-CLI שלח תצורת thinking שהמודל כבר לא מקבל.

API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

מה לעשות:

• הרץ claude update והפעל מחדש את Claude Code. Opus 4.7 צריך v2.1.111 או חדש יותר. Opus 4.8 צריך v2.1.154 או חדש יותר. Sonnet 5 צריך v2.1.197 או חדש יותר. Opus 5 צריך v2.1.219 או חדש יותר. Opus 5.5 צריך v2.1.280 או חדש יותר. Sonnet 5.5 צריך v2.1.284 או חדש יותר
• בערוץ השחרור היציב, עדכון לא מעביר אותך מעבר לשחרור היציב החדש ביותר, שעדיין יכול להיות ישן יותר מהגרסאות האלה. עבור לערוץ latest, ואז עדכן
• אם אי אפשר לשדרג, הרץ /model ובחר Opus 4.6 או Sonnet 4.6 במקום
• אם נתקלת בזה ב-Agent SDK, שדרג את חבילת ה-SDK במקום. Opus 4.8 צריך TypeScript SDK v0.3.154 או חדש יותר ו-Python SDK v0.2.88 או חדש יותר. Sonnet 5 צריך TypeScript SDK v0.3.197 או חדש יותר. Opus 5 צריך TypeScript SDK v0.3.219 או חדש יותר. Opus 5.5 צריך TypeScript SDK v0.3.280 או חדש יותר. Sonnet 5.5 צריך TypeScript SDK v0.3.284 או חדש יותר

#Effort לא זמין כש-thinking כבוי

כיבית חשיבה מורחבת ורצת ברמת effort מעל high. המודל לא מקבל את הצירוף הזה, אז ה-API דחה את הבקשה.

API Error: Effort 'xhigh' isn't available with thinking turned off on this model · run /effort high to continue, or turn thinking back on (unset MAX_THINKING_TOKENS=0)

הרמז אחרי · משתנה לפי סשן: בסשן לא אינטראקטיבי הוא use --effort high (or the effortLevel setting), ובסשן שאפליקציית Claude Desktop מריצה הוא you can lower effort to High.

מה לעשות:

• הורד את רמת ה-effort ל-high או מתחת.
• הפעל מחדש את thinking, למשל על ידי ביטול ההגדרה של MAX_THINKING_TOKENS או הסרת "alwaysThinkingEnabled": false מההגדרות שלך.

לפני v2.1.242, Claude Code הציג את ההודעה של ה-API עצמו: API Error: 400 output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking. לפני v2.1.251, Claude Code שלח את הבקשה ברמת ה-effort שהגדרת, אז Opus 5 דחה כל בקשה מעל high עם thinking כבוי. Claude Code שולח עכשיו effort high למודלים שהוא יודע שדוחים את הצירוף, כמו Opus 5.

#תקציב ה-thinking חורג ממגבלת הפלט

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

API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

מה לעשות:

• העלה את CLAUDE_CODE_MAX_OUTPUT_TOKENS מעל תקציב ה-thinking
• ראה חשיבה מורחבת לאיך התקציב מקיים אינטראקציה עם אורך הפלט

#התשובה חרגה ממקסימום טוקני הפלט

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

API Error: Claude's response exceeded the ... output token maximum. To configure this behavior, set the CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable.
API Error: Claude's response exceeded the 64000 output token maximum for a request sent without streaming. The CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable cannot raise this limit.

הצורה שמציינת a request sent without streaming פירושה שבקשת סטרימינג נכשלה ו-Claude Code שלח אותה מחדש בלי סטרימינג, וזה מגביל את התשובה ל-64,000 טוקני פלט. לפני v2.1.299, תשובה שנקטעה בבקשה שנשלחה מחדש כזו סיימה את התור בלי ההודעה הזו, כאילו התשובה שלמה.

מה לעשות:

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

#אי התאמה בבלוק שימוש בכלי או בחשיבה

היסטוריית השיחה הגיעה ל-API במצב לא עקבי.

API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
API Error: 400 orphaned tool_result in conversation history. Run /rewind to recover the conversation.
API Error: 400 duplicate tool_use ID in conversation history. Run /rewind to recover the conversation.
API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks
API Error: 400 ... thinking blocks ... cannot be modified

כל הווריאנטים מתכוונים לאותו דבר: רצף בלוקי tool_use, tool_result ו-thinking בהיסטוריה כבר לא תואם את מה שה-API מצפה לו.

מה לעשות:

• אם אתם משתמשים ב-Opus 4.7 או ב-Opus 4.8, הריצו קודם claude update. גרסאות שלפני v2.1.156 יכולות להפעיל את השגיאה הזו במהלך שימוש רגיל בכלים, ו-/rewind לא מנקה אותה.
• הריצו /rewind, או לחצו על Esc פעמיים, כדי לחזור לנקודת ביקורת שלפני התור הפגום ולהמשיך משם. ראו Checkpointing לאופן שבו נקודות ביקורת נוצרות ומשוחזרות.

#נתונים לא תקינים בבלוק redacted_thinking

ה-API סירב לבקשה עם 400 כי לא יכול היה לקבל בלוק redacted_thinking שתור מוקדם יותר בהיסטוריית השיחה נושא.

API Error: 400 ... Invalid `data` in `redacted_thinking` block

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

מה לעשות:

• אם אתם ב-v2.1.281 או מוקדם יותר וכל תור נכשל עם השגיאה הזו, הריצו claude update והמשיכו את הסשן
• אם השגיאה נמשכת, הריצו /clear כדי להתחיל שיחה שלא נושאת את הבלוק

#תוכן כלי לא נתמך הוסר

כש-Claude Code מתחבר ישירות ל-API של Anthropic וטוען או מציג בתצוגה מקדימה סשן שמור, הוא מסיר תוכן כלים שה-API של Anthropic לא מקבל, ומשאיר את השורה הזו במקום שבו ישב התוכן שהוסר בין שני בלוקי חשיבה:

[Unsupported tool content removed]

תוכן כזה מגיע לקובץ סשן כשמשהו שאינו ה-API של Anthropic ענה בפורמט של ה-API, בדרך כלל פרוקסי של צד שלישי שמוגדר דרך ANTHROPIC_BASE_URL ומתרגם קריאות כלים של ספק אחר. Claude Code מסיר אותו רק כשהסשן מתחבר ישירות ל-API של Anthropic, וטוען את ההיסטוריה השמורה כמות שהיא כשהסשן רץ דרך פרוקסי או אצל ספק אחר. לפני v2.1.246, Claude Code שלח את השימוש בכלי ואת התוצאה שלו בחזרה ל-API, וכל תור של הסשן שחודש נכשל עם שגיאת 400 כגון messages.1.content.0.server_tool_use.name: Input should be 'web_search', 'web_fetch', ....

מה לעשות:

• אין צורך בפעולה כשרואים את שורת מציין המקום. הסשן ממשיך בלי התוכן שהוסר.
• אם כל תור של סשן שחודש נכשל עם שגיאת ה-400 במקום זאת, הריצו claude update והמשיכו את הסשן שוב. גרסאות שלפני v2.1.246 לא מסירות את התוכן.

#role 'system' חייב להקדים הודעת 'assistant'

ה-API סירב לבקשה עם 400 כי הודעת system יושבת במיקום בשיחה שהוא לא מקבל:

API Error: 400 messages.6: role 'system' must precede an 'assistant' message or end the array; ...

Claude Code שולח חלק מטקסט התזכורות והצרופות שלו כהודעות system בתוך השיחה. כשה-API מסרב למיקום של אחת מהן, Claude Code מנסה את הבקשה שוב פעם אחת, כשהטקסט הזה נשלח כהודעות משתמש רגילות. ניסוחי מיקום אחים של ה-API, כגון use the top-level 'system' parameter for the initial system prompt, מקבלים את אותו שחזור.

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

מה לעשות:

• אם השגיאה חוזרת בכל תור מאחורי פרוקסי או שער שמוגדר דרך ANTHROPIC_BASE_URL, התחברו בלי הפרוקסי כדי לאשר את המקור, ודווחו על השגיאה למי שמפעיל אותו
• הריצו /clear כדי להתחיל שיחה חדשה. אם השגיאה חוזרת גם שם, הסיבה נמצאת בנתיב הבקשה, לא בשיחה השמורה.

לפני v2.1.280, Claude Code לא זיהה את הניסוח הזה, ולכן השגיאה הופיעה גם כשהודעת ה-system שנדחתה הייתה הודעה ש-Claude Code עצמו שלח, וכל תור מאוחר יותר של השיחה נכשל באותו אופן.

#encrypted_content לא תקין בבלוק search_result

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

API Error: 400 ... Invalid `encrypted_content` in `search_result` block
API Error: 400 ... Invalid `encrypted_index` in `text` block
API Error: 400 ... Failed to decrypt web search result content
API Error: 400 ... Invalid `encrypted_stdout` in `encrypted_code_execution_result` block

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

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

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

מה לעשות:

• אם אתם ב-v2.1.281 או מוקדם יותר וכל תור נכשל עם אחד מניסוחי חיפוש האינטרנט, הריצו claude update והמשיכו את הסשן
• אם השגיאה נמשכת, או שההודעה מציינת encrypted_stdout, הריצו /rewind כדי לחזור לנקודת ביקורת שלפני התור שהוסיף את התוכן, או הריצו /clear כדי להתחיל שיחה שלא נושאת אותו
• אם אתם מריצים את Claude Code מאחורי פרוקסי או שער, דווחו על השגיאה למי שמפעיל אותו

#סירוב לפי מדיניות השימוש

ה-API סירב להגיב כי תוכן בשיחה הפעיל בדיקה של מדיניות השימוש.

אם ההודעה כוללת את השורה Details: `[reasoning_extraction]`, ראו אמצעי הגנה סימנו בקשה להנמקה של Claude.

ההודעה כוללת Request ID ו-Message ID שאפשר לצטט לתמיכה אם אתם סבורים שהסירוב שגוי.

API Error: Opus 4.6 can't help with this. Start a new session to continue.

Send feedback with /feedback or learn more: https://www.anthropic.com/legal/aup

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

הבדיקה מעריכה את השיחה המלאה, לא רק את ההנחיה האחרונה שלכם, ולכן שליחת הודעה חדשה באותו סשן בדרך כלל מפעילה מחדש את אותו סירוב. אותו דבר חל אחרי יציאה ופתיחה מחדש של הסשן עם --continue או --resume, כי התמליל בדיסק עדיין מכיל את התוכן המפעיל. ב-Amazon Bedrock, ב-Google Cloud's Agent Platform וב-Microsoft Foundry, ההודעה הזו מכסה גם בקשות שאמצעי הבטיחות של המודל סימנו כנושא אבטחת סייבר. ראו אמצעי בטיחות סימנו נושא אבטחת סייבר.

לפני v2.1.219, ההודעה נקראה Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.

מה לעשות:

• לחצו על Esc פעמיים או הריצו /rewind כדי לחזור לנקודת ביקורת שלפני התור שהפעיל את הסירוב, ואז נסחו מחדש או נקטו גישה אחרת. ראו Checkpointing.
• אם אינכם מצליחים לזהות איזה תור גרם לכך, הריצו /clear כדי להתחיל שיחה חדשה באותו פרויקט. השיחה הקודמת שלכם נשמרת בדיסק ונשארת זמינה ב-/resume.
• במצב לא אינטראקטיבי (-p), שבו rewind אינו זמין, נסו שוב עם הנחיה מנוסחת מחדש בסשן חדש בלי --continue. בדיקות המדיניות משתנות לפי מודל, ולכן מעבר למודל אחר עם --model עשוי גם לפתור את הסירוב בחלק מהמקרים.

#אמצעי בטיחות סימנו נושא אבטחת סייבר

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

API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude

אם ההודעה כוללת את השורה Details: `[reasoning_extraction]`, ראו אמצעי הגנה סימנו בקשה להנמקה של Claude.

ההודעה הזו מקשרת ל-Cyber Verification Program, שמעניק גישה לעבודת אבטחת סייבר לגיטימית. מודלים עם מעבר אוטומטי למודל חלופי מדפיסים הודעה אחרת, בלי הקישור הזה. ב-Opus 5.5 וב-Sonnet 5.5 היא נפתחת ב-<model>'s safeguards flagged this session. הסעיף הזה מכסה גם מתי Claude Code מחליף מודלים במקום זאת.

ב-Amazon Bedrock, ב-Google Cloud's Agent Platform וב-Microsoft Foundry, סימון אבטחת סייבר מייצר את הודעת סירוב לפי מדיניות השימוש במקום.

מה לעשות:

• אם העבודה שלכם דורשת את התוכן הזה, הגישו בקשה לגישה דרך Cyber Verification Program
• אם הבקשה שלכם לא עסקה בנושא אבטחת סייבר, הריצו /feedback כדי לדווח על זיהוי חיובי שגוי
• כדי להמשיך לעבוד באותו סשן, לחצו על Esc פעמיים או הריצו /rewind כדי לחזור לנקודת ביקורת שלפני התור שהפעיל את הסימון, ואז נקטו גישה אחרת. ראו Checkpointing.

אם ההודעה שאתם רואים מנוסחת כמו אחת מאלה, זה אותו סימון בגרסה מוקדמת יותר של Claude Code:

• מ-v2.1.219 עד v2.1.296, ההודעה יכלה לכלול גם Apply to the Cyber Verification Program to reduce these interruptions. לפני משפט הסיום שלה
• מ-v2.1.203 עד v2.1.218, ההודעה נקראה <model> has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center: ואחריו אותו קישור למרכז העזרה. בסשנים אינטראקטיביים היא המשיכה ב-If you were not engaging in a cybersecurity topic, please send feedback via /feedback.
• לפני v2.1.203, היא נקראה <model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption: ואחריו קישור לטופס פטור

#אמצעי הגנה סימנו בקשה להנמקה של Claude

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

Details: `[reasoning_extraction]`

לפני v2.1.234, הודעות הסירוב לא כללו את שורת Details.

מה לעשות:

• הסירו או נסחו מחדש כל הוראה שמבקשת מ-Claude לכתוב את החשיבה או את ההנמקה שלו כלשונן או בפורמט קבוע, כגון מקטע <thinking>, מקטע scratchpad, או שדה reasoning בפלט JSON. ההוראה יכולה להיות בהנחיה שלכם או בהתאמה אישית ש-Claude Code טוען יחד איתה, כגון CLAUDE.md, skill, הנחיה של subagent, סגנון פלט, או תיאור של כלי MCP.
• כדי לבדוק אם התאמה אישית היא הגורם, הריצו claude --safe-mode בטרמינל כדי להתחיל סשן כשההתאמות האישיות מושבתות, ואז שלחו את אותה הנחיה
• אחרי שינוי של התאמה אישית, התחילו סשן חדש
• כדי לנסח מחדש הנחיה שכבר שלחתם, ראו חזרה לאחור וסיכום
• עדיין אפשר לבקש מ-Claude להסביר את התשובה. בקשו הסבר קצר, את הראיות שמאחורי תוצאה, או סיכום של הפעולות שהוא ביצע. כדי לקרוא סיכומים של החשיבה של Claude, ראו showThinkingSummaries.
• לדוגמאות נוספות, ולמה לעשות אם בקשה שנוסחה מחדש עדיין נדחית, ראו שמירת ההנמקה בבלוקי חשיבה

#הפלט נחסם על ידי מדיניות סינון תוכן

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

API Error: Output blocked by content filtering policy

מה לעשות:

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

#שגיאות שורת פקודה

השגיאות האלה מגיעות משורת הפקודה claude ומתת-הפקודות שלה, משם פקודה שאתם מגישים בהנחיה, ומפקודות כגון /security-review שאוספות הקשר על ידי הרצת פקודות מעטפת לפני שההנחיה שלהן רצה. הן מגיעות גם מ-/tui, שמפעיל מחדש את ה-CLI.

#התנגשות בין --bg ל---print

ההודעה הזו דורשת את Claude Code מגרסה v2.1.198 ואילך. שילבתם את --bg עם -p או עם --print באותה הפעלה של claude. --bg מתחיל סשן רקע שאליו מתחברים אחר כך עם claude agents, בעוד --print רץ באופן לא אינטראקטיבי ולעולם לא מתחיל את הסשן האינטראקטיבי ש-claude agents מתחבר אליו. לפני v2.1.198 השילוב הזה יצר בשקט משימת רקע שלא היה אפשר להתחבר אליה.

--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional , drop --print: `claude --bg '<task>'`.

מה לעשות:

• השמיטו את -p או את --print. --bg מקבל את ההנחיה כארגומנט המיקומי שלו, כך ש-claude --bg "<task>" היא הפקודה המלאה. ראו שיגור סוכנים חדשים מהמעטפת.
• כדי להריץ את ההנחיה באופן לא אינטראקטיבי ולהדפיס את התוצאה במקום ליצור סשן רקע, השמיטו את --bg והריצו claude -p "<task>"

#לא ניתן לדעת אם --bg הוא דגל או טקסט

הרצת את claude עם --bg או --background במיקום שבו Claude Code לא הצליח לדעת אם התכוונת לדגל הרקע או לטקסט. הפקודה לא התחילה דבר, הדפיסה את השורה הזו, ויצאה עם קוד 1:

Couldn't tell whether --bg is a flag or text here, so nothing was started. To start a background session put it first: claude --bg <prompt>

אם הקלדת --background, השורה מציינת את --background במקום זאת.

מה לעשות:

• כדי להתחיל סשן ברקע, הרץ את הפקודה שוב במעטפת שלך כשהדגל ראשון: claude --bg --name nightly-audit "<task>"

#התנגשות בין דגל של system prompt לבין צורת הקובץ שלו

העברת את --append-subagent-system-prompt יחד עם --append-subagent-system-prompt-file בהפעלה אחת של claude, ולכן claude יוצא עם קוד 1 במקום להתחיל את הסשן:

Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.

לפני v2.1.283, claude יצא באותו אופן כשהעברת --system-prompt עם --system-prompt-file, או --append-system-prompt עם --append-system-prompt-file, כי הזוגות האלה התנגשו במקום להשתלב. בגרסאות האלה ההודעה מציינת את הזוג ששילבת.

מה לעשות:

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

#תצורת --agents לא תקינה

הערך שהעברת ל---agents לא תקין, ולכן claude יוצא עם קוד 1 במקום להתחיל את הסשן. כשאתה מעביר --safe-mode או מגדיר את CLAUDE_CODE_SAFE_MODE, Claude Code מתעלם מ---agents לגמרי. עם --resume או --continue, ערך JSON מוטמע לא נבדק והסשן מתחיל. ערך שנקרא מקובץ נבדק בכל הפעלה. לפני v2.1.242, Claude Code התחיל את הסשן בכל מקרה.

Error: Invalid --agents configuration:
<what failed>

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

1. כשהערך מתחיל ב-{ אבל לא מנותח כ-JSON, או שתוכן של קובץ --agents לא מנותח, Claude Code מדפיס שורת invalid JSON: אחת שנושאת את ההודעה של מנתח ה-JSON עצמו
2. כשהוא מנותח אבל הגדרת סוכן לא תואמת את הסכמה של סוכני משנה שמוגדרים ב-CLI, Claude Code מדפיס שורה אחת לכל בעיה
3. כששם סוכן מתחיל ב--, Claude Code מדפיס <name>: agent names must not start with '-'

כשיש יותר מ-20 שורות בעיה, Claude Code מדפיס את 20 הראשונות ומחליף את השאר ב-…and N more.

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

• Error: --agents takes a JSON object, or a file path only with --print (-p): Claude Code קרא את הערך כנתיב קובץ בסשן אינטראקטיבי. העבר את ההגדרות כ-JSON מוטמע, או הוסף -p כדי לקרוא אותן מקובץ.
• Error: --agents file not found: <path>: אין קובץ בנתיב הזה. ערך שלא מתחיל ב-{ ואינו JSON תקין נקרא כנתיב, ולכן גם JSON מוטמע שהמעטפת שלך שיבשה יכול להיכשל כך. בדוק את הנתיב או את המירכאות והרץ את הפקודה שוב.

מה לעשות:

• תקן כל בעיה שההודעה מפרטת, ואז הרץ את הפקודה שוב. ראה את השדות שסוכן משנה שמוגדר ב-CLI מקבל.

#לא ניתן ליצור סשנים בענן מסשן --restricted

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

Cloud sessions cannot be created from a --restricted session: they would not enforce it.

מה לעשות:

• הרץ את המשימה מקומית בסשן המוגבל
• אם אתה שולט באופן שבו הסשן הופעל, התחל סשן claude חדש בלי --restricted וצור ממנו את הסשן בענן

לפני v2.1.248, ל-Claude Code לא היה דגל --restricted. גרסאות מוקדמות יותר דוחות את הדגל עצמו עם שגיאת אפשרות לא מוכרת.

#סשנים בענן מושבתים לפי מדיניות הארגון שלך

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

Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.

ההודעה מופיעה כשאתה יוצר סשן בענן מהטרמינל וכשאתה שולח פקודה שזקוקה לסשנים בענן, כמו /teleport, /remote-env, או /web-setup. לפני v2.1.268, שליחת אחת מהפקודות האלה החזירה Unknown command במקום זאת.

אם ההודעה במקום זאת מציינת אישור שסשן זה משתמש בו ומסתיימת ב-Cloud sessions use your claude.ai login., ראה סשנים בענן משתמשים בהתחברות שלך ל-claude.ai. אם Claude Code לא הצליח לטעון את מדיניות הארגון שלך בכלל, אתה רואה הודעה אחרת במקום זאת.

מה לעשות:

• בקש מ-Owner בארגון שלך להפעיל סשנים בענן בהגדרות הניהול של Claude Code בכתובת claude.ai/admin-settings/claude-code

#סשנים בענן משתמשים בהתחברות שלך ל-claude.ai

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

Cloud sessions are disabled by your organization's policy. This session is using ANTHROPIC_API_KEY, so Claude Code checked the policy for the organization that key belongs to. Cloud sessions use your claude.ai login.

המשפט האחרון אומר שסשנים בענן רצים על ההתחברות שלך ל-claude.ai ולא על האישור הזה. הצורה הזו מופיעה כשאתה מתחיל, ממשיך או שולח הודעה לסשן בענן מהמעטפת שלך, למשל עם --cloud או --teleport. לפני v2.1.296, Claude Code הדפיס גם במקרה הזה את הצורה שאומרת לפנות למנהל הארגון שלך.

#לא ניתן לאמת את מדיניות הארגון שלך לסשנים בענן

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

Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.

בתוך סשן, פקודה שזקוקה לסשנים בענן, כמו /teleport או /web-setup, נותנת גם היא את ההודעה הזו. היא עושה זאת גם במקום שבו המעטפת שלך הייתה מדפיסה צורה של Cloud sessions aren't available:, והמשפט השני שלה הוא Check your network connection, then restart Claude Code and try again.

אחרי שבקשת המדיניות נכשלה, ההודעה אומרת מה נכשל. זה חל כשאתה מתחיל, ממשיך או שולח הודעה לסשן בענן מהמעטפת שלך עם דגל כמו --cloud או --teleport. כשאין מסלול ל-API, היא נקראת כך:

Cloud sessions aren't available: couldn't reach api.anthropic.com to load your organization's policy. Check your network or proxy.

כשלים אחרים ממשיכים באותה פתיחה עם הסיבה שלהם, כמו פרוקסי שסירב לבקשה עם HTTP 403, שגיאת שרת, או אישורים שה-API לא קיבל. כשה-API לא קיבל אישור שסשן זה משתמש בו במקום ההתחברות שלך ל-claude.ai, כמו משתנה הסביבה ANTHROPIC_API_KEY, ההודעה יכולה גם לציין אותו ולומר לבטל את ההגדרה שלו:

Cloud sessions aren't available: api.anthropic.com didn't accept this session's credentials when Claude Code asked for your organization's policy. Cloud sessions use your claude.ai login. ANTHROPIC_API_KEY is set, so this session is using API-key auth , unset it (or run in a shell without it) to use cloud sessions.

לפני v2.1.296, הכשלים האלה הדפיסו גם את הודעת Couldn't verify.

מה לעשות:

• עבור הודעת Couldn't verify, בדוק את חיבור הרשת ונסה שוב. בתוך סשן, הפעל מחדש את Claude Code קודם
• עבור הודעת Cloud sessions aren't available:, עשה מה שהסיבה שלה דורשת, כמו בדיקת הפרוקסי או ביטול ההגדרה של האישור שהיא מציינת, ואז הרץ את הפקודה שוב

#דבר לא נשמר ב-stash כי תיקייה החליפה קובץ במעקב

ההודעה הזו אומרת שתיקייה ב-checkout שלך יושבת עכשיו במקום שבו היה קובץ או קישור במעקב של git. היא מופיעה אחרי שאתה בוחר באפשרות ה-stash בזמן משיכת סשן בענן לטרמינל שלך, למשל עם claude --teleport או /teleport. שמירת המצב הזה ב-stash עלולה למחוק את הקבצים שבתוך התיקייה, ולכן Claude Code מסרב ל-stash ומשאיר את ה-checkout ואת ה-index ללא שינוי:

Error: Nothing was stashed: "f" is now a folder in place of a tracked file or link, and stashing could delete what's in it for good. Commit the change or move the folder somewhere else, then try again.

מה לעשות:

• בצע commit לשינוי או העבר את התיקייה למקום אחר, כפי שההודעה אומרת, ואז הרץ את ה-teleport שוב

#הערך של --json-schema אינו JSON Schema תקין

הסכמה שהעברת ל---json-schema במצב לא אינטראקטיבי נכשלה בקומפילציה של JSON Schema, ולכן claude יוצא עם קוד 1 במקום להריץ את ה-prompt. לפני v2.1.205, סכמה לא תקינה יצרה פלט לא מובנה בלי שגיאה, וכל סכמה שהשתמשה במילת המפתח format טופלה כלא תקינה.

Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

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

Claude Code מריץ שתי בדיקות לפני קומפילציית הסכמה: הוא דוחה ערך שאינו JSON שניתן לניתוח עם Error: --json-schema is not valid JSON, ו-JSON תקין שאינו אובייקט עם Error: --json-schema must be a JSON object.

מה לעשות:

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

#קובץ ההגדרות חורג ממגבלת 2MiB

הקובץ שהעברת ל---settings גדול מ-2 MiB, ולכן claude יוצא עם קוד 1 בהפעלה במקום לטעון אותו. לפני v2.1.214, Claude Code קרא את הקובץ בלי בדיקת גודל, וקובץ של כמה גיגה-בייט או קובץ התקן כמו /dev/zero הגדיל את הזיכרון בלי גבול.

Error: Settings file exceeds the 2MiB limit: /path/to/settings.json

Claude Code דוחה נתיב --settings שאינו קובץ רגיל באותו אופן: התקן, FIFO, או socket מדווחים Error: Cannot use settings file (Not a regular file (device, FIFO, or socket)) ואחריו הנתיב, ותיקייה מדווחת סיבת EISDIR.

מה לעשות:

• כוון את --settings לקובץ הגדרות JSON רגיל שקטן מ-2 MiB. ראה Settings לפורמט.

#שגיאת תצורה ב-~/.claude.json

Claude Code לא הצליח לנתח את ~/.claude.json, הקובץ שמחזיק את פרטי החשבון שלך, שרתי MCP, ומצב לפי פרויקט. הקובץ שלך לא השתנה. התחלה לא אינטראקטיבית כמו claude -p יוצאת עם קוד 1 בכל פעם עד שתתקן את הקובץ.

כש-Claude Code מוצא גיבוי, הפלט מציין אותו ומדפיס שורת cp שמעתיקה אותו בחזרה:

Claude configuration file at /home/user/.claude.json is corrupted: <JSON parser's message>
The corrupted file has been backed up to: /home/user/.claude/backups/.claude.json.corrupted.1793664000000
A backup file exists at: /home/user/.claude/backups/.claude.json.backup.1793660400000
You can manually restore it by running: cp -f "/home/user/.claude/backups/.claude.json.backup.1793660400000" "/home/user/.claude.json"

Configuration error in /home/user/.claude.json: <JSON parser's message>

מה לעשות:

• בפלט יש שורת cp: הרץ את השורה הזו בטרמינל שלך. ב-Windows, הרץ אותה ב-PowerShell. היא מחליפה את הקובץ השבור בגיבוי, גרסה מוקדמת יותר של ~/.claude.json.
• בפלט אין שורת cp, או שהשגיאה חוזרת אחרי שהרצת אותה: תקן את ה-JSON ב-~/.claude.json, העתק מעליו קובץ .claude.json.backup.<timestamp> אחר מ-~/.claude/backups/ אם יש כזה, או שנה את שמו. כשאין קובץ ב-~/.claude.json, Claude Code מתחיל עם הגדרות ברירת מחדל ובלי מה שהקובץ החזיק.

לפני v2.1.318, נשארת עם ברירות מחדל ב-~/.claude.json אחרי שהתחלה לא אינטראקטיבית הדפיסה את השגיאה הזו, ולכן ההתחלה הבאה רצה בלי התצורה שלך.

#קובץ התצורה של Claude היה ריק ואין גיבוי שמחזיק דבר

ההודעה הזו בהפעלה אומרת שהקובץ שהיא מציינת היה ריק ואף אחד מעותקי .backup של הקובץ אינו מחזיק דבר. Claude Code התחיל עם ברירות מחדל למה שהקובץ הזה מחזיק. קובצי settings.json ו-.mcp.json שלך הם קבצים נפרדים.

Claude configuration file at /home/user/.claude.json was empty and no backup holds anything: starting with defaults.

מה לעשות:

• הגדר מחדש את מה שהגדרת בקובץ הזה. לדוגמה, הוסף את שרתי MCP בטווח user ו-local שלך עם claude mcp add מהטרמינל שלך.
• התחבר שוב אם Claude Code מבקש ממך

לפני v2.1.318, Claude Code דיווח על קובץ ריק בלי גיבוי כפגום.

#התיקייה הנוכחית כבר לא קיימת

התחלת את claude מתיקייה שנמחקה או הועברה אחרי שהמעטפת שלך נכנסה אליה, למשל worktree או תיקייה זמנית שמעטפת אחרת הסירה. Claude Code לא יכול לקרוא את תיקיית העבודה שלו, ולכן הוא יוצא עם קוד 1 לפני תחילת הסשן, גם במצב אינטראקטיבי וגם במצב לא אינטראקטיבי. לפני v2.1.239, Claude Code קרס עם מקור bundle ממוזער ו-stack גולמי של ENOENT ... uv_cwd ב-stderr במקום ההודעה הזו.

The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.

הסיבה והתיקון זהים בשתי הצורות.

כש-Claude Code לא יכול לקרוא את תיקיית העבודה מסיבה אחרת, כמו שינוי הרשאות, ההודעה מציינת את קוד השגיאה במקום זאת: Can't read the current directory (EACCES). Start Claude Code from a different directory.

ב-macOS, EPERM עבור תיקייה ב-~/Desktop, ~/Documents, ~/Downloads, או iCloud Drive בדרך כלל אומר ש-macOS חוסם את אפליקציית הטרמינל שלך מהתיקייה הזו. פקודות אחרות שקוראות את התיקייה הזו נכשלות באותו אופן: ls שם מדווח Operation not permitted, גם עם sudo.

מה לעשות:

• עבור לתיקייה שקיימת, כמו תיקיית הבית או תיקיית הפרויקט שלך, ואז הרץ את claude שוב
• אם התיקייה נוצרה מחדש באותו נתיב, המעטפת שלך עדיין מחזיקה את זו שנמחקה. הרץ cd "$PWD" או צא וחזור לתיקייה, ואז הרץ את claude שוב
• עבור EPERM ב-macOS, צא מאפליקציית הטרמינל שלך עם Cmd+Q, פתח אותה שוב, חזור לתיקייה הזו, והרץ את claude. אם ls בתיקייה הזו עדיין נכשל, פתח את System Settings > Privacy & Security > Files and Folders, הפעל את התיקייה עבור אפליקציית הטרמינל שלך, ואז פתח מחדש את הטרמינל

#ספריית זמנית נדחתה או שלא ניתן ליצור אותה

ב-macOS וב-Linux, קלוד קוד יוצר בהפעלה ספרייה זמנית פרטית, claude-<uid>, תחת ספריית הזמניים של המערכת או תחת העקיפה CLAUDE_CODE_TMPDIR. כאשר לא ניתן ליצור את הספרייה, או שרשומה שכבר נמצאת בנתיב הזה נכשלת בבדיקות הבטיחות, קלוד קוד מדפיס את הכשל ל-stderr ויוצא עם קוד 1 במקום להתחיל את הסשן:

Claude Code's temporary directory /tmp/claude-501 could not be created: the volume holding /tmp is full (ENOSPC). Free space on that volume, or set CLAUDE_CODE_TMPDIR to a directory on another one, then try again.

Temp directory /tmp/claude-501 is not a directory (may be an attacker-planted symlink). Refusing to use it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

Temp directory /tmp/claude-501 is owned by uid 502, expected 501. Refusing to use it , another user may have pre-created it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

Temp directory /tmp/claude-501 is not readable (its mode may have been altered, or a path component denies search). Refusing to use it , restore its permissions (chmod 0700) or remove it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

מה לעשות:

• עבור could not be created ואחריו is full (ENOSPC), פנו מקום בדיסק באמצעי האחסון שההודעה מציינת. כאשר כתוב במקום זאת your disk quota on the volume holding /tmp is used up (EDQUOT), מחקו קבצים משלכם באמצעי האחסון הזה שכבר אינכם צריכים
• עבור הצורות של Refusing to use it, הסירו את הרשומה ששמה מופיע עצמה, לא את מה שקישור מצביע אליו, והפעילו את קלוד קוד שוב. עבור הצורה owned by uid, רק מנהל מערכת או אותו משתמש יכולים להסיר אותה
• עבור is not readable, הריצו chmod 0700 על הספרייה ששמה מופיע, או הסירו אותה והפעילו שוב
• בכל אחד מהמקרים האלה, הגדירו את CLAUDE_CODE_TMPDIR לספרייה שבשליטתכם והפעילו את קלוד קוד שוב, והשאירו את הנתיב שנדחה כמו שהוא

לפני v2.1.309, קלוד קוד הדפיס רק את טקסט השגיאה של מערכת ההפעלה כאשר אמצעי האחסון היה מלא או שהמכסה שלכם נוצלה. דוגמה היא ENOSPC: no space left on device, mkdir '/tmp/claude-501', ואותם צעדים חלים.

#לא ניתן היה לפענח את הספרייה למיקום אמיתי

הרצתם /add-dir עבור תת-ספרייה של ספריית העבודה, וקלוד קוד לא הצליח לפענח את הספרייה למיקום האמיתי שלה.

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

packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.

מה לעשות:

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

לפני v2.1.261, ההודעה הזו הופיעה גם עבור כל /add-dir <subdirectory> כאשר ספריית העבודה הייתה על automount של /net/<host>, שבו קלוד קוד נמנע מפענוח נתיבים לפי התכנון. הספרייה הייתה תקינה, וניסיון חוזר לא יכול היה לעזור.

#סביבת העבודה אינה מהימנה בעת הפעלת Remote Control

[!NOTE]

אם claude ultrareview הדפיס Error: Workspace not trusted, ראו סביבת העבודה אינה מהימנה בעת הרצת claude ultrareview.

הפעלתם מצב שרת של Remote Control באמצעות claude remote-control או הכינוי claude rc שלו, בספרייה שעדיין לא סימנתם כמהימנה, והפקודה לא יכלה לשאול אתכם אם לסמוך עליה. לדוגמה, הקלט התקני או הפלט התקני של הפקודה אינו מסוף, כי אחד מהם מופנה או מועבר בצינור. הפקודה יוצאת עם קוד 1:

Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.

שתי וריאציות שגם הן מתחילות ב-Error: Workspace not trusted. מופיעות במסוף קטן מדי כדי להציג מה אמון בספרייה מפעיל, או במסוף שלא דיווח על הגודל שלו. הגדילו את החלון או עברו לחלון מסוף רגיל, ואז הריצו claude rc שוב.

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

Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).

אם תענו n או תלחצו Enter בשאלה Trust <directory>?, הפקודה מדפיסה הודעת Remote Control did not start שמציינת את הספרייה ויוצאת עם קוד 1. הריצו claude rc שוב כדי לענות y.

מה לעשות:

• סמכו על הספרייה קודם מתוך מסוף: הריצו שם claude rc וענו y, או הריצו שם claude וקבלו את תיבת הדו-שיח של אמון בסביבת העבודה, ואז הריצו שוב את הפקודה המקורית
• בספריית הבית, עברו לספריית פרויקט והפעילו שם את Remote Control

לפני v2.1.284, הפקודה לא שאלה אף פעם, גם במסוף.

#סביבת העבודה אינה מהימנה בעת הרצת claude ultrareview

בתיקייה שעדיין לא סימנתם כמהימנה, כאשר claude ultrareview לא יכול לשאול אם אתם סומכים עליה, ההרצה יוצאת עם קוד 1 לפני שהסקירה מתחילה:

Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog. Or, in a script or CI job, pass `--trust-workspace` to trust the folder for this run only.

לדוגמה, פקודת המשנה לא יכולה לשאול כאשר הקלט התקני או הפלט התקני שלה אינו מסוף. שליחת הפלט לקובץ, כמו ב-claude ultrareview --json > findings.json, פירושה שהפלט התקני אינו מסוף.

מה לעשות:

• בסקריפט או בעבודת CI, הוסיפו --trust-workspace כדי לסמוך על התיקייה להרצה הזו: claude ultrareview --trust-workspace. הוסיפו אותו רק עבור קוד שאתם סומכים עליו, כי git וקלוד קוד יכולים אז להריץ תוכניות ששמן מופיע בתצורת ה-git ובהגדרות הפרויקט של התיקייה. עבור בקשת משיכה שהקוד שלה אינו מהימן אצלכם, הריצו את הסקירה מענף שאתם סומכים עליו.
• במחשב שלכם, הריצו claude בתיקייה הזו וקבלו את תיבת הדו-שיח של אמון בסביבת העבודה, ואז הריצו שוב את הפקודה המקורית

כל אחת מההודעות האלה מ-claude ultrareview פירושה שלא התחילה סקירה וקוד היציאה הוא 1:

• Error: Workspace not trusted. This terminal ...: המסוף לא דיווח על מספר שורות ועמודות, או שאינו יכול להכיל את שאלת האמון ואת האזהרות שלה. הגדילו אותו או השתמשו במסוף שמדווח על הגודל שלו, ואז הריצו claude ultrareview שוב. מחוץ לספריית הבית, אפשר גם להריץ claude בתיקייה הזו פעם אחת ולקבל את תיבת הדו-שיח של האמון, כך שהרצות מאוחרות שם לא ישאלו.
• Error: Workspace not trusted. <folder> is your home directory: מכיוון שאמון עבור ספריית הבית לעולם לא נשמר, הרצת claude שם קודם לא יכולה לעזור. הריצו claude ultrareview מספריית פרויקט, אחרי הרצת claude שם פעם אחת כדי לקבל את תיבת הדו-שיח של האמון, או הוסיפו --trust-workspace.
• No answer in time. ואחריו Error: Workspace not trusted: השאלה Trust <folder>? [y/N] נשארה בלי מענה במשך 5 דקות. הריצו claude ultrareview שוב וענו עליה.
• Ultrareview did not start: <folder> is not trusted: סירבתם בשאלה Trust <folder>? [y/N], לדוגמה על ידי מענה n או לחיצה על Enter. כדי להתחיל את הסקירה, הריצו claude ultrareview שוב וענו y.
• Ultrareview did not start: `--trust-workspace` takes no value: משהו שאינו דגל מופיע אחרי --trust-workspace, כמו מספר PR או false. אם אינכם סומכים על התיקייה, השמיטו את הדגל. כדי לסמוך עליה להרצה הזו, שימו את מספר ה-PR או את ענף הבסיס לפני הדגל: claude ultrareview 1234 --trust-workspace.

לפני v2.1.309, claude ultrareview לא קיבל את --trust-workspace.

#לא מועבר לסשנים ש-Remote Control מתחיל

הפעלתם את Remote Control עם דגל גלובלי של claude לפני הפועל remote-control, דגל שהיה מגביל או מגדיר את הסשנים ש-Remote Control מתחיל, כמו --settings, --setting-sources, --permission-mode, --disallowed-tools או --mcp-config. דגל שמוצב לפני הפועל לעולם לא מגיע לסשנים האלה. קלוד קוד מסרב להתחיל, ומציין את הדגל:

Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it , remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).

קלוד קוד לא מסרב לדגלים גלובליים שאפשר להשמיט בלי נזק, כמו --verbose, --model, או --session-id או --plugin-dir שמוזרקים על ידי מעטפת: הוא מתעלם מהם ו-Remote Control מתחיל.

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

מה לעשות:

• הסירו את הדגל מלפני הפועל והעבירו אפשרויות משלו של Remote Control אחריו. claude remote-control --help מפרט אותן
• כאשר הדגל שנדחה הוא --permission-mode, הריצו claude remote-control --permission-mode <mode> כדי להגדיר את מצב ההרשאות עבור הסשנים ש-Remote Control מתחיל

לפני v2.1.248, claude remote-control לא קיבל את הדגלים שלו כאשר דגל גלובלי הגיע קודם, והפקודה נכשלה עם שגיאת unknown option.

#--sandbox או --no-sandbox אינו נתמך על ידי claude remote-control

השגיאה הזו אומרת שהפקודה שמפעילה את שרת Remote Control שלכם מעבירה --sandbox או --no-sandbox אחרי remote-control, ו-claude remote-control לא מקבל אף אחד משני הדגלים. השרת יוצא עם קוד 1 במקום להתחיל:

Error: --sandbox is not supported by claude remote-control. The flag had no effect and was removed. To sandbox sessions, set sandbox.enabled to true in settings.
Error: --no-sandbox is not supported by claude remote-control. The flag had no effect and was removed. Remove it from the command.

מה לעשות:

• הסירו את הדגל מהפקודה, כולל בסקריפט או בהגדרת שירות שמפעילים עבורכם את השרת, ואז הריצו אותה שוב
• כדי להפעיל sandbox לסשנים שהשרת מתחיל, הפעילו sandboxing על ידי הגדרת sandbox.enabled ל-true בקובץ הגדרות

שני הדגלים הוסרו מ-claude remote-control ב-v2.1.300, ולכן פקודה שנכתבה לגרסה מוקדמת יותר עדיין יכולה לכלול אחד מהם.

#claude import עדיין אינו זמין בבילד הזה

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

`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.

קלוד קוד מפעיל את claude import באמצעות דגל תכונה שהוא מביא מ-Anthropic ושומר במטמון על הדיסק. ההודעה הזו אומרת שהערך שבמטמון כבוי. הסיבה היא בדרך כלל אחת מהבאות:

• לא הפעלתם סשן מאז ההתקנה, ולכן קלוד קוד עדיין לא הביא את הדגל. ה-claude import הראשון יכול להדפיס את זה גם כאשר התכונה זמינה לכם.
• אתם משתמשים בקלוד קוד דרך Amazon Bedrock, Agent Platform של Google Cloud, Microsoft Foundry, או Claude Platform on AWS, או דרך Claude apps gateway. קלוד קוד לא מביא דגלי תכונה בסשנים האלה, ולכן claude import נשאר לא זמין.
• הגדרתם DISABLE_TELEMETRY, DO_NOT_TRACK, DISABLE_GROWTHBOOK, או CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, והם מכבים את הבאת דגלי התכונה, ולכן claude import נשאר לא זמין.

מה לעשות:

• בהתקנה חדשה, הפעילו claude, המתינו לטעינת הסשן, צאו, והריצו claude import שוב
• במקום שבו הבאת דגלי תכונה נשארת כבויה, הגדירו את התצורה בעצמכם: הוסיפו שרתי MCP עם claude mcp add, וצרו את קבצי CLAUDE.md, skills ופקודות, וסוכני משנה שאתם רוצים להעביר. ההודעה גם מציינת את ~/.claude/settings.json. מתוך התצורה ש-claude import מעביר, הקובץ הזה מחזיק רק את מצב ההרשאות. קלוד קוד לא קורא ממנו שרתי MCP.

#לא ניתן היה לקרוא את תצורת Claude Code

הרצתם claude import בזמן שקלוד קוד לא הצליח לפרסר את ~/.claude.json, הקובץ שבו הוא שומר את פרטי החשבון ואת המצב לפי פרויקט. פקודת המשנה קוראת את הקובץ כדי לבדוק זמינות, אבל לא מציגה את תיבת הדו-שיח לשחזור שהסשן האינטראקטיבי מציג, ולכן היא יוצאת עם קוד 1. לפני v2.1.222, claude import עם קובץ תצורה שלא ניתן לקריאה התחיל סשן אינטראקטיבי, שתיבת הדו-שיח לשחזור שלו טיפלה בקובץ.

Could not read Claude Code config , run `claude` with no arguments to recover it.

מה לעשות:

• הריצו claude בלי ארגומנטים. קלוד קוד מזהה את הקובץ הלא תקין ומציע לאפס אותו. אחר כך הריצו claude import שוב.
• כדי לשמור עריכות ידניות שעשיתם, תקנו את תחביר ה-JSON ב-~/.claude.json בעורך, ואז הריצו שוב את claude import

#לא ניתן היה לייבא שרת מ-Claude Desktop

קלוד קוד לא הצליח להוסיף אחד מהשרתים שבחרתם ב-claude mcp add-from-claude-desktop. הפקודה עדיין מייבאת את שאר השרתים שנבחרו ומדפיסה שורה אחת לכל שרת שלא הצליחה להוסיף. לפני v2.1.205, השרת הראשון שנכשל עצר את הייבוא.

Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

הטקסט שאחרי שם השרת הוא הסיבה. הסיבה הנפוצה ביותר היא בדיקת השם: Claude Desktop מתיר תווים בשמות שרתים, כמו רווחים ונקודות, ש-claude mcp מגביל לאותיות, מספרים, מקפים וקווים תחתונים. סיבות נוספות כוללות תצורת שרת שנכשלת באימות, ושרת שנחסם על ידי מדיניות MCP של הארגון.

מה לעשות:

• שנו את שם השרת ב-claude_desktop_config.json כך שישתמש רק באותיות, מספרים, מקפים וקווים תחתונים, ואז הריצו claude mcp add-from-claude-desktop שוב
• הוסיפו את השרת הזה ישירות עם claude mcp add או claude mcp add-json תחת שם תקין. ראו ייבוא שרתי MCP מ-Claude Desktop.

#לא ניתן להוסיף שרת MCP להיקף managed

הרצתם claude mcp add או claude mcp add-json עם --scope managed. ההיקף הזה מחזיק את השרתים שהארגון מספק דרך ההגדרה המנוהלת managedMcpServers. קלוד קוד קורא אותם רק מהגדרות מנוהלות, ולכן הפקודה לא יכולה לכתוב שרת להיקף הזה.

Cannot add MCP server to scope: managed

מה לעשות:

• הוסיפו את השרת להיקף שאפשר לכתוב אליו: local, user או project. בלי --scope, הפקודה משתמשת ב-local. ראו היקפי התקנת MCP
• כדי לספק את השרת לכל משתמש בארגון, הוסיפו אותו ל-managedMcpServers בהגדרות המנוהלות שאתם פורסים

#לא ניתן להוסיף שרת MCP כשההגדרות המנוהלות מאפשרות רק שרתים מתוספים

הרצת claude mcp add או claude mcp add-json בזמן שההגדרות המנוהלות של הארגון מגדירות את strictPluginOnlyCustomization ל-true או לרשימה שכוללת את mcp. עם ההגדרה הזו, Claude Code לא טוען שרתי MCP מ-~/.claude.json או מ-.mcp.json, ולכן הפקודה יוצאת עם קוד 1 במקום לשמור שרת שלעולם לא ייטען:

Cannot add MCP server: your organization's managed settings allow only MCP servers that plugins provide. Install a plugin that provides this server, or ask your administrator to make it available.

claude mcp add-from-claude-desktop מדווח על כל שרת שבחרת כלא יובא, עם ההודעה הזו כסיבה. /import מדווח על ההודעה הזו לכל שרת MCP שהוא מנסה להוסיף, ועדיין מייבא את שאר הפריטים שמצא.

לפני v2.1.284, הפקודות האלה שמרו את השרת ודיווחו על הצלחה, והשרת מעולם לא נטען.

מה לעשות:

• התקן תוסף שמספק את השרת
• בקש ממנהל המערכת להפיץ את השרת בתוסף, או לספק אותו דרך managedMcpServers אם זה שרת HTTP או SSE מרוחק

#לא ניתן לקרוא את .mcp.json

פקודה שקוראת את .mcp.json של הפרויקט, כמו claude mcp add או claude mcp add-json עם --scope project, או claude mcp remove, מצאה שהקובץ בתיקייה הנוכחית אינו קובץ רגיל או גדול מ-2 MiB, ולכן היא יוצאת עם השגיאה הזו במקום לקרוא את הקובץ.

Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.

לפני v2.1.257, FIFO ב-.mcp.json השאיר את הפקודה ממתינה לנצח בלי פלט, וקישור סמלי לקובץ התקן כמו /dev/zero הגדיל את הזיכרון עד שהתהליך נהרג.

מה לעשות:

• בדוק מה נמצא ב-.mcp.json בתיקייה הנוכחית. החלף אותו בקובץ JSON רגיל בפורמט של היקף הפרויקט, או מחק אותו, ואז הרץ את הפקודה שוב.

#שרת MCP לא נשמר או לא הוסר

הרצת claude mcp add, claude mcp add-json או claude mcp remove עבור שרת בהיקף user או local. שני ההיקפים נשמרים ב-~/.claude.json, והשינוי אינו בקובץ הזה כש-Claude Code קורא אותו בחזרה אחרי הכתיבה. הפקודה יוצאת עם השגיאה הזו במקום בשורת ההצלחה שלה.

MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.

אחרי הסרה, ההודעה אומרת was not removed from ומסתיימת ב-then remove the server again. עבור שרת בהיקף local, אחרי הנתיב מופיעה תיקיית הפרויקט שהרשומה שייכת אליה, בצורה (local scope for /path/to/project).

לפני v2.1.283, claude mcp add, claude mcp add-json ו-claude mcp remove דיווחו על הצלחה גם כשהשינוי לא הגיע לקובץ.

מה לעשות:

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

#ייתכן ששרת MCP לא נשמר או לא הוסר

הרצת claude mcp add, claude mcp add-json או claude mcp remove עבור שרת בהיקף user או local, ו-Claude Code לא הצליח לקרוא בחזרה את ~/.claude.json כדי לאשר את השינוי. ייתכן שהשינוי על הדיסק, וייתכן שלא. הטקסט בסוגריים הוא השגיאה מאותה קריאה.

MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.

אחרי הסרה, ההודעה אומרת may not have been removed ומסתיימת ב-then remove the server again if it is still listed.

לפני v2.1.283, הפקודות דיווחו על הצלחה גם כשלא היה אפשר לאשר את השינוי.

מה לעשות:

• הרץ claude mcp get <name> כדי לבדוק אם השינוי על הדיסק. עבור שרת בהיקף local, הרץ אותה מתיקיית הפרויקט שהשרת שייך אליה, כי היקף local הוא לכל פרויקט.
• אם השרת חסר אחרי הוספה, או עדיין מופיע ברשימה אחרי הסרה, הרץ שוב את אותה פקודת הוספה או הסרה.

#השרת מתארח ב-Anthropic ואינו תומך ב-OAuth מקומי

התחלת התחברות לשרת MCP שה-URL שלו מצביע על מארח מחבר שמתארח ב-Anthropic ומאמת דרך ספק זהויות של צד שלישי. המארחים האלה כוללים את microsoft365.mcp.claude.com, gmail.mcp.claude.com ו-gcal.mcp.claude.com. Claude Code מסרב להתחיל את זרימת ה-OAuth המקומית שלו עבור המארחים האלה גם מלוח /mcp וגם מ-claude mcp login, כי ההתחברות שלהם עובדת רק דרך claude.ai.

"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.

מה לעשות:

• הסר את הרשומה שלך עם claude mcp remove <name>, כדי שהיא לא תוכל להסתיר את המחבר של claude.ai באותו URL
• אחרי ההסרה, חבר את השירות ב-claude.ai/customize/connectors, כשאתה מחובר לחשבון שבו אתה משתמש ב-Claude Code. אחרי החיבור, המחבר מופיע ב-Claude Code באופן אוטומטי אם שיטת האימות הפעילה שלך היא התחברות במנוי של claude.ai

#השרת דחה את כותרת Authorization שנוצרה על ידי ה-headersHelper המוגדר

שרת MCP שה-headersHelper שלו מספק את כותרת Authorization ענה לחיבור ב-HTTP 401 או 403, ולכן Claude Code מדווח על החיבור כנכשל. מכיוון שהעוזר מספק את כותרת Authorization, Claude Code לא נופל חזרה ל-OAuth עבור השרת:

Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint , OAuth fallback is disabled when the helper supplies Authorization.

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

מה לעשות:

• הרץ את פקודת headersHelper בעצמך באותו אופן ש-Claude Code מריץ אותה: מהתיקייה שבה Claude Code מריץ אותה, עם משתני הסביבה ש-Claude Code מגדיר עבורה, ובלי משתני האישורים ש-Claude Code מסיר עבור שרת מ-.mcp.json של פרויקט, מתוסף, או מקובץ סוכן של פרויקט. בדוק שהיא מדפיסה ערך Authorization שנקודת הקצה של השרת מקבלת
• אחרי תיקון העוזר או מקור האישורים שלו, בחר את השרת ב-/mcp ובחר Reconnect

לפני v2.1.248, Claude Code הריץ גילוי OAuth עבור שרת שהעוזר שלו סיפק את כותרת Authorization. הגילוי הזה יכול היה להיכשל עם Incompatible auth server: does not support dynamic client registration במקום לדווח על האישור שנדחה.

#שרת MCP דחה את יכולת elicitation

שרת MCP שנבנה על Java MCP SDK 0.11.0 עד 0.17.0 סירב לחיבור. גרסאות ה-SDK האלה לא יכולות לנתח את מצבי elicitation form ו-url ש-Claude Code מצהיר עליהם בלחיצת היד. ההודעה אומרת:

This server (Java MCP SDK 0.17.0 or older) rejected Claude Code's elicitation capability. Set "bareElicitationCapability": true for it, or upgrade to Java MCP SDK 0.17.1+ (Spring AI 1.0.7+ or 1.1.6+).

מה לעשות:

• שדרג את השרת ל-Java MCP SDK 0.17.1 או חדש יותר, או לאחת מגרסאות Spring AI שההודעה מציינת
• או הוסף "bareElicitationCapability": true לרשומה של אותו שרת בתצורת ה-MCP שלך, ואז הפעל מחדש את Claude Code. השדה מתקבל ברשומות stdio, sse, http ו-ws, ודורש Claude Code v2.1.281 או חדש יותר

רשומת .mcp.json הזו מגדירה את השדה עבור שרת HTTP אחד:

{
  "mcpServers": {
    "inventory": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "bareElicitationCapability": true
    }
  }
}

אחרי ההפעלה מחדש, /mcp מציג את השרת כמחובר. Claude Code מצהיר על מצב form רק לשרת הזה, ולכן הסר את השדה אחרי שתשדרג אותו.

שרת יכול גם להיכשל עם טקסט שגיאה משלו, כמו טקסט שמכיל Unrecognized field "form". אותם תיקונים חלים.

#כלי בקשת ההרשאה של MCP לא נמצא

הכלי שהעברת ל---permission-prompt-tool לא היה בין כלי ה-MCP המחוברים כשהריצה נזקקה לראשונה להחלטת הרשאה, או כי השרת שלו מעולם לא התחבר, או כי אף שרת מחובר לא חושף כלי בשם הזה. Claude Code עדיין שולח את הבקשה שלך: הריצה הלא אינטראקטיבית יוצאת עם השגיאה הזו, ועם קוד יציאה 1, בקריאת הכלי הראשונה, ולכן היא לא מפיקה תשובה אף שהבקשה נשלחה. לפני הבקשה הראשונה, Claude Code ממתין עד לזמן הקצוב לחיבור לכל שרת, 30 שניות, שמוגדר על ידי MCP_TIMEOUT, כדי שהשרת הזה יתחבר. לפני v2.1.206, ההפעלה לא המתינה שהשרת יסיים להתחבר, ולכן גם שרת בריא שמתחיל לאט הפיק את השגיאה הזו.

Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none

הרשימה אחרי Available MCP tools: מציינת את כלי ה-MCP שהיו מחוברים.

מה לעשות:

• בדוק שהשרת מופעל ונשאר מחובר: הרץ claude mcp list באותה תיקייה ואשר שהשרת מופיע כמחובר
• אשר ששם הכלי תואם לשם mcp__<server>__<tool> שהשרת חושף
• אם השרת צריך יותר מ-30 שניות כדי להתחיל, העלה את MCP_TIMEOUT

#פורט ה-callback של OAuth כבר בשימוש

כשאתה מתחבר לשרת MCP מרוחק עם OAuth, Claude Code מפעיל מאזין מקומי כדי לקבל את ה-callback של ההתחברות. אם הפורט שהמאזין צריך תפוס על ידי תהליך אחר, ההתחברות נכשלת עם ההודעה הזו. זה קורה בעיקר עם פורט callback קבוע שמוגדר דרך המשתנה MCP_OAUTH_CALLBACK_PORT או --callback-port, כי בלי אחד כזה Claude Code בוחר פורט פנוי.

OAuth callback port <port> is already in use , another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.

ב-Windows, הפקודה המוצעת היא netstat -ano | findstr :<port> במקום זאת.

מה לעשות:

• הרץ את הפקודה מההודעה כדי למצוא את התהליך שמחזיק את הפורט, ועצור אותו או המתן שהוא יסתיים
• אם תוכנית אחרת צריכה את הפורט הזה באופן קבוע, רשום URI הפניה אחר אצל השרת והגדר את הפורט שלו עם MCP_OAUTH_CALLBACK_PORT או --callback-port, לפי מה שאתה משתמש בו
• ואז התחל את ההתחברות שוב, למשל על ידי בחירת השרת ב-/mcp

#אין פורטים זמינים להפניה של OAuth

כשאתה מתחבר לשרת MCP מרוחק עם OAuth, Claude Code מפעיל מאזין מקומי כדי לקבל את ה-callback של ההתחברות. ההתחברות נכשלת עם ההודעה הזו כש-Claude Code לא יכול לקשור פורט מקומי עבורה. משהו במכונה מונע ממנו להאזין על 127.0.0.1, למשל תוכנת אבטחה או מדיניות sandbox שאוסרת מאזינים מקומיים.

No available ports for OAuth redirect

לפני v2.1.268, Claude Code לא נפל חזרה לפורט שהוקצה על ידי מערכת ההפעלה, ולכן ההודעה הופיעה גם כשרק הפורטים שהוא בחר בעצמו לא ניתנו לקישור. זה יכול לקרות במארחי Windows שבהם Hyper-V שומר טווחי פורטים שמכסים את הפורטים ש-Claude Code בוחר מהם.

מה לעשות:

• בדוק אם תוכנת אבטחה או מדיניות sandbox חוסמת תהליכים מלהאזין על 127.0.0.1, ואפשר ל-Claude Code לקשור פורט מקומי
• ואז התחל את ההתחברות שוב, למשל על ידי בחירת השרת ב-/mcp

#/security-review נכשל בלי origin/HEAD

/security-review בונה את הקשר הסקירה על ידי diff של הענף שלך מול origin/HEAD, ה-ref המקומי שרושם איזה ענף הוא ברירת המחדל ב-remote origin שלך. כשה-ref הזה לא קיים, פקודות ה-git שאוספות את ה-diff נכשלות והסקירה נעצרת לפני שהיא מתחילה.

Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
fatal: ambiguous argument 'origin/HEAD...': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'

ההודעה עשויה לצטט git log או git diff אחר במקום זאת. Git יוצר את origin/HEAD רק כשה-remote מפרסם ענף ברירת מחדל וה-refspec של ה-fetch שלך מכסה אותו, מה ש-git clone מלא של remote עם commits עושה. ה-ref חסר בהגדרות האלה:

• checkout של ענף יחיד או של CI, שמביא refspec צר מדי
• remote שה-HEAD בצד השרת שלו מצביע על ענף שאף אחד לא דחף
• מאגר בלי remote בשם origin, או מאגר שמעולם לא ביצעת עבורו fetch

Claude Code מציג את אותה שגיאה לכל skill שמזריק הקשר דינמי, ופקודה מוזרקת שנכשלה מבטלת את ההפעלה של אותו skill.

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

• Shell command permission check failed for pattern "...": בדיקת ההרשאה של הפקודה לא אפשרה אותה. בדיקות הרשאה על פקודות מוזרקות מכסה אילו תוצאות מבטלות בכל מצב הרשאה, ואיך לאשר מראש פקודה עם allowed-tools
• Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found: ה-frontmatter של ה-skill דורש bash במכונה שאין בה אותו. התקן Git for Windows או שנה את ה-frontmatter ל-shell: powershell. ראה איך פקודות מוזרקות רצות

מה לעשות:

• צור את ה-ref על ידי ציון ענף ברירת המחדל של ה-remote שלך: git remote set-head origin <default-branch>. זה עובד בכל פעם שה-ref המקומי למעקב origin/<default-branch> קיים. אם הוא לא קיים, כמו בשכפולים של ענף יחיד, הבא את הענף קודם: הרץ git remote set-branches --add origin <branch>, ואז git fetch origin, ואז הרץ שוב את פקודת set-head. הרץ שוב את /security-review.
• אם אתה מעדיף לא לציין את הענף, הרץ git fetch origin ואז git remote set-head origin --auto, ששואל את ה-remote איזה ענף הוא ברירת המחדל שלו. זה נכשל עם error: Cannot determine remote HEAD כשה-remote לא מפרסם ענף ברירת מחדל, כי הוא ריק או שה-HEAD שלו מצביע על ענף שאף אחד לא דחף. במקרה כזה ציין את הענף במפורש. זה נכשל עם error: Not a valid ref כשהשכפול שלך לא מביא את הענף הזה. הרחב קודם את ה-refspec כמו למעלה.
• אם למאגר אין remote, הוסף אחד עם git remote add origin <url> ובצע fetch לפני יצירת ה-ref. אם ה-remote ריק, דחף קודם את הענף שלך עם git push -u origin HEAD וציין את הענף הזה בפקודת set-head. origin/HEAD יצביע אז על הענף שזה עתה דחפת, ולכן /security-review רואה diff ריק עד שהענף מתפצל ממנו.

#לא הורצה פקודת מעטפת ב-skill או בפקודה

No shell command in <name> was run אומר שפקודת !`<command>` של הקשר דינמי בקובץ ה-skill או הפקודה הזה מכילה תו שכלי Bash או PowerShell מסרב לו:

• כל אחד מהכלים: תו בקרה גולמי שאינו טאב או שורה חדשה
• כלי PowerShell: גם U+FEFF או U+180E

ההודעה מסתיימת בפקודה שנדחתה, ומציגה כל תו שנדחה כ-�, כמו בדוגמה הזו של כלי Bash:

No shell command in /my-skill was run, because the Bash tool does not accept one of them: command contains control characters that would be hidden in the approval dialog. Unprintable characters are shown as � below: remove them from the skill or command file, or from the arguments or options substituted into it.
build.sh --target�dist

מה לעשות:

• מצא כל � בפקודה שמובאת בסוף ההודעה. הסר את התו שהוא מייצג מקובץ ה-skill או הפקודה, או מהארגומנטים או מהאפשרויות שמוחלפים לתוך הקובץ.

#יש לספק קלט כשמשתמשים ב---print

claude לבדו צריך ש-stdout יהיה מסוף כדי להפעיל את ממשק המשתמש האינטראקטיבי. כש-stdout מופנה, או שהקונסולה אינה מסוף אמיתי, כמו PowerShell ISE וחלוניות פלט של חלק מסביבות הפיתוח, claude רץ באופן לא אינטראקטיבי. זה אותו מצב כמו claude -p, שדורש הנחיה, ולכן ההודעה נוקבת בשם --print גם כשלא העברת את הדגל. העברת -p/--print בלי הנחיה ובלי שום דבר שמוזרם ב-stdin מייצרת את אותה שגיאה בכל מקום.

Error: Input must be provided either through stdin or as a prompt argument when using --print

מה לעשות:

• לשימוש אינטראקטיבי, הרץ את claude במסוף אמיתי: Windows Terminal או קונסולת PowerShell ולא ISE, והמסוף המשולב של סביבת הפיתוח ולא חלונית פלט
• לשימוש חד פעמי, העבר את ההנחיה: claude -p "your question", או הזרם אותה עם echo "your question" | claude -p

#Claude Code לא יכול לקרוא את המקלדת כאן

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

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

• Windows: Claude Code מדפיס את ההודעה ל-stderr ויוצא עם קוד 1 במקום להפעיל את הממשק
• macOS ו-Linux: Claude Code קורא את הקשות המקשים מ-/dev/tty ומתחיל את הסשן, וכל טקסט שהוזרם משמש כהנחיה הראשונה. רואים את ההודעה כשלא ניתן לפתוח את /dev/tty, והשורה הראשונה שלה מציינת את /dev/tty במקום הניסוח של Windows.

ב-Windows ההודעה נקראת כך:

Claude Code can't read the keyboard here: stdin is not a terminal (it is piped, redirected, or supplied by the program that launched claude), and on Windows it can't fall back to the console for input yet.
Run claude directly in Windows Terminal, PowerShell, or Command Prompt, without piping or redirecting its input.
To send text as a prompt and print the reply instead, add -p; it also works with --continue and --resume <session-id> (for example: type notes.md | claude -p --continue).

מה לעשות:

• לעבודה אינטראקטיבית, הרץ את claude ישירות במסוף, בלי להזין או להפנות את הקלט שלו
• כדי לקבל תשובה בלי הממשק האינטראקטיבי, למשל מסקריפט, הוסף -p ותן את ההנחיה כארגומנט או ב-stdin, כמו ב-claude -p "your question" או echo "your question" | claude -p. אותו דבר עובד עם --continue ועם --resume <session-id>.

לפני v2.1.287, Claude Code הפעיל את הממשק במקום להדפיס את ההודעה הזו, ואז או שלא הוצג דבר על המסך או שהפעולה נכשלה עם שגיאה שמכילה Raw mode is not supported.

אם רואים Raw mode is not supported במהלך claude install, ראה Raw mode is not supported during install.

#הקלט הכיל רק רווח לבן

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

• ארגומנט הנחיה או stdin מוזרם עבור claude -p: claude יוצא עם Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print
• הודעה שנשלחה לסשן --input-format stream-json שרץ או לסשן Agent SDK: Claude Code מסיים את התור בלי לקרוא למודל והסשן נשאר שמיש. הסירוב מגיע כהודעת מידע וכטקסט התוצאה של התור: Blank prompt , the message was only whitespace, so nothing was sent to the model.

לפני v2.1.229, Claude Code שלח את ההודעה שמכילה רק רווח לבן ל-API, שדחה את הבקשה עם שגיאת 400.

מה לעשות:

• כלול טקסט גלוי בהנחיה. אם סקריפט בונה את ההנחיה ממשתנה או מקובץ, בדוק שהמקור אינו ריק לפני הקריאה ל-Claude Code.

#קלט stream-json נשא יותר מ-256M תווים בלי שורה חדשה

התוכנית שלך שלחה יותר מ-268,435,456 תווים ב-stdin בלי שורה חדשה להרצה של claude -p --input-format stream-json, ולכן Claude Code מדפיס את השגיאה הזו ל-stderr ויוצא עם קוד 1 במקום לאגור עוד קלט. ההודעה מציינת את התקציב הזה כ-256M. לפני v2.1.257, Claude Code אגר קלט כזה בלי הגבלה, והזיכרון גדל עד שהתהליך קרס או נהרג.

Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.

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

מה לעשות:

• בדוק מה מוזרם ל-stdin. עם --input-format stream-json, כל הודעה חייבת להיות שורת JSON אחת שמסתיימת בשורה חדשה
• כדי לשלוח טקסט רגיל, השמט את --input-format stream-json. claude -p קורא הנחיה בטקסט רגיל מ-stdin כברירת מחדל

#פקודה לא מוכרת

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

Unknown command: /hepl. Did you mean /help?

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

• שגיאת הקלדה, כמו /hepl במקום /help. איך תפריט הפקודות מתאים את מה שמקלידים מכסה בחירה של התאמה קרובה לפני השליחה
• פקודה שקיימת אבל אינה זמינה בסשן הזה כי דרישה אינה מתקיימת, כמו הפלטפורמה, התוכנית או שיטת האימות. ראה את הערך עבור /web-setup, /schedule, או /auto-mode-setup. חלק מהפקודות עונות בהודעה משלהן כשמדיניות הארגון משביתה אותן, כמו Cloud sessions are disabled by your organization's policy
• פקודה מתוסף או משרת MCP שאינו מותקן או מחובר בסשן הזה

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

• הרצות -p
• יישומי Agent SDK
• לשונית Code של אפליקציית שולחן העבודה
• חלונית הצ'אט של הרחבת VS Code
• סשני ענן ומשימות ענן מתוזמנות

עבור פקודה מובנית שאי אפשר להריץ באחד מהסשנים האלה, Claude Code עדיין עונה שהפקודה אינה זמינה במקום לשלוח אותה ל-Claude. לפני v2.1.274, רק סשני ענן ומשימות ענן מתוזמנות שלחו שם לא תואם ל-Claude. לפני v2.1.273, הם ענו גם Unknown command.

Claude Code לא מתייחס לכל הנחיה שמתחילה ב-/ כפקודה. הוא שולח את ההנחיה ל-Claude כהודעה רגילה כשהמילה הראשונה אחרי ה-/ מתחילה בסימן פיסוק, כמו ה-/-- שפותח הערת תיעוד של Lean, או שהיא נתיב כמו /var/log/syslog.

לפני v2.1.236, אם לחצת Enter בזמן שתפריט הפקודות הציג התאמה קרובה לשם שהקלדת, Claude Code הריץ את ההתאמה הזו, כך ששגיאת הקלדה כמו /hepl הריצה את /help במקום לייצר את ההודעה הזו.

מה לעשות:

• הרץ את השם המוצע, או הקלד / ואחריו חלק מהשם כדי לראות מה זמין בסשן הזה
• אם Claude Code מדווח על פקודה מתועדת כלא מוכרת, בדוק את השורה שלה במדריך הפקודות עבור הדרישה שהוא מציין

#ההפרש גדול מדי עבור ultrareview

ההפרש בין הענף שלך לענף הבסיס, כולל שינויים שלא עברו commit ושינויים שנוספו לאינדקס, חורג ממגבלות הגודל של ultrareview, ולכן /code-review ultra ותת הפקודה claude ultrareview מסרבים לסקירה לפני שסשן הענן מתחיל. סקירה שנדחתה לא משתמשת בהרצה חינמית ולא מחייבת קרדיטים של שימוש. ההודעה מציינת את המגבלות שבתוקף, את גודל ההפרש, ואת הקבצים שתורמים את רוב השורות שהשתנו. לפני v2.1.216, ההודעה הציגה רק את סטטיסטיקת ההפרש הגולמית.

Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.

סקירת pull request מחילה את אותן מגבלות. צורה זו של ההודעה מתחילה ב-PR #<N> is too large for ultrareview ומציינת את מספר הקבצים והשורות של ה-PR.

מה לעשות:

• העבר ענף בסיס קרוב יותר לעבודה שלך, כמו /code-review ultra develop, כדי שהסקירה תכסה רק את ההפרש מול הענף הזה
• פצל את השינוי לענפים קטנים יותר וסקור כל אחד. הקבצים שההודעה מציינת תורמים את רוב השורות שהשתנו, אז התחל בהעברתם לענף משלהם.

#לא נמצא merge-base עם ענף הבסיס

/code-review ultra ותת הפקודה claude ultrareview סוקרים את ההפרש בין הענף שלך לענף בסיס, וזה דורש commit ששניהם חולקים. כש-git merge-base לא מוצא כזה, Claude Code מסרב לסקירה לפני שסשן הענן מתחיל. בשכפול ש-Claude Code יכול לאמת שהוא שלם, עם לפחות ענף אחד, הוא נופל חזרה לסקירת כל קובץ במעקב במקום לסרב. רואים את הסירוב הזה כשענף הבסיס לא נמצא בכלל, כש-Claude Code לא יכול לאמת שהשכפול שלך שלם, או במאגר הנדיר שבו הפרש של כל העץ אינו אפשרי, כמו פורמט האובייקטים SHA-256.

Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.

הרמז אחרי המשפט הראשון תלוי במה ש-Claude Code ראה:

• לא העברת ענף בסיס: Claude Code השווה מול ענף ברירת המחדל של המאגר ומציע להעביר את הבסיס במפורש, כמו בדוגמה למעלה
• העברת ענף בסיס שכבר היה בשכפול שלך: הרמז נקרא Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)
• העברת ענף בסיס שלא היה בשכפול שלך: Claude Code משך אותו מ-origin לפני ההשוואה. הרמז נקרא <branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`). כש-Claude Code לא יכול לדעת אם השכפול שלך רדוד, הוא מציע git fetch --unshallow origin. לפני v2.1.221, הרמז הציע git fetch --unshallow origin לכל ענף בסיס שנמשך, ובשכפול שלם הפקודה הזו נכשלת עם fatal: --unshallow on a complete repository does not make sense.

מה לעשות:

• אם ענף אחר הוא הבסיס האמיתי שלך, העבר אותו במפורש: /code-review ultra <branch>
• אם ייתכן שלשכפול שלך אין היסטוריה מלאה, הרץ git fetch --unshallow origin והרץ שוב את הסקירה

#ל-checkout שלך אין ענפים

ל-checkout יכולים להיות commits אבל בלי ענפים: אם מריצים git init ואחריו git fetch <url> ו-git checkout FETCH_HEAD, מקבלים detached HEAD בלי refs. Claude Code אורז את המאגר שלך כ-git bundle כדי להעלות אותו ל-ultrareview, והוא לא יכול לארוז מאגר שאין בו ענפים או refs אחרים, ולכן /code-review ultra ותת הפקודה claude ultrareview מסרבים לסקירה לפני שסשן הענן מתחיל.

Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first , `git checkout -b <name>` , then rerun /code-review ultra.

לפני v2.1.221, Claude Code ניסה לסקור כל קובץ במעקב ב-checkout הזה, וההעלאה נכשלה.

מה לעשות:

• צור ענף ב-commit הנוכחי עם git checkout -b <name>, ואז הרץ שוב את הסקירה

#אין חשבון GitHub מחובר לחשבון Claude שלך

הרצת /code-review ultra <PR#> או claude ultrareview <PR#>, ולפני יצירת סשן הענן Claude Code שואל את השרת אם חשבון GitHub המחובר לחשבון Claude שלך יכול להגיע למאגר של ה-PR. אין חשבון מחובר, או שהחיבור פג, ולכן שכפול הענן היה נכשל ו-Claude Code מסרב להפעלה. Claude Code לא מוציא הרצה חינמית ולא מחייב קרדיטים של שימוש עבור הפעלה שנדחתה.

Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github , then re-run /code-review ultra 1234 (allow a minute after connecting).

כש-/web-setup אינו זמין בסשן שלך, ההודעה מציינת רק את הקישור ל-claude.ai.

מה לעשות:

• הרץ /web-setup כדי לחבר את ההתחברות של GitHub CLI לחשבון Claude שלך, או חבר חשבון ב-claude.ai/connect-github
• הרץ שוב את הסקירה דקה אחרי החיבור

לפני v2.1.248, Claude Code לא בדק את זה לפני ההפעלה.

#חשבון GitHub המחובר שלך לא יכול לראות את המאגר

הרצת /code-review ultra <PR#> או claude ultrareview <PR#>, וחשבון GitHub המחובר לחשבון Claude שלך לא יכול לקרוא את המאגר של ה-PR, ולכן שכפול הענן היה נכשל ו-Claude Code מסרב להפעלה. Claude Code לא מוציא הרצה חינמית ולא מחייב קרדיטים של שימוש עבור הפעלה שנדחתה.

Your connected GitHub account can't see <owner>/<repo> , usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new , then re-run /code-review ultra 1234.

כש-/web-setup אינו זמין בסשן שלך, ההודעה מציינת רק את התקנת האפליקציה.

מה לעשות:

• אם CLI של gh המקומי יכול לקרוא את המאגר, הרץ /web-setup כדי לחבר את ההתחברות הזו לחשבון Claude שלך
• הרץ שוב את הסקירה אחרי השינוי

לפני v2.1.248, Claude Code לא בדק את זה לפני ההפעלה.

#בדיקת ה-preflight של GitHub App נכשלה באופן חולף

התחלת סשן ענן ממאגר מקומי, ושני שלבים נכשלו יחד. Claude Code לא הצליח לבנות או להעלות את ה-bundle של המאגר שלך. לפני ההעלאה, הוא בדק אם שירות הענן יכול לשכפל את המאגר מ-GitHub, ובמקום תשובה ודאית, הבדיקה הסתיימה בשגיאה שניסיון חוזר יכול לנקות, כמו שגיאת רשת, timeout, או שגיאת שרת זמנית. ההודעה המלאה מתחילה במה שעצר את ה-bundle, למשל Could not upload repo bundle (<error>), ומסתיימת במשפט ה-preflight:

Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) , retry in a moment to start from GitHub instead

מה לעשות:

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

לפני v2.1.251, Claude Code סיים את ההודעה ב-Please set up GitHub on https://claude.ai/code גם כשבדיקת GitHub נכשלה רק באופן חולף, ועצת ההגדרה לא יכולה לנקות כשל חולף.

#העלאת המאגר לא יכולה לעקוב אחרי הגדרת git

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

Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository’s .git/config or directly into your ~/.gitconfig, then retry.

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

ההודעה יכולה לציין קובץ תצורה שתצורת ה-git שלך מושכת דרך הנחיית include או includeIf, גם כאשר התנאי של ההנחיה לא חל על המאגר הזה.

מה לעשות:

• החל את התיקון שבמשפט האחרון של ההודעה

#GitHub לא מחובר לחשבון Claude שלך

התחלת סשן ענן מהמאגר המקומי שלך, למשל עם /autofix-pr. אין חשבון GitHub שמחובר לחשבון Claude שלך, או שהחיבור פג, ולכן Claude Code מסרב להפעלה:

GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github

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

מה לעשות:

• הרץ /web-setup כדי לחבר את ההתחברות של GitHub CLI לחשבון Claude שלך, או חבר חשבון ב-claude.ai/connect-github. ראה אפשרויות אימות GitHub כדי להבין במה השתיים נבדלות.
• הרץ שוב את הפקודה דקה אחרי החיבור

לפני v2.1.268, Claude Code דיווח על זה ככשל זמני של בדיקת Claude GitHub App והציע לנסות שוב או להתקין את האפליקציה. אף אחת משתי האפשרויות לא מחברת חשבון GitHub.

#מדיניות של ארגון GitHub חוסמת את Claude

הרצת פקודה בשורת Claude Code שמתחילה סשן ענן, כגון /autofix-pr. לפני יצירת הסשן, Claude Code בודק את הגישה של Claude למאגר ב-GitHub, ו-GitHub סירב כי לארגון GitHub שלך יש מדיניות שחוסמת את Claude. Claude Code עוצר שם ומציג הודעה שמציינת את המדיניות.

כשרשימת היתר של כתובות IP היא מה שחוסם את הגישה, ההודעה היא:

Your GitHub organization has an IP allowlist that is blocking Claude. Add Claude's IP ranges to your GitHub allowlist.

כש-single sign-on הוא מה שחוסם, ההודעה היא:

Your GitHub organization requires single sign-on. Disconnect and reconnect GitHub on the Connectors page in Claude on the web, click Authorize next to your organization when GitHub asks, then try again.

כשמדיניות Conditional Access של Microsoft Entra ID היא מה שחוסם, ההודעה היא:

Your GitHub organization's identity provider (Microsoft Entra ID) has a Conditional Access policy that is blocking Claude. Ask your GitHub Enterprise or Entra ID admin to allow Claude in that policy.

מה לעשות:

• רשימת היתר IP: בקש מבעלים של ארגון GitHub או של ה-enterprise שלך לאפשר את כתובות ה-IP היוצאות של Anthropic. ראה רשימות היתר וחומות אש של GitHub לכתובות ולהגדרות GitHub שצריך לשנות.
• Single sign-on: נתק את GitHub ב-claude.ai/customize/connectors, ואז חבר אותו שוב. כש-GitHub שואל, לחץ על Authorize ליד הארגון שלך כדי שהחיבור החדש יהיה מורשה ל-single sign-on שלו.
• מדיניות Conditional Access: בקש ממנהל GitHub Enterprise או Microsoft Entra ID שלך לאפשר את Claude במדיניות הזו
• אחרי השינוי, הרץ שוב את הפקודה

#נדרש אישור single sign-on

הרצת /install-github-app ובחרת מאגר שהארגון שלו אוכף SAML single sign-on. לפני ההגדרה, Claude Code בודק את הגישה שלך למאגר עם GitHub CLI, ו-GitHub סירב לבדיקה כי אסימון gh שלך עדיין לא מורשה לארגון. האשף מציג את האזהרה עם השלבים לאישור:

Single sign-on authorization needed
<owner>/<repo> belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet.

מה לעשות:

• אשר מחדש את ההתחברות של GitHub CLI עם ההיקפים repo ו-workflow על ידי הרצת gh auth refresh -h github.com -s repo,workflow, ואשר את הארגון כש-GitHub מבקש single sign-on
• אם אתה מאמת עם personal access token ב-GH_TOKEN, פתח את github.com/settings/tokens, בחר Configure SSO על האסימון, ואשר את הארגון
• הרץ שוב את /install-github-app

לפני v2.1.273, Claude Code הציג את האזהרה Admin permissions required למצב הזה במקום זאת.

#חידוש השיחה נכשל

Claude Code לא הצליח לקרוא או לעבד את התמליל השמור של הסשן שבחרת מבורר claude --resume, ולכן הוא מסיים את התהליך במקום להמשיך במצב שנטען חלקית. ההודעה כוללת את הפקודה לניסיון חוזר:

Failed to resume the conversation.
Run claude --resume <session-id> to retry, or claude to start a new session.

Claude Code יוצא עם קוד 1 אחרי הצגת ההודעה. בורר /resume בתוך סשן שרץ מדווח Failed to resume conversation בתוך השיחה, והסשן הנוכחי שלך ממשיך לרוץ. לפני v2.1.216, חידוש שנכשל מבורר claude --resume נשאר על הספינר Resuming conversation… ללא הגבלת זמן במקום להציג את ההודעה הזו.

מה לעשות:

• הרץ claude --resume <session-id> עם מזהה הסשן מההודעה כדי לנסות שוב
• בגרסה שלפני v2.1.285, אם הניסיון החוזר נכשל באותו אופן, הרץ claude update וחדש שוב. הגרסאות האלה נכשלות בחידוש כשהתמליל השמור מכיל רשומה שהן לא יכולות לקרוא.
• אם הניסיון החוזר נכשל שוב, הרץ claude כדי להתחיל סשן חדש

#לא נמצאה שיחה עם מזהה הסשן

העברת מזהה סשן אל claude --resume <session-id> ואף תמליל שמור לא התאים לו:

No conversation found with session ID: <session-id>

Claude Code יוצא עם קוד 1 אחרי הצגת ההודעה. Claude Code מחפש קודם בפרויקט הנוכחי, ואחר כך בכל פרויקט אחר במחשב הזה את המזהה. לפני v2.1.223, החיפוש נעצר בתיקיית הפרויקט הנוכחי וב-git worktrees שלה, ולכן חדש מהתיקייה שבה הסשן עבד לאחרונה.

סיבות נפוצות:

• מזהה שהוקלד לא נכון: בהרצה לא אינטראקטיבית, המזהה הוא שדה session_id של פלט --output-format json
• תמליל שנמחק: Claude Code מסיר תמלילים אחרי תקופת השמירה, 30 ימים כברירת מחדל, לפי כללי סריקת השמירה
• מחשב אחר: Claude Code שומר תמלילים מקומית, ולכן חדש את הסשן במחשב שבו הוא רץ
• עותקים כפולים: אם העתקת תיקיית פרויקט תחת ~/.claude/projects כך ששני תמלילים נושאים את אותו מזהה, Claude Code מדווח את ההודעה הזו במקום לחדש עותק אחד באופן שרירותי

מה לעשות:

• לסשן אינטראקטיבי, פתח את בורר הסשנים עם claude --resume ולחץ Ctrl+A כדי להרחיב אותו לכל פרויקט במחשב הזה, ואז בחר את הסשן
• סשנים שנוצרו עם claude -p או עם Agent SDK לא מופיעים בבורר, ולכן בדוק שוב את המזהה מול session_id שההרצה המקורית שלך הדפיסה

#Windows דיווח על שגיאה (EBADF) כש-Claude Code קרא את קובץ התמליל של הסשן הזה

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

Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads , security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.

ההודעה באה אחרי שורת הכשל של הפקודה עצמה, למשל Failed to resume session <session-id>. פקודת claude --resume או claude -p יוצאת עם קוד 1 אחרי ההצגה. אחרי /resume בתוך סשן, הסשן הנוכחי שלך ממשיך לרוץ.

מה לעשות:

• אל תכלול את התיקייה שמחזיקה את תמלילי הסשנים שלך בתוכנה שסורקת או מיירטת קריאות קבצים, כגון כלי אבטחה, הצפנה או ניהול נקודות קצה. התמלילים נמצאים כברירת מחדל תחת %USERPROFILE%\.claude\projects, או תחת התיקייה ש-CLAUDE_CONFIG_DIR מציין
• אם אי אפשר להוסיף החרגה, הוסף את Claude Code ליישומים המותרים של התוכנה הזו במקום זאת
• חדש שוב את הסשן

לפני v2.1.282, הכשל הגיע בלי הסבר: claude --resume <session-id> הסתיים ב-Failed to resume session <session-id>, והרצת -p הדפיסה רק את טקסט שגיאת המערכת, למשל Failed to resume session: EBADF: bad file descriptor, read.

#אי אפשר להחליף רנדררים בסשן הזה

כשמחליפים רנדררים, Claude Code מפעיל מחדש את התהליך שלו. הרצת /tui בסשן ש-Claude Code מסרב להפעיל מחדש, ולכן הוא לא מחליף ולא שומר דבר. איזו הודעה מוצגת אומרת לך את הסיבה:

• Cannot switch renderers while work is running in the background: יש עבודה שרצה ברקע שהפעלה מחדש הייתה נוטשת, למשל מעטפת רקע או subagent. המתן שהעבודה תסתיים או עצור אותה עם /tasks, ואז הרץ שוב /tui fullscreen או /tui default
• Cannot switch renderers in this session: לסשן יש הגבלות ש-Claude Code לא יכול להעביר לתהליך שהופעל מחדש. לפני v2.1.234, Claude Code הפעיל מחדש בכל מקרה והסשן שהופעל מחדש רץ בלעדיהן

בהודעת ההגבלות, החלק שבסוגריים מציין את ההגבלות ש-Claude Code מצא:

Cannot switch renderers in this session , it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.

כל סיבה שההודעה יכולה להציג בסוגריים:

• launch flags: a custom system prompt, a tool allowlist, or restricted settings: התחלת את הסשן עם דגל ש-Claude Code לא מעביר בחזרה לתהליך שהופעל מחדש. הדגלים האלה כוללים --system-prompt, --system-prompt-file, --append-system-prompt-file, רשימת היתר של --tools, --setting-sources, ו---permission-prompt-tool
• permission rules set for this session only: עדכון הרשאה מ-hook או מקורא SDK הוסיף כללי deny או ask עם יעד session. כללי allow בהיקף הסשן לא מפעילים את הסירוב. הפעלה מחדש משמיטה אותם, ו-Claude Code שואל שוב במקום זאת
• ask-before-running rules with no command-line form: עדכון הרשאה מ-hook או מקורא SDK הוסיף כללי ask לצד הכללים ש-Claude Code מעביר בחזרה כ---allowed-tools ו---disallowed-tools. אין דגל לכללי ask
• permission rules a command line cannot carry intact ו-added directories a command line cannot carry intact: עדכון הרשאה הוסיף כלל או נתיב תיקייה באמצע הסשן. שורת הפקודה של התהליך שהופעל מחדש לא יכולה לשאת את הטקסט שלו כאותו ערך

מה לעשות:

• בסשן שהתחיל בלי ההגבלות האלה, הרץ /tui fullscreen, או /tui default כדי לחזור. Claude Code שומר שם את הגדרת tui

#אי אפשר להפעיל מחדש בזמן שעבודה רצה או ש-Remote Control מחובר

Claude Code לא הופעל מחדש, והסשן שלך ממשיך לרוץ כפי שהיה. עקוב אחרי התיקון שבהודעה.

#Claude Code לא הצליח להפעיל מחדש

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

Claude Code couldn't restart. Your conversation is saved. Start Claude Code again and run /resume to pick it up.

כשלהפעלה מחדש לא הייתה שיחה לפתוח מחדש, למשל כי /tui היה הקלט הראשון שלך בסשן חדש, ההודעה היא Claude Code couldn't restart. Start Claude Code again.

מה לעשות:

• הרץ שוב claude במעטפת שלך. אם ההודעה אמרה שהשיחה שלך נשמרה, הרץ /resume בסשן החדש ובחר את השיחה. אם היא לא ברשימה, הרחב את בורר הסשנים
• אם הפעלות מחדש ממשיכות להיכשל, התחל את Claude Code מהמעטפת עם claude --debug-file claude-debug.log. אם הפעלה מחדש מהסשן הזה נכשלת, claude-debug.log בתיקייה שממנה התחלת רושם שורת Failed to relaunch: עם שגיאת מערכת ההפעלה. כלול את השורה הזו כשאתה מדווח על הבעיה

#לא ניתן לפתוח את Claude Desktop

הרצת /desktop או את הכינוי שלו /app בסשן, או claude --desktop במעטפת, ופקודת המערכת ש-Claude Code משתמש בה כדי לפתוח את Claude Desktop נכשלה. אחרי /desktop, הסשן נשאר בטרמינל. claude --desktop מדפיס את ההודעה בלי הקידומת Error: ויוצא עם סטטוס 1.

הטקסט בסוגריים מציין את הפקודה שנכשלה, עם סטטוס היציאה שלה והשורה הראשונה של פלט השגיאה שלה כשהיא ייצרה אותם. ב-macOS הפקודה הזו היא open, כמו בדוגמה הזו. ב-Windows היא rundll32:

Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.

מה לעשות:

• פתח את Claude Desktop בעצמך, ואז הרץ שוב /desktop או claude --desktop
• כדי לקרוא את פלט השגיאה המלא של הפקודה שנכשלה, הפעל רישום דיבוג עם /debug והרץ שוב את /desktop, או הרץ claude --desktop --debug-file <path>, ואז בדוק את יומן הדיבוג

לפני v2.1.285, ההודעה הסתיימה ב-Open Claude Desktop and run /desktop again. לפני v2.1.275, היא הייתה Failed to open Claude Desktop. Please try opening it manually. ולא אמרה מה נכשל.

#/terminal-setup השאיר את מפת המקשים של Zed ללא שינוי

הרצת /terminal-setup ב-Zed, ו-Claude Code לא הצליח להשלים את העדכון של keymap.json של Zed, ולכן השאיר את הקובץ כמו שהיה.

כל הודעה מציינת את הנתיב למפת המקשים שלך ומסתיימת בבלוק קיצור המקשים שצריך להוסיף בעצמך:

Couldn't update your Zed keymap, so it was left unchanged.
To add the binding yourself, add this block to the keymap array in <path to keymap.json>:
{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }

השורה הראשונה של ההודעה מציינת את הסיבה:

• Couldn't read your Zed keymap, so it was left unchanged.: Claude Code לא הצליח לקרוא את הקובץ, למשל בגלל הרשאות קובץ
• Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.: הקובץ נקרא בהצלחה אבל לא מתפרש כמערך של בלוקי קיצורי מקשים, גם כשהערות // ופסיקים בסוף מותרים
• Couldn't back up your Zed keymap; not modifying it.: Claude Code לא הצליח להעתיק את הקובץ לגיבוי .bak לצדו, ולכן לא שינה דבר
• Couldn't update your Zed keymap, so it was left unchanged.: התוצאה הממוזגת לא אומתה כמפת מקשים תקינה שנושאת את הקישור, ולכן Claude Code זרק אותה במקום לכתוב. בלוק קיצור מקשים עם מפתח כפול יכול לגרום לזה

מה לעשות:

• העתק את הבלוק מההודעה אל המערך ברמה העליונה ב-keymap.json בנתיב שההודעה מציינת
• עבור isn't a readable list of keybindings, תקן את שגיאת התחביר, או הפוך את הערך ברמה העליונה של הקובץ למערך, ואז הרץ שוב את /terminal-setup

לפני v2.1.247, /terminal-setup לא הצליח לפרסר מפת מקשים של Zed שהשתמשה בהערות // או בפסיקים בסוף, והחליף את כל הקובץ רק בקישור שלו תוך דיווח שהקישור הותקן. כדי לשחזר מפת מקשים שגרסה קודמת החליפה, השתמש בקובץ הגיבוי .bak המתואר תחת הזנת הנחיות מרובות שורות.

#דיווחי שימוש ב-skill אינם זמינים בחיבור הזה

הרצת /skill-doctor דרך Remote Control, מהטלפון או מהדפדפן. Claude Code לא שולח את דוח השימוש ב-skill דרך Remote Control ועונה בהודעה הזו במקום:

Skill usage reports are not available on this connection.

מה לעשות:

• הרץ את /skill-doctor בטרמינל במכונה שבה הסשן רץ, או הרץ שם claude -p "/skill-doctor"

#אי אפשר לבחור סגנונות פלט מותאמים אישית דרך Remote Control

הרצת /output-style מהאפליקציה לנייד או מהאינטרנט דרך Remote Control, או שהפקודה הגיעה בהודעה שהועברה לתוך הסשן. מכיוון שתור כזה עשוי לא להגיע מבעל החשבון, Claude Code מציג ובוחר בו רק סגנונות מובנים, ומוסיף את ההודעה הזו בכל פעם שהפקודה מציגה את הסגנונות או לא מזהה את השם שנתת. שם של סגנון מותאם אישית מקבל את אותה תשובה כמו שם שלא קיים:

Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.

מה לעשות:

• בחר סגנון מובנה, למשל /output-style concise
• כדי להשתמש בסגנון מותאם אישית, הגדר את outputStyle ב-.claude/settings.local.json של הפרויקט, או הרץ /output-style <style> בטרמינל של הסשן עצמו אם יש לו כזה

#סגנונות הפלט נשמרים בהגדרות מקומיות שהסשן הזה לא טוען

ניסית להחליף סגנונות פלט עם /output-style <style> או /config outputStyle=<style> בסשן שמקורות ההגדרות שלו לא כוללים את local. דוגמאות הן סשן Agent SDK שבו settingSources משמיט את "local", וסשן CLI שהופעל עם ערך --setting-sources שמשמיט את local. שתי הפקודות שומרות את הסגנון ב-.claude/settings.local.json, קובץ שסשן כזה אף פעם לא קורא בחזרה, ולכן Claude Code מסרב במקום לכתוב הגדרה שלא תהיה לה השפעה:

Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.

מה לעשות:

• הוסף את local למקורות ההגדרות של הסשן והחלף שוב
• הגדר את המפתח outputStyle בקובץ הגדרות שהסשן כן טוען, כגון .claude/settings.json בפרויקט או ~/.claude/settings.json. ב-TypeScript SDK, הגדר את outputStyle בתוך אובייקט settings המוטמע. ראה הפעלת סגנון פלט

#/recap רץ רק כשאתה מבקש אותו בעצמך

הבקשה /recap לא הגיעה מהקלט שלך. היא הגיעה בהודעה שהועברה לתוך הסשן משרשור Slack, Teams, או פרויקט, או בהנחיה ששלחה משימה מתוזמנת בענן או תוכנית אחרת.

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

/recap only runs when you ask for it yourself in this session: from the terminal, the Claude app or claude.ai/code, or over Remote Control. A message relayed from Slack, Teams or a project thread, or sent by a routine or another program, can't request it.

/recap שאתה מעביר אל claude -p, או שאפליקציית Agent SDK שלך שולחת לסשן שהיא הפעילה, נחשב לקלט שלך.

מה לעשות:

• פתח את הסשן בעצמך והרץ שם את /recap: בטרמינל שלו, באפליקציית Desktop או באפליקציה לנייד, ב-claude.ai/code, או דרך Remote Control
• אם משימה מתוזמנת בענן או תוכנית אחרת שלחה אותו, הסר את /recap מההנחיה הזו

#/feedback מושבת לפי מדיניות הארגון שלך

ההודעה הזו אומרת שמדיניות הארגון שלך לא מאפשרת משוב על המוצר מ-Claude Code, ולכן /feedback, /bug ו-/share לא פותחים את תיבת הדו-שיח של המשוב. ההודעה מציינת את הפקודה שהקלדת בהנחיה של Claude Code:

/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.

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

מה לעשות:

• כדי לדווח על באג, פתח issue ב-github.com/anthropics/claude-code/issues. כל אחד יכול לקרוא issues שם, לכן השמט קוד, תמלילים, וכל דבר אחר סודי.

לפני v2.1.302, ההודעה המלאה הייתה /feedback is disabled by your organization's policy. Contact your organization admin to enable it.

#שגיאות plugin

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

#plugin eval נמצא כרגע בגישה מוקדמת

הרצת claude plugin eval או claude plugin eval init והפקודה יצאה עם קוד 1 עם אחת מההודעות האלה לפני שעשתה משהו:

`plugin eval` is currently in early access

`plugin eval` is currently unavailable

ההודעה הראשונה אומרת שה-build שלך ישן מ-v2.1.269, הגרסה הראשונה שבה הפקודה זמינה באופן כללי. ההודעה השנייה אומרת ש-Anthropic כיבתה את הפקודה בצד השרת. שום דבר במכונה שלך לא מפעיל אותה בחזרה.

מה לעשות:

• הרץ claude --version, אחר כך claude update, והרץ את הפקודה שוב בסשן חדש. ראה את הדרישות ל-plugin evals
• אם אתה רואה את ההודעה השנייה ב-build עדכני, נסה שוב מאוחר יותר אחרי claude update נוסף

#Marketplace רשום ממקור לא מהימן

ה-marketplace רשום תחת שם ששמור ל-marketplaces רשמיים של Anthropic, אבל המקור הרשום שלו אינו מאגר GitHub של anthropics. Claude Code בודק מחדש שמות שמורים בכל פעם שהוא טוען או מרענן marketplace, ולכן ה-marketplace וה-plugins שהותקנו ממנו מפסיקים להיטען. לפני v2.1.205, רשומה שנרשמה לפני שהשם שלה הפך לשמור המשיכה להיטען.