📘 תיעוד 54

פתרון בעיות

תקן שימוש גבוה ב-CPU או בזיכרון, קפיאות, דשדוש בדחיסה אוטומטית (auto-compact thrashing) ובעיות חיפוש ב-Claude Code, ומצא את הדף הנכון עבור בעיות אחרות.

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

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

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

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

#שימוש גבוה ב-CPU או בזיכרון

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

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

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

[!WARNING] קובץ ה-.heapsnapshot מכיל כל מחרוזת שקיימת בתהליך, כולל השיחה המלאה שלך ופרטי הגישה שלך. אל תצרף אותו לדיווח תקלה ציבורי (issue) ואל תשתף אותו.

הפקודה מדפיסה גם סיכום בשיחה, המציג את ה-resident set size, ערימת ה-JS, חוצצי מערכים (array buffers), וזיכרון מקומי (native memory) שאינו מוסבר, לצד כל מדד דליפה שזוהה, כגון קצב גידול זיכרון גבוה או מספר חריג של ידיות (handles) פתוחות. הסיכום מציין אם רוב הזיכרון נמצא בערימת ה-JS, שתצלום המצב לוכד, או בזיכרון מקומי, שאותו הוא אינו לוכד.

בצע אחת משתי פעולות עם הפלט:

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

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

#טבלאות גדולות נחתכות במסוף

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

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

אם אתה רואה 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 אם השיחה המוקדמת אינה נחוצה עוד

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

אם נראה ש-Claude Code אינו מגיב:

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

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

#טקסט משובש במסוף המובנה של עורך הקוד

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

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

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

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

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

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

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

כדי לאפשר לפקודה מנותבת (piped) להגיע ישירות אל הלוח במקום זאת, הוסף את pbcopy *, wl-copy * או xclip * אל excludedCommands כדי שהפקודה תרוץ מחוץ ל-sandbox.

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

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

macOS:

brew install ripgrep

Ubuntu/Debian:

sudo apt install ripgrep

Alpine:

apk add ripgrep

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

Arch:

pacman -S ripgrep

Windows:

winget install BurntSushi.ripgrep.MSVC

לאחר מכן הגדר את USE_BUILTIN_RIPGREP ל-0, בסביבת המעטפת שלך (environment) או בבלוק 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. עיין ב-כיצד לקבל תמיכה עבור התהליך המלא, כולל מי יכול להגיע לנציג אנושי בכל תוכנית.