Alle Einstellungen

​

Einstellungsindex

​

Modell und Antworten

​

advisorModel

• Geltungsbereich: Beliebige Datei
• Typ: String, einer der Aliase "fable", "opus" oder "sonnet", die in die aktuelle Standardversion dieser Modellfamilie von Claude Code aufgelöst werden, oder eine vollständige Modell-ID wie "claude-opus-5-5"
• Standard: nicht gesetzt, daher ist der Advisor ausgeschaltet
• Überschreibungen pro Sitzung: --advisor hat für eine Sitzung Vorrang vor diesem Schlüssel. CLAUDE_CODE_DISABLE_ADVISOR_TOOL schaltet den Advisor aus, und dieser Schlüssel kann ihn nicht wieder einschalten

{
  "advisorModel": "opus"
}

​

alwaysThinkingEnabled

• Geltungsbereich: Beliebige Datei
• Typ: Boolean
  • true: keine Auswirkung; Thinking ist bereits aktiviert
  • false: Claude Code deaktiviert Extended Thinking für jede Sitzung
• Standard: nicht gesetzt, daher ist Thinking für Modelle aktiviert, die es unterstützen
• Überschreibungen pro Sitzung: MAX_THINKING_TOKENS hat für eine Sitzung Vorrang vor diesem Schlüssel: 0 deaktiviert Thinking unter den gleichen Modell- und Provider-Einschränkungen wie false, und ein positiver Wert aktiviert Thinking, auch wenn dieser Schlüssel false ist. Bei Modellen mit adaptivem Reasoning wird die Zahl selbst ignoriert

{
  "alwaysThinkingEnabled": false
}

​

availableModels

• Geltungsbereich: Beliebige Datei. Stellen Sie es in verwalteten Einstellungen bereit, um es für eine Organisation durchzusetzen.
• Typ: Array von Modellaliasen oder IDs
• Standard: nicht gesetzt, daher sind alle Modelle verfügbar

{
  "availableModels": ["sonnet", "haiku"]
}

​

availableModelsMatch

• Geltungsbereich: Verwaltet. Claude Code ignoriert den Schlüssel in Benutzer-, Projekt- und lokalen Einstellungen sowie in --settings mit einer Warnung
• Typ: String, einer von:
  • "prefix": ein Modell-ID-Eintrag erlaubt seine Version und jede Modell-ID, die ihn um ein weiteres Segment erweitert
  • "exact": ein Modell-ID-Eintrag erlaubt nur die genannte Version, sodass "claude-opus-5" Opus 5 erlaubt, aber nicht claude-opus-5-5. Ein Eintrag wie "claude-opus-4-5" erlaubt auch seine datierte Anthropic-Modell-ID claude-opus-4-5-20251101. Ein Familienalias wie "opus" erlaubt weiterhin die gesamte Familie, und Einträge best, opusplan und default werden ignoriert
• Standard: "prefix"

{
  "availableModels": ["claude-opus-5", "claude-sonnet-5"],
  "availableModelsMatch": "exact"
}

​

deniedModels

• Geltungsbereich: Verwaltet. Claude Code ignoriert den Schlüssel in Benutzer-, Projekt- und lokalen Einstellungen sowie in --settings mit einer Warnung
• Typ: Array von Modellaliasen oder IDs
  • Ein Familienalias wie "opus" blockiert jedes Modell dieser Familie
  • Eine Modell-ID wie "claude-opus-5-5" blockiert diese Version in jeder Schreibweise, einschließlich datierter und providerspezifischer IDs
  • Eine Modell-ID ohne Nebenversion, wie "claude-opus-5", blockiert auch spätere Nebenversionen wie Opus 5.5. Schreiben Sie "claude-opus-5-0", um nur Opus 5 zu blockieren
  • Einträge best, opusplan und default werden ignoriert
• Standard: nicht gesetzt, daher ist kein Modell blockiert

{
  "availableModels": ["opus", "sonnet"],
  "deniedModels": ["claude-opus-5-5"]
}

​

effortLevel

• Geltungsbereich: Beliebige Datei
• Typ: String, einer von:
  • "low": das geringste Reasoning, für kurze, klar umrissene, latenzempfindliche Aufgaben, die keine hohe Intelligenz erfordern
  • "medium": reduziert die Token-Nutzung für kostensensitive Arbeiten, die etwas Intelligenz opfern können
  • "high": balanciert Token-Nutzung und Intelligenz
  • "xhigh": tieferes Reasoning bei höherem Token-Verbrauch
• Standard: nicht gesetzt
• Überschreibungen pro Sitzung: --effort hat für eine Sitzung Vorrang vor diesem Schlüssel, und CLAUDE_CODE_EFFORT_LEVEL hat Vorrang vor beiden

{
  "effortLevel": "xhigh"
}

​

enforceAvailableModels

• Geltungsbereich: Beliebige Datei
• Typ: Boolean
  • true: wenn Standard zu einem Modell außerhalb von availableModels aufgelöst würde, löst Claude Code es stattdessen zum ersten verfügbaren Modell in der Liste auf
  • false: dieser Schlüssel ändert nicht, wie Standard aufgelöst wird
• Standard: false

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

​

fallbackModel

• Geltungsbereich: Beliebige Datei
• Typ: Array von Modellaliasen oder IDs; "default" wird zum Standardmodell erweitert
• Standard: nicht gesetzt, daher wird eine fehlgeschlagene Anfrage nicht mit einem anderen Modell erneut versucht
• Überschreibungen pro Sitzung: --fallback-model hat für eine Sitzung Vorrang vor diesem Schlüssel

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

​

fastMode

• Geltungsbereich: Beliebige Datei
• Typ: Boolean
  • true: Claude Code aktiviert den Fast-Modus für Sitzungen, in denen er verfügbar ist
  • false: Der Fast-Modus bleibt ausgeschaltet
• Standard: nicht gesetzt, daher ist der Fast-Modus ausgeschaltet
• Überschreibungen pro Sitzung: CLAUDE_CODE_DISABLE_FAST_MODE schaltet den Fast-Modus für eine Sitzung aus, und dieser Schlüssel kann ihn nicht wieder einschalten

{
  "fastMode": true
}

​

fastModePerSessionOptIn

• Geltungsbereich: Beliebige Datei
• Typ: Boolean
  • true: ein gespeichertes fastMode: true aktiviert den Fast-Modus nicht mehr beim Sitzungsstart, daher führt jede Person /fast in jeder Sitzung aus, in der sie ihn möchte; ein mit --settings übergebenes fastMode: true zählt weiterhin für diese Sitzung, es sei denn, verwaltete Einstellungen setzen diesen Schlüssel
  • false: ein gespeichertes fastMode: true aktiviert den Fast-Modus zu Beginn jeder späteren Sitzung
• Standard: false

{
  "fastModePerSessionOptIn": true
}

​

language

• Geltungsbereich: Beliebige Datei
• Typ: String, jeder Sprachname, wie "japanese", "spanish" oder "french"; Claude Code überprüft ihn nicht
• Standard: nicht gesetzt; Sitzungstitel entsprechen dann der Sprache Ihrer Konversation

{
  "language": "japanese"
}

​

maxEffortLevel

• Geltungsbereich: Beliebige Datei. Stellen Sie ihn in verwalteten Einstellungen bereit, um ihn für eine Organisation durchzusetzen. Wenn mehrere Geltungsbereiche eine Obergrenze setzen, gilt die niedrigste, daher kann eine in einem Geltungsbereich gesetzte Obergrenze nicht von einem anderen angehoben werden
• Typ: String, einer von "low", "medium", "high", "xhigh" oder "max". Ein Wert "max" setzt keine Obergrenze
• Standard: nicht gesetzt, daher gilt keine Obergrenze
• Obergrenzen pro Modell: Fügen Sie maxEffortLevel zum modelSettings-Eintrag eines Modells hinzu. Dieser Eintrag ersetzt diesen Schlüssel für das Modell nur innerhalb der Einstellungsquelle, die beide setzt, wie Ihre Benutzereinstellungen oder eine verwaltete Quelle. Setzen Sie dort "max", um das Modell von der Obergrenze dieser Quelle auszunehmen; Claude Code wendet weiterhin Obergrenzen aus anderen Quellen an

{
  "maxEffortLevel": "medium",
  "modelSettings": {
    "claude-sonnet-4-6": {
      "maxEffortLevel": "max"
    }
  }
}

​

model

• Geltungsbereich: Beliebige Datei
• Typ: String, ein Modellalias oder eine vollständige Modell-ID
• Standard: nicht gesetzt, daher verwendet Claude Code das Standardmodell Ihres Kontos
• Überschreibungen pro Sitzung: --model hat Vorrang vor ANTHROPIC_MODEL, und beide haben für eine Sitzung Vorrang vor diesem Schlüssel, auch vor einem verwalteten model; eine availableModels-Liste gilt weiterhin für die Auswahl

{
  "model": "claude-sonnet-5"
}

​

modelOverrides

• Geltungsbereich: Beliebige Datei
• Typ: Objekt, das Modell-IDs Provider-Modell-IDs zuordnet
• Standard: nicht gesetzt

{
  "modelOverrides": {
    "claude-opus-4-6": "arn:aws:bedrock:us-east-1:123456789012:inference-profile/example"
  }
}

​

modelPicker

• Geltungsbereich: Benutzer oder verwaltet. Claude Code liest den Schlüssel aus verwalteten Einstellungen, --settings und Benutzereinstellungen und ignoriert ihn in Projekt- und lokalen Einstellungen, damit ein Repository, das Sie klonen, die Auswahl nicht umbenennen kann. Die höchste dieser drei Quellen, die den Schlüssel setzt, liefert die gesamte Auswahl, und Claude Code kombiniert nie Auswahllisten aus zwei Quellen.
• Typ: Objekt mit einem Array options von Zeilen und einem optionalen Boolean replaceBuiltInOptions
• Standard: nicht gesetzt, daher zeigt die Auswahl die integrierte Auswahl

{
  "modelPicker": {
    "options": [
      { "model": "us.anthropic.claude-opus-4-8", "label": "Opus (production)" },
      {
        "model": "us.anthropic.claude-sonnet-4-6",
        "label": "Sonnet (production)",
        "description": "Day-to-day work"
      }
    ]
  }
}

​

Felder für modelPicker

• Entfernt: eine Zeile, die Claude Code nicht bedienen kann, wie ein eingestelltes Modell oder ein Modell, auf das Ihre Organisation keinen Zugriff hat
• Ausgegraut: eine Zeile, die Sie noch nicht auswählen können, mit Angabe des Grundes
• Keine Zeile bleibt übrig: Claude Code behält die integrierte Auswahl, wie üblich durch die Allowlist gefiltert

​

modelPricing

• Geltungsbereich: Verwaltet. Stellen Sie den Schlüssel über serverseitig verwaltete Einstellungen, eine MDM-Richtlinie, eine Datei managed-settings.json oder ein Richtlinien-Hilfsprogramm bereit. Claude Code ignoriert ihn in Benutzer-, Projekt- und lokalen Einstellungen, in --settings und unter Windows in der vom Benutzer beschreibbaren HKCU-Registrierung. Mit serverseitig verwalteten Einstellungen meldet jede Sitzung Kosten zum Listenpreis, bis der Einstellungsabruf dieser Sitzung die Einstellung bestätigt hat. Eine Host-Anwendung, die Claude Code einbettet und CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST setzt, kann über die SDK-Option managedSettings eine eigene Tabelle liefern, die Claude Code nur verwendet, wenn keine verwaltete Quelle den Schlüssel setzt, und nur in Claude Code v2.1.246 oder später.
• Typ: Objekt mit einem optionalen multiplier und einer optionalen Zuordnung overrides
• Standard: nicht gesetzt, daher meldet Claude Code den Listenpreis, es sei denn, eine Host-Anwendung liefert eine Tabelle

{
  "modelPricing": {
    "multiplier": 0.85,
    "overrides": {
      "claude-sonnet-4-6": {
        "input": 2.4,
        "output": 12,
        "cacheRead": 0.24,
        "cacheWrite": 3
      }
    }
  }
}

​

Felder für modelPricing

​

Für welche Modelle eine modelPricing-Zeile gilt

• Die ID eines integrierten Modells: ein Schlüssel, den Claude Code selbst für ein integriertes Modell verwendet, sei es die eigene ID des Modells, wie claude-sonnet-4-6, oder seine Bedrock-, Agent Platform- oder Foundry-ID. Claude Code wendet die Zeile auf jede datierte Snapshot-ID und jede providerspezifische ID dieses Modells an.
• Jeder andere Schlüssel: ein Schlüssel, der nicht die ID eines integrierten Modells ist, wie ein Gateway-Modellalias. Claude Code wendet die Zeile nur auf genau diese ID an. Wenn eine Modell-ID genau mit einem Ihrer Schlüssel übereinstimmt und zugleich unter eine Zeile fällt, deren Schlüssel die ID eines integrierten Modells ist, verwendet Claude Code die genaue Übereinstimmung.
• Ein Bedrock-Anwendungsinferenzprofil: Sobald Claude Code das Profil über Ihre Zuordnung modelOverrides oder die Abfrage bedrock:GetInferenceProfile zu dem Modell aufgelöst hat, an das es weiterleitet, wendet Claude Code die Zeile dieses Modells auf das Profil an.

​

modelSettings

• Geltungsbereich: Beliebige Datei
• Typ: Objekt, das einen Modellnamen einem Objekt mit beliebigen dieser Felder zuordnet:
  • effortLevel: einer von "low", "medium", "high" oder "xhigh"
  • maxEffortLevel: die höchste Effort-Stufe, mit der das Modell laufen darf
  • autoCompactWindow: eine Anzahl von Token von 100000 bis 1000000 oder "auto" für das auf das Modell abgestimmte Fenster. /autocompact speichert hier. Für dieses Modell hat der Wert Vorrang vor einem autoCompactWindow der obersten Ebene in derselben Einstellungsdatei. Erfordert Claude Code v2.1.288 oder später
• Standard: nicht gesetzt

{
  "modelSettings": {
    "claude-opus-5-5": {
      "effortLevel": "high"
    }
  }
}

​

outputStyle

• Geltungsbereich: Beliebige Datei
• Typ: String, der Name eines integrierten oder benutzerdefinierten Ausgabestils
• Standard: nicht gesetzt, daher verwendet Claude Code den Standardstil

{
  "outputStyle": "Explanatory"
}

​

promptCacheTtl

• Geltungsbereich: Beliebige Datei
• Typ: String, einer von:
  • "5m": der Cache hält fünf Minuten
  • "1h": der Cache hält eine Stunde
• Standard: nicht gesetzt, daher erhält jede Anfrage der Hauptkonversation ihre Standardlebensdauer
• Überschreibungen pro Sitzung: FORCE_PROMPT_CACHING_5M hat Vorrang vor allem anderen, dann CLAUDE_CODE_PROMPT_CACHE_TTL, dann dieser Schlüssel und zuletzt ENABLE_PROMPT_CACHING_1H

{
  "promptCacheTtl": "1h",
  "subagentPromptCacheTtl": "5m"
}

​

showThinkingSummaries

• Geltungsbereich: Beliebige Datei
• Typ: Boolean
  • true: Sie sehen vollständige Thinking-Zusammenfassungen, wenn Sie Thinking mit Ctrl+O aufklappen
  • false: die Anthropic API schwärzt Thinking-Blöcke und Claude Code zeigt einen zugeklappten Platzhalter
• Standard: false

{
  "showThinkingSummaries": true
}

​

subagentPromptCacheTtl

• Geltungsbereich: Beliebige Datei
• Typ: String, einer von:
  • "5m": der Cache hält fünf Minuten
  • "1h": der Cache hält eine Stunde
• Standard: nicht gesetzt, daher erhält jede dieser Anfragen ihre Standardlebensdauer
• Überschreibungen pro Sitzung: FORCE_PROMPT_CACHING_5M hat Vorrang vor allem anderen, dann CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, dann dieser Schlüssel, dann ENABLE_PROMPT_CACHING_1H, das für jede Anfrage die einstündige Lebensdauer anfordert. Wo der Frontmatter-Wert eines Subagenten selbst in dieser Rangfolge steht, erfahren Sie unter Die TTL selbst wählen

{
  "subagentPromptCacheTtl": "1h"
}

​

switchModelsOnFlag

• Geltungsbereich: Beliebige Datei. Erscheint in /config als Modelle wechseln, wenn eine Nachricht gekennzeichnet ist, mit den Optionen Automatisch wechseln und Jedes Mal fragen.
• Typ: Boolean
  • true: Claude Code wechselt zum Fallback-Modell und fährt fort
  • false: In einer interaktiven Sitzung pausiert Claude Code, damit Sie zwischen Wechseln und Bearbeiten des Prompts wählen können; wo kein Dialog angezeigt werden kann, wie bei einem -p-Lauf, endet die gekennzeichnete Anfrage mit einem Fehler
• Standard: nicht gesetzt. Claude Code wechselt automatisch, kann in einer interaktiven Sitzung aber zuerst nachfragen

{
  "switchModelsOnFlag": false
}

​

ultracode

• Geltungsbereich: Beliebige Datei
• Typ: Boolean
  • true: Sitzungen starten mit aktiviertem Ultracode, wenn dynamische Workflows für Sie aktiviert sind und Ihr Modell xhigh unterstützt
  • false: Sitzungen starten mit deaktiviertem Ultracode
• Standard: nicht gesetzt, daher ist Ultracode deaktiviert
• Überschreibungen pro Sitzung: /effort ultracode aktiviert Ultracode für eine Sitzung ohne diesen Schlüssel, und /effort ultracode off deaktiviert es für eine Sitzung, wenn dieser Schlüssel true ist. Das Flag --effort ultracode aktiviert es ebenfalls für eine Sitzung, mit dem Effort xhigh

{
  "ultracode": true
}

​

Berechtigungseinstellungen

​

allowManagedPermissionRulesOnly

• Das .claude/-Verzeichnis eines Repositorys
• Ihre Verzeichnisse ~/.claude/skills/ und ~/.claude/commands/, einschließlich von claude.ai synchronisierter Skills
• Ein --add-dir-Verzeichnis
• Plugins, die mit einem .claude-plugin-Manifest deklariert sind, innerhalb von ~/.claude/skills/ oder dem .claude/skills/ des Projekts
• Plugins, die nur für eine Sitzung geladen werden und deren IDs auf @inline enden, wenn alle folgenden Bedingungen erfüllt sind:
  • Die Sitzung ist eine Code-Sitzung oder Cowork-Sitzung, jedoch keine Cloud-Sitzung, für die die Claude Desktop-App selbst Claude Code startet
  • Ihre verwalteten Einstellungen setzen den Schlüssel, nicht nur die übergeordneten Einstellungen eines Embedding-Hosts
  • Die Sitzung läuft mit Claude Code v2.1.305 oder später

• Geltungsbereich: Managed
• Typ: Boolean
  • true: verwaltete Einstellungen werden zur einzigen Quelle für Berechtigungsregeln
  • false: Claude Code wendet Berechtigungsregeln aus Benutzer-, Projekt-, lokalen und --settings-Dateien zusätzlich zu den verwalteten an
• Standard: nicht gesetzt, daher wendet Claude Code Berechtigungsregeln aus Benutzer-, Projekt- und lokalen Einstellungen sowie aus --settings zusätzlich zu den verwalteten an

{
  "allowManagedPermissionRulesOnly": true
}

​

autoMode

• Geltungsbereich: User or managed
• Typ: Objekt mit environment-, allow-, soft_deny- und hard_deny-Arrays von Prosa-Regeln sowie dem Boolean classifyAllShell
• Standard: nicht gesetzt, daher verwendet der Klassifikator nur seine integrierten Regeln

{
  "autoMode": {
    "soft_deny": ["$defaults", "Never run terraform apply"]
  }
}

​

autoMode.classifyAllShell

• Geltungsbereich: User or managed. Wird überall dort gelesen, wo autoMode gelesen wird.
• Typ: Boolean
  • true: Während der Auto-Modus aktiv ist, sendet Claude Code jeden Bash- und PowerShell-Befehl durch den Klassifikator und setzt Ihre Shell-Allow-Regeln aus; außerhalb des Auto-Modus gelten die Regeln weiterhin
  • false: Der Auto-Modus setzt nur Allow-Regeln aus, die beliebigen Code ausführen könnten, wie Bash(*) und Bash(python *); ein Befehl, der einer anderen Allow-Regel entspricht, überspringt den Klassifikator, es sei denn, er trägt Pro-Befehl zulässige Domains, und jeder andere Shell-Befehl wird durch ihn geleitet
• Standard: false

{
  "autoMode": {
    "classifyAllShell": true
  }
}

​

disableAutoMode

• Geltungsbereich: Any file. Am nützlichsten in verwalteten Einstellungen, wo Benutzer es nicht überschreiben können. Auch unter permissions als permissions.disableAutoMode akzeptiert.
• Typ: die Zeichenfolge "disable"
• Standard: nicht gesetzt

{
  "disableAutoMode": "disable"
}

​

permissions

• Geltungsbereich: Any file
• Typ: Objekt mit allow, ask, deny, additionalDirectories, blockReadsOutsideWorkingDirectories, defaultMode, disableBypassPermissionsMode und disableAutoMode
• Standard: nicht gesetzt

{
  "permissions": {
    "allow": ["Bash(npm run *)"],
    "ask": ["Bash(git push *)"],
    "deny": ["Read(./.env)"],
    "defaultMode": "acceptEdits"
  }
}

​

useAutoModeDuringPlan

• Geltungsbereich: User, local, or managed. Ein Repository kann es nicht für Sie ausschalten.
• Typ: Boolean
  • true: dasselbe wie nicht gesetzt; wenn der Auto-Modus verfügbar ist, überprüft der Klassifikator jeden Shell-Befehl während der Planung, anstatt bei Ihnen nachzufragen, außer bei Entfernungen kritischer Pfade. Ein false in einer dieser Dateien schaltet es immer noch aus
  • false: Sie erhalten eine Berechtigungsabfrage für jeden Befehl außerhalb des integrierten Satzes nur lesender Befehle
• Standard: true

{
  "useAutoModeDuringPlan": false
}

​

permissions.allow

• Geltungsbereich: Any file
• Typ: Array von Berechtigungsregel-Zeichenfolgen
• Standard: nicht gesetzt
• Sitzungsspezifische Überschreibungen: --allowedTools fügt Allow-Regeln für eine Sitzung hinzu, und eine Deny-Regel aus einer Einstellungsdatei blockiert immer noch ein Tool, das sie benennt

{
  "permissions": {
    "allow": ["Bash(git diff *)", "Read(~/.zshrc)"]
  }
}

​

Berechtigungsregelsyntax

​

permissions.ask

• Geltungsbereich: Any file
• Typ: Array von Berechtigungsregel-Zeichenfolgen
• Standard: nicht gesetzt

{
  "permissions": {
    "ask": ["Bash(git push *)"]
  }
}

​

permissions.deny

• Geltungsbereich: Any file
• Typ: Array von Berechtigungsregel-Zeichenfolgen
• Standard: nicht gesetzt
• Sitzungsspezifische Überschreibungen: --disallowedTools fügt Deny-Regeln für eine Sitzung neben diesem Schlüssel hinzu

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Bash(curl *)"
    ]
  }
}

​

permissions.additionalDirectories

• Geltungsbereich: Any file, mit Einschränkungen beim Sandbox-Schreibzugriff, den Projekt- und lokale Einträge gewähren
• Typ: Array von Verzeichnispfaden
• Standard: nicht gesetzt
• Sitzungsspezifische Überschreibungen: --add-dir und /add-dir fügen Verzeichnisse für eine Sitzung neben diesem Schlüssel hinzu

{
  "permissions": {
    "additionalDirectories": ["../docs/"]
  }
}

​

permissions.blockReadsOutsideWorkingDirectories

• Aktionen, die kein Modus automatisch genehmigt beschreibt, wann ein Shell-Befehl, der einen solchen Pfad liest, bei Ihnen nachfragt
• In einer Sandbox ausgeführte Befehle unter der Blockierung beschreibt, was ein in einer Sandbox ausgeführter Befehl lesen kann

• Geltungsbereich: Any file. Ein true in einer beliebigen Datei gilt, daher kann ein Repository die Blockierung für sich selbst aktivieren, Ihre Blockierung aber nicht aufheben.
• Typ: Boolean
  • true: Die Datei-Tools von Claude verweigern Lesevorgänge außerhalb der Arbeitsverzeichnisse
  • false: dasselbe wie nicht gesetzt; die Blockierung gilt trotzdem, wenn eine andere Datei true setzt
• Standard: nicht gesetzt, daher folgen Lesevorgänge außerhalb der Arbeitsverzeichnisse Ihrem Berechtigungsmodus

{
  "permissions": {
    "blockReadsOutsideWorkingDirectories": true
  }
}

​

In einer Sandbox ausgeführte Befehle unter der Blockierung

• Die Dateisystemisolierung ist über sandbox.filesystem.disabled deaktiviert
• allowManagedReadPathsOnly ist gesetzt
• Der Pfad des Verzeichnisses, in dem Sie Claude Code gestartet haben, enthält ein Glob-Zeichen wie *, ? oder [

• ~/.gitconfig
• Die Dateien config, ignore und attributes unter $XDG_CONFIG_HOME/git, standardmäßig ~/.config/git
• Dateien, die Ihre globale Git-Konfiguration über [include], [includeIf], core.excludesFile oder core.attributesFile angibt

​

permissions.defaultMode

• Geltungsbereich: Any file. auto und bypassPermissions werden nicht aus Projekt- oder lokalen Einstellungen wirksam, daher setzen Sie sie stattdessen in ~/.claude/settings.json. Vor v2.1.257 wurde bypassPermissions aus jeder Datei wirksam. Für Konversationen, die die VS Code-Erweiterung startet, liest Claude Code nur Benutzer-, verwaltete und --settings-Werte.
• Typ: Zeichenfolge, eine von:
  • "default": Claude Code führt nur Lesevorgänge ohne Nachfrage aus
  • "acceptEdits": Claude Code führt auch Dateibearbeitungen und häufige Dateisystem-Befehle wie mkdir und mv ohne Nachfrage aus
  • "plan": Claude Code liest und plant, blockiert aber Bearbeitungen, bis Sie einen Plan genehmigen
  • "auto": Claude Code läuft ohne die üblichen Nachfragen; bevor Aktionen wie Shell-Befehle und Netzwerkanfragen ausgeführt werden, prüft ein Klassifikator im Hintergrund, ob sie mit Ihrer Anfrage übereinstimmen
  • "dontAsk": Claude Code verweigert automatisch jeden Aufruf, bei dem sonst nachgefragt würde, wobei ein von Ihnen installierter Mod einige dieser Aufrufe dennoch genehmigen kann. Dateilesevorgänge innerhalb Ihrer Arbeitsverzeichnisse, andere Aktionen, die keine Genehmigung benötigen, und vorab genehmigte Tools werden weiterhin ausgeführt, mit Ausnahme von Lesevorgängen aus Netzwerkpfaden
  • "bypassPermissions": Claude Code führt alles ohne Nachfrage aus
  • "manual": ein Alias für "default"
• Standard: nicht gesetzt
• Sitzungsspezifische Überschreibungen: --permission-mode und sein Äquivalent --dangerously-skip-permissions für bypassPermissions haben Vorrang vor diesem Schlüssel für eine Sitzung

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

​

permissions.disableBypassPermissionsMode

• Geltungsbereich: Any file. Typischerweise in verwalteten Einstellungen gesetzt, um Organisationsrichtlinien durchzusetzen.
• Typ: die Zeichenfolge "disable"
• Standard: nicht gesetzt
• Sitzungsspezifische Überschreibungen: Dieser Schlüssel hat Vorrang vor --dangerously-skip-permissions, das Claude Code ablehnt, während der Schlüssel gesetzt ist

{
  "permissions": {
    "disableBypassPermissionsMode": "disable"
  }
}

​

skipAutoPermissionPrompt

• Geltungsbereich: User or managed. Ein Repository kann es nicht für Sie setzen.
• Typ: Boolean
  • true: Claude Code überspringt die Mitteilung
  • false: dasselbe wie nicht gesetzt; die Mitteilung wird einmal angezeigt, es sei denn, eine andere dieser Dateien setzt true
• Standard: nicht gesetzt, daher wird die Mitteilung einmal angezeigt

{
  "skipAutoPermissionPrompt": true
}

​

skipDangerousModePermissionPrompt

• Geltungsbereich: User, local, or managed. Ein nicht vertrauenswürdiges Repository kann den Dialog nicht für Sie überspringen.
• Typ: Boolean
  • true: Claude Code überspringt den Bestätigungsdialog, bevor eine Sitzung den bypassPermissions-Modus betritt
  • false: dasselbe wie nicht gesetzt; der Dialog wird angezeigt, es sei denn, eine andere dieser Dateien setzt true
• Standard: nicht gesetzt, daher wird der Dialog angezeigt

{
  "skipDangerousModePermissionPrompt": true
}

​

Sandbox-Einstellungen

​

sandbox

• Bereich: Any file
• Typ: Objekt mit enabled, failIfUnavailable, autoAllowBashIfSandboxed, excludedCommands, allowUnsandboxedCommands, enableWeakerNestedSandbox, enableWeakerNetworkIsolation, allowAppleEvents, allowNestedUserNamespaces, bwrapPath, socatPath, ignoreViolations und ripgrep sowie den Objekten filesystem, network und credentials
• Standard: nicht gesetzt, daher führt Claude Code Befehle ohne Sandbox aus

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker *"],
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

​

sandbox.enabled

• Bereich: Any file, mit Einschränkungen für Projekt- und lokale Einstellungen
• Typ: Boolescher Wert
  • true: Claude Code führt Bash-Befehle in der Sandbox aus
  • false: Bash-Befehle werden ohne Sandbox ausgeführt
• Standard: false

{
  "sandbox": {
    "enabled": true
  }
}

​

sandbox.failIfUnavailable

• Bereich: Any file, mit Einschränkungen für Projekt- und lokale Einstellungen
• Typ: Boolean
  • true: Claude Code beendet sich beim Start mit einem Fehler, wenn sandbox.enabled auf true steht, die Sandbox aber nicht starten kann. Besteht die Sandbox diese Prüfung und schlägt danach die Initialisierung fehl, läuft die Sitzung weiter und Claude Code verweigert jeden Befehl in der Sandbox
  • false: Claude Code führt Befehle ohne Sandbox aus, wenn die Sandbox nicht starten kann
• Standard: false

{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true
  }
}

​

sandbox.autoAllowBashIfSandboxed

• Bereich: Any file
• Typ: Boolescher Wert
  • true: Claude Code führt Bash-Befehle in der Sandbox ohne Berechtigungsabfrage aus, außer in den Fällen, die Auto-allow mode beschreibt; CLAUDE_CODE_SUBPROCESS_ENV_SCRUB deaktiviert die automatische Freigabe
  • false: Befehle in der Sandbox durchlaufen den regulären Berechtigungsfluss, daher entscheiden Ihre allow-Regeln und Ihr Berechtigungsmodus. Die Mode-Registerkarte von /sandbox nennt dies regulären Berechtigungsmodus
• Standard: true

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": false
  }
}

​

sandbox.excludedCommands

• Bereich: Any file, mit Einschränkungen für Projekt- und lokale Einstellungen
• Typ: Array von Befehlsmustern
• Standard: nicht gesetzt, daher wird kein Befehl ausgeschlossen

{
  "sandbox": {
    "excludedCommands": ["docker *"]
  }
}

• Ein Befehl, der mit sudo, eval oder xargs beginnt
• Ein cd, pushd oder popd, egal wo es im Aufruf erscheint
• Eine Befehlsersetzung, eine Subshell oder ein Kontrollfluss-Block wie if oder for
• Eine Umleitung, wie docker build . > build.log, außer einer, die nur einen Dateideskriptor dupliziert, wie 2>&1 es tut
• Ein Befehlsname, der aus einer Variable stammt
• Ein git clone, git init, git worktree add, git worktree move oder git bundle create mit einem Pfadargument, das absolut ist, mit ~ beginnt oder ein ..-Segment enthält

​

sandbox.allowUnsandboxedCommands

• Bereich: Any file, mit einer Einschränkung für Projekt- und lokale Einstellungen
• Typ: Boolescher Wert
  • true: Claude kann einen Befehl mit dem Parameter dangerouslyDisableSandbox außerhalb der Sandbox erneut versuchen, nachdem die Sandbox ihn blockiert hat
  • false: Claude Code ignoriert diesen Parameter, daher werden Befehle, die Claude ausführt, solange die Sandbox läuft, in der Sandbox ausgeführt, es sei denn, sie entsprechen einem excludedCommands-Eintrag
• Standard: true

{
  "sandbox": {
    "enabled": true,
    "allowUnsandboxedCommands": false
  }
}

​

sandbox.filesystem

• Bereich: Any file
• Typ: Objekt mit den Arrays allowWrite, denyWrite, denyRead und allowRead, plus die booleschen Werte allowManagedReadPathsOnly und disabled
• Standard: nicht gesetzt, daher gelten die Standard-Lese- und Schreibgrenzen

{
  "sandbox": {
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    }
  }
}

​

Sandbox-Pfadpräfixe

~/keys/*.pem              the entry
/home/alice/keys/*.pem    its full path
 ^^^^                     the first directory name, home

app/
└── [slug]/
    └── page.tsx

• Eckige Klammern wie [slug]: In jeder Liste unter macOS sowie in denyRead und allowRead unter Linux und WSL2 sind die Klammern in ./app/[slug] zugleich ein Muster. Der Eintrag passt dann auch auf jeden Pfad unter app, der aus einem Zeichen aus slug besteht, etwa app/s oder app/g. Steht dieser Eintrag in allowRead oder unter macOS in allowWrite, können in der Sandbox ausgeführte Befehle auch diese Pfade erreichen. Benennen Sie alle um, die sie nicht erreichen sollen.
• Eckige Klammern wie [user-id] oder [post-id], bei denen das Zeichen links vom Bindestrich nach dem rechten einsortiert wird: ./app/[user-id] deckt nur das Verzeichnis mit genau diesem Namen ab, in jeder Liste auf jeder Plattform. Vor v2.1.304 konnten in der Sandbox ausgeführte Befehle unter Linux und WSL2 nicht starten, solange denyRead oder allowRead einen solchen Eintrag enthielt.
• Geschweifte und runde Klammern: Diese sind gewöhnliche Zeichen, sodass ~/data/{keys,tokens} ein Verzeichnis namens {keys,tokens} abdeckt, nicht zwei Alternativen. Um ~/data/keys und ~/data/tokens abzudecken, fügen Sie jedes als eigenen Eintrag hinzu.

​

sandbox.filesystem.allowWrite

• Bereich: Any file, mit Einschränkungen für Projekt- und lokale Einstellungen
• Typ: Array von Pfadzeichenfolgen, unter Verwendung der Sandbox-Pfadpräfixe
• Standard: nicht gesetzt, daher können Befehle in der Sandbox in das Arbeitsverzeichnis, das benutzerspezifische Temp-Verzeichnis, Verzeichnisse, die Sie mit --add-dir oder /add-dir hinzugefügt haben, und Verzeichnisse in permissions.additionalDirectories schreiben

{
  "sandbox": {
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"]
    }
  }
}

​

sandbox.filesystem.denyWrite

• Bereich: Any file
• Typ: Array von Pfadzeichenfolgen, unter Verwendung der Sandbox-Pfadpräfixe
• Standard: nicht gesetzt

{
  "sandbox": {
    "filesystem": {
      "denyWrite": ["/etc", "/usr/local/bin"]
    }
  }
}

​

sandbox.filesystem.denyRead

• Bereich: Any file
• Typ: Array von Pfadzeichenfolgen, unter Verwendung der Sandbox-Pfadpräfixe
• Standard: nicht gesetzt, daher behalten Befehle in der Sandbox den Standard-Lesezugriff, der Anmeldedateien wie ~/.aws/credentials einschließt

{
  "sandbox": {
    "filesystem": {
      "denyRead": ["~/.aws/credentials"]
    }
  }
}

​

sandbox.filesystem.allowRead

• Bereich: Any file, mit Einschränkungen für Projekt- und lokale Einstellungen
• Typ: Array von Pfadzeichenfolgen, unter Verwendung der Sandbox-Pfadpräfixe
• Standard: nicht gesetzt

{
  "sandbox": {
    "filesystem": {
      "denyRead": ["~/"],
      "allowRead": ["."]
    }
  }
}

​

sandbox.filesystem.allowManagedReadPathsOnly

• Bereich: Managed
• Typ: Boolescher Wert
  • true: Claude Code berücksichtigt nur die allowRead-Einträge aus verwalteten Einstellungen
  • false: allowRead-Einträge aus anderen Einstellungsdateien können einfließen
• Standard: false

{
  "sandbox": {
    "filesystem": {
      "denyRead": ["~/"],
      "allowRead": ["~/work"],
      "allowManagedReadPathsOnly": true
    }
  }
}

​

sandbox.filesystem.disabled

• Bereich: User or managed. Wenn verwaltete Einstellungen sandbox.filesystem überhaupt konfigurieren oder einen sandbox.credentials.files-Eintrag mit "mode": "deny" auflisten, können nur verwaltete Einstellungen ihn setzen.
• Typ: Boolescher Wert
  • true: Claude Code überspringt die Dateisystem-Isolierung und behält die Netzwerk-Isolierung bei
  • false: Die Dateisystem-Isolierung bleibt aktiv
• Standard: false, daher bleibt die Dateisystem-Isolierung aktiv

{
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "disabled": true
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

​

sandbox.ignoreViolations

• Bereich: Any file, mit Einschränkungen für Projekt- und lokale Einstellungen
• Typ: Objekt, das eine Befehlsteilzeichenfolge einem Array von Verletzungsteilzeichenfolgen zuordnet, normalerweise Pfade
• Standard: nicht gesetzt, daher wird jede Verletzung gemeldet

{
  "sandbox": {
    "ignoreViolations": {
      "*": ["/etc/hosts"]
    }
  }
}

​

sandbox.enableWeakerNestedSandbox

• Bereich: Any file, mit Einschränkungen für Projekt- und lokale Einstellungen
• Typ: Boolescher Wert
  • true: Die innere Sandbox bindet das vorhandene /proc des Containers per Bind-Mount ein, anstatt ein frisches zu mounten
  • false: Die Sandbox mountet ein frisches /proc, was in einem unprivilegierten Docker-Container nicht funktioniert
• Standard: false

{
  "sandbox": {
    "enabled": true,
    "enableWeakerNestedSandbox": true
  }
}

​

sandbox.enableWeakerNetworkIsolation

• Bereich: Any file, mit Einschränkungen für Projekt- und lokale Einstellungen
• Typ: Boolescher Wert
  • true: Befehle in der Sandbox auf macOS können com.apple.trustd.agent erreichen
  • false: Befehle in der Sandbox auf macOS können den System-TLS-Vertrauensdienst nicht erreichen
• Standard: false

{
  "sandbox": {
    "enabled": true,
    "enableWeakerNetworkIsolation": true
  }
}

​

sandbox.allowAppleEvents

• Bereich: User or managed
• Typ: Boolescher Wert
  • true: Befehle in der Sandbox auf macOS können Apple Events senden
  • false: Befehle in der Sandbox auf macOS können keine Apple Events senden, daher schlagen open und osascript mit dem Fehler -600 fehl
• Standard: false

{
  "sandbox": {
    "enabled": true,
    "allowAppleEvents": true
  }
}

​

sandbox.allowNestedUserNamespaces

• Geltungsbereich: User or managed. Ein true zählt aus ~/.claude/settings.json, aus mit --settings übergebenem JSON oder aus verwalteten Einstellungen. Claude Code ignoriert ein true in der .claude/settings.json oder .claude/settings.local.json eines Projekts. In einer Sitzung, in der CLAUDE_CODE_SUBPROCESS_ENV_SCRUB auf 1 gesetzt ist, ignoriert Claude Code ein true aus jeder Quelle. Ein false zählt aus jeder Datei, gemäß dem Vorrang der Einstellungen.
• Typ: Boolean
  • true: Befehle in der Sandbox können User-Namespaces erstellen
  • false: Dieser Schlüssel erlaubt nichts zusätzlich, und es gilt der Standard der Sandbox
• Standard: false

{
  "sandbox": {
    "enabled": true,
    "allowNestedUserNamespaces": true
  }
}

​

sandbox.ripgrep

• Bereich: User or managed
• Typ: Objekt mit command, dem Pfad zur ripgrep-Binärdatei, und optional args, einem Array von Argumenten, die vorangestellt werden
• Standard: nicht gesetzt, daher verwendet die Sandbox dieselbe ripgrep-Binärdatei wie Claude Code. Das ist die gebündelte Binärdatei, sofern Sie USE_BUILTIN_RIPGREP nicht auf 0 setzen

{
  "sandbox": {
    "ripgrep": {
      "command": "/usr/local/bin/rg"
    }
  }
}

​

sandbox.bwrapPath

• Bereich: Managed. Claude Code liest es nur aus verwalteten Einstellungen, damit eine Benutzer-, Projekt- oder lokale Datei die Sandbox nicht auf eine andere Binärdatei verweisen kann.
• Typ: Zeichenfolge, ein absoluter Pfad; Claude Code verwirft einen relativen Pfad und greift auf die Suche in PATH zurück
• Standard: nicht gesetzt, daher sucht Claude Code bwrap in PATH

{
  "sandbox": {
    "enabled": true,
    "bwrapPath": "/opt/admin/bwrap"
  }
}

​

sandbox.socatPath

• Bereich: Managed
• Typ: Zeichenfolge, ein absoluter Pfad; Claude Code verwirft einen relativen Pfad und greift auf die Suche in PATH zurück
• Standard: nicht gesetzt, daher sucht Claude Code socat in PATH

{
  "sandbox": {
    "enabled": true,
    "socatPath": "/opt/admin/socat"
  }
}

​

sandbox.credentials

• Bereich: Any file. Claude Code berücksichtigt mask-Einträge, allowPlaintextInject, awsPairs und sigv4 nur aus Benutzereinstellungen, verwalteten Einstellungen und dem --settings-Flag.
• Typ: Objekt mit files, envVars, allowPlaintextInject, awsPairs und sigv4
• Standard: nicht gesetzt, daher werden keine Anmeldedaten geschützt

{
  "sandbox": {
    "credentials": {
      "files": [{ "path": "~/.aws/credentials", "mode": "deny" }],
      "envVars": [{ "name": "GITHUB_TOKEN", "mode": "deny" }]
    }
  }
}

​

Ungültige Anmeldedaten-Einträge in verwalteten Einstellungen

• Ein Eintrag in files oder envVars, der noch einen gültigen path oder name und einen mode von mask oder deny hat, z. B. einer, dessen extract-Muster keine Erfassungsgruppe hat, wird mit einer Warnung auf mode: "deny" herabgestuft, sodass die Anmeldedaten blockiert statt maskiert bleiben, bis Sie den Eintrag korrigieren. Ein herabgestufter files-Eintrag fixiert filesystem.disabled wie ein expliziter deny-Eintrag, und die Warnung weist darauf hin, dass seine Lesesperre nicht erzwungen wird, wenn verwaltete Einstellungen die Dateisystem-Isolierung ausschalten.
• Ein Eintrag mit einem unbekannten mode oder einem ungültigen path oder name wird entfernt.
• In jedem Fall wird gewarnt; ob ein Eintrag herabgestuft oder entfernt wird, die verbleibenden gültigen Einträge werden weiterhin erzwungen.

​

sandbox.credentials.files

• Bereich: Any file. Claude Code verwirft mask-Einträge aus der Projektdatei .claude/settings.json und der lokalen Datei .claude/settings.local.json.
• Typ: Array von Objekten, jedes mit path und einem mode von "deny" oder "mask", plus die optionalen Maskierungsfelder für Dateien
• Standard: nicht gesetzt, daher werden keine Anmeldedateien geschützt

{
  "sandbox": {
    "credentials": {
      "files": [
        { "path": "~/.aws/credentials", "mode": "deny" },
        { "path": "~/.config/gh/hosts.yml", "mode": "mask", "injectHosts": ["api.github.com"] }
      ]
    }
  }
}

​

Maskierungsfelder für Dateien

{
  "sandbox": {
    "credentials": {
      "files": [
        {
          "path": "~/.config/gh/hosts.yml",
          "mode": "mask",
          "extract": "oauth_token:\\s*(\\S+)",
          "maskDuplicates": true,
          "onExtractNoMatch": "deny",
          "injectHosts": ["api.github.com"]
        }
      ]
    }
  }
}

​

sandbox.credentials.envVars

• Bereich: Any file. Claude Code verwirft mask-Einträge aus der Projektdatei .claude/settings.json und der lokalen Datei .claude/settings.local.json.
• Typ: Array von Objekten, jedes mit name und einem mode von "deny" oder "mask", plus die optionalen Maskierungsfelder für Umgebungsvariablen
• Standard: nicht gesetzt, daher werden keine Umgebungsvariablen geschützt

{
  "sandbox": {
    "credentials": {
      "envVars": [
        { "name": "NPM_TOKEN", "mode": "deny" },
        { "name": "GITHUB_TOKEN", "mode": "mask", "injectHosts": ["api.github.com"] }
      ]
    }
  }
}

​

Maskierungsfelder für Umgebungsvariablen

{
  "sandbox": {
    "credentials": {
      "envVars": [
        {
          "name": "DATABASE_URL",
          "mode": "mask",
          "extract": "://[^:]+:([^@]+)@",
          "onExtractNoMatch": "deny"
        },
        {
          "name": "SERVICE_JWT",
          "mode": "mask",
          "decode": "jwt",
          "maskClaims": ["api_key"]
        }
      ]
    }
  }
}

​

sandbox.credentials.allowPlaintextInject

• Bereich: User or managed
• Typ: Boolescher Wert
  • true: Claude Code erlaubt die mask-Ersetzung sowohl bei einfachen HTTP-Anfragen als auch bei TLS-terminiertem HTTPS
  • false: Claude Code erlaubt die mask-Ersetzung nur bei TLS-terminiertem HTTPS
• Standard: false