📘 תיעוד 93

הגדרות Claude Code

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

הערה: דף זה עוסק ב-Claude Code שרץ במחשב שלך: הטרמינל, הרחבות VS Code ו-JetBrains, ואפליקציית שולחן העבודה (desktop app), אשר כולן קוראות את אותם קובצי הגדרות. הפעלת ענן ב-Claude Code on the web רצה במחשב אחר וקוראת רק חלק מהם: ראה הגדרות בהפעלות ענן.

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

Claude Code קורא הגדרות מקובצי הגדרות מסוג JSON כגון ~/.claude/settings.json. הוא מחפש אותם בכמה מיקומים, והקובץ שממנו הוא קורא הגדרה קובע על מי ההגדרה חלה.

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

מדריך ההגדרות (settings reference) מפרט כל מפתח שניתן להגדיר, יחד עם הקובץ שבו מגדירים אותו, הטיפוס שלו, וברירת המחדל שלו. המדריך להגדרת הרשאות (permissions) מכסה מה Claude Code יכול להריץ בלי לבקש רשות וכיצד לכתוב כללי allow, ask, ו-deny.

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

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

בעמודת הקובץ, ~/.claude היא תיקיית .claude בספריית הבית שלך, ואילו .claude ללא קידומת היא תיקיית .claude בתוך הפרויקט שלך.

#השוואת טווח התחולה של כל קובץ הגדרות

נניח שיש לך שלושה פרויקטים במחשב שלך, website/, api/, ו-acme-app/, לחבר צוות יש שכפול (clone) משלו של acme-app/, ואתה מתחיל הפעלת ענן על acme-app/.

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

• ~/.claude/settings.json: כל פרויקט במחשב שלך, ושום דבר במחשב של חבר הצוות או בהפעלת הענן.
• acme-app/.claude/settings.json: ה-acme-app/ שלך. הקובץ מגיע לשכפול של חבר הצוות ולהפעלת הענן רק אם אתה מבצע commit לקובץ במערכת בקרת הגרסאות; עד שתעשה זאת, זהו קובץ בדיסק שלך כמו כל קובץ אחר ולאף אחד אחר אין אותו.
• acme-app/.claude/settings.local.json: ה-acme-app/ שלך בלבד. Claude Code מוסיף אותו לקובץ ה-git excludes הגלובלי שלך בפעם הראשונה שהוא כותב את הקובץ, כך שהוא נשאר מחוץ ל-commits שלך בכל מאגר; אם אתה יוצר את הקובץ ידנית, הוסף אותו בעצמך ל-.gitignore.
• הגדרות מנוהלות (Managed settings), בין אם קובץ managed-settings.json, מדיניות MDM, או הגדרות מנוהלות שרת מקונסולת claude.ai: כל פרויקט בכל מכונה שהארגון שלך פורס אליהן, או שאתה מתחבר אליהן עם חשבון הארגון שלך. רק הגדרות מנוהלות שרת מגיעות להפעלת הענן.

#מציאת קובצי ההגדרות שלך או יצירתם

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

• מנוהל (Managed): הארגון שלך פורס אותו. אינך יוצר או עורך אותו.
• פרויקט משותף (Shared project): פרויקט שכבר משתמש ב-Claude Code עשוי לכלול קובץ כזה ב-commit. אם לא, צור אותו בנתיב .claude/settings.json בתוך תיקיית הפרויקט.
• משתמש (User) ופרויקט מקומי (Project local): צור אותם בעצמך, או תן ל-Claude Code ליצור אותם. הוא כותב את ~/.claude/settings.json בפעם הראשונה שאתה משנה אפשרות בתפריט /config שנשמרת בהגדרות המשתמש, כגון ערכת הנושא, ואת .claude/settings.local.json בפעם הראשונה שאתה נותן אישור קבוע בבקשת הרשאה, כגון "Yes, and don't ask again" עבור פקודת Bash. מספר אפשרויות ב-/config, כולל Show tips, נשמרות ב-.claude/settings.local.json במקום בקובץ המשתמש.

מידע: ב-Windows, המשמעות של ~/.claude היא %USERPROFILE%\.claude. כדי לשמור את קובצי ספריית הבית במקום אחר, הגדר את CLAUDE_CONFIG_DIR; Claude Code ישמור אז את ההגדרות, היסטוריית ההפעלות והתוספים שלך שם במקום זאת.

Claude Code מחזיק גם קובץ חמישי, ~/.claude.json, שהוא כותב עבור עצמו; אינך צריך לערוך אותו. הוא שומר את הפעלת ההתחברות שלך, תצורות שרתי MCP, מצב פר פרויקט כגון החלטות אמון (trust decisions), ואת מפתחות התצורה הגלובלית ש-/config כותב עבורך.

#שיתוף הגדרות עם הצוות שלך

בצע commit לקובץ .claude/settings.json כדי שכל מי שמשכפל את המאגר יקבל את אותן הרשאות, hooks, טלמטריה ותוספים. כל חבר צוות עדיין יכול לדרוס זאת עבור עצמו בקובץ .claude/settings.local.json שלו, כך שחריגות אישיות אינן דורשות commit. עבור קובץ צוותי מלא, ראה את ההגדרות המשותפות של צוות בתיעוד.

חלק ממה שאתה עושה לו commit ממתין עד שכל חבר צוות יביע אמון בתיקייה (trusts the folder), ומספר מפתחות אינם נכנסים לתוקף לעולם מקובץ מאגר; הסעיף פתרון בעיות בהגדרה שאינה מוחלת מכסה את שני המקרים.

#שמירת הגדרות אישיות מחוץ למאגר

כדי לשנות הגדרה עבור עצמך בפרויקט אחד מבלי לשנות אותה עבור חברי הצוות שלך, שמור אותה ב-.claude/settings.local.json בתוך הפרויקט. Claude Code מחיל את הקובץ הזה מעל הקובץ .claude/settings.json שנמצא ב-commit, כך שאם הקובץ של הצוות שלך מגדיר "model": "claude-sonnet-5" ואתה רוצה את Opus, שים "model": "claude-opus-4-8" בקובץ המקומי שלך ורק ההפעלות שלך ישתנו.

שלושה דברים שכדאי לדעת על הקובץ המקומי:

• Claude Code כותב אליו גם כן: כאשר Claude מבקש הרשאה להריץ פקודת Bash ואתה בוחר "Yes, and don't ask again", Claude Code שומר את אישור ההרשאה הזה כאן ככלל allow.
• אינך צריך להוסיף אותו ל-gitignore בעצמך, אלא אם יצרת אותו ידנית: בפעם הראשונה ש-Claude Code כותב את הקובץ במאגר git שעדיין אינו מתעלם ממנו, הוא מוסיף את **/.claude/settings.local.json לקובץ ה-git excludes הגלובלי שלך, כך שהקובץ נשאר מחוץ ל-commits שלך בכל מאגר. קובץ זה הוא core.excludesFile כאשר תצורת ה-git הגלובלית שלך מגדירה אותו לנתיב מוחלט או לנתיב המתחיל ב-~; אחרת הוא $XDG_CONFIG_HOME/git/ignore, או ~/.config/git/ignore כאשר XDG_CONFIG_HOME אינו מוגדר. אם יצרת את הקובץ ידנית ו-Claude Code טרם כתב אליו, הוסף אותו בעצמך ל-.gitignore.
• כללי ה-allow שלו אינם ממתינים להבעת אמון כל עוד הקובץ אינו במעקב (untracked): מכיוון שהקובץ שייך לך ולא למאגר, Claude Code מחיל את כללי ה-allow שלו ללא שלב הבעת האמון בסביבת העבודה (workspace trust) הנדרש עבור הקובץ שנמצא ב-commit. אם הקובץ נמצא במעקב על ידי git, שלב האמון חל גם עליו; ראה מתי קובץ ההגדרות המקומי שלך זקוק לאמון.

#היכן Claude Code שומר את הקובץ המקומי במאגר git

כאשר Claude מבקש הרשאה להריץ פקודת Bash ואתה בוחר "Yes, and don't ask again", Claude Code שומר את האישור הזה ככלל allow בתוך .claude/settings.local.json. אם אתה מפעיל את Claude Code בתת-ספרייה של מאגר git, הוא קורא וכותב את הקובץ הזה בשורש המאגר ומחיל את האישור על פני המאגר כולו. ב-worktree, הוא משתמש בקובץ שנמצא בשורש ה-checkout הראשי.

שני כללים מסייגים את מיקום השורש:

• מתי הקובץ נשאר יחד עם .claude/settings.json במקום זאת: מחוץ למאגר git, כאשר שורש המאגר הוא ספריית הבית שלך, ב-Windows, או כאשר שורש המאגר או הרשומות .git או .claude שבו אינם בבעלות המשתמש שלך.
• נתיבים בקובץ אינם מעוגנים בשורש המאגר: כלל הרשאה שמתחיל ב-/ או נתיב ארגז חול (sandbox) יחסי מעוגן במקום זאת בספריית העבודה הראשית של ההפעלה.

לפני גרסה v2.1.211, Claude Code שמר את הקובץ בספריית ההתחלה. הוא עדיין קורא קובץ שגרסה מוקדמת יותר השאירה שם לצד קובץ השורש; במקרה ששניהם מגדירים את אותו מפתח, הערך של השורש חל, וכללי הרשאות משני הקבצים חלים. פונקציית העזר resolveSettings() של ה-Agent SDK תמיד קוראת את הקובץ מספריית ההתחלה.

Claude Code קורא את .claude/settings.json המשותף מספריית העבודה הראשית של ההפעלה, כך שכדי להשתמש בקובץ שנמצא ב-commit בשורש המאגר, הפעל את Claude Code שם. לאחר שאתה מעביר את ההפעלה באמצעות /cd, Claude Code קורא את שני קובצי הפרויקט מהספרייה החדשה במקום זאת, וממקם את הקובץ המקומי לפי אותם כללים. קריאתם מהספרייה שאליה עברת דורשת את Claude Code בגרסה v2.1.246 ומעלה.

#בדיקה של מה שהארגון שלך אוכף

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

הגדרות מנוהלות מגיעות אליך באמצעות מנגנוני ההעברה (delivery mechanisms) שבדף ההגדרות המנוהלות, בדרך כלל באמצעות:

• הגדרות מנוהלות שרת (Server-managed settings), ש-Claude Code מושך מקונסולת הניהול של claude.ai או מ-Claude apps gateway באירוח עצמי.
• מדיניות MDM או מדיניות ברמת מערכת ההפעלה, וקובצי managed-settings.json בספריית מערכת.
• מארח מוטמע כגון Claude Desktop, דרך אפשרות managedSettings ב-SDK; ראה שליטה במדיניות ממארח מוטמע.

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

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

#שינוי הגדרה

באפשרותך לשנות הגדרה מתפריט /config, באמצעות עריכת קובץ הגדרות, או עבור הפעלה בודדת משורת הפקודה.

ה-system prompt של Claude Code אינו מפורסם. כדי לתת ל-Claude הנחיות קבועות, השתמש בקובצי CLAUDE.md או בדגל --append-system-prompt.

#שימוש בתפריט /config

הרץ /config בתוך Claude Code ופתח את הכרטיסייה Config. היא מציגה רשימה קצרה של אפשרויות אישיות כגון ערכת נושא, מצב עורך ופלט מפורט (verbose output), ולא כל מפתח הגדרה. בחר באפשרות כדי לשנות אותה; Claude Code ישמור אותה עבורך:

• רוב האפשרויות: ~/.claude/settings.json
• מספר אפשרויות, כגון Show tips: ב-.claude/settings.local.json
• אפשרויות התצורה הגלובלית (global config): ב-~/.claude.json

כדי להגדיר אפשרות אחת ללא התפריט, העבר key=value, לדוגמה /config verbose=true.

הערה: הפקודה /config היא חלק מממשק הטרמינל. חלונית הצ'אט של VS Code ואפליקציית שולחן העבודה אינן פותחות אותה; שנה הגדרות שם על ידי עריכת קובץ הגדרות או דרך ההגדרות של האפליקציות עצמן.

#עריכת קובץ הגדרות

פתח בעורך שלך את קובץ ההגדרות עבור טווח התחולה הרצוי והוסף או שנה מפתח. קובצי הגדרות הם בפורמט JSON קפדני: הערת // או פסיק מיותר בסוף (trailing comma) מהווים שגיאת תחביר, ו-Claude Code ידווח על הקובץ כשגיאת הגדרות (Settings Error) בהפעלה הבאה. לדוגמה, כדי לאפשר ל-Claude Code להריץ את פקודות ה-lint והבדיקות שלך בלי לבקש רשות ולמנוע ממנו לקרוא קובצי .env, הוסף את הדברים הבאים ל-~/.claude/settings.json:

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

כל רשומה תחת permissions היא כלל שמציין כלי ומה מותר לו לעשות; המדריך להגדרת הרשאות מסביר את התחביר. שורת ה-$schema מצביעה על ה-JSON schema הרשמי עבור הגדרות Claude Code, מה שמעניק לך השלמה אוטומטית (autocomplete) ואימות בתוך הקובץ ב-VS Code, Cursor ובכל עורך אחר התומך ב-JSON schema. הסכמה עשויה לפגר מעט אחרי גרסאות CLI חדשות, ולכן אזהרת אימות על מפתח שתועד לאחרונה אינה מעידה בהכרח שהתצורה שלך שגויה.

לאחר השמירה, הרץ /status בתוך Claude Code כדי לוודא שהקובץ נטען; הסעיף אימות מה נטען מציין מה מציגה שורת Setting sources וכיצד מדווח על קובץ פגום.

עבור דוגמה מלאה לקובץ אישי, קובץ צוותי וקובץ ארגוני, שכל אחד מהם מוצג עם הסבר על כל מפתח שהוא מגדיר, ראה את דוגמאות לקובצי הגדרות (example settings files).

#שינוי הגדרה להפעלה בודדת

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

• --settings: העבר מפתח כ-JSON, ישירות בשורת הפקודה או כנתיב לקובץ. Claude Code מחיל אותו מעל קובצי המשתמש, הפרויקט והקבצים המקומיים שלך, ומתחת להגדרות מנוהלות. הוא יכול להגדיר כל מפתח שקובץ הגדרות המשתמש שלך יכול להגדיר; הוא אינו יכול להגדיר מפתחות Managed או Global config.
• דגל עבור אותו מפתח: לחלק מהמפתחות יש דגל משלהם, כגון --model עבור model, ו---effort עבור effortLevel ו-modelSettings.
• משתנה סביבה: בצע export למשתנה התואם של המפתח לפני שתריץ את claude, כגון ANTHROPIC_MODEL עבור model.

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

פקודות שאתה מריץ בתוך הפעלה שומרות לרוב את הבחירה שלך: /config כותב לקובצי ההגדרות שלך, /model שומר את הערך כברירת המחדל שלך להפעלות חדשות, ו-/effort במחשב שלך שומר את הרמה כברירת המחדל שלך עבור המודל שבו אתה משתמש.

אם תלחץ על s בבוחר המודלים של /model, Claude Code יחליף את המודל מבלי לשמור אותו כברירת המחדל של המשתמש שלך. Claude Code מחיל רמות /effort מסוימות, כגון max ו-ultracode, על ההפעלה הנוכחית בלבד; ראה כוונון רמת המאמץ (Adjust effort level).

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

claude --settings '{"model": "claude-opus-4-8"}'

#מתי עריכות נכנסות לתוקף

Claude Code עוקב אחר קובצי ההגדרות שלך וטוען אותם מחדש כאשר הם משתנים, כך שהוא מחיל את רוב העריכות על ההפעלה הרצה ללא צורך בהפעלה מחדש, כולל עריכות ב-permissions, ב-hooks, ובמסייעי אימות כגון apiKeyHelper. הטעינה מחדש כוללת הגדרות משתמש, פרויקט, הגדרות מקומיות והגדרות מנוהלות, ו-Claude Code מריץ את ה-hook בשם ConfigChange עבור כל שינוי בקובץ הגדרות שהוא מזהה, אך לא עבור הגדרות מנוהלות שמגיעות מ-MDM או מקונסולת claude.ai. הגדרות מנוהלות שמגיעות דרך MDM או מקונסולת claude.ai מגיעות להפעלה רצה לפי לוח זמנים מוגדר ולא בעת שמירה; טבלת ההעברה (delivery table) מפרטת זאת לפי מקור.

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

• model: השתמש ב-/model כדי להחליף מודל באמצע הפעלה. לכל מודל יש מטמון הנחיות (prompt cache) משלו, כך שהבקשה הראשונה לאחר החלפה קוראת מחדש את כל השיחה ללא מטמון; ראה החלפת מודלים (Switching models).
• effortLevel ו-modelSettings: השתמש ב-/effort כדי לשנות את רמת המאמץ באמצע הפעלה.
• outputStyle: מהווה חלק מה-system prompt, ולכן Claude Code מחיל את העריכה לאחר /clear או הפעלה מחדש.

#אימות מה נטען

הרץ /status בתוך Claude Code כדי לראות אילו מקורות הגדרות פעילים. הכרטיסייה Status כוללת שורת Setting sources שמפרטת כל קובץ הגדרות ש-Claude Code טען עבור ההפעלה הנוכחית, כגון User settings או Project local settings. כאשר הגדרות מנוהלות נמצאות בתוקף, רשומת ההגדרות המנוהלות מציגה בסוגריים כיצד הן הגיעו למחשב שלך.

השורה מאשרת אילו קבצים Claude Code קרא; היא אינה מציגה איזה קובץ סיפק כל מפתח. כדי לקבל רשימה של רשומות ש-Claude Code דחה, הרץ claude doctor; עבור מודל שהוגדר על ידי הגדרות פרויקט או הגדרות מנוהלות, כותרת הפתיחה מציינת את שם הקובץ שהגדיר אותו. הפקודות /status ו-/config פותחות את אותה תיבת דו-שיח בכרטיסיות שונות, והכרטיסייה Config אינה מציגה את תוכן ה-settings.json שלך.

#תיקון קובץ הגדרות פגום

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

• Settings Error (שגיאת הגדרות): קובץ משתמש, פרויקט או קובץ מקומי מכיל JSON לא חוקי או ערך שהסכמה דוחה. בתחילת הפעלה אינטראקטיבית Claude Code מציג תיבת דו-שיח שמאפשרת לך לתקן את הקובץ בעזרתו של Claude, לצאת, או להמשיך ללא ההגדרות הפגומות.
• Settings Warning (אזהרת הגדרות): רק רשומות בודדות נכשלות, כגון כלל הרשאה במבנה שגוי או שם אירוע hook לא מוכר. Claude Code מדלג על ערכים אלה ומשאיר את יתר הקובץ בתוקף.
• Managed settings (הגדרות מנוהלות): Claude Code ממשיך לאכוף את יתר הקובץ. המדריך רשומות לא חוקיות בהגדרות מנוהלות מציין מה הוא משמיט ואילו מפתחות חוזרים לערך מחמיר יותר עד שתתקן אותם. עבור מסמך הגדרות מנוהלות שאינו JSON חוקי, ראה את השגיאה Managed settings document could not be parsed.
• Configuration error (שגיאת תצורה): לא ניתן לנתח את ~/.claude.json. Claude Code מעתיק את הקובץ הפגום לנתיב ~/.claude/backups/.claude.json.corrupted.<timestamp> ושואל אם לצאת ולתקן אותו ידנית או לאפס לתצורת ברירת המחדל; ריצה עם דגל -p מדפיסה את השגיאה ויוצאת. כדי לשחזר את המצב הקודם שלך, העתק בחזרה את אחד מחמשת קובצי הגיבוי האחרונים מסוג .claude.json.backup.<timestamp> שנמצאים ב-~/.claude/backups/, ש-Claude Code שומר לפני שהוא כותב לקובץ.

לאחר שתמשיך, הרץ /status כדי לראות את הקבצים המושפעים ו-claude doctor עבור פרטי כל שגיאה.

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

#סדר קדימויות של הגדרות

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

לפי הסדר, מהקדימות הגבוהה ביותר לנמוכה ביותר:

1. הגדרות מנוהלות (Managed settings): הגדרות שהארגון שלך פורס, באמצעות קובץ managed-settings.json, מדיניות MDM, או הגדרות מנוהלות שרת מתוך קונסולת claude.ai. שום דבר שאתה מגדיר אינו דורס אותן: מפתח שאתה מעביר עם --settings אינו דורס את אותו מפתח מנוהל, ודגל כגון --model בוחר רק מבין המודלים שהארגון שלך מאשר. מפתח model מנוהל קובע את המודל שכל הפעלה מתחילה איתו, ועדיין תוכל להחליף מודל באמצעות /model; הנעילה היא availableModels, שמגביל את /model, את --model ואת המפתח model בקבצים שלך. כאשר הארגון שלך מספק יותר ממקור מנוהל אחד, הכללים עבור קדימות בתוך רובד הניהול (precedence within the managed tier) קובעים מה Claude Code קורא מכל מקור.
2. ארגומנטים בשורת הפקודה (Command line arguments): דגלים שאתה מעביר בעת הפעלת claude מהטרמינל, עבור הפעלה אחת; ראה שינוי הגדרה להפעלה בודדת. Claude Code ממזג קוד JSON שאתה מעביר באמצעות --settings <file-or-json> עם קובצי ההגדרות שלך לפי אותם כללים כמו שאר הרמות: הוא מעדיף מפתח שהגדרת כאן על פני אותו מפתח בהגדרות מקומיות, הגדרות פרויקט או הגדרות משתמש, ושומר על הערך מהרמה הנמוכה יותר עבור מפתח שלא ציינת.
3. הגדרות מקומיות לפרויקט (Project local settings) (.claude/settings.local.json): ההגדרות האישיות שלך עבור פרויקט זה.
4. הגדרות פרויקט משותפות (Shared project settings) (.claude/settings.json): הגדרות שהצוות שלך שומר בבקרת גרסאות.
5. הגדרות משתמש (User settings) (~/.claude/settings.json): ההגדרות האישיות שלך עבור כל פרויקט.

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

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

#רשימות מתמזגות במקום להידרס

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

• fallbackModel: זוהי שרשרת סדורה שבה למיקום יש משמעות, ולכן Claude Code לוקח את הערך במלואו מהקובץ בעל הקדימות הגבוהה ביותר שמגדיר אותו.
• modelPicker: מכיל רשימת שורות סדורה אחת בתוספת דגל החלפה (replace flag), ולכן Claude Code לעולם אינו ממזג שורות משני מקורות. הוא לוקח את הערך במלואו מהמקור בעל הקדימות הגבוהה ביותר מבין הגדרות מנוהלות, --settings והגדרות משתמש שמגדיר אותו, ומתעלם מהמפתח בהגדרות פרויקט ובהגדרות מקומיות. דורש את Claude Code בגרסה v2.1.242 ומעלה.
• availableModels: כאשר ההגדרות המנוהלות ש-Claude Code מחיל מגדירות אותו, Claude Code מחיל את הרשימה הזו כמות שהיא ומתעלם מרשומות שתוסיף בהגדרות משתמש, פרויקט או הגדרות מקומיות, אלא אם אפליקציה שמטמיעה את Claude Code מספקת רשימת מודלים משלה; ראה חריגים לקדימות של הגדרות מנוהלות. בין מקורות מנוהלים שונים הרשימה לעולם אינה מתמזגת; המדריך כיצד Claude Code משלב מקורות מנוהלים מציין איזו רשימת מקור חלה. בין טווחי תחולה שאינם מנוהלים, Claude Code ממזג את המערכים כרגיל.
• modelSettings: Claude Code פותר אותו מודל אחד בכל פעם, יחד עם effortLevel. הרשומה של modelSettings מציינת איזה ערך של קובץ חל על מודל.

#דוגמאות לקדימות

בזמן ש-Claude עובד, Claude Code מציג טיפ של שורה אחת מתחת למחוון הסיבוב (spinner), כגון "Use /config to change your default permission mode (including Plan Mode)". נניח שאתה רוצה לכבות את הטיפים הללו, ולכן אתה מגדיר את spinnerTipsEnabled כ-false ב-~/.claude/settings.json. כל תרחיש להלן מתאר מצב שיכול להפעיל אותם בחזרה, ומה באפשרותך לעשות בנידון:

#הגדרות צוות דורסות הגדרות אישיות

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

באפשרותך להחזיר את הערך שלך: הוסף "spinnerTipsEnabled": false ל-.claude/settings.local.json באותו פרויקט. פרויקט מקומי נמצא מעל פרויקט משותף, כך שההפעלות שלך שם יפסיקו להציג טיפים וההפעלות של חברי הצוות שלך לא ישתנו.

#הגדרות ארגון דורסות הכל

ההגדרות המנוהלות של הארגון שלך מגדירות אותו כ-true. שום דבר שתשים בהגדרות משתמש, פרויקט או הגדרות מקומיות לא יכבה את הטיפים, וגם לא --settings. רמת מנוהל (Managed) היא הרמה העליונה ביותר.

אינך יכול להחזיר את הערך שלך. הרץ /status כדי לראות איזה מקור מנוהל חל, ושאל את מנהל המערכת שלך אם יש לשנות את המדיניות.

#שורת הפקודה דורסת את הקבצים שלך להפעלה בודדת

התחלת את ההפעלה עם claude --settings '{"spinnerTipsEnabled": true}'. שורת הפקודה נמצאת מעל כל קובץ למעט הגדרות מנוהלות, ולכן הפעלה זו מציגה טיפים למרות שהקבצים שלך מגדירים false.

הערך שלך יחזור בהפעלה הבאה; הדגל --settings תקף להפעלה אחת בלבד ואינו כותב לשום קובץ.

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

לחלק מהמפתחות יש דגל בשורת הפקודה או משתנה סביבה שדורס את ערך ההגדרה ללא קשר לאיזה קובץ הגדיר אותו: ANTHROPIC_MODEL דורס את הגדרת model, והדגל --model דורס את שניהם עבור הפעלה מסוימת.

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

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

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

#ערך שהגדרת זוכה להתעלמות

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

• רמה גבוהה יותר מגדירה אותו: קובץ הגדרות אחר, דגל --settings או מקור מנוהל מגדיר את המפתח מעל שלך; ערימת הקדימויות מציינת מי מהם. דגל או משתנה סביבה יכולים גם הם לדרוס את המפתח בפני עצמם, בהחלטה מפתח אחר מפתח; הרשומה של המפתח במדריך ההגדרות מציינת באיזה מהם Claude Code משתמש, ורשומת env מכסה ערך env מנוהל לעומת export ב-shell.
• מפתח אבטחה שומר על הערך המחמיר שלו: עבור מספר מפתחות Claude Code מכבד את הערך המגביל מכל קובץ, כך שערך true של פרויקט עבור disableClaudeAiConnectors נשאר מופעל; ראה חריגים לקדימות של הגדרות מנוהלות.
• הקובץ אינו יכול להגדיר ערך זה: הערכים auto ו-bypassPermissions של permissions.defaultMode אינם נכנסים לתוקף מהגדרות פרויקט או מהגדרות מקומיות; הגדר אותם בהגדרות משתמש או בהגדרות מנוהלות במקום זאת, או העבר את הדגל --permission-mode עבור הפעלה בודדת. לפני גרסה v2.1.257, הערך bypassPermissions נכנס לתוקף מכל קובץ.
• הקובץ פגום: JSON לא חוקי או ערך שנדחה גורמים ל-Claude Code לדלג על הקובץ או על הרשומה; ראה תיקון קובץ הגדרות פגום.

#שינוי שביצעת ב-Claude Code אובד בהפעלות חדשות

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

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

#שינוי מנוהל טרם הגיע אליך

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

#מפתח שנמצא ב-commit אינו מגיע לחברי הצוות

שני דברים מונעים ממפתח ב-.claude/settings.json לחול על כל מי שמשכפל את המאגר:

• Claude Code מתעלם מהמפתח בקובץ מאגר: חפש את הערכים User, local, or managed, User or managed, Managed, או Global config בעמודת ה-Scope באינדקס כל ההגדרות (All settings); מפתחות אלה לעולם אינם חלים מקובץ משותף, למעט autoContinueAtUsageLimit, שקובץ מאגר עדיין יכול לכבות: כל עוד הקובץ מגדיר את המפתח ואף ערך משתמש, ערך מ---settings או ערך מנוהל אינו מגדיר אותו, Claude Code קורא את ההגדרה כמכובה. מפתחות מסוג Global config חלים רק מ-~/.claude.json.
• המפתח ממתין לאמון (trust): כללי permissions.allow, permissions.additionalDirectories, extraKnownMarketplaces, ורוב ערכי env חלים רק לאחר שכל חבר צוות מביע אמון בתיקייה (trusts the folder). עד אז הם עדיין יראו בקשות אישור ולא יקבלו תוספים ממרקטפלייס שהקובץ מצהיר עליו. כללי deny ו-ask חלים מיד.

#כללי הרשאות משתלבים באופן שונה ממה שציפית

• בחרת "Yes, and don't ask again" בבקשת הרשאה אך אתה עדיין מקבל בקשות אישור עבור אותו כלי: בחירה זו שמרה כלל allow בקובץ המקומי שלך, וכלל allow שם אינו גובר על כלל ask מקובץ פרויקט או מקובץ מנוהל; המדריך כיצד כללי הרשאות משתלבים מסביר את הסדר. בהרחבת VS Code כרטיס האישור מאפשר לך לבחור את קובץ היעד, כולל הקובץ המשותף של הפרויקט, מה שמשנה את הכלל עבור כולם; ב-CLI, Claude Code כותב אך ורק לקובץ המקומי שלך.
• כללי ה-allow של הארגון שלך עדיין חלים לצד הכללים שלך: הדבר צפוי: Claude Code ממזג את permissions.allow על פני כל טווחי התחולה, אלא אם הארגון שלך מגדיר את allowManagedPermissionRulesOnly.

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

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

אפליקציה שמריצה את Claude Code בתוכה ומגדירה את CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST מהווה גם היא חריג. Claude Code מקבל את תצורת המודל של אותה אפליקציה מעל המפתחות model, fallbackModel, ו-modelOverrides מכל מקור מנוהל, ומעל משתני בחירת המודל בבלוק env מנוהל, כגון ANTHROPIC_MODEL ומשפחת ANTHROPIC_DEFAULT_*_MODEL. Claude Code משאיר בתוקף רשימת מורשים (allowlist) מנוהלת של availableModels, אלא אם האפליקציה מספקת רשימה משלה.

#הגדרות בהפעלות ענן

הפעלת ענן (cloud session), ב-Claude Code on the web או באמצעות claude --cloud, רצה בסביבת ענן על שכפול חדש של המאגר שלך, ולא במחשב שלך. הדבר משנה אילו הגדרות מגיעות אליה:

• הגדרות פרויקט משותפות (.claude/settings.json): נקראות, מכיוון שהקובץ הוא חלק מהשכפול. בצע commit להגדרה שם כדי להחיל אותה בהפעלות ענן.
• הגדרות משתמש והגדרות מקומיות לפרויקט (~/.claude/settings.json ו-.claude/settings.local.json): אינן נקראות. שתיהן נשארות במחשב שלך, והקובץ המקומי אינו קיים בשכפול.
• הגדרות מנוהלות: רק הגדרות מנוהלות שרת (server-managed settings) מגיעות להפעלת ענן; קובץ managed-settings.json או פרופיל MDM במכשיר שלך אינם מגיעים. סביבה באירוח עצמי (self-hosted environment) קוראת גם את קובץ ההגדרות המנוהלות ב-runner image שלה. המדריך כיצד Claude Code משלב מקורות מנוהלים מציין מתי קובץ זה חל.
• /config: באינטרנט, פקודה זו פותחת את מדור Claude Code בהגדרות claude.ai שלך במקום לשנות ערך. כדי לשנות הגדרה עבור הפעלת ענן, הגדר משתנה סביבה בסביבה או בצע commit של המפתח ל-.claude/settings.json של המאגר.

המדריך מה מועבר מההגדרה שלך מפרט את השאר: CLAUDE.md, מיומנויות (skills), שרתי MCP, תוספים, ופרטי הזדהות (credentials).

#השלבים הבאים

• מדריך ההגדרות (Settings reference): כל מפתח, היכן מגדירים אותו ודוגמה.
• דוגמאות לקובצי הגדרות (Example settings files): קובץ אישי, קובץ צוותי, וקובץ מנוהל של ארגון.
• הגדרת הרשאות (Configure permissions): כללי allow, ask ו-deny, ומה ש-Claude Code מריץ בלי לבקש רשות.
• משתני סביבה (Environment variables): המשתנים ש-Claude Code קורא ובלוק env.
• ניפוי שגיאות בתצורה שלך (Debug your configuration): כאשר הגדרה אינה מוחלת.
• מדריך תיקיית Claude (Claude directory reference): כל קובץ ש-Claude Code קורא, כולל סוכני משנה (subagents), שרתי MCP, תוספים, ו-CLAUDE.md.