📘 תיעוד 59

פתרון בעיות

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

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

אם אינכם בטוחים מה חל, הריצו /doctor בתוך Claude Code לבדיקה אוטומטית של ההתקנה, ההגדרות, התוספים ושימוש בהקשר. הבדיקה מציעה תיקונים שהיא יכולה להחיל אחרי שתאשרו. אם claude לא עולה בכלל, הריצו claude doctor מהמעטפת במקום. הריצו /mcp כדי לבדוק את מצב שרתי MCP.

#ביצועים ויציבות

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

#שימוש גבוה במעבד או בזיכרון

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

1. השתמשו ב /compact באופן קבוע כדי להקטין את גודל ההקשר. אם הוא מחזיר Not enough messages to compact., בשיחה יש מעט מדי תורות לסיכום. זה יכול לקרות גם כשההקשר מלא, כשהדבקה אחת גדולה מילאה אותו
2. סגרו והפעילו מחדש את Claude Code בין משימות גדולות
3. שקלו להוסיף ספריות בנייה גדולות לקובץ .gitignore
4. הפעילו מחדש עם claude --safe-mode כדי לבדוק אם תוסף, שרת MCP או hook הם המקור. זה משבית את כל ההתאמות האישיות לסשן. אם השימוש יורד, ראו ניפוי התצורה כדי למצוא איזה מהם

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

מחוץ ל רינדור מסך מלא, הרצת /compact גם משחררת זיכרון. האזהרה נעלמת ברגע ששימוש הזיכרון יורד חזרה מתחת ל 2.5GB.

אם שימוש הזיכרון נשאר גבוה אחרי השלבים האלה, הריצו /heapdump כדי לכתוב שני קבצים אל ~/Desktop: תמונת heap של JavaScript בשם <session-id>.heapsnapshot ופירוט זיכרון בשם <session-id>-diagnostics.json. Claude Code מסתיר את הפקודה מתפריט הפקודות. הקלידו אותה במלואה. ב Linux בלי תיקיית Desktop, הקבצים נכתבים לתיקיית הבית.

[!WARNING]

קובץ .heapsnapshot מכיל כל מחרוזת בתהליך, כולל השיחה המלאה ואישורים. אל תצרפו אותו לדיווח ציבורי ואל תשתפו אותו.

הפקודה גם מדפיסה סיכום בשיחה, שמציג את סך הזיכרון של התהליך, כמה ממנו נמצא ב JS heap, וכמה יושב מחוץ ל heap. הסיכום גם מפרט אינדיקטורים לדליפה, כמו קצב גידול זיכרון גבוה או מספר גבוה במיוחד של handles פתוחים. הסיכום אומר אם רוב הזיכרון נמצא ב JS heap, שהתמונה לוכדת, או בזיכרון native, שהיא לא לוכדת.

דווחו על הפלט או חקרו אותו בעצמכם:

• דווחו עליו: פתחו דיווח ב GitHub וצרפו רק את קובץ -diagnostics.json, שנושא את הסטטיסטיקה שמאחורי הסיכום המודפס ובלי תוכן שיחה או אישורים
• חקרו בעצמכם: אם הסיכום אומר שרוב הזיכרון הוא JS heap, פתחו את קובץ .heapsnapshot ב Chrome DevTools תחת Memory → Load ומיינו לפי retained size כדי לראות מה מחזיק את הזיכרון

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

#טבלאות גדולות נחתכות בטרמינל

טבלת Markdown עם יותר מ 200 שורות מרנדרת את 200 השורות הראשונות ואחריהן שורה … N more rows not shown. רק התצוגה מוגבלת: הטבלה המלאה נשארת בשיחה, ו /copy מעתיק כל שורה. לטבלה גדולה מדי לקריאה בטרמינל, בקשו מ Claude לכתוב אותה לקובץ במקום. לפני v2.1.208, Claude Code רינדר כל שורה, ולכן חידוש סשן שהכיל טבלה גדולה מאוד יכול היה להיתקע בזמן הרינדור מחדש.

#דחיסה אוטומטית נעצרת עם שגיאת thrashing

אם אתם רואים Autocompact is thrashing: the context refilled to the limit..., הדחיסה האוטומטית הצליחה, אבל קובץ או פלט של כלי מילאו מחדש את חלון ההקשר כמה פעמים ברצף. Claude Code מפסיק לנסות שוב כדי לא לבזבז קריאות API על לולאה שלא מתקדמת.

כדי להתאושש:

1. בקשו מ Claude לקרוא את הקובץ הגדול מדי בחלקים קטנים יותר, כמו טווח שורות מסוים או פונקציה, במקום את כל הקובץ
2. הריצו /compact עם מיקוד שמוריד את הפלט הגדול, למשל /compact keep only the plan and the diff
3. העבירו את עבודת הקובץ הגדול ל subagent כדי שהיא תרוץ בחלון הקשר נפרד
4. הריצו /clear אם השיחה הקודמת כבר לא נדרשת

אם השגיאה חוזרת אחרי /clear, הריצו /context והשוו את שורת Messages לשורות שמעליה:

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

#פקודה נתקעת או קופאת

אם Claude Code נראה לא מגיב:

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

הפעלה מחדש לא מאבדת את השיחה. הריצו claude --resume באותה ספרייה כדי להמשיך את הסשן.

#טקסט משובש או פגום בטרמינל משולב של עורך

אם תווים מוצגים כתיבות, מריחות, או גליפים שגויים כשמריצים את Claude Code בטרמינל המשולב של VS Code, Cursor, או Devin Desktop, כנראה שמנוע ה GPU של הטרמינל הוא הסיבה. הריצו /terminal-setup בתוך Claude Code כדי להגדיר את terminal.integrated.gpuAcceleration ל "off", או הגדירו זאת ידנית בהגדרות העורך וטענו מחדש את החלון. ראו תצורת טרמינל לשאר ההגדרות ש /terminal-setup כותב.

#>0q תועה בהפעלה או >4m אחרי יציאה

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

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

echo $VTE_VERSION

בטרמינל מבוסס VTE, תוצאה מתחת ל 5300 פירושה ספרייה ישנה מ 0.53: עדכנו או החליפו את הטרמינל כדי לקבל VTE 0.53 או חדש יותר. אחרת, ראו עזרה נוספת.

#גלגל העכבר גולל שורה אחת בכל פעם ברינדור מסך מלא

ב רינדור מסך מלא, Claude Code גולל את השיחה בעצמו ולא משאיר זאת לטרמינל. אם כל חריץ בגלגל מזיז פחות שורות ממה שאתם רוצים, הריצו /scroll-speed כדי להעלות את מספר השורות לחריץ ולשמור זאת, או הגדירו את משתנה הסביבה CLAUDE_CODE_SCROLL_SPEED, חוץ מבטרמינל של JetBrains IDE, שם Claude Code מחיל טיפול גלילה משלו ואף אחד מהם לא נכנס לתוקף. ראו גלילת גלגל עכבר לערכים שכל אחד מקבל.

כדי לזוז מהר יותר בלי לשנות את המהירות, לחצו PgUp ו PgDn כדי לגלול חצי מסך בכל פעם. כדי להשתמש ב scrollback המקורי של הטרמינל, הריצו /tui default כדי לעבור למנוע הרינדור הקלאסי.

#פקודות לוח כמו pbcopy נכשלות בתוך ה sandbox

כש sandboxing פעיל, כלי לוח כמו pbcopy, xclip, ו wl-copy יכולים להיכשל בהגעה ללוח המערכת מתוך פקודת Bash ב sandbox, ולוח ההעתקה נשאר ללא שינוי אחרי ש Claude מזרים אליהם טקסט.

כדי לשים את הפלט של Claude על לוח ההעתקה, בקשו מ Claude להדפיס את התוכן בתשובה שלו, ואז הריצו /copy. /copy כותב ללוח מתהליך Claude Code עצמו ולא מפקודה ב sandbox, ולכן ה sandboxing לא חוסם אותו. הוא יכול להעתיק בלוק קוד יחיד במקום את כל התשובה, והוא גם כותב את מה שהעתיק לקובץ ומדפיס את הנתיב, מה שנותן גיבוי כשכתיבה ללוח לא מגיעה לטרמינל, למשל דרך SSH.

כש Claude מזרים טקסט לאחד הכלים האלה, הוספת pbcopy *, wl-copy *, או xclip * ל excludedCommands לא מוציאה את הקריאה הזו מה sandbox בפני עצמה.

#טקסט שהועתק לא מגיע ללוח המקומי דרך SSH

כש Claude Code רץ על מכונה מרוחקת דרך SSH, הוא לא יכול להריץ כלי לוח על המכונה המקומית. מחוץ ל tmux, כשבוחרים טקסט ב רינדור מסך מלא או מריצים /copy, Claude Code שולח את הטקסט לטרמינל כרצף מילוט OSC 52 במקום. הטרמינל מחליט אם לשים אותו על לוח ההעתקה. /copy מדווח Copied to clipboard בין אם הטקסט הגיע ובין אם לא, ומחוץ ל tmux הודעת הבחירה היא sent N chars via OSC 52.

חלק מהטרמינלים לא פועלים על OSC 52. iTerm2 מתעלם ממנו עד שמפעילים Settings > General > Selection > Applications in terminal may access clipboard, ו Terminal.app של macOS לא תומך בזה.

כדי לקבל את הטקסט בלי OSC 52:

• החזיקו את מקש הבחירה המקורית של הטרמינל בזמן הגרירה, ואז העתיקו בקיצור הרגיל של הטרמינל, כמו Cmd+C. המקש הוא Fn ב Terminal.app ו Option ב iTerm2. שמירה על בחירת טקסט מקורית מפרטת זאת לטרמינלים אחרים.
• הגדירו CLAUDE_CODE_DISABLE_MOUSE=1 במכונה המרוחקת כדי שהטרמינל יטפל בבחירה לכל הסשן.

#בעיות חיפוש וגילוי

אם כלי החיפוש, אזכורי @file, סוכנים מותאמים, או skills מותאמים לא מוצאים קבצים, ייתכן שהבינארי ripgrep המצורף לא רץ במערכת. התקינו את חבילת ripgrep של הפלטפורמה ואמרו ל Claude Code להשתמש בה במקום:

macOS

brew install ripgrep

Ubuntu/Debian

sudo apt install ripgrep

Alpine

apk add ripgrep

ripgrep נמצא במאגר community של Alpine. אם apk מדווח שהחבילה חסרה, ראו הגדרת Alpine Linux.

Arch

pacman -S ripgrep

Windows

winget install BurntSushi.ripgrep.MSVC

אחר כך הגדירו את USE_BUILTIN_RIPGREP ל 0, או ב סביבה של המעטפת או בבלוק env של settings.json:

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

כדי לאשר שהמעבר נכנס לתוקף, הריצו claude doctor בטרמינל ובדקו ששורת Search מציגה את הנתיב של ripgrep של המערכת במקום OK (bundled).

#תוצאות חיפוש איטיות או חלקיות ב WSL

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

[!NOTE]

claude doctor מציג את Search כ OK במקרה הזה.

פתרונות:

1. הגישו חיפושים ספציפיים יותר: צמצמו את מספר הקבצים שנסרקים על ידי ציון ספריות או סוגי קבצים: "Search for JWT validation logic in the auth-service package" או "Find use of md5 hash in JS files".

2. העבירו את הפרויקט למערכת הקבצים של Linux: אם אפשר, ודאו שהפרויקט נמצא על מערכת הקבצים של Linux (/home/) ולא על מערכת הקבצים של Windows (/mnt/c/).

3. השתמשו ב Windows מקורי במקום: שקלו להריץ את Claude Code באופן מקורי על Windows במקום דרך WSL, לביצועי מערכת קבצים טובים יותר.

#עזרה נוספת

אם אתם נתקלים בבעיות שלא מכוסות כאן:

1. הריצו /doctor לבדיקת הגדרה ו /mcp כדי לבדוק את מצב שרתי MCP
2. השתמשו בפקודה /feedback בתוך Claude Code כדי לדווח על בעיות ישירות ל Anthropic
3. בדקו את מאגר GitHub לבעיות ידועות
4. שאלו את Claude ישירות על היכולות והתכונות שלו. ל Claude יש גישה מובנית לתיעוד שלו.

לבעיות חשבון, חיוב, או מנוי, פנו במקום זאת לתמיכה של Anthropic: התחברו ב claude.ai (משתמשי Console: platform.claude.com), לחצו על ראשי התיבות בפינה השמאלית התחתונה, ובחרו Get help. ראו איך לקבל תמיכה לתהליך המלא, כולל מי יכול להגיע לנציג אנושי בכל תוכנית.