Claude Code Safe Mode: איך לאבחן בעיות בהגדרות תוך 30 שניות

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

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

מה זה Safe Mode ולמה זה משנה לבעל עסק

בגרסה 2.1.169 של Claude Code (יוני 2026), Anthropic הוסיפו את --safe-mode. פקודה אחת שמכבה בבת אחת את כל ההתאמות שהוספת: CLAUDE.md, Skills, Hooks, MCP servers, Plugins, Workflows, Themes. הכל.

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

למה זה חשוב? כי בעל עסק שמפעיל אוטומציות דרך Claude Code לא יכול להרשות לעצמו שעות חיפוש תקלות. כל שעה שהמערכת למטה, לידים לא נכנסים ותוכן לא מפורסם. claude –safe-mode נותן תשובה ב-30 שניות: הבעיה שלי, או של Anthropic?

איך משתמשים: 5 צעדים, 30 שניות

• הבעיה קורית. Claude Code לא מגיב כמו שצריך. סוכן נתקע. אוטומציה שהפסיקה לרוץ.
• מפעילים Safe Mode. כותבים בטרמינל: claude --safe-mode. בסקריפט: CLAUDE_CODE_SAFE_MODE=1 claude.
• משחזרים את הבעיה. עושים בדיוק את מה שגרם לתקלה.
• הבעיה נעלמה? התקלה בהגדרות שלך. ממשיכים לבידוד.
• הבעיה נשארה? התקלה ב-Claude Code עצמו. יש לך שחזור נקי לדיווח ל-Anthropic.

בדיוק כמו שרופא שואל "כואב כשאני לוחץ פה?" לפני שהוא שולח לצילום. בדיקה מהירה שחוסכת שעות של ניחושים.

מה בדיוק קרה אצלי: הפירוט הטכני

אני מנהל עסק מתאילנד. המערכת שלי רצה 24/7, כמו שתיעדתי כשהגעתי ל-1,500 קליקים מגוגל ב-28 יום. כשכל הסוכנים קרסו באותו בוקר, התחלתי לחפש.

בדקתי את .mcp.json. נראה תקין. בדקתי את ה-Hooks. תקין. העברתי את CLAUDE.md הצידה. עדיין לא עובד. ביטלתי MCP servers אחד אחד. שום שינוי. רק אחרי 40 דקות פתחתי את settings.json ב-validator חיצוני ומצאתי: פסיק חסר אחרי ערך שהוספתי בערב הקודם.

פסיק אחד. זה מה שהפיל את כל המערכת.

לפי הדוקומנטציה של Anthropic, שגיאת JSON בקובץ הגדרות אחד יכולה למנוע טעינה של כל ה-MCP servers. בלי הודעת שגיאה. בשקט.

עם Safe Mode, הדרך קצרה: claude --safe-mode, רואה שהכל עובד, חוזר למצב רגיל, מריץ /doctor, מקבל "invalid JSON in settings.json". דקה אחת במקום 40.

5 תקלות נפוצות ואיך לזהות כל אחת

אחרי חודשים של הפעלת המערכת, לפי מדריך האבחון הרשמי של Anthropic, אלה הדברים שנשברים הכי הרבה:

• נתיב יחסי ב-MCP server. כתבת ./my-server ב-.mcp.json? הנתיב נקבע לפי התיקייה שממנה הפעלת את Claude Code, לא לפי מיקום הקובץ. לפי מדריך ה-MCP: תמיד נתיב מלא. איך מזהים: /mcp מראה שהשרת לא מחובר.
• JSON שבור ב-settings.json. פסיק חסר, סוגר מיותר. שגיאה בלי שום הודעה, השפעה על כל המערכת. איך מזהים: /doctor מדווח "invalid JSON".
• Hook שלא רץ. ל-Hooks יש כללי הפעלה שקובעים על אילו כלים הם רצים. שגיאת כתיב בשם הכלי? ה-Hook פשוט לא ירוץ. בלי אף הודעה. איך מזהים: הפעל claude --debug ובדוק ב-log אם ה-Hook הופעל (לפי מדריך ה-Hooks הרשמי).
• CLAUDE.md סותר ברמות שונות. קובץ ברמת הפרויקט וגם ברמה הגלובלית, עם הוראות סותרות. איך מזהים: /context מראה מה בדיוק נטען לקונטקסט.
• MCP server שדורש אימות בפעם הראשונה. שרת שמחכה לקלט בהפעלה הראשונה ייתקע. איך מזהים: /mcp מראה "connecting…" שלא מסתיים. הפתרון: להריץ ידנית קודם, להשלים את האימות, ורק אז להגדיר.

5 פקודות אבחון שכל בעל עסק צריך להכיר

Safe Mode אומר "הבעיה בהגדרות שלך". אבל איפה בדיוק? בשביל זה יש חמש פקודות:

• /doctor הבדיקה הראשונה. בודקת גרסה, JSON תקין, שגיאות MCP, בעיות plugins. אם משהו שבור, היא תגיד מה ואיפה.
• /status מראה אילו מקורות הגדרות פעילים, כולל הגדרות ארגוניות. קובץ שבור יופיע עם סימון שגיאה.
• /mcp מציג כל MCP server, סטטוס חיבור, ואישורים. אם שרת תקוע, תראה את זה.
• /hooks מציג כל Hook רשום, לאילו אירועים הוא מחכה, ומה הוא מריץ.
• /context מראה מה בדיוק נמצא בקונטקסט של Claude. שימושי לוודא ש-CLAUDE.md או Skill מסוים באמת נטען.

סדר העדיפויות שחוסך שעות של בלבול

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

• Managed (הגדרות ארגוניות). אי אפשר לדרוס.
• Command line (דגלים בהפעלה).
• Local (.claude/settings.local.json. לא נכנס ל-git).
• Project (.claude/settings.json. כן נכנס ל-git).
• User (~/.claude/settings.json. גלובלי).

בפועל: הגדרת משהו בקובץ הגלובלי ולא מבין למה זה לא עובד בפרויקט מסוים? כנראה שיש קובץ Project שדורס אותך. /status חושף את זה.

disableBundledSkills: לשלוט ב-Skills שרצים

באותו עדכון, Anthropic הוסיפו גם את disableBundledSkills. ההגדרה מכבה את כל ה-Skills שמגיעים מובנים עם Claude Code.

למה זה רלוונטי? אם בנית Skills מותאמים לעסק שלך (כמו שאנחנו עושים בסדנת Claude Code), לפעמים Skill מובנה מתנגש עם שלך. אותו שם, התנהגות שונה. disableBundledSkills פותר את זה.

CLAUDE_CODE_DISABLE_BUNDLED_SKILLS=1 claude

מתי Safe Mode לא מתאים

• לא לעבודה יומיומית. בלי CLAUDE.md, Skills ו-Hooks, Claude Code גנרי. כל ההתאמה שבנית לעסק לא פועלת. במדריך המלא הסברתי כמה ההתאמה משנה.
• לא לעקיפת אבטחה. Safe Mode לא עוקף הגדרות ארגוניות. הוא מכבה רק מה שאתה הוספת.
• לא לבלבל עם Auto Mode. Auto Mode מדלג על אישורי הרשאות. Safe Mode עוזר לאתר מאיפה הבעיה. שני כלים שונים.

לאבחן לפני שמתקנים

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

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

ועכשיו, יש לך את הכלי: claude --safe-mode.

באהבה ענקית,
יהב.