Alle Einstellungen

Einstellungsindex

Modell und Antworten

advisorModel

• Geltungsbereich: Any file
• Typ: String, einer der Aliase "fable", "opus" oder "sonnet", die auf die aktuelle Standardversion der jeweiligen Modellfamilie in Claude Code aufgelöst werden, oder eine vollständige Modell-ID wie "claude-opus-5-5"
• Standard: nicht gesetzt, der Advisor ist also 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: Any file
• Typ: Boolean
  • true: keine Wirkung; Thinking ist bereits eingeschaltet
  • false: Claude Code schaltet Extended Thinking für jede Sitzung aus
• Standard: nicht gesetzt, Thinking ist also bei Modellen eingeschaltet, die es unterstützen
• Überschreibungen pro Sitzung: MAX_THINKING_TOKENS hat für eine Sitzung Vorrang vor diesem Schlüssel: 0 schaltet Thinking aus, mit denselben Modell- und Anbietergrenzen wie false, und ein positiver Wert schaltet Thinking ein, selbst wenn dieser Schlüssel false ist. Bei Modellen mit adaptivem Reasoning wird die Zahl selbst ignoriert

{
  "alwaysThinkingEnabled": false
}

availableModels

• Geltungsbereich: Any file. Stellen Sie es in verwalteten Einstellungen bereit, um es für eine Organisation durchzusetzen.
• Typ: Array von Modell-Aliasen oder -IDs
• Standard: nicht gesetzt, jedes Modell ist also verfügbar

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

availableModelsMatch

• Geltungsbereich: Managed. Claude Code ignoriert den Schlüssel in Benutzer-, Projekt- und lokalen Einstellungen sowie in --settings und gibt eine Warnung aus
• Typ: String, einer der Werte:
  • "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 die Einträge best, opusplan und default werden ignoriert
• Standard: "prefix"

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

deniedModels

• Geltungsbereich: Managed. Claude Code ignoriert den Schlüssel in Benutzer-, Projekt- und lokalen Einstellungen sowie in --settings und gibt eine Warnung aus
• Typ: Array von Modell-Aliasen 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 anbieterspezifischer IDs
  • Eine Modell-ID ohne Nebenversion, etwa "claude-opus-5", blockiert auch spätere Nebenversionen wie Opus 5.5. Schreiben Sie "claude-opus-5-0", um nur Opus 5 zu blockieren
  • Die Einträge best, opusplan und default werden ignoriert
• Standard: nicht gesetzt, es ist also kein Modell blockiert

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

effortLevel

• Geltungsbereich: Any file
• Typ: String, einer der Werte:
  • "low": das geringste Reasoning, für kurze, klar umrissene, latenzkritische Aufgaben, die keine hohe Intelligenz erfordern
  • "medium": reduziert den Token-Verbrauch für kostensensible Arbeit, bei der etwas Intelligenz geopfert werden kann
  • "high": ausgewogenes Verhältnis von Token-Verbrauch und Intelligenz
  • "xhigh": gründlicheres 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: Any file
• Typ: Boolean
  • true: Wenn Default auf ein Modell außerhalb von availableModels aufgelöst würde, löst Claude Code es auf das erste verfügbare Modell der Liste auf
  • false: Dieser Schlüssel ändert nicht, wie Default aufgelöst wird
• Standard: false

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

fallbackModel

• Geltungsbereich: Any file
• Typ: Array von Modell-Aliasen oder -IDs; "default" wird zum Standardmodell erweitert
• Standard: nicht gesetzt, eine fehlgeschlagene Anfrage wird also 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: Any file
• Typ: Boolean
  • true: Claude Code schaltet den Fast-Modus für Sitzungen ein, in denen er verfügbar ist. Bei Fable 5.2 müssen Sie außerdem /fast ausführen, während Sie Fable 5.2 verwenden
  • false: Der Fast-Modus bleibt ausgeschaltet
• Standard: nicht gesetzt, der Fast-Modus ist also 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: Any file
• Typ: Boolean
  • true: Ein gespeichertes fastMode: true schaltet den Fast-Modus beim Sitzungsstart nicht mehr ein, sodass jede Person /fast in jeder Sitzung ausführt, in der sie ihn nutzen möchte; ein mit --settings übergebenes fastMode: true gilt weiterhin für diese Sitzung, sofern verwaltete Einstellungen diesen Schlüssel nicht setzen
  • false: Ein gespeichertes fastMode: true wirkt so, wie unter fastMode beschrieben
• Standard: false

{
  "fastModePerSessionOptIn": true
}

language

• Geltungsbereich: Any file
• Typ: String, ein beliebiger Sprachname wie "japanese", "spanish" oder "french"; Claude Code validiert ihn nicht
• Standard: nicht gesetzt; Sitzungstitel entsprechen dann der Sprache Ihrer Konversation

{
  "language": "japanese"
}

maxEffortLevel

• Geltungsbereich: Any file. Stellen Sie es in verwalteten Einstellungen bereit, um es für eine Organisation durchzusetzen. Wenn mehrere Geltungsbereiche eine Obergrenze setzen, gilt die niedrigste, sodass eine in einem Geltungsbereich gesetzte Obergrenze nicht von einem anderen angehoben werden kann
• Typ: String, einer der Werte "low", "medium", "high", "xhigh" oder "max". Der Wert "max" setzt keine Obergrenze
• Standard: nicht gesetzt, es gilt also 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 beides setzt, etwa Ihre Benutzereinstellungen oder eine verwaltete Quelle. Setzen Sie dort "max", um das Modell von der Obergrenze dieser Quelle auszunehmen; Claude Code wendet Obergrenzen aus anderen Quellen weiterhin an

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

model

• Geltungsbereich: Any file
• Typ: String, ein Modellalias oder eine vollständige Modell-ID
• Standard: nicht gesetzt, Claude Code verwendet also 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: Any file
• Typ: Objekt, das Modell-IDs Anbieter-Modell-IDs zuordnet
• Standard: nicht gesetzt

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

modelPicker

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

{
  "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, etwa 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 das integrierte Angebot, wie üblich durch die Allowlist gefiltert

modelPricing

• Geltungsbereich: Managed. Stellen Sie den Schlüssel über serververwaltete 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-Registry. Bei serververwalteten Einstellungen weist jede Sitzung Kosten zum Listenpreis aus, 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 bereitstellen, die Claude Code nur verwendet, wenn keine verwaltete Quelle den Schlüssel setzt, und nur in Claude Code v2.1.246 oder höher.
• Typ: Objekt mit einem optionalen multiplier und einer optionalen Zuordnung overrides
• Standard: nicht gesetzt, Claude Code weist also den Listenpreis aus, sofern keine Host-Anwendung eine Tabelle bereitstellt

{
  "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, etwa claude-sonnet-4-6, oder seine Bedrock-, Agent Platform- oder Foundry-ID. Claude Code wendet die Zeile auf jede datierte Snapshot-ID und jede anbieterspezifische ID dieses Modells an.
• Jeder andere Schlüssel: ein Schlüssel, der nicht die ID eines integrierten Modells ist, etwa ein Gateway-Modellalias. Claude Code wendet die Zeile nur auf genau diese ID an. Wenn eine Modell-ID exakt mit einem Ihrer Schlüssel übereinstimmt und gleichzeitig unter eine Zeile fällt, deren Schlüssel die ID eines integrierten Modells ist, verwendet Claude Code die exakte Übereinstimmung.
• Ein Bedrock Application Inference Profile: Sobald Claude Code das Profil auf das Modell aufgelöst hat, an das es weiterleitet, über Ihre modelOverrides-Zuordnung oder die bedrock:GetInferenceProfile-Abfrage, wendet Claude Code die Zeile dieses Modells auf das Profil an.

modelSettings

• Geltungsbereich: Any file
• Typ: Objekt, das einen Modellnamen einem Objekt mit beliebigen dieser Felder zuordnet:
  • effortLevel: einer der Werte "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 übergeordneten autoCompactWindow in derselben Einstellungsdatei. Erfordert Claude Code v2.1.288 oder höher
• Standard: nicht gesetzt

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

outputStyle

• Geltungsbereich: Any file
• Typ: String, der Name eines integrierten oder benutzerdefinierten Ausgabestils
• Standard: nicht gesetzt, Claude Code verwendet also den Standardstil

{
  "outputStyle": "Explanatory"
}

promptCacheTtl

• Geltungsbereich: Any file
• Typ: String, einer der Werte:
  • "5m": Der Cache hält fünf Minuten
  • "1h": Der Cache hält eine Stunde
• Standard: nicht gesetzt, jede Anfrage der Hauptkonversation erhält also 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: Any file
• 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 an
• Standard: false

{
  "showThinkingSummaries": true
}

subagentPromptCacheTtl

• Geltungsbereich: Any file
• Typ: String, einer der Werte:
  • "5m": Der Cache hält fünf Minuten
  • "1h": Der Cache hält eine Stunde
• Standard: nicht gesetzt, jede dieser Anfragen erhält also 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 eigene Frontmatter-Wert eines Subagenten in der Rangfolge steht, erfahren Sie unter TTL selbst wählen

{
  "subagentPromptCacheTtl": "1h"
}

switchModelsOnFlag

• Geltungsbereich: Any file. Erscheint in /config als Switch models when a message is flagged mit den Optionen Switch automatically und Ask each time.
• 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, etwa bei einem -p-Lauf, endet die gekennzeichnete Anfrage mit einem Fehler
• Standard: nicht gesetzt. Claude Code wechselt automatisch, kann aber in einer interaktiven Sitzung zuerst nachfragen

{
  "switchModelsOnFlag": false
}

ultracode

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Sitzungen starten mit eingeschaltetem ultracode, wenn dynamische Workflows für Sie aktiviert sind und Ihr Modell xhigh unterstützt
  • false: Sitzungen starten mit ausgeschaltetem ultracode
• Standard: nicht gesetzt, ultracode ist also ausgeschaltet
• Überschreibungen pro Sitzung: /effort ultracode schaltet ultracode für eine Sitzung ohne diesen Schlüssel ein, und /effort ultracode off schaltet es für eine Sitzung aus, wenn dieser Schlüssel true ist. Das Flag --effort ultracode schaltet es ebenfalls für eine Sitzung ein, 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, blockWritesOutsideWorkingDirectories, defaultMode, denyInsteadOfPrompting, 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.
  • Ein false in einer dieser Dateien oder in --settings schaltet es aus, es sei denn, Sie lassen diese Benutzer- oder lokale Datei mit einer Option wie --setting-sources weg. Das Ignorieren einer weggelassenen Datei erfordert Claude Code v2.1.314 oder später
• Typ: Boolean
  • true: dasselbe wie nicht gesetzt; wenn der Auto-Modus verfügbar ist, überprüft der Klassifikator Shell-Befehle während der Planung
  • 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.blockWritesOutsideWorkingDirectories

• Geltungsbereich: Any file. Ein true in einer beliebigen Datei, die die Sitzung lädt, gilt, daher kann ein Repository die Blockierung für sich selbst aktivieren, Ihre Blockierung aber nicht aufheben. In einer Cloud-Sitzung wendet Claude Code den Schlüssel möglicherweise nicht an, da die Datei-Tools in einem Container laufen, der selbst die Grenze bildet.
• Typ: Boolean
  • true: aktiviert die Blockierung
  • false: dasselbe wie nicht gesetzt; die Blockierung gilt trotzdem, wenn eine andere Datei true setzt
• Standard: nicht gesetzt, daher folgen Schreibvorgänge außerhalb der Arbeitsverzeichnisse Ihrem Berechtigungsmodus. Die Blockierung ist außerdem aktiv, solange Claude Code das permissions-Objekt in Ihren verwalteten Einstellungen nicht lesen kann.

{
  "permissions": {
    "blockWritesOutsideWorkingDirectories": true
  }
}

Was die Schreibblockierung verweigert und was beschreibbar bleibt

• Einstellungsdateien von Claude Code: Claude Code verweigert diese Schreibvorgänge auch innerhalb der Arbeitsverzeichnisse, da eine Einstellungsdatei die Blockierung aufheben kann. Bearbeiten Sie Einstellungsdateien selbst.
• Ein Verzeichnis, das nur Repository-Einstellungen hinzufügen: eines, das additionalDirectories nur in .claude/settings.json auflistet, oder in .claude/settings.local.json, sofern Git diese Datei nicht als nicht verfolgt meldet
• Den Worktree eines Subagenten: Dateibearbeitungen eines Subagenten mit isolation: worktree werden verweigert, wenn sein Worktree außerhalb der Arbeitsverzeichnisse liegt
• Auto-Memory in einem vom Repository gewählten Verzeichnis: ein Verzeichnis, das autoMemoryDirectory in Repository-Einstellungen angibt

Ein Verzeichnis durch die Lese- oder Schreibblockierung lassen

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.denyInsteadOfPrompting

• Geltungsbereich: User or managed sowie --settings. Ein Repository kann es nicht für Sie setzen.
• Typ: Boolean
  • true: Claude Code verweigert Aufrufe, bei denen sonst nachgefragt würde
  • false: dasselbe wie nicht gesetzt; Aufrufe werden trotzdem verweigert, wenn eine andere dieser Quellen true setzt
• Standard: nicht gesetzt, daher fragt ein Aufruf, der eine Genehmigung benötigt, bei Ihnen nach

{
  "permissions": {
    "defaultMode": "auto",
    "denyInsteadOfPrompting": true
  }
}

Was denyInsteadOfPrompting außerdem unterbindet

• Frage- und Plan-Tools: Claude Code lässt AskUserQuestion, EnterPlanMode und ExitPlanMode weg, sodass eine Sitzung im Plan-Modus diesen nicht von sich aus verlassen kann. Ein Teammitglied in einem Agent-Team behält EnterPlanMode und ExitPlanMode
• MCP-Elicitation: Claude Code bricht eine Elicitation-Anfrage ab, es sei denn, ein Elicitation-Hook beantwortet sie
• Berechtigungs-Hosts: Claude Code fragt weder Ihren canUseTool-Callback noch --permission-prompt-tool. Um Aufrufe per Code zu genehmigen, antworten Sie über einen PermissionRequest-Hook. Einige Aufrufe werden verweigert, bevor ein Hook gefragt wird, etwa eine Entfernung kritischer Pfade im auto-Modus, die keine Ask-Regel abdeckt.
• Abrechnungshinweis des Klassifikators: Wo der Hinweis zu abgerechneten Klassifikator-Anfragen einen Dialog öffnen würde, zeigt Claude Code ihn nicht an und verweigert die Aktionen, die diese Anfragen benötigen

Meldungen von denyInsteadOfPrompting

Permission for this tool use was denied. It requires approval, and this session has no approval surface

no approval surface in this session; permission request denied automatically

20 actions were refused and no work went ahead in between, so Claude stopped.

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 sowie mit --settings übergebene Dateien. Hintergrundsitzungen berücksichtigen nur Benutzer- und verwaltete Einstellungen. 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, etwa docker build . > build.log oder ein <<EOF-Heredoc, sofern sie nicht nur einen Dateideskriptor dupliziert, wie es 2>&1 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

Wo Platzhalter in Sandbox-Pfaden funktionieren

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

Verzeichnisnamen mit eckigen, geschweiften oder runden Klammern

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"]
        }
      ]
    }
  }
}