Alle Einstellungen

Vollständige Referenz für jeden Claude Code settings.json-Schlüssel: wo jeder hingehört, sein Typ und Standard, sowie ein einsatzbereites Beispiel, mit einem Index aller Schlüssel.

Zurück zum Index

Diese Referenzseite listet jeden Schlüssel auf, den Claude Code aus einer Einstellungsdatei liest, sowie die kurze Gruppe von Schlüsseln, die es stattdessen in ~/.claude.json speichert. Um eine Datei auszuwählen oder die Priorität zu überprüfen, beginnen Sie mit Einstellungsdateien und Priorität.

Einstellungsindex

Jeder Schlüssel unten verlinkt zu seinem Eintrag. Der Geltungsbereich listet die Dateien auf, in denen er verwendet werden kann: User ist ~/.claude/settings.json, Project ist .claude/settings.json, Local ist .claude/settings.local.json, und Managed ist das, was Ihre Organisation bereitstellt. Any file bedeutet alle vier, und Global config bedeutet ~/.claude.json.

Modell und Antworten

Wählen Sie, welche Modelle Claude Code verwendet und wie es antwortet. Informationen darüber, wie diese Einstellungen mit dem Befehl /model und Umgebungsvariablen interagieren, finden Sie unter Modellkonfiguration.

advisorModel

Wählen Sie, welches Modell antwortet, wenn Claude das serverseitige Advisor-Tool aufruft. Entfernen Sie den Wert, um den Advisor auszuschalten. Der Advisor muss mindestens so leistungsfähig sein wie Ihr Hauptmodell. Informationen zu akzeptierten Kombinationen und was passiert, wenn Sie eine nicht akzeptierte Kombination wählen, finden Sie unter Wählen Sie ein Advisor-Modell.

Sie bearbeiten diesen Schlüssel normalerweise nicht manuell. Führen Sie /advisor aus, um eine Auswahl zu öffnen, die die aktuelle Auswahl, die Modelle, die beraten können, und Kein Advisor anzeigt. Claude Code speichert Ihre Auswahl in diesem Schlüssel in ~/.claude/settings.json. Wenn Sie aus einem Remote Control-Client oder in einer Sitzung auswählen, die an einen Remote Worker angehängt ist, gilt die Auswahl nur für diese Sitzung und ändert diesen Schlüssel nicht.

Wenn Ihr Konto die Zustimmung zu Nutzungsguthaben erfordert, akzeptieren Sie diese zuerst, indem Sie /model fable ausführen. Bis dahin speichert die Auswahl von Fable in /advisor nichts und Claude Code teilt Ihnen mit, dass Sie zuerst /model fable ausführen sollen.

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

Der Schlüssel hat keine Auswirkung auf Provider, bei denen der Advisor nicht verfügbar ist, wie Amazon Bedrock und Claude Platform auf AWS. "fable" erfordert Fable-Zugriff.

alwaysThinkingEnabled

Deaktivieren Sie Extended Thinking für jede Sitzung, indem Sie dies auf false setzen. Thinking ist standardmäßig aktiviert, daher ändert true nichts. Die meisten Benutzer stellen dies über /config ein, anstatt die Datei zu bearbeiten.

Bei Modellen, die immer nachdenken, wie Opus 5.5, Sonnet 5.5, Haiku 5.5 und die Fable-Modelle, hat false keine Auswirkung. Bei Drittanbieter-Providern lässt Claude Code den Parameter thinking weg, anstatt Thinking auszuschalten, daher können Modelle mit adaptivem Reasoning möglicherweise trotzdem nachdenken. Wenn Thinking auf der Anthropic API ausgeschaltet ist, sendet Claude Code den Effort high statt einer höheren Stufe an Modelle, von denen es weiß, dass sie diese Kombination nicht akzeptieren, wie Opus 5.

• 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

Beschränken Sie, welche Modelle Personen für die Hauptsitzung, Subagenten, Skills und den Advisor auswählen können. Eine verwaltete Liste beschränkt /model, --model und den Schlüssel model in den eigenen Dateien eines Entwicklers; ein Modell außerhalb davon kann nicht ausgewählt werden. Mit dem standardmäßigen Präfixabgleich berührt dies die Option Standard allein nicht; kombinieren Sie es dafür mit enforceAvailableModels.

• 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

Dieses Beispiel ermöglicht es Personen, nur Sonnet- und Haiku-Modelle auszuwählen:

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

Ein Modell-ID-Eintrag wie "claude-opus-5" erlaubt auch spätere Versionen, die ihn erweitern, wie Opus 5.5. Um eine dieser Versionen zu blockieren, verwenden Sie deniedModels. Damit jeder Modell-ID-Eintrag nur die genannte Version erlaubt, verwenden Sie availableModelsMatch. Siehe Modellauswahl einschränken.

availableModelsMatch

Legen Sie fest, wie Einträge in availableModels mit Modell-IDs abgeglichen werden. Standardmäßig erlaubt ein Modell-ID-Eintrag auch spätere Versionen, die ihn erweitern, sodass "claude-opus-5" Opus 5.5 erlaubt. Mit "exact" erlaubt jeder Modell-ID-Eintrag nur die genannte Version, sodass eine neuere Version dieses Modells blockiert bleibt, bis Sie sie auflisten. Erfordert Claude Code v2.1.283 oder später.

• 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, einschließlich der datierten IDs dieser Version, sodass "claude-opus-5" Opus 5 erlaubt, aber nicht claude-opus-5-5. Ein Familienalias wie "opus" erlaubt weiterhin die gesamte Familie, und Einträge best, opusplan und default werden ignoriert
• Standard: "prefix"

Dieses Beispiel erlaubt Opus 5 und Sonnet 5, aber keine spätere Version eines der beiden:

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

Mit "exact" ist auch die Option Standard auf die aufgelisteten Modelle beschränkt, sobald die Liste mindestens ein Modell oder eine Familie nennt. Siehe Bestimmte Modelle oder Versionen blockieren.

deniedModels

Blockieren Sie bestimmte Modelle, mit oder ohne availableModels-Allowlist und selbst dann, wenn diese Liste sie erlaubt. Claude Code blendet ein blockiertes Modell in der Auswahl /model aus, und das Modell kann nirgends ausgewählt werden, wo availableModels durchgesetzt wird. Eine Sitzung mit der Option Standard führt ein blockiertes Modell ebenfalls nicht aus, wie unter Bestimmte Modelle oder Versionen blockieren beschrieben. Erfordert Claude Code v2.1.283 oder später.

• 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

Dieses Beispiel erlaubt Opus- und Sonnet-Modelle und blockiert Opus 5.5:

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

Siehe Bestimmte Modelle oder Versionen blockieren.

effortLevel

Legen Sie eine Standard-Effort-Stufe für Modelle fest, für die Sie noch keine Stufe gespeichert haben. Niedrigere Stufen sind bei einfachen Aufgaben schneller und günstiger, höhere Stufen denken bei komplexen Problemen gründlicher nach.

Wenn Sie /effort low, medium, high oder xhigh in einer interaktiven Sitzung auf Ihrem Computer ausführen, speichert Claude Code die Stufe für das aktive Modell unter modelSettings, anstatt diesen Schlüssel zu schreiben. Vor v2.1.251 schrieb /effort diesen Schlüssel.

Innerhalb derselben Einstellungsdatei verwendet Claude Code die gespeicherte Stufe eines Modells anstelle dieses Schlüssels. modelSettings beschreibt die dateiübergreifende Rangfolge.

In einer Sitzung, die an einen Remote Worker angehängt ist, in einem -p-Lauf und im Agent SDK gilt /effort nur für diese Sitzung. Effort-Stufe anpassen listet die interaktiven Auswahlmöglichkeiten auf, die ebenfalls nur für diese Sitzung gelten. Die Meldung, die /effort ausgibt, sagt, was passiert ist.

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

In Ihrer Benutzereinstellungsdatei ~/.claude/settings.json ist dieser Schlüssel die ältere Form, die /effort schrieb, bevor Stufen pro Modell gespeichert wurden, und er gilt weiterhin dort, wo er zuvor galt: für Opus 5, Fable 5.1 und frühere Modelle. Opus 5.5 und später veröffentlichte Modelle ignorieren ihn und beginnen mit ihrem eigenen Standard, bis Sie eine Stufe für sie speichern, die /effort unter modelSettings schreibt. In Projekt-, lokalen und verwalteten Einstellungen sowie mit --settings gilt dieser Schlüssel für jedes Modell.

enforceAvailableModels

Die Auswahl /model hat eine Option Standard, und unter Einstellung des Modells default ist beschrieben, zu welchem Modell sie aufgelöst wird. Eine availableModels-Allowlist beschränkt die Modelle, die Sie benennen können, aber mit dem standardmäßigen Präfixabgleich ordnet sie den Standard Ihres Kontotyps nicht neu zu, sodass Standard immer noch zu einem Modell außerhalb der Liste aufgelöst werden kann. Dieser Schlüssel schließt diese Lücke. Erfordert Claude Code v2.1.175 oder später.

Wenn Ihre Organisation verwaltete Einstellungen bereitstellt, liest Claude Code diesen Schlüssel nur aus der verwalteten Quelle und ignoriert ihn in Ihren anderen Dateien.

Wie dieser Schlüssel bei den Modellprüfungen beim Start angewendet wird, erfahren Sie unter Amazon Bedrock und Google Cloud's Agent Platform.

• 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

Dieses Beispiel beschränkt benannte Auswahlmöglichkeiten auf Sonnet- und Haiku-Modelle und lässt Standard zum ersten verfügbaren dieser Modelle auflösen:

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

Dieser Schlüssel hat keine Auswirkung, wenn availableModels nicht gesetzt oder leer ist. Siehe Allowlist für das Standardmodell durchsetzen. Erfordert Claude Code v2.1.175 oder später.

fallbackModel

Benennen Sie Backup-Modelle, die Claude Code der Reihe nach versuchen soll, wenn Ihr primäres Modell überlastet oder nicht verfügbar ist. Claude Code wechselt für den Rest des Turns zum nächsten verfügbaren Modell in der Kette und zeigt einen Hinweis an. Ohne eine Kette versucht Claude Code dasselbe Modell erneut und zeigt dann den Fehler des Servers an, und Sie versuchen es selbst erneut oder wechseln das Modell.

Ein Wechsel bedeutet einen Turn mit einem kalten Prompt-Cache auf dem Fallback-Modell; Ihre nächste Nachricht versucht zuerst wieder das primäre Modell.

• 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

Dieses Beispiel versucht zuerst Sonnet 5, dann Haiku 4.5, wenn Ihr primäres Modell fehlschlägt:

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

Im Gegensatz zu den meisten Array-Einstellungen wird dieser Schlüssel nicht über Einstellungsdateien hinweg zusammengeführt: Die Datei mit dem höchsten Vorrang, die ihn definiert, liefert die ganze Kette. Wenn Ihre Projektdatei ["claude-sonnet-5"] setzt und Ihre Benutzerdatei ["claude-haiku-4-5"] setzt, ist die Kette nur ["claude-sonnet-5"]. Claude Code behält höchstens drei unterschiedliche zulässige Modelle aus der Liste und ignoriert den Rest. Siehe Fallback-Modellketten.

fastMode

Aktivieren Sie den Fast-Modus für Sitzungen, in denen er verfügbar ist, für interaktive Arbeiten wie schnelle Iteration oder Live-Debugging, bei denen Sie Geschwindigkeit zu höheren Kosten pro Token wünschen. Sie bearbeiten diesen Schlüssel normalerweise nicht manuell: Das Ausführen von /fast schreibt fastMode: true in ~/.claude/settings.json, und das erneute Ausführen zum Ausschalten des Fast-Modus entfernt den Schlüssel. Der Fast-Modus läuft nur auf Opus 5.5, Opus 5 und Opus 4.8: Wenn Sie ihn von einem anderen Modell aus aktivieren, wechseln Sie zu Opus, und der Wechsel zu einem nicht unterstützten Modell schaltet ihn aus. Siehe Modelle wechseln, während der Fast-Modus aktiv ist.

• 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

Normalerweise speichert das Ausführen von /fast fastMode in den Benutzereinstellungen einer Person, sodass der Fast-Modus zu Beginn jeder späteren Sitzung aktiviert ist. Setzen Sie diesen Schlüssel auf true, um das zu verhindern: Ein gespeichertes fastMode: true aktiviert den Fast-Modus nicht mehr beim Sitzungsstart, und jede Person muss /fast in jeder Sitzung ausführen, in der sie ihn möchte. Claude Code lässt den Schlüssel fastMode in ihrer Datei, daher stellt das Ausschalten dieses Schlüssels das alte Verhalten wieder her.

Owner in Team- oder Enterprise-Plänen können ihn organisationsweit über serverseitig verwaltete Einstellungen bereitstellen. Wenn verwaltete Einstellungen den Schlüssel setzen, wird /fast on außerhalb interaktiver Terminal-Sitzungen abgelehnt und meldet, dass Ihre Organisation den Fast-Modus deaktiviert hat. Das umfasst den nicht interaktiven Modus, die VS Code-Erweiterung und Cloud-Sitzungen.

• 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
}

Siehe Opt-in pro Sitzung erforderlich.

language

Lassen Sie Claude standardmäßig in einer anderen Sprache als Englisch antworten. Es gibt keine feste Liste für Antworten: Claude Code übergibt den Wert wörtlich an Claude als Anweisung, immer in dieser Sprache zu antworten, daher funktioniert jeder Sprachname, den Claude lesen kann. Claude Code überprüft den Wert nicht, daher erreicht ein falsch geschriebener Name Claude so, wie er geschrieben ist, anstatt einen Fehler zu erzeugen. Derselbe Wert legt die Sprache für das Sprachdiktat fest, das eine feste Liste von unterstützten Diktiersprachen hat, sowie für automatisch generierte Sitzungstitel.

• 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

Begrenzen Sie die Effort-Stufe, die eine Sitzung verwenden kann, wobei niedrigere Stufen verfügbar bleiben. Jede höhere Stufe läuft stattdessen mit der Obergrenze, einschließlich einer Stufe aus /effort, der Auswahl /model, --effort, CLAUDE_CODE_EFFORT_LEVEL, dem Frontmatter-Feld effort eines Skills oder Subagenten oder dem eigenen Standard des Modells. Claude Code wendet die Obergrenze vor jeder Anfrage selbst an, daher gilt sie bei jedem Provider, einschließlich Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry. Erfordert Claude Code v2.1.267 oder später.

• 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

Dieses Beispiel begrenzt jedes Modell auf medium und nimmt Sonnet 4.6 aus:

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

Wenn Ihre Organisation zusätzlich ein Effort-Limit für ein Modell setzt, gilt die niedrigere der beiden Obergrenzen.

model

Legen Sie das Modell fest, das jede neue Sitzung verwendet, damit Sie nicht jedes Mal mit /model eines auswählen müssen. Das Festlegen hier hindert Sie nicht daran, während der Sitzung zu wechseln. Wenn Ihr Admin ein Organisations-Standardmodell gesetzt hat, um die Benutzerauswahl zu überschreiben, erhalten Sie dieses Modell, auch wenn Sie diesen Schlüssel in Benutzer-, Projekt- oder lokalen Einstellungen setzen.

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

Ein Wert hier hat Vorrang vor ANTHROPIC_DEFAULT_MODEL, das Claude Code nur verwendet, wenn nichts anderes ein Modell auswählt.

modelOverrides

Ordnen Sie Anthropic-Modell-IDs providerspezifischen Modell-IDs zu, wie ARNs von Amazon Bedrock-Inferenzprofilen. Jeder Eintrag der Modellauswahl verwendet dann seinen zugeordneten Wert beim Aufruf der Provider-API. Administratoren verwenden dies auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, um jede Modellversion für Governance, Kostenzuordnung oder regionales Routing an ein bestimmtes Inferenzprofil, einen Versionsnamen oder eine Bereitstellung zu leiten.

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

Dieses Beispiel leitet jeden Aufruf für Opus 4.6 an das benannte Bedrock-Inferenzprofil:

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

Siehe Modell-IDs pro Version überschreiben.

modelPicker

Listen Sie die Modelle auf, die die Auswahl /model anbietet, in der Reihenfolge, in der Sie sie schreiben, und unter Bezeichnungen, die Sie wählen, sodass die Auswahl die Modelle aufführt, die Ihre Organisation verwendet, nach der integrierten Auswahl oder an ihrer Stelle. Das model jeder Zeile wird wörtlich übernommen, daher akzeptiert es alles, was --model akzeptiert: einen Alias wie opus, eine Anthropic-Modell-ID oder eine ID im Provider-Format für Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder ein LLM-Gateway. Erfordert Claude Code v2.1.242 oder später.

• 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

Dieses Beispiel fügt nach der integrierten Auswahl zwei Bedrock-Bereitstellungen unter Namen hinzu, die Ihr Team kennt:

{
  "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

Der Schlüssel hat zwei Felder: eines für die Zeilen selbst und eines dafür, ob sie die integrierte Auswahl ersetzen oder ergänzen.

Ein Eintrag in options kann neben seinem model auch einen optionalen String behavesAs enthalten, was v2.1.257 oder später erfordert. Setzen Sie ihn auf die ID eines Modells, das Ihre Claude Code-Version bereits kennt, wie claude-opus-4-8, bei einem Eintrag, dessen model neuer als Ihre Version ist. Claude Code wendet dann die Fähigkeiten und Effort-Standards dieses bekannten Modells auf den Eintrag an, anstatt sein Modell als unbekannt zu behandeln. Die Bezeichnung des Eintrags und die Modell-ID, die Claude Code in Anfragen sendet, ändern sich nicht.

Wenn replaceBuiltInOptions aktiviert ist, blendet Claude Code alle anderen Zeilen aus: die integrierte Auswahl, die Zeilen, die es für availableModels-Einträge hinzufügt, die Modelle, die die Gateway-Erkennung gefunden hat, und ANTHROPIC_CUSTOM_MODEL_OPTION. Wenn es deaktiviert ist, überspringt Claude Code ein aufgelistetes Modell, das die integrierte Auswahl bereits abdeckt. Eine Bezeichnung ändert, was die Auswahl anzeigt, nicht welches Modell Claude Code ausführt.

Eine availableModels-Allowlist gilt weiterhin für diese Zeilen. Bevor Sie ein aufgelistetes Modell zur Allowlist hinzufügen, lesen Sie Zusammenführungsverhalten: Eine spezifische Modell-ID schränkt den Wildcard-Eintrag ihrer Familie ein. Claude Code prüft außerdem jede Zeile gegen die Sitzung, bevor es die Auswahl anzeigt:

• 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

Claude Code entfernt eine Zeile, die es nicht parsen kann, und behält den Rest. Siehe Fehlerhafte Einstellungsdatei beheben.

modelPricing

Melden Sie Ausgaben zu den Preisen, die Ihre Organisation zahlt, anstatt zum Listenpreis. Setzen Sie den Schlüssel, wenn Ihre Organisation vertraglich vereinbarte Preise hat, damit die Dollarbeträge, die Entwickler sehen, Ihrer Rechnung entsprechen. Claude Code wendet die Preise in /usage, der Statuszeile, dem total_cost_usd des Agent SDK, dem Limit --max-budget-usd sowie der Kostenmetrik und den Ereignissen von OpenTelemetry an. Sie liefern die Preise: Claude Code liest sie nicht aus Ihrem Vertrag oder der Claude Console. Erfordert Claude Code v2.1.242 oder später.

• 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

Setzen Sie nur multiplier für einen pauschalen Rabatt oder Aufschlag, nur overrides für Preise pro Modell oder beides.

Dieses Beispiel setzt vertraglich vereinbarte Preise für Sonnet 4.6 und reduziert dann jeden Betrag, einschließlich der Sonnet-Zeile, um 15 %:

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

Setzen Sie multiplier auf einen Wert über 1, bis maximal 10, um jeden Betrag mit einem Aufschlag zu versehen. Ein Aufschlag erfordert Claude Code v2.1.271 oder später. Frühere Versionen ignorieren einen multiplier über 1 mit einer Warnung und behalten den Rest der Einstellung.

Die Schritte, einschließlich der Bestätigung, dass die Preise wirksam sind, finden Sie unter Ausgaben zu Ihren vertraglich vereinbarten Preisen melden.

Felder für modelPricing

Claude Code verwendet die Preise einer Zeile genau so, wie Sie sie geschrieben haben, ohne den Fast-Modus-Aufschlag oder den Preis für reine US-Inferenz hinzuzufügen. Wenn Sie auch multiplier setzen, wendet Claude Code ihn zusätzlich auf die Preise der Zeile an. Claude Code entfernt eine Zeile mit einem Preis, den es nicht parsen kann, oder einen multiplier, den es nicht parsen kann, und behält den Rest; siehe Fehlerhafte Einstellungsdatei beheben.

Für welche Modelle eine modelPricing-Zeile gilt

Claude Code bestimmt anhand des Schlüssels der Zeile, für welche Modelle eine 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

Speichern Sie eine Effort-Stufe für jedes Modell, das Sie verwenden. Erfordert Claude Code v2.1.251 oder später.

Wenn Sie in einer interaktiven Sitzung auf Ihrem Computer low, medium, high oder xhigh mit /effort oder dem Effort-Schieberegler der Auswahl /model als Ihren Standard speichern, schreibt Claude Code diese Stufe hier unter dem Modell, das Sie verwenden, daher bearbeiten Sie diesen Schlüssel selten selbst. Wenn Sie eine dieser Stufen in der Modellauswahl der VS Code-Erweiterung auswählen, speichert Claude Code sie auf dieselbe Weise hier. Der Eintrag effortLevel listet die Sitzungen auf, in denen /effort nur für diese Sitzung gilt.

Bearbeiten Sie den Schlüssel manuell, um eine gespeicherte Stufe zu ändern oder zu entfernen.

Ein effortLevel eines Modells hier hat Vorrang vor dem effortLevel der obersten Ebene (effortLevel) in derselben Einstellungsdatei. Dateiübergreifend löst Claude Code jedes Modell separat auf: Die Einstellungsdatei mit dem höchsten Vorrang, die entweder ein effortLevel für dieses Modell oder ein effortLevel der obersten Ebene setzt, das für dieses Modell gilt, entscheidet, daher hat ein effortLevel in verwalteten Einstellungen Vorrang vor einer Stufe, die Sie in Benutzereinstellungen gespeichert haben. Effort-Stufe anpassen listet auf, was eine gespeicherte Stufe sonst noch überschreiben kann, wie --effort beim Start.

Um den Effort eines Modells zu begrenzen, anstatt seine Stufe festzulegen, fügen Sie dem Eintrag dieses Modells ein Feld maxEffortLevel hinzu. Das Feld erfordert Claude Code v2.1.267 oder später.

• 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

Claude Code schreibt jeden Eintrag unter dem kanonischen Namen des Modells, wie claude-opus-5-5, und ordnet den Alias, die IDs mit Datumssuffix, [1m] und erkannte providerspezifische IDs dieses Modells demselben Eintrag zu.

Dieses Beispiel hält Opus 5.5 auf high, während andere Modelle ihre eigenen gespeicherten oder Standardstufen verwenden:

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

Führen Sie /effort auto aus, um Ihre gespeicherte Stufe für das Modell zu löschen, das Sie verwenden. Claude Code lässt die anderen Einträge und jedes effortLevel der obersten Ebene bestehen.

outputStyle

Wählen Sie einen Ausgabestil nach Namen aus. Ein Ausgabestil ist ein gespeicherter Satz von Anweisungen, der Claudes Rolle, Ton und Ausgabeformat ändert, wie die integrierten Stile Explanatory und Learning oder ein Stil, den Sie selbst geschrieben haben.

Wenn Sie diesen Schlüssel während einer Sitzung ändern, verwendet Claude den neuen Stil ab Ihrer nächsten Nachricht. Was diese Nachricht beim Prompt-Caching kostet, erfahren Sie unter Ausgabestil ändern. Vor v2.1.251 wurde die Änderung erst wirksam, nachdem Sie /clear ausgeführt oder eine neue Sitzung gestartet hatten.

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

Dieses Beispiel wählt den integrierten Stil Explanatory, der zwischen Aufgaben erklärende Einblicke hinzufügt:

{
  "outputStyle": "Explanatory"
}

promptCacheTtl

Legen Sie fest, wie lange der Prompt-Cache die Hauptkonversation vorhält. Dieser Schlüssel gilt für Ihre interaktiven, -p- und Agent SDK-Turns sowie für die Hilfsanfragen, die Claude Code direkt mit ihnen ausführt. Die einstündige Lebensdauer hält den Cache über längere Pausen warm, und die API berechnet jeden Cache-Schreibvorgang zu einem höheren Preis als bei der fünfminütigen Lebensdauer. Erfordert Claude Code v2.1.242 oder später.

• 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

Dieses Beispiel hält die Hauptkonversation auf der einstündigen Lebensdauer und lässt Subagenten bei fünf Minuten:

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

Was jede Lebensdauer kostet, erfahren Sie unter Cache-Lebensdauer.

showThinkingSummaries

Zeigen Sie Zusammenfassungen von Claudes Extended Thinking in interaktiven Sitzungen an. Setzen Sie den Schlüssel, wenn Sie die vollständigen Zusammenfassungen sehen möchten, wenn Sie Thinking mit Ctrl+O aufklappen. Wenn er nicht gesetzt oder false ist, schwärzt die Anthropic API Thinking-Blöcke und Claude Code zeigt einen zugeklappten Platzhalter; Drittanbieter-Provider schwärzen nicht.

• 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
}

Die Schwärzung ändert nur, was Sie sehen, nicht was das Modell generiert. Um die Thinking-Kosten zu senken, verringern Sie stattdessen das Budget oder deaktivieren Sie Thinking.

subagentPromptCacheTtl

Legen Sie fest, wie lange der Prompt-Cache die Anfragen vorhält, die Claude Code außerhalb der Hauptkonversation stellt. Dieser Schlüssel gilt für Subagenten, Workflows und die eigenen Hintergrund- und Hilfsanfragen von Claude Code, wie Komprimierung und Sitzungstitel. Die einstündige Lebensdauer hält den Cache über längere Pausen warm, und die API berechnet jeden Cache-Schreibvorgang zu einem höheren Preis als bei der fünfminütigen Lebensdauer. Erfordert Claude Code v2.1.242 oder später.

• 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

Dieses Beispiel gibt Subagenten und den anderen Anfragen außerhalb der Hauptkonversation die einstündige Lebensdauer:

{
  "subagentPromptCacheTtl": "1h"
}

Dieser Schlüssel deckt die Anfragen ab, die promptCacheTtl nicht abdeckt, daher setzen Sie beide, um für jede Anfrage von Claude Code eine Lebensdauer festzulegen. Wie sich der Cache eines Subagenten von dem der Hauptkonversation unterscheidet, erfahren Sie unter Subagenten und der Cache.

switchModelsOnFlag

Legen Sie fest, was passiert, wenn ein Sicherheits-Klassifikator eine Anfrage kennzeichnet: zum Fallback-Modell wechseln und fortfahren oder pausieren, damit Sie zwischen Wechseln und Bearbeiten des Prompts wählen können.

• 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
}

Siehe Vor dem Wechsel fragen.

ultracode

Starten Sie Sitzungen mit aktiviertem Ultracode. Wenn es aktiviert ist, plant Claude für jede substanzielle Aufgabe einen Workflow, anstatt darauf zu warten, dass Sie darum bitten. Claude plant Workflows nur, wenn dynamische Workflows für Sie aktiviert sind und Ihr Modell den Effort xhigh unterstützt. Der Schlüssel ändert die Effort-Stufe der Sitzung nicht: Ultracode läuft mit der Stufe, die die Sitzung verwendet. Claude Code liest diesen Schlüssel, schreibt ihn aber nie: /effort ultracode aktiviert Ultracode nur für die aktuelle Sitzung.

• 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
}

Die Effort-Stufe der Sitzung ergibt sich aus effortLevel, modelSettings und den anderen Effort-Quellen, und eine Effort-Obergrenze wie maxEffortLevel senkt diese Stufe, ohne Ultracode auszuschalten. Dies und die Form /effort ultracode off erfordern Claude Code v2.1.284 oder später. Vor v2.1.284 ließ ultracode: true die Sitzung mit dem Effort xhigh laufen, und eine Effort-Obergrenze unter xhigh hielt Ultracode ausgeschaltet. Eine Agent SDK-Steuerungsanfrage apply_flag_settings akzeptiert den Schlüssel ebenfalls.

Berechtigungseinstellungen

Entscheiden Sie, was Claude ohne Nachfrage tun kann, in welchem Berechtigungsmodus eine Sitzung startet, und was der Klassifikator des Auto-Modus zulässt. Informationen zur Regelsyntax und zum Berechtigungsmodell finden Sie unter Berechtigungen konfigurieren.

allowManagedPermissionRulesOnly

Machen Sie verwaltete Einstellungen zur einzigen Quelle für Berechtigungsregeln. Claude Code ignoriert dann allow-, ask- und deny-Regeln in Benutzer-, Projekt-, lokalen und --settings-Dateien, ignoriert --allowedTools, blendet die Optionen zum Immer-Zulassen in Berechtigungsabfragen aus und speichert keine neuen Regeln.

Wenn übergeordnete Einstellungen von einem Embedding-Host gelten, behandelt Claude Code diese als Teil der verwalteten Ebene. Es verwirft deren allow-Regeln und additionalDirectories und behält deren deny- und ask-Regeln bei, außer Read- und Edit-Regeln, deren Muster mit ! beginnt. Ein Host kann Pfade aus den verwalteten Regeln nicht mit einer !-Regel ausschneiden, unabhängig davon, ob Sie diesen Schlüssel setzen oder nicht.

--disallowedTools-Regeln und die deny- und ask-Regeln der aktuellen Sitzung gelten weiterhin, auch nachdem Claude Code die Einstellungen während der Sitzung neu lädt. Sie beschränken nur, daher können sie nicht erweitern, was die verwalteten Regeln gewähren. Vor v2.1.257 verwarf Claude Code diese Befehlszeilen- und Sitzungsregeln beim ersten Neuladen der Einstellungen.

Informationen dazu, was ein !-Muster in einer --disallowedTools- oder Sitzungsregel ausschneiden kann, finden Sie unter Read- und Edit-Regeln.

Wenn Sie diesen Schlüssel setzen, ignoriert Claude Code v2.1.282 oder später außerdem das allowed-tools-Frontmatter in Skills und .claude/commands/-Dateien aus diesen Quellen:

• 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

Skills aus verwalteten Einstellungen und mitgelieferte Skills behalten ihr allowed-tools. Das disallowed-tools eines Skills gilt weiterhin. Was ein Entwickler sieht, wenn Claude Code das Feld ignoriert, erfahren Sie unter Wenn nur verwaltete Berechtigungsregeln gelten.

• 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
}

Dieser Schlüssel sperrt nicht die MCP-Server-Allowlist; verwenden Sie dazu allowManagedMcpServersOnly. Siehe Nur verwaltete Einstellungen.

autoMode

Fügen Sie Ihre eigenen Regeln zu dem hinzu, was der Auto-Modus-Klassifikator blockiert und zulässt. Verwenden Sie es, um dem Klassifikator mitzuteilen, welchen Repos, Buckets und Domains Ihre Organisation vertraut, damit er alltägliche interne Vorgänge nicht mehr blockiert. Der Klassifikator wird mit integrierten Allow- und Deny-Regeln ausgeliefert. Fügen Sie die Literalzeichenfolge "$defaults" in einem Array ein, um diese integrierten Regeln an dieser Position zu behalten und Ihre Regeln um sie herum hinzuzufügen; lassen Sie sie weg, um sie durch Ihre zu ersetzen.

• 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

Dieses Beispiel behält die integrierten soft_deny-Regeln durch "$defaults" und fügt eine weitere hinzu, die terraform apply blockiert:

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

Wenn mehr als eine dieser Dateien dasselbe Array setzt, verkettet Claude Code die Einträge. Informationen zum Regelformat und zur Anwendung der einzelnen Arrays finden Sie unter Auto-Modus konfigurieren.

autoMode.classifyAllShell

Senden Sie jeden Bash- und PowerShell-Befehl durch den Auto-Modus-Klassifikator, während der Auto-Modus aktiv ist. Standardmäßig setzt der Auto-Modus nur Allow-Regeln aus, die beliebigen Code ausführen könnten: Tool-weite und Wildcard-Regeln wie Bash(*) sowie Interpreter- oder Shell-Wrapper-Präfixe wie Bash(python *). Ein Befehl, der einer anderen Allow-Regel entspricht, wie Bash(npm test), überspringt den Klassifikator, es sei denn, er trägt Pro-Befehl zulässige Domains. Wenn er überspringt, kann ein destruktives Argument, das das Präfix der Regel nicht erwartet hat, ungesehen durchkommen. Das Setzen dieses Schlüssels setzt jede Shell-Allow-Regel für die Sitzung aus, damit der Klassifikator jeden Befehl sieht. Erfordert Claude Code v2.1.193 oder später.

• 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
  }
}

Siehe Alle Shell-Befehle durch den Klassifikator leiten.

disableAutoMode

Entfernen Sie den Auto-Modus aus dem Shift+Tab-Zyklus. Jede Sitzung, die sonst im Auto-Modus starten würde, ob von --permission-mode auto, einer Einstellungsdatei oder dem integrierten Standard, startet stattdessen im default-Modus. Administratoren setzen es in verwalteten Einstellungen, um zu verhindern, dass Entwickler in ihrer Organisation den Auto-Modus verwenden.

• 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

Steuern Sie, welche Tools Claude ohne Nachfrage verwenden kann, bei welchen immer nachgefragt wird und welche blockiert sind, und legen Sie den Berechtigungsmodus fest, in dem eine Sitzung startet. Jeder permissions.*-Schlüssel unten verschachtelt sich unter diesem Objekt.

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

Dieses Beispiel genehmigt npm run-Befehle ohne Nachfrage, fragt vor git push nach, blockiert Lesevorgänge von .env und startet Sitzungen im acceptEdits-Modus:

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

Die drei Regel-Arrays teilen sich eine Syntax; siehe Berechtigungsregelsyntax unter permissions.allow. Informationen dazu, wie Berechtigungsregeln aus verschiedenen Dateien kombiniert werden, finden Sie unter Wie Berechtigungsregeln über Geltungsbereiche hinweg zusammengeführt werden; Informationen dazu, wie Einstellungsschlüssel im Allgemeinen kombiniert werden, finden Sie unter Einstellungspriorität im Einstellungshandbuch.

useAutoModeDuringPlan

Wählen Sie, ob Claude Code den Auto-Modus-Klassifikator verwendet, um Shell-Befehle im Plan-Modus zu überprüfen. Mit dem Standard true überprüft der Klassifikator jeden Befehl während der Planung, wenn der Auto-Modus verfügbar ist, und Sie sehen keine Abfrage, außer bei Entfernungen kritischer Pfade. Setzen Sie false, um für jeden Befehl außerhalb des integrierten Satzes nur lesender Befehle eine Berechtigungsabfrage zu erhalten. Wird in /config als Auto-Modus während Plan verwenden angezeigt.

• 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

Listen Sie die Tool-Verwendungen auf, die Claude Code ohne Nachfrage genehmigt. In einer MCP-Regel kann * nur im Tool-Namen nach dem mcp__<server>__-Präfix erscheinen, wie mcp__github__get_*; es kann nicht im Server-Namen erscheinen.

• 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

Dieses Beispiel genehmigt git diff und lässt Claude Code Ihre .zshrc ohne Nachfrage lesen:

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

Claude Code wendet allow-Regeln aus der .claude/settings.json eines Projekts nur an, nachdem Sie den Workspace-Trust-Dialog für diesen Ordner akzeptiert haben.

Berechtigungsregelsyntax

Berechtigungsregeln folgen dem Format Tool oder Tool(specifier). Claude Code wertet deny-Regeln zuerst aus, dann ask, dann allow, und die erste Übereinstimmung entscheidet, unabhängig davon, wie spezifisch jede Regel ist; siehe die Berechtigungsregel-Evaluierungsreihenfolge.

Jede Zeile zeigt eine Regelform und worauf sie zutrifft.

Für die vollständige Regelsyntax, einschließlich Wildcard-Verhalten, Tool-spezifischer Muster für Read, Edit, WebFetch, MCP und Agent-Regeln sowie der Sicherheitsbeschränkungen von Bash-Mustern, siehe Berechtigungsregelsyntax.

permissions.ask

Listen Sie die Tool-Verwendungen auf, bei denen Sie um Bestätigung gebeten werden, auch in einem Berechtigungsmodus, der sie sonst genehmigen würde, wie acceptEdits oder bypassPermissions. Im dontAsk-Modus verweigert Claude Code eine entsprechende Tool-Verwendung, anstatt nachzufragen.

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

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

permissions.deny

Listen Sie die Tool-Verwendungen auf, die Claude Code blockiert. Verwenden Sie es für Dateien, die API-Schlüssel, Geheimnisse oder Umgebungswerte enthalten: Claude Code schließt entsprechende Dateien aus der Dateiermittlung und Suchergebnissen aus, verweigert Lesevorgänge dafür und blockiert die Edit- und Write-Tools auf den entsprechenden Pfaden.

Read- und Edit-Deny-Regeln gelten für die integrierten Datei-Tools von Claude, für Dateibefehle, die Claude Code in Bash erkennt, wie cat, head, tail, sed und tee, und für die Ziele von Bash-Umleitungen wie > file und < file; sie gelten nicht für einen Befehl, der Dateien liest, ohne sie zu benennen, wie grep -r pattern ., oder für beliebige Unterprozesse, daher aktivieren Sie die Sandbox für eine Durchsetzung auf Betriebssystemebene.

• 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

Dieses Beispiel verweigert Lesevorgänge von .env-Dateien, dem secrets-Verzeichnis und einer Datei mit Anmeldedaten und blockiert curl-Befehle:

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

Tool-Namen akzeptieren Glob-Muster, daher verweigert "*" jedes Tool und "mcp__*" verweigert jedes MCP-Tool. Claude Code ignoriert eine Deny-Regel für das EndConversation-Tool, solange noch ein anderes Tool für Claude verfügbar ist. Eine Bash-Deny-Regel gleicht den Befehl so ab, wie Claude ihn schreibt, daher stoppt Bash(curl *) nicht /usr/bin/curl oder sh -c 'curl …'; siehe worauf eine Bash-Regel nicht zutrifft. Dieser Schlüssel ersetzt die veraltete ignorePatterns-Konfiguration.

permissions.additionalDirectories

Geben Sie Claude Dateizugriff auf Verzeichnisse außerhalb desjenigen, in dem Sie gestartet haben, als zusätzliche Arbeitsverzeichnisse. Die meisten .claude/-Konfigurationen werden aus diesen Verzeichnissen nicht ermittelt.

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

Wie allow-Regeln werden Einträge in der .claude/settings.json eines Projekts nur wirksam, nachdem Sie den Workspace-Trust-Dialog für diesen Ordner akzeptiert haben.

permissions.blockReadsOutsideWorkingDirectories

Lassen Sie die Datei-Tools von Claude Lesevorgänge außerhalb Ihrer Arbeitsverzeichnisse in jedem Berechtigungsmodus verweigern, einschließlich bypassPermissions. Claude Code verweigert Read-, Grep-, Glob- und LSP-Aufrufe für diese Pfade und weist Claude an, Sie zu bitten, das Verzeichnis mit /add-dir hinzuzufügen. Dateien, die Claude Code selbst benötigt, bleiben lesbar, etwa Ihre Skills, Plugins, Regeln, Agenten, Befehle und die Memory-Datei CLAUDE.md unter ~/.claude/. Erfordert Claude Code v2.1.257 oder später.

Shell-Befehle verweigert Claude Code nicht auf dieselbe Weise:

• 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

Ein Bash-Befehl, den der Shell-Parser nicht nachverfolgen kann, etwa einer, der das Verzeichnis mehr als einmal wechselt oder eine Subshell ausführt, fragt auch im Auto-Modus und im bypassPermissions-Modus bei Ihnen nach. Die Abfrage erscheint auch dann, wenn der Befehl keinen Pfad außerhalb der Arbeitsverzeichnisse benennt. Diese Abfrage entfällt, wenn der Befehl in der Sandbox ausgeführt wird und die Sandbox die Blockierung durchsetzt.

Claude Code schreibt hier außerdem true, wenn Sie in der Abfrage des Auto-Modus vor dem ersten Lesevorgang außerhalb der Arbeitsverzeichnisse festlegen, solche Lesevorgänge zu blockieren.

• 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
  }
}

Verzeichnisse, die Sie mit --add-dir, /add-dir oder additionalDirectories in Ihren Benutzer- oder verwalteten Einstellungen hinzufügen, zählen für die Blockierung als Arbeitsverzeichnisse. Verzeichnisse, die nur in Repository-Einstellungen hinzugefügt werden, zählen nicht: solche in .claude/settings.json und solche in .claude/settings.local.json, sofern Git diese Datei nicht als nicht verfolgt meldet. In einem Verzeichnis, das kein Git-Repository ist, oder wenn Git die Datei verfolgt, behandelt Claude Code .claude/settings.local.json als Repository-Einstellungen; legen Sie Verzeichnisse, die lesbar bleiben sollen, daher stattdessen in Ihren Benutzereinstellungen fest.

Wenn autoMemoryDirectory aus der .claude/settings.json des Projekts kommt oder aus einer .claude/settings.local.json, die als vom Repository bereitgestellt behandelt wird, lädt Claude Code kein Auto-Memory aus diesem Verzeichnis und speichert keines darin.

Um die Blockierung aufzuheben, entfernen Sie den Schlüssel aus jeder Einstellungsdatei, die ihn setzt, und starten Sie dann eine neue Sitzung.

In einer Sandbox ausgeführte Befehle unter der Blockierung

Wenn Sandboxing aktiviert ist, umfasst die Blockierung auch in einer Sandbox ausgeführte Befehle. Claude Code verweigert ihnen den Lesezugriff auf Ihr Home-Verzeichnis und auf die anderen Stammverzeichnisse, die Benutzerdateien enthalten: /Users, /home, /root, /Volumes, /mnt, /media, /run/media und /srv. Anschließend gibt es die Arbeitsverzeichnisse, die Worktrees, die Claude Code in der Sitzung erstellt, das temporäre Verzeichnis der Sitzung und die Teile von ~/.claude, die Befehle benötigen, etwa Skills und Plugins, wieder frei. Solange die Blockierung gilt, zählen allowRead- und allowWrite-Einträge aus Repository-Einstellungen nicht.

Wenn das Arbeitsverzeichnis der Sitzung ein verknüpfter Git-Worktree ist, einschließlich eines, den Claude Code während der Sitzung betreten hat, bleibt das gemeinsame .git-Verzeichnis des Repositorys für in einer Sandbox ausgeführte Befehle lesbar und beschreibbar, sodass Git dort weiterhin funktioniert.

In diesen Fällen erreicht die Blockierung in einer Sandbox ausgeführte Befehle nicht, während die Datei-Tools von Claude sie weiterhin durchsetzen:

• 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 [

Unter der Blockierung gibt Claude Code Ihre globalen Git-Konfigurationsdateien für in einer Sandbox ausgeführte Befehle wieder frei, damit git Ihre Identität und Einstellungen beibehält:

• ~/.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

Claude Code beurteilt jede Datei einzeln. Wenn eine Datei an einem Ort liegt, an dem ein in einer Sandbox ausgeführter Befehl schreiben kann, direkt oder über einen Symlink, gibt Claude Code die darin angegebenen Dateien nicht wieder frei.

Unter Linux und WSL2 kann eine Konfigurationsdatei, die ein Symlink ist, unter ihrem eigenen Pfad unlesbar bleiben; git läuft dann ohne sie. ~/.git-credentials und $XDG_CONFIG_HOME/git/credentials bleiben blockiert.

Wenn eine wieder freigegebene Datei ein Geheimnis enthält, etwa ein http.extraHeader-Token, fügen Sie ihren Pfad zu sandbox.filesystem.denyRead hinzu. Ein denyRead-Eintrag, der eine Datei abdeckt, hat immer Vorrang vor dieser Freigabe.

permissions.defaultMode

Legen Sie den Berechtigungsmodus fest, in dem neue Sitzungen starten. Wenn Sie ihn nicht gesetzt lassen, starten Sitzungen im integrierten Standard für Ihre Oberfläche.

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

Berechtigungsregeln überlagern jeden Modus: deny-Regeln blockieren in jedem Modus, einschließlich bypassPermissions. Siehe Berechtigungsmodi. In Cloud-Sitzungen berücksichtigt Claude Code nur acceptEdits, plan, default und auto aus diesem Schlüssel. Für Konversationen, die die VS Code-Erweiterung startet, siehe welche Einstellung die Erweiterung für den Start-Berechtigungsmodus liest.

permissions.disableBypassPermissionsMode

Verhindern Sie, dass jemand den bypassPermissions-Modus betritt. Claude Code lehnt dann das --dangerously-skip-permissions-Flag ab und ignoriert die Angabe permissionMode: bypassPermissions in einer Agent-Definition, daher wird der Subagent mit dem Berechtigungsmodus der übergeordneten Sitzung ausgeführt.

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

Vor v2.1.223 wendete Claude Code den Frontmatter-Berechtigungsmodus auch mit deaktiviertem Bypass an.

skipAutoPermissionPrompt

Überspringen Sie die einmalige Mitteilung, die den Auto-Modus beschreibt und die Claude Code anzeigt, wenn Sie selbst zum ersten Mal den Auto-Modus betreten, beispielsweise durch Ihre eigenen Einstellungen oder den Modus-Selektor, anstatt wenn der integrierte Standard eine Sitzung darin startet. Claude Code zeigt diese Mitteilung einmal an und zeichnet dann auf, dass sie angezeigt wurde, daher ist dieser Schlüssel nur relevant, wenn die Mitteilung noch nicht angezeigt wurde.

• 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

Überspringen Sie den Bestätigungsdialog, den Claude Code anzeigt, bevor eine Sitzung den bypassPermissions-Modus betritt, ob von --dangerously-skip-permissions oder von defaultMode: "bypassPermissions". Claude Code schreibt hier true in Ihre Benutzereinstellungen, wenn Sie diesen Dialog einmal akzeptieren.

• 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

Isolieren Sie die Befehle, die Claude ausführt, von Ihrem Dateisystem, Ihrem Netzwerk und Ihren Anmeldedaten. Informationen zur Funktionsweise von Sandboxing und zu Plattformanforderungen finden Sie unter Sandboxing.

sandbox

Isolieren Sie die Bash-Befehle, die Claude ausführt, mit Sandboxing von Ihrem Dateisystem und Netzwerk. Aktivieren Sie die Sandbox mit enabled, und grenzen Sie dann mit den Unterobjekten filesystem, network und credentials ein oder erweitern Sie, worauf in der Sandbox ausgeführte Befehle zugreifen können. Die Sandbox läuft auf macOS, Linux und WSL2.

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

Dies aktiviert die Sandbox, überspringt Berechtigungsabfragen für Befehle in der Sandbox, führt docker außerhalb der Sandbox aus, öffnet zwei zusätzliche Schreibpfade, verbirgt Ihre AWS-Anmeldedatei und erlaubt GitHub und npm vorab:

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

Wenn verwaltete Einstellungen einen booleschen Schlüssel wie enabled oder failIfUnavailable setzen, überschreibt dieser Wert alles, was ein Entwickler setzt. Claude Code führt Array-Schlüssel über die Einstellungsbereiche zusammen, die die Sitzung lädt, sodass ein Entwickler Einträge anhängen kann; siehe Keep developers from widening the policy für die Sperren, die nur in verwalteten Einstellungen gelten. Um Sandboxing für eine Organisation zu erzwingen, siehe Enforce sandboxing with managed settings.

sandbox.enabled

Aktivieren Sie Sandboxing für Bash-Befehle. Wenn Sie einen Modus im /sandbox-Panel auswählen, schreibt Claude Code diesen Schlüssel in .claude/settings.local.json für das aktuelle Projekt; setzen Sie ihn in ~/.claude/settings.json, um jedes Projekt in einer Sandbox auszuführen.

• 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
  }
}

Auf Linux und WSL2 benötigt die Sandbox bubblewrap und socat; siehe Set up Linux and WSL2. Wenn die Sandbox nicht starten kann, führt Claude Code Befehle ohne Sandbox aus, es sei denn, Sie setzen auch failIfUnavailable.

sandbox.failIfUnavailable

Lassen Sie Claude Code beim Start mit einem Fehler beenden, wenn sandbox.enabled true ist, die Sandbox aber nicht starten kann, weil eine Abhängigkeit fehlt oder die Plattform nicht unterstützt wird. Ohne diesen Schlüssel führt Claude Code Befehle ohne Sandbox aus. Verwaltete Bereitstellungen, die Sandboxing als Sicherheitsschranke erfordern, können diese Einstellung verwenden.

Auf einer Plattform, die die Sandbox nicht unterstützt, startet Claude Code nicht, wenn dieser Schlüssel aktiviert ist. Siehe Enforce sandboxing with managed settings.

• Bereich: Any file, mit Einschränkungen für Projekt- und lokale Einstellungen
• Typ: Boolescher Wert
  • true: Claude Code beendet sich beim Start mit einem Fehler, wenn sandbox.enabled true ist, die Sandbox aber nicht starten kann
  • false: Claude Code führt Befehle ohne Sandbox aus, wenn die Sandbox nicht starten kann
• Standard: false

Dies lässt jeden verwalteten Computer Befehle in der Sandbox ausführen oder den Start verweigern:

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

Siehe Enforce sandboxing with managed settings.

sandbox.autoAllowBashIfSandboxed

Lassen Sie Claude Code Bash-Befehle in der Sandbox ohne Berechtigungsabfrage ausführen. Befehle, die nicht in der Sandbox ausgeführt werden können, durchlaufen weiterhin den regulären Berechtigungsfluss, und deny-Regeln sowie inhaltsbezogene ask-Regeln wie Bash(git push *) gelten weiterhin; eine bloße Bash-ask-Regel wird für Befehle in der Sandbox übersprungen. Setzen Sie den Schlüssel auf false, um auch Befehle in der Sandbox durch den regulären Berechtigungsfluss zu leiten, den die Mode-Registerkarte von /sandbox als regulären Berechtigungsmodus bezeichnet.

• 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

Dies behält die Sandbox bei und leitet Befehle in der Sandbox durch den regulären Berechtigungsfluss:

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

Siehe Auto-allow mode dafür, wobei der Modus mit automatischer Freigabe weiterhin nachfragt und wie er sich im Plan-Modus verhält.

sandbox.excludedCommands

Benennen Sie Befehle, die Claude Code außerhalb der Sandbox ausführt, z. B. Tools, die darin nicht funktionieren. Jeder Eintrag verwendet die gleiche Syntax wie der Inhalt einer Bash(...)-Berechtigungsregel: ein exakter Befehl, ein Präfix wie docker * oder ein Wildcard-Muster. Ein Muster ohne Wildcard ist eine exakte Übereinstimmung, daher passt docker nur auf docker ohne Argumente.

Ihre Einträge nehmen einen Bash-Aufruf nur dann aus der Sandbox heraus, wenn sie jeden Befehl darin abdecken, und einige Aufrufformen bleiben selbst dann in der Sandbox. Ein docker *-Eintrag allein nimmt npm ci && docker build . nicht aus der Sandbox heraus.

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

Claude Code hält einen Bash-Aufruf in der Sandbox, wenn er unter anderem eine dieser Formen hat:

• 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

Zum Beispiel bleibt cd build && docker compose up unter einem docker *-Eintrag in der Sandbox, und das Hinzufügen eines cd-Eintrags ändert das nicht. Unter einem git *-Eintrag wird git clone <url> vendor/lib außerhalb der Sandbox ausgeführt, aber git clone <url> ~/tools bleibt in der Sandbox. Ein Clone schreibt einen ganzen Baum von Dateien, möglicherweise auch ausführbare, an die Stelle, auf die sein Zielpfad zeigt.

Ausgeschlossene Befehle durchlaufen weiterhin den regulären Berechtigungsfluss. Ausschluss ist eine Bequemlichkeit, keine Sicherheitsgrenze: Wenn ein Tool nur an eine bestimmte Stelle schreiben muss, hält filesystem.allowWrite es in der Sandbox.

Einträge aus den Einstellungsbereichen, die die Sitzung lädt, werden zu einer Liste zusammengeführt, es sei denn, die Sandbox ist vom Admin vorgeschrieben. Solange dies der Fall ist, ignoriert Claude Code Einträge in .claude/settings.json und .claude/settings.local.json, sodass ein geklontes Repository keine Befehle aus der Sandbox herausnehmen kann. Einträge in verwalteten Einstellungen, --settings und Ihrer ~/.claude/settings.json gelten weiterhin, und für diese Liste gibt es keine Sperre, die nur in verwalteten Einstellungen gilt.

sandbox.allowUnsandboxedCommands

Lassen Sie Claude einen Befehl mit dem Parameter dangerouslyDisableSandbox außerhalb der Sandbox erneut versuchen, nachdem die Sandbox ihn blockiert hat. Bei false ignoriert Claude Code diesen Parameter. Solange die Sandbox läuft, werden Befehle, die Claude ausführt, dann in der Sandbox ausgeführt, es sei denn, sie entsprechen einem excludedCommands-Eintrag. Die Overrides-Registerkarte von /sandbox zeigt diesen Zustand als Strict sandbox mode an. Ein false in verwalteten Einstellungen aktiviert den strikten Sandbox-Modus für die Entwickler, für die diese Einstellungen gelten.

• 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

Dies erzwingt den strikten Sandbox-Modus für alle, für die die verwalteten Einstellungen gelten:

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

Ein false aus verwalteten Einstellungen oder --settings macht die Sandbox außerdem vom Admin vorgeschrieben. Ein false in Ihren Benutzereinstellungen setzt sich gegen ein true eines Projekts durch, macht die Sandbox aber nicht vom Admin vorgeschrieben. Das Durchsetzen gegen den Wert eines Projekts erfordert Claude Code v2.1.285 oder später.

Wer einen Wiederholungsversuch ohne Sandbox genehmigt, hängt von Ihrem Berechtigungsmodus und Ihren allow-Regeln ab. Siehe The unsandboxed retry escape hatch.

Um zu sehen, wann Befehle, die Sie selbst an der !-Shell-Modus-Eingabeaufforderung eingeben, in der Sandbox ausgeführt werden, siehe strict sandbox mode.

sandbox.filesystem

Legen Sie fest, welche Pfade Befehle in der Sandbox lesen und schreiben können. Standardmäßig können sie in das Arbeitsverzeichnis, das benutzerspezifische Temp-Verzeichnis und Verzeichnisse schreiben, die Sie mit --add-dir, /add-dir oder permissions.additionalDirectories hinzufügen, und können den Rest des Dateisystems lesen, einschließlich Anmeldedateien. Erweitern oder verengen Sie dies mit den vier Pfadlisten, oder schalten Sie die Dateisystem-Schicht mit disabled aus. Siehe Filesystem isolation für die Standardgrenzen.

• 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

Dies lässt Befehle in der Sandbox in ein Build-Verzeichnis und Ihre kubeconfig schreiben und verbirgt Ihre AWS-Anmeldedatei:

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

Claude Code erzwingt diese Listen an der OS-Sandbox-Grenze, daher gelten sie für jeden Unterprozess, den ein Befehl in der Sandbox startet, z. B. kubectl, terraform oder npm. Claude Code fügt Ihre Berechtigungsregeln zu denselben Listen hinzu: Edit-allow- und -deny-Regeln zu allowWrite und denyWrite, Read-deny-Regeln zu denyRead und WebFetch(domain:...)-allow- und -deny-Regeln zu den network-Domänenlisten.

Sofern keine Sperre greift, führt Claude Code diese Listen über die Einstellungsdateien zusammen, die die Sitzung lädt. allowManagedReadPathsOnly beschränkt allowRead auf Einträge aus verwalteten Einstellungen, und allowManagedDomainsOnly macht dasselbe für zulässige Domänen. Repository-Sperren lassen Einträge aus den Einstellungsdateien eines Repositorys weg.

Configure sandboxing behandelt Quellen, die Sie mit --setting-sources ausschließen. Wenn Sie eine Liste während einer Sitzung bearbeiten, wendet Claude Code die Änderung auf die laufende Sitzung an.

Sandbox-Pfadpräfixe

Pfade in allowWrite, denyWrite, denyRead, allowRead und credentials.files werden nach ihrem Präfix aufgelöst:

Das Präfix //path für absolute Pfade funktioniert ebenfalls. Wenn Sie /path mit einem einzelnen Schrägstrich verwenden und eine projektrelative Auflösung erwarten, wechseln Sie zu ./path. Diese Syntax unterscheidet sich von Read and Edit permission rules, die //path für absolute und /path für projektrelative Pfade verwenden: Sandbox-Dateisystempfade folgen den Standardkonventionen, daher ist /tmp/build ein absoluter Pfad.

Claude Code entfernt einen nachgestellten Schrägstrich aus einem Verzeichnispfad, daher entsprechen ~/.aws und ~/.aws/ demselben Verzeichnis. Vor v2.1.224 gab Claude Code den nachgestellten Schrägstrich an die Sandbox weiter, und Claude konnte weiterhin Pfade unter einem denyRead- oder denyWrite-Eintrag lesen oder schreiben, der mit einem solchen Schrägstrich geschrieben war.

Claude Code entfernt auch ein nachgestelltes /**, daher decken ~/build/** und ~/build dasselbe Verzeichnis ab. Ob eine Wildcard wie * funktioniert, hängt davon ab, in welcher Liste sich der Eintrag befindet, und von der Plattform:

• allowWrite und denyWrite: Auf macOS funktionieren Wildcards. Auf Linux und WSL2 mountet die Sandbox konkrete Pfade, daher überspringt Claude Code einen Eintrag, der nach dem Entfernen des nachgestellten /** noch *, ? oder [ enthält, und dieser Eintrag hat keine Wirkung. Claude Code fügt die Pfade aus Ihren Edit-Berechtigungsregeln zu diesen Listen hinzu, daher gilt für sie dieselbe Einschränkung, und die Config-Registerkarte von /sandbox warnt vor Edit- und Read-Berechtigungsregeln, die Wildcards enthalten.
• denyRead und allowRead: Wildcards funktionieren auf jeder Plattform. Auf Linux und WSL2 erweitert Claude Code einen Leseeintrag auf die konkreten Pfade, auf die er passt, was es für die Schreiblisten nicht tut.

sandbox.filesystem.allowWrite

Fügen Sie Pfade hinzu, in die Befehle in der Sandbox schreiben können, über das Arbeitsverzeichnis, das benutzerspezifische Temp-Verzeichnis und die Verzeichnisse hinaus, die Sie mit --add-dir, /add-dir oder permissions.additionalDirectories hinzugefügt haben. Verwenden Sie es, wenn ein Unterprozess wie kubectl oder ein Build-Tool außerhalb des Projekts schreiben muss.

• 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

Dies lässt einen Build unter /tmp/build schreiben und lässt kubectl Ihre kubeconfig aktualisieren:

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

Claude Code führt allowWrite-Einträge und die Pfade aus Ihren Edit(...)-allow-Berechtigungsregeln über die Einstellungsbereiche zusammen, die die Sitzung lädt, und lässt dabei die aus Repository-Einstellungen weg, solange permissions.blockReadsOutsideWorkingDirectories aktiviert ist. Repository-Sperren können die Einträge eines Repositorys ebenfalls weglassen. Ein allowWrite-Eintrag kann einen geschützten Pfad nicht freigeben.

sandbox.filesystem.denyWrite

Verhindern Sie, dass Befehle in der Sandbox in bestimmte Pfade schreiben, einschließlich Pfaden in einem Verzeichnis, das ansonsten beschreibbar ist.

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

Dies verhindert, dass Befehle in der Sandbox die Systemkonfiguration ändern oder Binärdateien installieren:

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

Claude Code führt Einträge über jeden Einstellungsbereich zusammen, den die Sitzung lädt, und fügt die Pfade aus Ihren Edit(...)-deny-Berechtigungsregeln hinzu.

sandbox.filesystem.denyRead

Verhindern Sie, dass Befehle in der Sandbox bestimmte Pfade lesen, z. B. Anmeldedateien, die die Standard-Leserichtlinie ansonsten offenlegen würde. Um eine Anmeldedatei zu schützen und sie über den Sandbox-Proxy nutzbar zu halten, siehe stattdessen sandbox.credentials.

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

Claude Code führt Einträge über jeden Einstellungsbereich zusammen, den die Sitzung lädt, und fügt die Pfade aus Ihren Read(...)-deny-Berechtigungsregeln hinzu. Wenn filesystem.disabled true ist, erzwingt Claude Code diese Einträge nicht.

sandbox.filesystem.allowRead

Geben Sie das Lesen für bestimmte Pfade innerhalb eines Bereichs, den denyRead blockiert, wieder frei, um einen auf den Workspace beschränkten Lesezugriff aufzubauen. Ein exakter oder Wildcard-denyRead-Eintrag bleibt innerhalb eines breiteren allowRead blockiert, wie die Überlappungstabelle zeigt. Wenn ein Wildcard-denyRead-Eintrag wie ~/**/.env auf ein Verzeichnis passt, blockiert Claude Code auch das Lesen seines Inhalts. Vor v2.1.236 gab Claude Code auf macOS die Pfade, auf die ein Wildcard-denyRead-Eintrag passte, überall dort wieder frei, wo ein breiterer allowRead-Eintrag sie abdeckte, und ließ den Inhalt eines passenden Verzeichnisses lesbar.

• 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

Dies blockiert Lesevorgänge in Ihrem Home-Verzeichnis mit Ausnahme des Projekts selbst:

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

Claude Code löst einen .-Eintrag in Projekteinstellungen zum Projekt-Root und in Benutzereinstellungen zu ~/.claude auf. Claude Code führt Einträge über die Einstellungsdateien zusammen, die die Sitzung lädt, sofern allowManagedReadPathsOnly nicht gesetzt ist, und lässt Einträge aus Repository-Einstellungen weg, solange permissions.blockReadsOutsideWorkingDirectories aktiviert ist. Repository-Sperren können die Einträge eines Repositorys ebenfalls weglassen.

sandbox.filesystem.allowManagedReadPathsOnly

Berücksichtigen Sie nur die allowRead-Einträge, die aus verwalteten Einstellungen stammen, damit Entwickler den Lesezugriff auf Pfade, die Ihre Organisation blockiert hat, nicht wieder freigeben können. Claude Code führt weiterhin denyRead-Einträge aus jedem Einstellungsbereich zusammen, den die Sitzung lädt.

• 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

Dies blockiert Lesevorgänge im Home-Verzeichnis, gibt ~/work wieder frei und verhindert, dass Entwickler etwas anderes freigeben:

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

Siehe Keep developers from widening the policy.

sandbox.filesystem.disabled

Überspringen Sie die Dateisystem-Isolierung, während die Netzwerk-Isolierung erhalten bleibt. Befehle in der Sandbox erhalten uneingeschränkten Lese- und Schreibzugriff auf das Host-Dateisystem, und ihr ausgehender Netzwerkverkehr bleibt auf network.allowedDomains beschränkt. Verwenden Sie es, wenn Sie die Sandbox einsetzen, um zu steuern, wohin Befehle sich verbinden, und nicht, was sie schreiben. Erfordert Claude Code v2.1.216 oder später.

• 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

Dies lässt das Dateisystem offen und beschränkt den ausgehenden Netzwerkverkehr auf GitHub und npm:

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

Bei deaktivierter Schicht erzwingt Claude Code weder denyRead- noch credentials.files-deny-Einträge, während credentials.envVars-Einträge und angewendete mask-Einträge weiterhin funktionieren. autoAllowBashIfSandboxed ist weiterhin standardmäßig true, setzen Sie es daher auf false, damit weiterhin nachgefragt wird. Siehe Disable filesystem isolation für die vollständige Liste der Quellen, die es setzen können, und was sich ändert, wenn die Isolierung deaktiviert ist. Erfordert Claude Code v2.1.216 oder später.

sandbox.ignoreViolations

Unterdrücken Sie Sandbox-Verletzungsberichte für Pfade, bei denen Sie erwarten, dass ein Befehl sie prüft und abgewiesen wird, z. B. ein Tool, das beim Start /etc/hosts prüft, damit diese Ablehnungen weder als Verletzungen angezeigt werden noch in dem auftauchen, was Claude sieht. Die Sandbox blockiert den Zugriff weiterhin; nur der Bericht wird unterdrückt. Schlüssel sind Teilzeichenfolgen, die mit dem Befehl abgeglichen werden, wobei * auf jeden Befehl passt, und Werte sind Teilzeichenfolgen der Verletzung, die für diesen Befehl ignoriert werden sollen, z. B. ein Dateisystempfad.

• 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

Führen Sie die Linux-Sandbox in einem unprivilegierten Docker-Container aus, in dem bubblewrap kein frisches /proc mounten kann. Stattdessen bindet die innere Sandbox das vorhandene /proc des Containers per Bind-Mount ein, wodurch Prozessinformationen offengelegt werden, die ein frisches Mount verbergen würde. Dies verringert die Sicherheit; verwenden Sie es nur, wenn der äußere Container bereits die benötigte Isolierung bietet.

• 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
  }
}

Nur Linux und WSL2. Siehe Bubblewrap fails to start inside a container.

sandbox.enableWeakerNetworkIsolation

Lassen Sie Befehle in der Sandbox auf macOS den System-TLS-Vertrauensdienst com.apple.trustd.agent erreichen. Go-basierte Tools wie gh, gcloud und terraform benötigen ihn, um TLS-Zertifikate zu überprüfen, wenn Sie network.httpProxyPort mit einem MITM-Proxy und einer benutzerdefinierten CA verwenden. Dies verringert die Sicherheit, da über den Vertrauensdienst ein potenzieller Pfad zur Datenexfiltration geöffnet wird.

• 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
  }
}

Wenn Sie keinen MITM-Proxy verwenden, listen Sie die fehlschlagenden Tools stattdessen in excludedCommands auf; siehe Go-based CLIs fail TLS verification on macOS.

sandbox.allowAppleEvents

Lassen Sie Befehle in der Sandbox auf macOS Apple Events senden, die open, osascript und Tools, die URLs in einem Browser öffnen, benötigen; ohne diese Einstellung schlagen sie mit dem Fehler -600 fehl. Dies hebt die Isolierung der Codeausführung auf: Befehle in der Sandbox können andere Anwendungen ohne Sandbox und ohne Benutzerabfrage starten und AppleScript-Befehle an laufende Anwendungen wie Terminal senden, vorbehaltlich der macOS-Abfrage zur Automatisierungszustimmung pro App (TCC).

• 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
  }
}

Um die Isolierung beizubehalten und trotzdem ein solches Tool auszuführen, fügen Sie es stattdessen zu excludedCommands hinzu. Siehe Apple Events on macOS.

sandbox.ripgrep

Verweisen Sie die Sandbox auf eine eigene ripgrep-Binärdatei statt auf die, die Claude Code verwendet, z. B. wenn Ihre Plattform ein anders gebautes rg benötigt.

• 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

Verweisen Sie die Sandbox auf eine bubblewrap-Binärdatei, die außerhalb von PATH installiert ist, z. B. eine mitgelieferte Kopie auf einem vom Netzwerk isolierten Host. Claude Code verwendet den Pfad sowohl für die Abhängigkeitsprüfung beim Start als auch beim Umhüllen jedes Befehls in der Sandbox.

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

Nur Linux und WSL2.

sandbox.socatPath

Verweisen Sie den Sandbox-Netzwerk-Proxy auf eine socat-Binärdatei, die außerhalb von PATH installiert ist.

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

Nur Linux und WSL2.

sandbox.credentials

Deklarieren Sie die Anmeldedateien und Umgebungsvariablen, die vor Befehlen in der Sandbox geschützt werden sollen. Jeder Eintrag benennt eine Datei path oder eine Variable name und einen mode: deny verbirgt die Anmeldedaten in der Sandbox, und mask zeigt Befehlen in der Sandbox einen Platzhalter, während der Sandbox-Proxy bei ausgehenden Anfragen den echten Wert einsetzt. Claude Code schützt nur die Einträge, die Sie auflisten; es gibt keine integrierte Denylist für Anmeldedaten.

• 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

Dies verbirgt Ihre AWS-Anmeldedatei und entfernt GITHUB_TOKEN aus Befehlen in der Sandbox:

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

Der deny-Dateischutz ist Teil der Dateisystem-Schicht, daher gilt er nicht, wenn Sie die Dateisystem-Isolierung deaktivieren; der Schutz von Umgebungsvariablen gilt weiterhin.

Ungültige Anmeldedaten-Einträge in verwalteten Einstellungen

Wenn ein verwalteter sandbox.credentials-Eintrag die Validierung nicht besteht, schützt Claude Code die Anmeldedaten weiterhin, soweit möglich:

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

Gilt in v2.1.191 und später; vor v2.1.221 wurde jeder ungültige Eintrag entfernt. Für die anderen verwalteten Schlüssel mit feldweiser Behandlung siehe Invalid entries in managed settings.

sandbox.credentials.files

Schützen Sie Anmeldedateien oder Verzeichnisse vor Befehlen in der Sandbox. Mit "mode": "deny" blockiert Claude Code Lesevorgänge des Pfads in der Sandbox, dieselbe Lesesperre wie bei sandbox.filesystem.denyRead. Mit "mode": "mask" lesen Befehle in der Sandbox auf Linux und WSL2 eine Sentinel-Kopie der Datei, und der Sandbox-Proxy setzt bei ausgehenden Anfragen an die injectHosts dieses Eintrags den echten Wert ein; auf macOS ist die Datei in der Sandbox stattdessen nicht lesbar. "mode": "mask" erfordert Claude Code v2.1.221 oder später.

• 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

Dies verbirgt Ihre AWS-Anmeldedatei und maskiert die gh-Hosts-Datei, wobei der echte Wert nur bei Anfragen an api.github.com eingesetzt wird:

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

Pfade verwenden dieselben Präfixe wie die sandbox.filesystem.*-Einstellungen, und Claude Code führt die Arrays aus jedem Einstellungsbereich zusammen, den die Sitzung lädt. Protect credentials behandelt, was aus Quellen, die Sie mit --setting-sources ausschließen, weiterhin gilt. mask-Einträge erfordern Claude Code v2.1.221 oder später.

Die mask-Ersetzung läuft nur über den Sandbox-Proxy, setzen Sie daher sandbox.network.tlsTerminate oder für Testnetzwerke mit einfachem HTTP allowPlaintextInject. mask gilt für eine einzelne Datei, listen Sie daher jede Anmeldedatei einzeln auf. Claude Code akzeptiert die mask-Felder bei einem deny-Eintrag, ignoriert sie aber. Mask credentials behandelt, welche Einstellungsquellen berücksichtigt werden, und Mask credential files behandelt, wann ein Eintrag auf deny zurückfällt.

Maskierungsfelder für Dateien

Ein mask-Eintrag akzeptiert diese optionalen Felder. Ohne extract oder decode ersetzt Claude Code den gesamten Dateiinhalt durch einen Sentinel. Auf macOS mit aktivierter Dateisystem-Isolierung wendet Claude Code einen mask-Eintrag als deny an, bevor extract oder decode ausgeführt wird; siehe Mask credential files.

Dies maskiert nur den oauth_token-Wert in der gh-Hosts-Datei, ersetzt jede andere Kopie davon in der Datei, macht die Datei unlesbar, wenn das Muster auf nichts passt, und setzt das echte Token nur bei Anfragen an api.github.com ein:

{
  "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

Schützen Sie Umgebungsvariablen vor Befehlen in der Sandbox. Mit "mode": "deny" entfernt Claude Code die Variable aus der Umgebung von Befehlen in der Sandbox. Mit "mode": "mask" sehen Befehle in der Sandbox einen sitzungsspezifischen Sentinel-Wert, und der Sandbox-Proxy setzt bei ausgehenden Anfragen an die injectHosts dieses Eintrags den echten Wert ein, sodass Tools wie gh und npm sich weiterhin authentifizieren, ohne jemals die echten Anmeldedaten zu besitzen.

• 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

Dies entfernt NPM_TOKEN aus Befehlen in der Sandbox und maskiert GITHUB_TOKEN, wobei der echte Wert nur bei Anfragen an api.github.com eingesetzt wird:

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

Der name muss mit einem Buchstaben oder Unterstrich beginnen und darf nur Buchstaben, Ziffern und Unterstriche enthalten. Claude Code führt die Arrays aus jedem Einstellungsbereich zusammen, den die Sitzung lädt, und wendet deny an, wenn dieselbe Variable mit beiden Modi erscheint. Protect credentials behandelt, was aus Quellen, die Sie mit --setting-sources ausschließen, weiterhin gilt.

Die mask-Ersetzung läuft nur über den Sandbox-Proxy, setzen Sie daher sandbox.network.tlsTerminate oder für Testnetzwerke mit einfachem HTTP allowPlaintextInject; siehe Mask credentials. Claude Code akzeptiert die mask-Felder bei einem deny-Eintrag, ignoriert sie aber.

Maskierungsfelder für Umgebungsvariablen

Ein mask-Eintrag akzeptiert diese optionalen Felder. Ohne extract oder decode ersetzt Claude Code den gesamten Wert durch einen Sentinel. extract und decode können nicht im selben Eintrag kombiniert werden.

Dies maskiert nur das Passwort in DATABASE_URL, entfernt die Variable, wenn das Muster auf nichts passt, und maskiert ein JWT in SERVICE_JWT, wobei jeder Claim außer api_key lesbar bleibt:

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

sandbox.credentials.allowPlaintextInject

Erlauben Sie die mask-Ersetzung sowohl bei einfachen HTTP-Anfragen als auch bei TLS-terminiertem HTTPS. Bei einfachem HTTP ist die Identität des Upstream-Servers nicht verifiziert und die Anmeldedaten werden im Klartext übertragen, lassen Sie dies daher außerhalb vertrauenswürdiger Testnetzwerke deaktiviert.

• 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

{
  "sandbox": {
    "credentials": {
      "allowPlaintextInject": true
    }
  }
}

sandbox.credentials.awsPairs

Gruppieren Sie maskierte Umgebungsvariablen, die zusammen AWS-Anmeldedaten für die SigV4-Neusignierung bilden, wenn Ihre Anmeldedaten in Variablen mit nicht standardmäßigen Namen liegen. Claude Code verknüpft das konventionelle Trio AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY und AWS_SESSION_TOKEN automatisch, wenn Sie deren vollständige Werte maskieren, daher benötigen Sie diesen Schlüssel nur für andere Namen. Erfordert Claude Code v2.1.224 oder später.

• Bereich: User or managed
• Typ: Array von Objekten, jedes mit accessKeyIdVar, secretAccessKeyVar und optional sessionTokenVar, die sandbox.credentials.envVars-Einträge benennen
• Standard: nicht gesetzt, daher wird nur das konventionelle Trio gepaart

Dies verknüpft drei benutzerdefiniert benannte Variablen zu einem AWS-Anmeldedatensatz für die Neusignierung:

{
  "sandbox": {
    "credentials": {
      "awsPairs": [
        {
          "accessKeyIdVar": "MY_KEY_ID",
          "secretAccessKeyVar": "MY_SECRET_KEY",
          "sessionTokenVar": "MY_SESSION_TOKEN"
        }
      ]
    }
  }
}

Jede benannte Variable muss ein mask-Eintrag für den gesamten Wert in sandbox.credentials.envVars sein, ohne extract oder decode, und kann über alle Paare hinweg nur einen Slot belegen. Außerdem gelten diese Regeln:

• Der Proxy signiert Anfragen an die Hosts neu, die in den injectHosts des Eintrags für die Zugriffsschlüssel-ID aufgeführt sind
• Wenn sessionTokenVar gesetzt ist, sendet der Proxy das echte Token bei neu signierten Anfragen als x-amz-security-token
• Wenn Sie eine der konventionellen Variablen in einem Paar benennen, ersetzt dies die automatische Paarung

sandbox.credentials.sigv4

Wählen Sie, was der Sandbox-Proxy mit AWS-Anfrageformen macht, die er nicht neu signieren kann: streaming für aws-chunked-Streaming-Uploads, presigned für vorsignierte URLs und sigv4a für asymmetrische SigV4A-Signaturen. Dies gilt nur für Anfragen, die mit der Platzhalter-Zugriffsschlüssel-ID eines maskierten Paars signiert sind. Erfordert Claude Code v2.1.224 oder später.

• Bereich: User or managed
• Typ: Objekt mit streaming, presigned und sigv4a, jeweils einer der folgenden Werte:
  • "deny": Der Proxy lässt die Anfrage fehlschlagen
  • "passthrough": Der Proxy leitet die mit dem maskierten Platzhalter signierte Anfrage weiter, sodass das Tool die eigene Ablehnung von AWS erhält
• Standard: nicht gesetzt, daher ist jede Form "deny"

Dies leitet Streaming-Uploads weiter, anstatt sie am Proxy scheitern zu lassen:

{
  "sandbox": {
    "credentials": {
      "sigv4": {
        "streaming": "passthrough"
      }
    }
  }
}

Mit deny lässt der Proxy die Anfrage fehlschlagen. Mit passthrough leitet der Proxy die Anfrage mit ihrer aus dem maskierten Platzhalter berechneten Signatur weiter, sodass AWS sie ablehnt und das aufrufende Tool die eigene Antwort von AWS statt eines Proxy-Fehlers erhält.

sandbox.network

Legen Sie fest, welche Hosts, Ports und Sockets Befehle in der Sandbox erreichen können. Die Sandbox leitet ausgehenden Verkehr über einen Proxy, der diese Listen erzwingt; siehe Network isolation dafür, wie der Proxy entscheidet und wann er nachfragt.

• Bereich: Any file. strictAllowlist, allowManagedDomainsOnly und tlsTerminate werden aus weniger Quellen gelesen, wie ihre Einträge angeben.
• Typ: Objekt mit den unten aufgeführten Unterschlüsseln
• Standard: nicht gesetzt, daher werden keine Domänen vorab erlaubt, und Ihr Berechtigungsmodus entscheidet, was mit jedem neuen Host geschieht

Dies erlaubt GitHub und npm vorab, blockiert uploads.github.com und lässt Befehle an localhost binden:

{
  "sandbox": {
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"],
      "deniedDomains": ["uploads.github.com"],
      "allowLocalBinding": true
    }
  }
}

Claude Code führt die Array-Unterschlüssel über Einstellungsbereiche zusammen, sodass ein Projekt Domänen zu Ihrer Benutzerliste hinzufügen kann, sofern keine Repository-Sperre greift. WebFetch(domain:...)-allow- und -deny-Berechtigungsregeln speisen dieselben Allow- und Deny-Listen.

sandbox.network.allowUnixSockets

Listen Sie die Unix-Socket-Pfade auf, mit denen Befehle in der Sandbox auf macOS eine Verbindung herstellen können. Claude Code ignoriert diese Liste auf Linux und WSL2, wo der seccomp-Filter Socket-Pfade nicht prüfen kann; verwenden Sie dort stattdessen allowAllUnixSockets.

• Bereich: Any file, mit Einschränkungen für Projekt- und lokale Einstellungen
• Typ: Array von Zeichenfolgen, jede ein Socket-Pfad
• Standard: nicht gesetzt, daher blockiert die macOS-Sandbox jeden Unix-Socket

{
  "sandbox": {
    "network": {
      "allowUnixSockets": ["~/.ssh/agent-socket"]
    }
  }
}

Ein Socket-Pfad kann weitreichenden Zugriff gewähren: Wenn Sie beispielsweise /var/run/docker.sock erlauben, kann ein Befehl in der Sandbox den Docker-Daemon steuern. Siehe Security limitations.

sandbox.network.allowAllUnixSockets

Lassen Sie Befehle in der Sandbox eine Verbindung zu jedem Unix-Socket herstellen. Auf Linux und WSL2 blockiert der seccomp-Filter der Sandbox socket(AF_UNIX, ...)-Aufrufe, daher ist dies dort die einzige Möglichkeit, Unix-Sockets zu erlauben. Wenn der Filter fehlt, was /sandbox auf seiner Registerkarte Dependencies meldet, blockiert die Sandbox Unix-Socket-Aufrufe nicht. Siehe Set up Linux and WSL2 dafür, woher der Filter stammt.

• Bereich: Any file, mit Einschränkungen für Projekt- und lokale Einstellungen
• Typ: Boolescher Wert
  • true: Befehle in der Sandbox können eine Verbindung zu jedem Unix-Socket herstellen
  • false: Die Sandbox blockiert Unix-Socket-Verbindungen: auf macOS mit Ausnahme der Pfade in allowUnixSockets, und auf Linux und WSL2 über den seccomp-Filter, sofern er vorhanden ist
• Standard: false

{
  "sandbox": {
    "network": {
      "allowAllUnixSockets": true
    }
  }
}

Auf WSL2 öffnet true außerdem wieder den Interop-Socket, der Windows-Binärdateien wie cmd.exe und powershell.exe startet.

sandbox.network.allowLocalBinding

Lassen Sie Befehle in der Sandbox auf macOS an Netzwerk-Ports lauschen, z. B. um einen Dev-Server zu starten, und sich mit jedem Port auf localhost verbinden. Ein Befehl, der auf einer Nicht-Loopback-Adresse lauscht, nimmt Verbindungen von anderen Rechnern an. Der Schlüssel hat auf Linux und WSL2 keine Wirkung, wo jeder Befehl in der Sandbox eine eigene Loopback-Schnittstelle hat. Um von Linux oder WSL2 aus einen Server auf dem Host zu erreichen, siehe A command fails to reach a server on localhost.

• Bereich: Any file, mit Einschränkungen für Projekt- und lokale Einstellungen
• Typ: Boolescher Wert
  • true: Befehle in der Sandbox auf macOS können auf jeder lokalen Adresse lauschen und sich mit jedem Port auf localhost verbinden
  • false: Befehle in der Sandbox auf macOS können weder auf einem Port lauschen noch sich direkt mit Servern auf localhost verbinden
• Standard: false

{
  "sandbox": {
    "network": {
      "allowLocalBinding": true
    }
  }
}

sandbox.network.allowMachLookup

Listen Sie zusätzliche XPC- und Mach-Servicenamen auf, die die macOS-Sandbox nachschlagen darf. Tools, die über XPC kommunizieren, wie der iOS-Simulator oder Playwright, benötigen hier einen Eintrag für ihre Services.

• Bereich: Any file, mit Einschränkungen für Projekt- und lokale Einstellungen
• Typ: Array von Zeichenfolgen, jede ein Servicename; ein einzelnes nachgestelltes * passt auf ein Präfix, und "*" allein passt auf jeden Service
• Standard: nicht gesetzt

Dies erlaubt jeden Service unter dem Präfix com.apple.coresimulator.:

{
  "sandbox": {
    "network": {
      "allowMachLookup": ["com.apple.coresimulator.*"]
    }
  }
}

sandbox.network.allowedDomains

Erlauben Sie Domänen für ausgehenden Verkehr von Befehlen in der Sandbox vorab, sodass die Sandbox für sie nicht nachfragt. Wildcards wie *.example.com passen auf Subdomänen, und ein optionales :port-Suffix beschränkt einen Eintrag auf einen Port; ein Eintrag ohne Port passt auf jeden Port.

• Bereich: Any file, mit Einschränkungen für Projekt- und lokale Einstellungen. Nur verwaltete Einstellungen, wenn allowManagedDomainsOnly gesetzt ist.
• Typ: Array von Zeichenfolgen, jede eine Domäne, ein Wildcard-Muster oder ein IP-Literal, mit einem optionalen :port-Suffix
• Standard: nicht gesetzt, daher entscheidet Ihr Berechtigungsmodus, was mit jedem neuen Host geschieht

Dies erlaubt GitHub auf jedem Port, jede npm-Subdomäne und einen API-Host nur auf Port 443 vorab:

{
  "sandbox": {
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org", "api.example.com:443"]
    }
  }
}

Schreiben Sie IPv6-Literale in eckigen Klammern, mit optionalem Port: "[::1]" erlaubt jeden Port und "[::1]:443" einen Port. Die geklammerte Form erfordert Claude Code v2.1.229 oder später. Siehe IPv6 addresses in domain lists.

sandbox.network.deniedDomains

Blockieren Sie Domänen für ausgehenden Verkehr von Befehlen in der Sandbox, mit derselben Wildcard-, Port- und IPv6-Syntax wie bei allowedDomains. Eine blockierte Domäne bleibt blockiert, auch wenn ein allowedDomains-Eintrag ebenfalls auf sie passt.

• Bereich: Any file
• Typ: Array von Zeichenfolgen, jede eine Domäne, ein Wildcard-Muster oder ein IP-Literal, mit einem optionalen :port-Suffix
• Standard: nicht gesetzt

{
  "sandbox": {
    "network": {
      "deniedDomains": ["sensitive.cloud.example.com"]
    }
  }
}

Claude Code führt diese Liste aus jeder Einstellungsquelle zusammen, die die Sitzung lädt, auch wenn allowManagedDomainsOnly gesetzt ist, sodass ein Entwickler die Denylist jederzeit verschärfen kann. Für IPv6-Literale siehe IPv6 addresses in domain lists.

Ein Eintrag, der mit dem nachgestellten Punkt geschrieben ist, der einen vollständig qualifizierten Domänennamen kennzeichnet, wie example.com., blockiert dieselben Verbindungen wie example.com.

sandbox.network.strictAllowlist

Verweigern Sie Befehlen in der Sandbox den Zugriff auf Hosts außerhalb der Allowlist, anstatt um Genehmigung zu bitten. Die Allowlist besteht aus allowedDomains plus Domänen aus WebFetch(domain:...)-allow-Regeln, oder nur aus den Einträgen der verwalteten Einstellungen, wenn allowManagedDomainsOnly gesetzt ist. Locks that apply without an admin-required sandbox behandelt die Einträge eines Repositorys. Erfordert Claude Code v2.1.219 oder später.

• Bereich: User or managed. Ein Repository kann es weder ein- noch ausschalten.
• Typ: Boolescher Wert
  • true: Claude Code verweigert Befehlen in der Sandbox den Zugriff auf Hosts außerhalb der Allowlist
  • false: Sofern keine andere vertrauenswürdige Einstellungsdatei true setzt, entscheidet Claude Code über einen Host außerhalb der Allowlist anhand des Berechtigungsmodus, anstatt ihn direkt zu verweigern: Im Auto-Modus prüft es den Host gegen die per-command allowed domains des Befehls, im dontAsk-Modus verweigert es, im bypassPermissions-Modus und in interaktiven Terminal-Sitzungen im Plan-Modus, in denen Bypass verfügbar ist, erlaubt es, und andernfalls fragt es bei Ihnen nach
• Standard: false

{
  "sandbox": {
    "network": {
      "strictAllowlist": true
    }
  }
}

Claude Code erzwingt dies nur für Befehle in der Sandbox; In-Process-Tools wie WebFetch folgen weiterhin ihren Berechtigungsregeln. Wenn eine der berücksichtigten Quellen es auf true setzt, bleibt es aktiv. Siehe Network isolation. Erfordert Claude Code v2.1.219 oder später.

sandbox.network.allowManagedDomainsOnly

Sperren Sie die Netzwerk-Allowlist auf das, was verwaltete Einstellungen definieren. Claude Code berücksichtigt dann nur allowedDomains und WebFetch(domain:...)-allow-Regeln aus verwalteten Einstellungen, ignoriert Domänen aus Benutzer-, Projekt-, lokalen und --settings-Einstellungen und blockiert eine nicht zulässige Domäne automatisch, anstatt nachzufragen.

• Bereich: Managed
• Typ: Boolescher Wert
  • true: Claude Code berücksichtigt nur allowedDomains und WebFetch(domain:...)-allow-Regeln aus verwalteten Einstellungen und blockiert eine nicht zulässige Domäne, anstatt nachzufragen
  • false: Domänen aus anderen Einstellungsdateien können in die Allowlist einfließen
• Standard: false

Dies sperrt die Allowlist auf GitHub und npm und ignoriert alle Domänen, die Entwickler hinzufügen:

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

Solange der Schlüssel true ist, ist die Sandbox vom Admin vorgeschrieben, und nur verwaltete Einstellungen können einen Proxy-Port setzen.

Blockierte Domänen werden weiterhin aus jeder Quelle zusammengeführt, die die Sitzung lädt. Siehe Keep developers from widening the policy.

sandbox.network.httpProxyPort

Verweisen Sie die Sandbox auf Ihren eigenen HTTP-Proxy statt auf den, den Claude Code ausführt. Organisationen tun dies, um HTTPS-Verkehr zu prüfen, eigene Filterregeln anzuwenden oder Anfragen zu protokollieren. Ihr Proxy übernimmt die Filterung, und Claude Code wendet seine Domänenlisten und Netzwerkabfragen nicht mehr auf den dorthin gesendeten Verkehr an. Wenn nicht gesetzt, startet Claude Code seinen eigenen Proxy für HTTP-Verkehr.

• Bereich: Any file, sofern nicht andere Sandbox-Einstellungen einschränken, welche Dateien einen Port setzen können
• Typ: Zahl, ein lokaler TCP-Port
• Standard: nicht gesetzt, daher führt Claude Code seinen eigenen Proxy aus

{
  "sandbox": {
    "network": {
      "httpProxyPort": 8080
    }
  }
}

Setzen Sie zusätzlich socksProxyPort, wenn Ihr Proxy auch SOCKS-Verkehr übernehmen soll; wenn nur einer der beiden gesetzt ist, führt Claude Code für das andere Protokoll weiterhin seinen eigenen Proxy aus. Siehe Custom proxy configuration.

sandbox.network.socksProxyPort

Verweisen Sie die Sandbox auf Ihren eigenen SOCKS5-Proxy statt auf den, den Claude Code ausführt. Ihr Proxy übernimmt die Filterung, und Claude Code wendet seine Domänenlisten und Netzwerkabfragen nicht mehr auf den dorthin gesendeten Verkehr an. Wenn nicht gesetzt, startet Claude Code seinen eigenen Proxy für SOCKS-Verkehr.

• Bereich: Any file, sofern nicht andere Sandbox-Einstellungen einschränken, welche Dateien einen Port setzen können
• Typ: Zahl, ein lokaler TCP-Port
• Standard: nicht gesetzt, daher führt Claude Code seinen eigenen Proxy aus

{
  "sandbox": {
    "network": {
      "socksProxyPort": 8081
    }
  }
}

Siehe Custom proxy configuration.

sandbox.network.tlsTerminate

Lassen Sie den Sandbox-Proxy TLS terminieren, damit er den Inhalt von HTTPS-Anfragen lesen kann. Dies ist experimentell, und die mask-Ersetzung von Anmeldedaten erfordert es. Setzen Sie {}, um eine kurzlebige Zertifizierungsstelle für die Sitzung zu generieren, oder setzen Sie caCertPath und caKeyPath, um Ihre eigene zu verwenden.

• Bereich: User or managed. Ein Repository kann es weder einschalten noch eine Zertifizierungsstelle bereitstellen.
• Typ: Objekt mit optionalen Zeichenfolgen caCertPath und caKeyPath, jeweils ein Dateipfad
• Standard: nicht gesetzt, daher terminiert und prüft der Proxy TLS nicht

{
  "sandbox": {
    "network": {
      "tlsTerminate": {}
    }
  }
}

Wenn mehr als eine berücksichtigte Quelle es setzt, verwendet Claude Code den Wert aus der Quelle mit der höchsten Priorität: verwaltete Einstellungen, dann das --settings-Flag, dann Benutzereinstellungen.

Memory und Kontext

Steuern Sie, was Claude Code in den Kontext lädt, wie es komprimiert wird und wo es Memory und Pläne ablegt. Siehe Kontext verwalten und Memory.

autoCompactEnabled

Lassen Sie Claude Code die Konversation automatisch komprimieren, wenn sich der Kontext dem Limit nähert. Erscheint in /config als Auto-compact, und das Umschalten dort schreibt diesen Schlüssel in Ihre Benutzereinstellungen.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Claude Code komprimiert die Konversation automatisch, wenn sich der Kontext dem Limit nähert
  • false: Claude Code komprimiert nicht automatisch
• Standard: true
• Überschreibungen pro Sitzung: DISABLE_AUTO_COMPACT deaktiviert die automatische Komprimierung für eine Sitzung; welcher der beiden sie auch deaktiviert, der andere kann sie nicht wieder aktivieren

{
  "autoCompactEnabled": false
}

Der manuelle /compact-Befehl funktioniert weiterhin, während die automatische Komprimierung deaktiviert ist. Wenn Sie die automatische Komprimierung deaktivieren, wird auch die Komprimierung im Leerlauf deaktiviert.

autoCompactWindow

Legen Sie fest, wie voll das Kontextfenster wird, bevor Claude Code automatisch komprimiert.

• Geltungsbereich: Any file
• Typ: Anzahl der Token, von 100000 bis 1000000. Claude Code begrenzt den Wert auf das Kontextfenster Ihres Modells; die Modellübersicht listet das Fenster jedes Modells auf
• Standard: nicht gesetzt, daher wählt Claude Code ein für Ihr Modell optimiertes Fenster
• Überschreibungen pro Sitzung: --autocompact hat für eine Sitzung Vorrang vor diesem Schlüssel, und CLAUDE_CODE_AUTO_COMPACT_WINDOW hat Vorrang vor beiden, es sei denn, Claude Code ignoriert den Wert der Variable

{
  "autoCompactWindow": 500000
}

Der Befehl /autocompact speichert ein Fenster für das aktuelle Modell unter modelSettings, das für dieses Modell Vorrang vor diesem Schlüssel in derselben Datei hat. Auto-Compact-Fenster einstellen behandelt, wie der Befehl, das Flag, die Variable und die Einstellung zusammenwirken.

autoMemoryDirectory

Speichern Sie Auto-Memory in einem Verzeichnis Ihrer Wahl statt im projektspezifischen Standardverzeichnis.

• Geltungsbereich: Any file
• Typ: String, ein absoluter oder mit ~/ präfixierter Verzeichnispfad
• Standard: nicht gesetzt, daher verwendet Claude Code ~/.claude/projects/<project>/memory/

{
  "autoMemoryDirectory": "~/my-memory-dir"
}

Aus Projekt- oder lokalen Einstellungen respektiert Claude Code diesen Schlüssel unter der gleichen Workspace-Vertrauensregel wie Hooks, da ein geklontes Repository diese Dateien bereitstellen kann.

autoMemoryEnabled

Schalten Sie Auto-Memory ein oder aus. Wenn false, liest Claude nicht aus dem Auto-Memory-Verzeichnis und schreibt nicht dorthin. Sie können es auch während einer Sitzung mit /memory umschalten, was diesen Schlüssel in Ihre Benutzereinstellungen schreibt.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: dasselbe wie nicht gesetzt; Auto-Memory bleibt aktiviert, es sei denn, etwas, das Vorrang vor diesem Schlüssel hat, deaktiviert es für die Sitzung, wie --bare, der sichere Modus oder CLAUDE_CODE_DISABLE_AUTO_MEMORY
  • false: Claude liest nicht aus dem Auto-Memory-Verzeichnis und schreibt nicht dorthin
• Standard: true
• Überschreibungen pro Sitzung: CLAUDE_CODE_DISABLE_AUTO_MEMORY hat für eine Sitzung Vorrang vor diesem Schlüssel, in beide Richtungen

{
  "autoMemoryEnabled": false
}

bashOutputMaxChars

Legen Sie fest, wie viele Zeichen der Ausgabe eines erfolgreichen Bash- oder PowerShell-Befehls Claude inline erhält. Wenn die Ausgabe das Limit überschreitet, speichert Claude Code sie in einer Datei und Claude erhält eine kurze Vorschau plus den Pfad der Datei. Erhöhen Sie das Limit, wenn die Befehlsausgabe, wie ein ausführlicher Build oder ein vollständiges Test-Suite-Log, routinemäßig das Standardlimit überschreitet und Sie möchten, dass Claude sie liest, ohne die Datei zu öffnen. Erfordert Claude Code v2.1.261 oder später.

• Geltungsbereich: Any file
• Typ: Anzahl der Zeichen, eine positive ganze Zahl. Claude Code begrenzt den Wert auf den Bereich 4000 bis 128000
• Standard: nicht gesetzt, daher erhält Claude bis zu 30.000 Zeichen inline

{
  "bashOutputMaxChars": 100000
}

Wenn Sie diesen Schlüssel setzen, ignoriert Claude Code die Umgebungsvariable BASH_MAX_OUTPUT_LENGTH.

claudeMd

Fügen Sie CLAUDE.md-ähnliche Anweisungen als von der Organisation verwaltetes Memory ein, ohne eine separate Datei bereitzustellen. Claude Code lädt den Text als verwalteten Memory-Eintrag vor Benutzer- und Projekt-CLAUDE.md-Dateien.

• Geltungsbereich: Managed
• Typ: String, der Text einer CLAUDE.md-Datei; schreiben Sie ihn wie die Datei, Markdown eingeschlossen, mit Zeilenumbrüchen als \n
• Standard: nicht gesetzt

Dieses Beispiel stellt zwei Regeln als kurze Markdown-Liste bereit:

{
  "claudeMd": "# Engineering rules\n\n- Always run make lint before committing.\n- Never push directly to main."
}

Siehe Organisationsweite CLAUDE.md bereitstellen.

claudeMdExcludes

Überspringen Sie bestimmte CLAUDE.md-Dateien, wenn Claude Code Memory lädt. In einem großen Monorepo verwenden Sie es, um CLAUDE.md-Dateien anderer Teams zu überspringen, die für Ihre Arbeit nicht relevant sind; Irrelevante CLAUDE.md-Dateien ausschließen im Leitfaden für große Codebases führt Sie durch diesen Fall. Muster werden gegen absolute Dateipfade abgeglichen.

• Geltungsbereich: Any file
• Typ: Array von Strings, jeweils ein Glob-Muster oder absoluter Pfad
• Standard: nicht gesetzt, daher lädt Claude Code jede CLAUDE.md, die es findet

{
  "claudeMdExcludes": ["**/vendor/**/CLAUDE.md"]
}

Ausschlüsse gelten nur für Benutzer-, Projekt- und lokale Memory-Dateien; CLAUDE.md-Dateien aus verwalteten Richtlinien können nicht ausgeschlossen werden.

env

Legen Sie Umgebungsvariablen für jede Sitzung und für die Unterprozesse fest, die Claude Code von ihr aus startet. Die meisten Variablen in der Referenz der Umgebungsvariablen können hier eingetragen werden; so wenden Sie eine Variable auf jede Sitzung an oder verteilen sie an Ihr Team. Projekt- und lokale Einstellungen können einige davon nicht setzen.

• Geltungsbereich: Any file
• Typ: Objekt, das Variablennamen auf String-Werte abbildet
• Standard: nicht gesetzt

Dieses Beispiel deaktiviert die automatische Komprimierung und leitet API-Anfragen über einen Proxy:

{
  "env": {
    "DISABLE_AUTO_COMPACT": "1",
    "ANTHROPIC_BASE_URL": "https://proxy.example.com"
  }
}

Wie env-Werte mit Ihrer Shell interagieren

• Ein Wert hier überschreibt dieselbe Variable, die in Ihrer Shell exportiert wird, und wenn mehr als eine Einstellungsdatei eine Variable setzt, gilt die mit dem höchsten Vorrang. Variablen, die Claude Code in env ignoriert listet die Ausnahmen für Projekt- und lokale Einstellungen auf.
• Wenn die Claude Desktop-App oder ein Runner einer selbst gehosteten Umgebung die Sitzung startet, hat stattdessen die von ihr bzw. ihm erstellte Start-Umgebung Vorrang: Claude Code ignoriert einen env-Wert aus jeder Einstellungsdatei für eine Variable, die die Start-Umgebung bereits setzt. Das Debug-Log nennt jede ignorierte Variable.
• Um einen Shell-Export aufzuheben, setzen Sie die Variable auf "". Claude Code behandelt einen leeren Wert bei der Anbieterauswahl als nicht gesetzt, und Unterprozesse erben den leeren Wert.
• NO_COLOR und FORCE_COLOR, die hier gesetzt sind, erreichen nur Unterprozesse. Um die Farben der Claude Code-Oberfläche selbst zu ändern, setzen Sie sie in Ihrer Shell, bevor Sie claude starten.
• Werte hier stehen im Klartext in der Einstellungsdatei und erreichen jeden Unterprozess, den Claude Code startet. Für ein OTLP-Bearer-Token, das rotiert wird, verwenden Sie otelHeadersHelper; für API-Anmeldedaten verwenden Sie apiKeyHelper.

Wann Claude Code env-Werte anwendet

• Aus Benutzereinstellungen, --settings und verwalteten Einstellungen: beim Start und erneut in der laufenden Sitzung, wenn eine gespeicherte Änderung die zusammengeführte env ändert.
• Aus Projekt- und lokalen Einstellungen: nachdem Sie dem Workspace vertrauen, oder beim Start im -p-Modus, der niemals den Vertrauensdialog anzeigt, und erneut, wenn eine gespeicherte Änderung die zusammengeführte env ändert.
• Variablen, die Claude Code als sicher einstuft, wie Modellauswahl, Timeouts und Limits sowie Feature-Toggles: beim Start aus jeder Einstellungsdatei, außer den Variablen, die Projekt- und lokale Einstellungen nicht setzen können.
• Nachdem Sie die Sitzung mit /cd verschoben haben, ab v2.1.246: die Projekt- und lokalen env-Werte des neuen Verzeichnisses, zusätzlich zu denen des vorherigen Verzeichnisses.

Variablen, die Claude Code in env ignoriert

• Projekt- und lokale Einstellungen können keine Variablen setzen, die ein ausgechecktes Repository nicht steuern sollte; setzen Sie diese stattdessen in Ihrer Shell, in Benutzereinstellungen oder in verwalteten Einstellungen. Claude Code verwirft jede davon, außer einigen Werten, die Telemetrie ausschalten, und protokolliert eine Warnung, die Sie mit claude --debug sehen können. Dazu gehören:

  • Variablen, die festlegen, wo Claude Code seine eigenen Dateien speichert oder schreibt: CLAUDE_CONFIG_DIR, CLAUDE_CODE_TMPDIR und die Verzeichnisvariablen des Betriebssystems wie HOME, TMPDIR, TMP, TEMP und die XDG_*-Familie.

  • Windows-Variablen, die die Programme und die rechnerweite Konfiguration für die Prozesse festlegen, die Claude Code startet, wie SystemRoot, ComSpec, ProgramData, LOCALAPPDATA, PATHEXT, PSModulePath und die ProgramFiles-Familie.

  • Variablen, die Sitzungsinhalte exportieren: OTEL_LOG_RAW_API_BODIES und das detaillierte Beta-Tracing-Paar ENABLE_BETA_TRACING_DETAILED und BETA_TRACING_ENDPOINT.

  • Die Variablen des OpenTelemetry-Exporters, die Telemetrie aktivieren, festlegen, wohin sie gesendet wird, oder festlegen, welche Inhalte sie erfasst:

    • CLAUDE_CODE_ENABLE_TELEMETRY, plus das Beta-Paar für erweiterte Telemetrie CLAUDE_CODE_ENHANCED_TELEMETRY_BETA und ENABLE_ENHANCED_TELEMETRY_BETA
    • Die Exporter-Selektoren OTEL_LOGS_EXPORTER, OTEL_METRICS_EXPORTER und OTEL_TRACES_EXPORTER
    • Die Inhaltsvariablen OTEL_LOG_USER_PROMPTS, OTEL_LOG_ASSISTANT_RESPONSES, OTEL_LOG_TOOL_CONTENT und OTEL_LOG_TOOL_DETAILS
    • OTEL_EXPORTER_OTLP_*-Variablen, deren Namen auf _ENDPOINT, _HEADERS, _PROTOCOL, _CERTIFICATE, _CLIENT_KEY oder _INSECURE enden, in der generischen und der signalspezifischen Form, wie OTEL_EXPORTER_OTLP_ENDPOINT und OTEL_EXPORTER_OTLP_METRICS_HEADERS
    • OTEL_EXPORTER_PROMETHEUS_HOST und OTEL_EXPORTER_PROMETHEUS_PORT

    Nur diese Werte gelten weiterhin aus Projekt- und lokalen Einstellungen, da sie etwas ausschalten: none für die drei Exporter-Selektoren und ein Aus-Wert wie 0 für OTEL_LOG_USER_PROMPTS, OTEL_LOG_TOOL_CONTENT und OTEL_LOG_TOOL_DETAILS. Ein solcher Wert überschreibt dieselbe Variable in Ihren Benutzereinstellungen, aber nicht eine, die die Umgebung, aus der Sie Claude Code starten, eine --settings-Datei oder verwaltete Einstellungen setzen.

    Wenn eine Projekt- oder lokale Einstellungsdatei eine Variable aus dieser Gruppe setzt, zeigt eine lokale interaktive Sitzung beim Start einen Hinweis. Führen Sie /status oder claude doctor aus, um zu sehen, welche Claude Code ignoriert hat und welche die Telemetrie ausgeschaltet haben; beide listen Namen auf, niemals Werte. Ein nicht interaktiver Lauf mit -p oder eine Agent SDK-Sitzung zeigt keinen Hinweis, überprüfen Sie daher nach dem Upgrade, ob Ihr Collector noch Daten empfängt. Wenn nicht, setzen Sie die Variablen in Ihren Benutzereinstellungen, in verwalteten Einstellungen, in der Umgebung des Jobs oder in einer Datei, die Sie mit --settings übergeben.

    Das Ignorieren dieser Gruppe in Projekt- und lokalen Einstellungen erfordert Claude Code v2.1.282 oder später.

  • Variablen, die ändern, wie Claude Code startet oder synchronisiert, wie CLAUDE_CODE_PROCESS_WRAPPER, CLAUDE_CODE_SYNC_SKILLS, CLAUDE_CODE_SYNC_PLUGINS, CLAUDE_CODE_PLUGIN_CACHE_DIR und CLAUDE_CODE_PLUGIN_SEED_DIR.

  • Variablen, die die Timer für einen unbeantworteten Dialog festlegen: CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS, CLAUDE_AFK_TIMEOUT_MS und CLAUDE_AFK_COUNTDOWN_MS.

  • CLAUDE_CODE_DISABLE_ATTACHMENTS, das die Verarbeitung von Anhängen ausschaltet.

  • CLAUDE_CODE_DISABLE_FILE_MENTIONS, das verhindert, dass Claude Code @-Erwähnungen von Dateien und Verzeichnissen auflöst.

  Vor v2.1.251 konnten Projekt- und lokale Einstellungen auch die Variablen in dieser Liste setzen, die festlegen, wo Claude Code seine Dateien schreibt, oder die Sitzungsinhalte exportieren, außer HOME und XDG_CONFIG_HOME. Vor v2.1.290 konnten sie auch die Variablen für die Dialog-Timer und CLAUDE_CODE_DISABLE_ATTACHMENTS setzen.

• Identitätsvariablen, die den Hosting-Umgebungen von Claude Code gehören, wie CLAUDE_CODE_REMOTE und CLAUDE_CODE_ACCOUNT_UUID, werden aus jeder Datei ignoriert.

• CLAUDE_CODE_MESSAGING_SOCKET und CLAUDE_CODE_MESSAGING_TOKEN, die Claude Code selbst exportiert, werden aus jeder Datei ignoriert. Das Ignorieren der Socket-Variable erfordert Claude Code v2.1.224 oder später, und das Ignorieren des Tokens erfordert v2.1.228 oder später.

• CLAUDE_CODE_PROJECT_DIR_NAME, das Claude Code nur aus der Start-Umgebung liest, wird aus jeder Datei ignoriert; erfordert v2.1.234 oder später.

• CLAUDE_CODE_RESTRICTED, das Claude Code nur aus der Start-Umgebung liest, wird aus jeder Datei ignoriert.

• CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY, das Claude Code nur aus der Start-Umgebung liest, wird aus jeder Datei ignoriert. Die Variable erfordert Claude Code v2.1.283 oder später.

• CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT, CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT, CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT und CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPT, die Claude Code nur aus der Start-Umgebung liest, werden aus jeder Datei ignoriert.

fileCheckpointingEnabled

Lassen Sie Claude Code vor jeder Bearbeitung Snapshots von Dateien erstellen, damit /rewind sie wiederherstellen kann. Erscheint in /config als Rewind code (checkpoints), und das Umschalten dort schreibt diesen Schlüssel in Ihre Benutzereinstellungen.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Claude Code erstellt vor jeder Bearbeitung Snapshots von Dateien, damit /rewind sie wiederherstellen kann
  • false: Claude Code erstellt keine Snapshots von Dateien, daher kann /rewind sie nicht wiederherstellen
• Standard: true
• Überschreibungen pro Sitzung: CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING deaktiviert Checkpointing für eine Sitzung; welcher der beiden es auch deaktiviert, der andere kann es nicht wieder aktivieren

{
  "fileCheckpointingEnabled": false
}

In einem -p-Lauf oder einer Agent SDK-Sitzung ignoriert Claude Code diesen Schlüssel. Das SDK aktiviert Checkpointing mit seiner Option enableFileCheckpointing, und ein einfacher -p-Lauf benötigt CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true. Siehe Datei-Checkpointing im Agent SDK.

idleCompaction

Die Komprimierung im Leerlauf komprimiert eine lange Konversation, von der Sie sich entfernt haben, kurz bevor ihr Prompt-Cache abläuft. Ihre nächste Nachricht sendet dann eine Zusammenfassung statt der gesamten Konversation. Wenn Sie zurückkehren, zeigt die Konversation eine Zeile an, die mit Compacted while idle, before the prompt cache expired beginnt.

Die Komprimierung im Leerlauf ist standardmäßig für Konversationen aktiviert, die alle diese Bedingungen erfüllen:

• Sitzung: Sie befinden sich in einer interaktiven Terminal-Sitzung
• Prompt-Cache: Die Konversation verwendet die einstündige Prompt-Cache-TTL
• Feature-Flags: Claude Code kann Feature-Flags von Anthropic abrufen
• Größe: Der Kontext der Konversation hat den Token-Schwellenwert erreicht, den Sie gegenüber seinem Standardwert von 200.000 ändern können
• Leerlaufzeit: Seit der letzten Anfrage sind etwa 54 Minuten vergangen, und Ihr Computer befindet sich zu diesem Zeitpunkt nicht im Ruhezustand

Um die Komprimierung im Leerlauf auszuschalten, setzen Sie diesen Schlüssel auf false.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Claude Code komprimiert Konversationen im Leerlauf, die die Bedingungen erfüllen
  • false: Claude Code komprimiert nicht, während sich Ihre Sitzung im Leerlauf befindet
• Standard: true
• Überschreibungen pro Sitzung: DISABLE_AUTO_COMPACT deaktiviert die Komprimierung im Leerlauf zusammen mit der automatischen Komprimierung

{
  "idleCompaction": false
}

Um die Komprimierung im Leerlauf innerhalb einer Sitzung aus- oder einzuschalten, führen Sie /config aus und ändern Sie die Zeile Idle compaction. Ihre Auswahl wird in Ihren Benutzereinstellungen gespeichert und gilt sofort. Die Zeile erfordert Claude Code v2.1.302 oder später. Wenn Sie eine dieser Versionen verwenden und /config die Zeile nicht anzeigt, prüfen Sie diese Ursachen:

• Eine andere Einstellungsquelle setzt den Schlüssel: Ein Wert in verwalteten Einstellungen, im Flag --settings oder in einer Projekt- oder lokalen Einstellungsdatei überschreibt Ihre Benutzereinstellungen. Ändern Sie den Schlüssel stattdessen in dieser Quelle
• Feature-Flags sind nicht verfügbar: Wo Claude Code keine Feature-Flags von Anthropic abrufen kann, wird die Komprimierung im Leerlauf nicht ausgeführt, daher gibt es nichts auszuschalten

Der Schlüssel erfordert Claude Code v2.1.290 oder später. In einer früheren Version, die diesen Schlüssel ignoriert, deaktivieren Sie autoCompactEnabled, um die Komprimierung im Leerlauf zu stoppen.

Schwellenwert für die Komprimierung im Leerlauf ändern

Setzen Sie CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS auf die Anzahl der Token, die der Kontext einer Konversation erreichen muss, bevor die Komprimierung im Leerlauf für sie gilt. Verwenden Sie eine positive ganze Zahl. Werte unter 100000 werden auf 100000 angehoben, den niedrigsten Schwellenwert.

Beim Standardwert wird eine Konversation mit einem Kontextfenster von 200K automatisch komprimiert, bevor sie 200.000 Token erreicht. Dieses Beispiel senkt den Schwellenwert auf 150.000, sodass diese Konversationen infrage kommen:

{
  "env": {
    "CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS": "150000"
  }
}

plansDirectory

Wählen Sie, wo Claude Code die Plandateien speichert, die es im Plan-Modus schreibt. Claude Code löst den Pfad relativ zum Projektstamm auf.

• Geltungsbereich: Any file
• Typ: String, ein Pfad relativ zum Projektstamm
• Standard: nicht gesetzt, daher verwendet Claude Code ~/.claude/plans

{
  "plansDirectory": "./plans"
}

In Fällen wie diesen speichert Claude Code Pläne in ~/.claude/plans statt in dem von Ihnen festgelegten Verzeichnis:

• Außerhalb des Projektstamms: Der Pfad wird außerhalb des Projektstamms aufgelöst, wie bei "../plans".
• Backslash unter macOS, Linux und WSL: Der aufgelöste Pfad enthält einen Backslash, wie bei "docs\\plans" im Windows-Stil. Schreiben Sie "docs/plans", was auch unter Windows funktioniert.

skillListingBudgetFraction

In jedem Turn sieht Claude eine Auflistung Ihrer Skills mit ihren Beschreibungen, und Claude Code begrenzt diese Auflistung auf einen Anteil des Kontextfensters. Wenn die Auflistung die Obergrenze überschreitet, behält Claude Code den Namen jedes Skills bei, entfernt aber die Beschreibungen der am wenigsten verwendeten Skills, sodass Claude diese Skills weiterhin aufrufen kann, aber seltener von sich aus einen davon auswählt. Erhöhen Sie diesen Schlüssel, um mehr Beschreibungen sichtbar zu halten, auf Kosten von mehr Kontext pro Turn.

• Geltungsbereich: Any file
• Typ: Zahl, ein Bruchteil größer als 0 und höchstens 1
• Standard: 0.01, was 1 % des Kontextfensters reserviert

{
  "skillListingBudgetFraction": 0.02
}

Um zu sehen, wie viel Kontext die Auflistung verwendet und welche Skills am meisten beitragen, führen Sie /doctor aus.

skillListingMaxDescChars

In jedem Turn sieht Claude eine Auflistung Ihrer Skills, die den description- und when_to_use-Text jedes Skills zeigt. Dieser Schlüssel begrenzt, wie viele Zeichen dieses Textes Claude Code pro Skill anzeigt; längerer Text wird an der Obergrenze abgeschnitten.

• Geltungsbereich: Any file
• Typ: Anzahl der Zeichen, eine positive ganze Zahl
• Standard: 1536

{
  "skillListingMaxDescChars": 2048
}

Erhöhen Sie den Wert, um lange Beschreibungen vollständig zu erhalten, auf Kosten von mehr Kontext pro Turn; senken Sie ihn, um mehr Skills innerhalb von skillListingBudgetFraction unterzubringen.

taskOutputMaxChars

[!WARNING]

Entfernt in v2.1.277, zusammen mit dem TaskOutput-Tool, dessen Ausgabegröße es festlegte. Das Setzen hat in aktuellen Versionen keine Auswirkung. Claude liest die Ausgabedatei einer Hintergrundaufgabe stattdessen mit Read.

Bis v2.1.276 legten Sie mit diesem Schlüssel die Anzahl der Zeichen der Ausgabe einer Hintergrundaufgabe fest, die Claude inline erhielt, wenn es die Aufgabe mit dem TaskOutput-Tool las.

Oberfläche und Terminal

Ändern Sie, wie Claude Code in Ihrem Terminal aussieht und sich verhält: Theme, Editor-Modus, Statuszeile, Spinner, Benachrichtigungen innerhalb der Sitzung und Barrierefreiheit. Siehe Terminal-Konfiguration.

askUserQuestionTimeout

Lassen Sie einen unbeantworteten AskUserQuestion-Dialog nach einer Leerlaufzeit automatisch fortfahren, wobei die bereits ausgewählten Optionen übermittelt werden. Setzen Sie diesen Schlüssel, wenn Sie sich entfernen und möchten, dass Claude ohne Sie weiterarbeitet. Mit dem Standardwert warten Fragen, bis Sie sie beantworten. Wann der Timer pausiert oder gar nicht erst startet, erfahren Sie unter Timeout für automatisches Fortfahren bei Fragen.

• Geltungsbereich: User or managed
• Typ: String, einer von "60s", "5m", "10m" oder "never"
• Standard: "never"
• Überschreibungen pro Sitzung: CLAUDE_AFK_TIMEOUT_MS hat für eine Sitzung Vorrang vor diesem Schlüssel

{
  "askUserQuestionTimeout": "5m"
}

Erscheint in /config als Question auto-continue timeout, das diesen Schlüssel in die Benutzereinstellungen schreibt; Claude Code blendet die Zeile aus, solange verwaltete Einstellungen oder das Flag --settings den Schlüssel setzen.

autoContinueAtUsageLimit

Nachdem ein claude.ai-Nutzungslimit Ihre Sitzung angehalten hat, in der geöffneten Sitzung warten und die Aufgabe nach dem Zurücksetzen automatisch fortsetzen. Siehe Automatisches Fortsetzen ausschalten. Erfordert Claude Code v2.1.234 oder höher.

• Geltungsbereich: User or managed. Wird nur aus den Benutzereinstellungen, --settings und verwalteten Einstellungen gelesen. Wenn keine davon den Schlüssel setzt, schaltet eine Projekt- oder lokale Einstellungsdatei, die ihn setzt, die Funktion aus, statt ignoriert zu werden.
• Typ: Boolean
  • true: Nachdem ein claude.ai-Nutzungslimit Ihre Sitzung angehalten hat, wartet Claude Code in der geöffneten Sitzung und setzt die Aufgabe nach dem Zurücksetzen automatisch fort
  • false: Claude Code startet das Warten nicht von selbst. Sie können das Warten weiterhin selbst starten, und zwar über das Optionsmenü für Nutzungslimits
• Standard: true

{
  "autoContinueAtUsageLimit": false
}

Erscheint in /config als Continue automatically at usage limit, das diesen Schlüssel in die Benutzereinstellungen schreibt; Claude Code blendet die Zeile aus, solange verwaltete Einstellungen oder das Flag --settings den Schlüssel setzen.

autoScrollEnabled

Neuer Ausgabe bis zum Ende der Konversation folgen, im Vollbild-Rendering. Schalten Sie es aus, um an der Stelle zu bleiben, zu der Sie gescrollt haben, während Claude weiterarbeitet; Berechtigungsabfragen werden weiterhin in den sichtbaren Bereich gescrollt.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Die Konversation folgt neuer Ausgabe bis zum Ende
  • false: Sie bleiben an der Stelle, zu der Sie gescrollt haben, während Claude weiterarbeitet; Berechtigungsabfragen erscheinen weiterhin unterhalb des Transkripts
• Standard: true

{
  "autoScrollEnabled": false
}

Erscheint in /config als Auto-scroll, wenn das Vollbild-Rendering aktiv ist, und schreibt diesen Schlüssel in die Benutzereinstellungen.

axScreenReader

Screenreader-freundliche Ausgabe rendern: einfacher Text ohne dekorative Rahmen oder Animationen. Der Screenreader-Modus verwendet den klassischen Renderer, daher hat die Einstellung tui keine Wirkung, solange er aktiv ist; angehängte Hintergrundsitzungen werden weiterhin im Vollbild gerendert.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Claude Code rendert einfachen Text ohne dekorative Rahmen oder Animationen und verwendet den klassischen Renderer
  • false: Claude Code rendert normal
• Standard: nicht gesetzt, daher ist der Screenreader-Modus aus
• Überschreibungen pro Sitzung: --ax-screen-reader hat Vorrang vor CLAUDE_AX_SCREEN_READER, und beide haben für eine Sitzung Vorrang vor diesem Schlüssel

{
  "axScreenReader": true
}

bashEditDiffEnabled

Legen Sie fest, ob Claude Code aufzeichnet, welche Dateien sich in einem Git-Repository geändert haben, während ein Bash-Befehl läuft. Wenn es sie aufzeichnet, sehen Sie nach dem Befehl deren Diff im Terminal, und Ihre PostToolUse-Bash-Hooks erhalten die Liste der geänderten Dateien.

Eine aufgeführte Datei ist nicht immer eine, die der Befehl geändert hat. Auch eine Änderung, die ein anderes Programm oder ein anderer Bash-Aufruf vorgenommen hat, während der Befehl lief, kann dort erscheinen.

Setzen Sie den Schlüssel auf true, um sie in jedem Berechtigungsmodus aufzuzeichnen. Erfordert Claude Code v2.1.269 oder höher.

• Geltungsbereich: User or managed. Ein true zählt nur aus Ihren Benutzereinstellungen, aus mit --settings übergebenem JSON oder aus verwalteten Einstellungen, daher kann ein true in der .claude/settings.json oder .claude/settings.local.json eines Repositorys die Aufzeichnung nicht einschalten. Ein false in einer der beiden Repository-Dateien schaltet sie dennoch aus, es sei denn, eine Datei mit höherem Vorrang setzt true.
• Typ: Boolean
• Standard: nicht gesetzt, daher zeichnet Claude Code Änderungen im Auto-Modus und im Modus bypassPermissions auf, wenn es Claude anweist, Dateien über Bash zu bearbeiten
• Überschreibungen pro Sitzung: CLAUDE_CODE_BASH_EDIT_DIFF hat für eine Sitzung Vorrang vor diesem Schlüssel

{
  "bashEditDiffEnabled": true
}

companyAnnouncements

Den Benutzern beim Start die Ankündigungen Ihrer Organisation anzeigen. Wenn Sie mehr als eine auflisten, wählt Claude Code für jede Sitzung eine zufällig aus; beim allerersten Start einer Person zeigt es den ersten Eintrag.

• Geltungsbereich: Any file
• Typ: Array von Strings
• Standard: nicht gesetzt, daher wird keine Ankündigung angezeigt

{
  "companyAnnouncements": [
    "Welcome to Acme Corp! Review our code guidelines at docs.example.com"
  ]
}

defaultShell

Legen Sie fest, ob Bash oder PowerShell die Shell-Befehle ausführt, die Sie mit dem !-Präfix in das Eingabefeld eingeben, also die Befehle, die Claude Code direkt ausführt und der Sitzung hinzufügt.

"powershell" funktioniert nur, solange das PowerShell-Tool eingeschaltet ist. Das Tool ist standardmäßig unter Windows ohne Git Bash eingeschaltet sowie unter Windows mit Git Bash für claude.ai- und Console-Konten. In Sitzungen mit Amazon Bedrock, Google Clouds Agent Platform und Microsoft Foundry sowie unter macOS, Linux und WSL setzen Sie CLAUDE_CODE_USE_POWERSHELL_TOOL=1, um das Tool einzuschalten. Setzen Sie diese Variable auf 0, um das Tool auszuschalten.

• Geltungsbereich: Any file
• Typ: String, einer von:
  • "bash": Claude Code führt Ihre !-Befehle in Bash aus
  • "powershell": Claude Code führt Ihre !-Befehle in PowerShell aus
• Standard: "bash", oder "powershell" unter Windows, wenn Bash nicht verfügbar ist

{
  "defaultShell": "powershell"
}

Wenn die angegebene Shell nicht verfügbar ist, verwendet Claude Code die jeweils andere: "powershell" fällt auf Bash zurück, wenn das PowerShell-Tool ausgeschaltet ist, und "bash" fällt auf PowerShell zurück, wenn Bash nicht installiert ist.

dialogExpiry

Legen Sie die Frist für Dialoge fest, die Claude Code an einen Remote-Client weiterleitet, etwa einen Remote-Control- oder SDK-Host, sowie für den Genehmigungsdialog einer zurückgehaltenen sitzungsübergreifenden Nachricht. Ab Claude Code v2.1.236 begrenzt dieselbe Frist auch die während der Sitzung erscheinende Zustimmungsabfrage für Fable-Nutzungsguthaben in einer Sitzung, in der möglicherweise niemand am Terminal ist. Wenn vor Ablauf der Frist keine Antwort eingeht, bricht Claude Code den Dialog ab und fährt mit seinem Standard ohne Aktion fort. Erfordert Claude Code v2.1.224 oder höher.

• Geltungsbereich: User or managed
• Typ: String, einer von "60s", "5m", "10m" oder "never", was die Frist deaktiviert
• Standard: "5m"
• Überschreibungen pro Sitzung: CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS hat für eine Sitzung Vorrang vor diesem Schlüssel

{
  "dialogExpiry": "10m"
}

Berechtigungsabfragen und AskUserQuestion-Fragen verwenden eigene Abläufe und unterliegen dieser Frist nicht. Erscheint in /config als Dialog expiry, das diesen Schlüssel in die Benutzereinstellungen schreibt; die Zeile erfordert Claude Code v2.1.232 oder höher, und Claude Code blendet sie aus, solange verwaltete Einstellungen oder das Flag --settings den Schlüssel setzen.

editorMode

Wählen Sie den Tastenbelegungsmodus für die Eingabeaufforderung.

• Geltungsbereich: Any file
• Typ: String, einer von:
  • "normal": Standard-Tastenbelegungen in der Prompt-Eingabe
  • "vim": Bearbeitung im vim-Stil mit den Modi NORMAL, INSERT und VISUAL
• Standard: "normal"

{
  "editorMode": "vim"
}

Erscheint in /config als Editor mode, das diesen Schlüssel in die Benutzereinstellungen schreibt.

emojiCompletionEnabled

Emoji-Vorschläge anzeigen, wenn Sie in der Prompt-Eingabe : plus einen Shortcode eingeben, und einen vollständigen Shortcode wie :heart: durch sein Emoji ersetzen. Setzen Sie den Schlüssel auf false, um beides auszuschalten.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Claude Code zeigt nach : Emoji-Vorschläge an und ersetzt einen vollständigen Shortcode durch sein Emoji
  • false: Claude Code schlägt weder Emojis vor noch ersetzt es Shortcodes
• Standard: true

{
  "emojiCompletionEnabled": false
}

Siehe Emoji-Shortcodes. Erfordert Claude Code v2.1.217 oder höher.

fileSuggestion

Einen eigenen Befehl ausführen, um die @-Autovervollständigung für Dateipfade anstelle der integrierten Dateivorschläge bereitzustellen. Die integrierten Vorschläge verwenden eine schnelle Dateisystemdurchsuchung; bei einem großen Monorepo kann eine projektspezifische Indizierung, etwa ein vorab erstellter Dateiindex, besser geeignet sein.

• Geltungsbereich: Any file. Unter den Sperren für Statuszeile und Dateivorschläge schaltet Claude Code den Befehl aus oder führt nur einen verwalteten Wert aus und überspringt Ihren ohne Warnung.
• Typ: Objekt mit type, immer "command", und command, dem auszuführenden Shell-Befehl
• Standard: nicht gesetzt, daher verwendet Claude Code die integrierten Dateivorschläge

{
  "fileSuggestion": {
    "type": "command",
    "command": "~/.claude/file-suggestion.sh"
  }
}

Nachdem Sie dies gespeichert haben, geben Sie im Prompt @ gefolgt von einem Teil eines Pfads ein: Die Vorschläge stammen aus der Ausgabe Ihres Befehls.

Ein- und Ausgabe des Befehls

Claude Code führt den Befehl mit denselben Umgebungsvariablen wie Hooks aus, einschließlich CLAUDE_PROJECT_DIR, und hört nach fünf Sekunden auf zu warten. Der Befehl erhält auf stdin JSON mit einem Feld query, das enthält, was Sie bisher eingegeben haben:

{"query": "src/comp"}

Geben Sie durch Zeilenumbrüche getrennte Dateipfade auf stdout aus. Claude Code zeigt höchstens 15 an:

src/components/Button.tsx
src/components/Modal.tsx
src/components/Form.tsx

Das folgende Skript liest die Abfrage und übergibt sie an einen Dateiindex des Repositorys:

#!/bin/bash
query=$(cat | jq -r '.query')
# Replace your-repo-file-index with your own file search command
your-repo-file-index --query "$query" | head -20

footerLinksRegexes

Zusätzliche anklickbare Badges in der Fußzeile unterhalb des Eingabefelds rendern, wenn ein regulärer Ausdruck auf die Ausgabe eines Turns passt: Tool-Ergebnisse, einschließlich Dateiinhalten und abgerufener Seiten, sowie Claudes eigene Antworten. Verwenden Sie dies, um IDs, die von Projekt-CLIs wie Review-Tools und Issue-Trackern ausgegeben werden, in Sitzungslinks umzuwandeln.

• Geltungsbereich: User or managed
• Typ: Array von Objekten, jeweils mit type auf "regex" gesetzt, einem regulären Ausdruck pattern, einer url-Vorlage und einem optionalen label; {name}-Platzhalter in url und label werden aus benannten Erfassungsgruppen in pattern befüllt
• Standard: nicht gesetzt, daher werden keine Badges gerendert

Dieses Beispiel erkennt Issue-Schlüssel wie PROJ-1234 und erstellt jeden Link aus dem erfassten Schlüssel:

{
  "footerLinksRegexes": [
    {
      "type": "regex",
      "pattern": "\\b(?<key>PROJ-\\d+)\\b",
      "url": "https://issues.example.com/browse/{key}",
      "label": "{key}"
    }
  ]
}

Wenn dies konfiguriert ist und PROJ-1234 in einem Tool-Ergebnis oder in Claudes Antwort erscheint, erscheint in der Fußzeile ein Badge PROJ-1234, das auf https://issues.example.com/browse/PROJ-1234 verlinkt.

Einschränkungen für Badges

URL, Beschriftung und Badge-Anzahl jedes Eintrags sind wie folgt begrenzt:

Wenn ein Turn abgeschlossen ist, gleicht Claude Code den regulären Ausdruck pattern jedes Eintrags im Hauptthread mit der Ausgabe des Turns ab, daher blockiert ein langsamer regulärer Ausdruck die Oberfläche, bis er fertig ist. Verschachtelte Quantifizierer wie (a+)+$ können bei bestimmten Eingaben exponentiell lange dauern und die Sitzung einfrieren, halten Sie daher jedes pattern linear und vermeiden Sie verschachtelte + oder *.

Footer-Badges werden neben einer benutzerdefinierten Statuszeile gerendert, wenn eine konfiguriert ist; keines ersetzt das andere. Verwenden Sie eine Statuszeile für eine skriptgesteuerte Zeile, die ihren Inhalt selbst aus Sitzungsdaten berechnet, und Footer-Badges, um IDs aus der Konversation ohne Skript in Links umzuwandeln.

keybindingFlavor

[!WARNING]

Seit v2.1.261 veraltet und ohne Wirkung. Die Tasten zur Wortbearbeitung im Prompt folgen immer den readline-Konventionen, wie in Bash. Claude Code akzeptiert keybindingFlavor weiterhin, sodass eine Einstellungsdatei, die den Schlüssel setzt, gültig bleibt.

In v2.1.238 bis v2.1.260 bewirkte der Wert "readline", dass Ctrl+W bis zum vorherigen Leerraum löschte statt nur das vorherige Wort.

• Geltungsbereich: Any file
• Typ: String, "classic" oder "readline"
• Standard: nicht gesetzt

maxProseWidth

Die Breite des Fließtexts in Claudes Antworten begrenzen, damit Zeilen in einem breiten Terminal lesbar bleiben. Absätze, Überschriften, Listen und Blockzitate werden innerhalb dieser Anzahl von Spalten umbrochen, während Tabellen und Codeblöcke die volle Terminalbreite behalten. Erfordert Claude Code v2.1.282 oder höher.

• Geltungsbereich: Any file
• Typ: Anzahl der Terminalspalten, eine ganze Zahl, mindestens 40. Claude Code ignoriert jeden anderen Wert
• Standard: nicht gesetzt, daher wird Fließtext am Rand des Terminals umbrochen

{
  "maxProseWidth": 80
}

prefersReducedMotion

Animationen der Oberfläche wie den Spinner sowie Schimmer- und Blitzeffekte reduzieren oder ausschalten. Erscheint in /config als Reduce motion.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Claude Code reduziert Animationen der Oberfläche wie den Spinner sowie Schimmer- und Blitzeffekte oder schaltet sie aus
  • false: wie nicht gesetzt; Claude Code zeigt seine Animationen
• Standard: false

{
  "prefersReducedMotion": true
}

promptSuggestionEnabled

Prompt-Vorschläge anzeigen oder ausblenden, also die ausgegrauten Vorhersagen, die in Ihrer Prompt-Eingabe erscheinen. Setzen Sie den Schlüssel auf false oder schalten Sie Prompt suggestions in /config aus, um sie auszublenden.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Sie sehen Prompt-Vorschläge in Ihrer Prompt-Eingabe
  • false: Claude Code blendet Prompt-Vorschläge aus
• Standard: true
• Überschreibungen pro Sitzung: CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION hat für eine Sitzung Vorrang vor diesem Schlüssel

{
  "promptSuggestionEnabled": false
}

Prompt-Vorschläge erfordern ein claude.ai- oder Console-Konto mit eingeschalteter Telemetrie. Bei Amazon Bedrock, Google Clouds Agent Platform und Microsoft Foundry oder bei ausgeschalteter Telemetrie, etwa durch DISABLE_TELEMETRY, hat dieser Schlüssel keine Wirkung, und nur CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=1 schaltet sie ein.

respectGitignore

Steuern, ob die @-Dateiauswahl Dateien auslässt, die auf .gitignore-Muster passen. Erscheint in /config als Respect .gitignore in file picker.

• Geltungsbereich: Any file. Wenn keine Einstellungsdatei den Schlüssel setzt, greift Claude Code auf respectGitignore in ~/.claude.json zurück, das vom Schalter in /config geschrieben wird.
• Typ: Boolean
  • true: Die @-Dateiauswahl lässt Dateien aus, die auf .gitignore-Muster passen
  • false: Die @-Dateiauswahl schließt Dateien ein, die auf .gitignore-Muster passen
• Standard: true

{
  "respectGitignore": false
}

respondToBashCommands

Legen Sie fest, ob Claude antwortet, nachdem Sie einen Shell-Befehl mit dem !-Präfix im Eingabefeld ausgeführt haben. Standardmäßig fügt Claude Code die Ausgabe des Befehls der Konversation hinzu, und Claude antwortet darauf. Setzen Sie diesen Schlüssel auf false, um die Ausgabe ohne Antwort dem Kontext hinzuzufügen, sodass Sie mehrere Befehle ausführen und gemeinsam danach fragen können.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Claude Code fügt die Ausgabe des Befehls der Konversation hinzu, und Claude antwortet darauf
  • false: Claude Code fügt die Ausgabe ohne Antwort dem Kontext hinzu
• Standard: true

{
  "respondToBashCommands": false
}

Siehe Shell-Modus mit !-Präfix.

showClearContextOnPlanAccept

Wenn Claude im Plan-Modus einen Plan fertigstellt, zeigt es ein Genehmigungsmenü an. Das Planen kann viel Kontext verbrauchen, daher fügt dieser Schlüssel dem Menü eine erste Option hinzu, Yes, clear context and …, die den Plan genehmigt, den Konversationskontext leert und die Implementierung allein auf Grundlage des Plans beginnt. Der Rest der Beschriftung nennt den Berechtigungsmodus, in dem die Sitzung fortgesetzt wird, und zeigt, wie viel Ihres Kontexts das Planen verbraucht hat.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Das Menü zur Plan-Genehmigung erhält eine erste Option, Yes, clear context and …, die den Plan genehmigt und den Konversationskontext leert
  • false: Das Menü zur Plan-Genehmigung zeigt keine Option zum Leeren des Kontexts
• Standard: false

{
  "showClearContextOnPlanAccept": true
}

showTurnDuration

Die Meldung zur Turn-Dauer nach jeder Antwort anzeigen oder ausblenden, etwa „Cooked for 1m 6s · done 6:05 PM“. Die Uhrzeit nach „done“ zeigt, wann der Turn beendet wurde; timeFormat und timeZone steuern ihr Format und ihre Zeitzone. Erscheint in /config als Show turn duration.

• Geltungsbereich: Any file. Ein Wert in ~/.claude.json aus einer älteren Version gilt, wenn keine Einstellungsdatei den Schlüssel setzt.
• Typ: Boolean
  • true: Sie sehen nach jeder Antwort die Meldung zur Turn-Dauer
  • false: Claude Code blendet die Meldung zur Turn-Dauer aus
• Standard: true

{
  "showTurnDuration": false
}

spellcheck

Falsch geschriebene Wörter in der Prompt-Eingabe während der Eingabe unterstreichen, mithilfe einer von Ihnen installierten Rechtschreibprüfung. Claude Code prüft nur den Text im Eingabefeld. Rechtschreibung während der Eingabe prüfen behandelt die Installation von aspell, hunspell oder ispell und was die Prüfung abdeckt. Erfordert Claude Code v2.1.235 oder höher.

• Geltungsbereich: User or managed. Der Block aus der höchsten Ebene, die den Schlüssel setzt, gilt als Ganzes.
• Typ: Objekt mit enabled (Boolean), checker ("aspell", "hunspell", "ispell" oder "auto"), language (String, wird an die Prüfung als Name ihres Wörterbuchs übergeben) und color (String, ein Terminal-Farbname, #rrggbb, rgb(r,g,b), ansi256(n) oder ansi:<name>)
• Standard: nicht gesetzt, daher ist die Rechtschreibprüfung aus; checker ist standardmäßig "auto", also die erste der drei Prüfungen, die auf dem PATH gefunden wird; language ist standardmäßig das eigene Wörterbuch der Prüfung; color ist standardmäßig die Fehlerfarbe des Themes

{
  "spellcheck": { "enabled": true, "language": "en_GB" }
}

spinnerTipsEnabled

Während Claude arbeitet, zeigt die Spinner-Zeile abwechselnd kurze Tipps zu Funktionen von Claude Code an, etwa „Use Plan Mode to prepare for a complex request before making changes. Press Shift+Tab twice to enable.“ Setzen Sie diesen Schlüssel auf false, um sie auszublenden. Erscheint in /config als Show tips.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Sie sehen Tipps im Spinner, während Claude arbeitet
  • false: Claude Code blendet Spinner-Tipps aus
• Standard: true

{
  "spinnerTipsEnabled": false
}

spinnerTipsOverride

Eigene Tipps zu den Spinner-Tipps hinzufügen, die Claude Code anzeigt, während Claude arbeitet, oder die integrierten Tipps durch Ihre ersetzen. Claude Code nimmt Ihre Tipps in dieselbe Rotation auf wie die integrierten.

Wenn Sie spinnerTipsEnabled auf false setzen, blendet Claude Code alle Tipps aus, auch Ihre.

• Geltungsbereich: Any file. Claude Code berücksichtigt Tipp-Objekte, tipsFile, label und excludeDefault aus den Benutzereinstellungen, dem Flag --settings und verwalteten Einstellungen; aus Projekt- und lokalen Einstellungen liest es nur einfache String-Tipps.
• Typ: Objekt mit den Feldern tips, tipsFile, label und excludeDefault, jeweils optional
• Standard: nicht gesetzt, daher zeigt Claude Code nur die integrierten Tipps

Tipp-Objekte, tipsFile, label und die Regel aus der Zeile zum Geltungsbereich, dass Projekt- und lokale Einstellungen nur einfache Strings beitragen, erfordern Claude Code v2.1.247 oder höher.

Jeder tips-Eintrag ist ein einfacher String oder ein Objekt mit diesen Feldern:

Claude Code liest einen einfachen String als Tipp mit diesen Standardwerten und einer positionsbasierten ID, sodass sein Anzeigeverlauf zurückgesetzt wird, wenn Sie die Liste umsortieren. Geben Sie einem Tipp eine id, um seinen Verlauf über Bearbeitungen hinweg zu behalten.

Claude Code liest höchstens 200 Tipps aus tips und tipsFile zusammen und verwirft einen ungültigen Eintrag mit einer Debug-Warnung, statt die Einstellungsdatei abzulehnen.

Verwenden Sie die übrigen Felder, um eine Tipp-Datei anzugeben, das Präfix festzulegen und die integrierten Tipps auszublenden:

• tipsFile: ein absoluter oder mit ~/ beginnender Pfad zu einer lokalen JSON-Datei, die ein Array derselben Einträge oder ein Objekt mit einem tips-Array enthält, bis zu 256 KB. Claude Code liest die Datei einmal pro Prozess, daher lädt es Ihre Änderungen beim nächsten Start. Sie können sie nicht über serververwaltete Einstellungen festlegen; stellen Sie dort Inline-tips bereit, oder stellen Sie den Pfad in einer managed-settings.json auf dem Datenträger bereit.
• label: das Präfix, das Claude Code vor Tipps aus Benutzereinstellungen, --settings und verwalteten Einstellungen anzeigt, bis zu 40 Zeichen. Der Standard ist Tip, dasselbe Präfix wie bei den integrierten Tipps, und Tipps aus Projekt- und lokalen Einstellungen verwenden es immer.
• excludeDefault: Setzen Sie es auf true, um die integrierten Tipps auszublenden und nur Ihre anzuzeigen. Wenn Claude Code keinen Ihrer Tipps laden kann, zum Beispiel weil tipsFile nicht existiert oder jeder Eintrag ungültig ist, behält es die integrierte Rotation bei, statt einen leeren Spinner anzuzeigen.

Wenn mehr als eine Einstellungsdatei den Schlüssel setzt, zeigt Claude Code Tipps aus allen an und übernimmt tipsFile, label und excludeDefault jeweils aus derjenigen der verwalteten Einstellungen, des Flags --settings und der Benutzereinstellungen, die den höchsten Vorrang hat und das jeweilige Feld setzt.

Dieses Beispiel in Ihren Benutzereinstellungen fügt der Rotation einen einfachen String-Tipp und einen Objekt-Tipp unter dem Präfix Acme tip hinzu:

{
  "spinnerTipsOverride": {
    "label": "Acme tip",
    "tips": [
      "Run /review before opening a PR",
      {
        "id": "gateway-errors",
        "text": "Seeing 5xx errors? Check the gateway status page first",
        "cooldownSessions": 5,
        "priority": 2
      }
    ]
  }
}

Jedes Feld im Beispiel ändert einen Aspekt daran, wie Claude Code die Tipps anzeigt:

• label: Claude Code zeigt beide Tipps als Acme tip: ... statt Tip: ... an.
• Der einfache String: Claude Code gibt ihm die Standardwerte, daher kann er gleich in der nächsten Sitzung wieder erscheinen.
• id: Claude Code verknüpft den Anzeigeverlauf des zweiten Tipps mit gateway-errors, sodass seine Wartezeit weiterhin gilt, nachdem Sie Tipps hinzufügen oder umsortieren.
• cooldownSessions: Nachdem Claude Code den Tipp gateway-errors angezeigt hat, zeigt es ihn erst fünf Sitzungen später wieder an.
• priority: Wenn der Tipp gateway-errors und ein anderer Tipp gleich viele Sitzungen lang nicht angezeigt wurden, zum Beispiel wenn noch keiner von beiden angezeigt wurde, zeigt Claude Code gateway-errors zuerst an. Der einfache String hat die Standardpriorität 0.

Während Claude arbeitet, zeigt Claude Code Ihre Tipps im Spinner mit Ihrem Präfix an, etwa Acme tip: Run /review before opening a PR.

spinnerVerbs

Während ein Turn läuft, zeigt der Spinner ein wechselndes Verb wie „Accomplishing“, „Architecting“ oder „Baking“. Verwenden Sie diesen Schlüssel, um dieser Rotation eigene Verben hinzuzufügen oder die integrierte Liste durch Ihre zu ersetzen.

• Geltungsbereich: Any file
• Typ: Objekt mit einem Array verbs aus Strings und mode, einer von:
  • "append": Claude Code fügt Ihre Verben zum integrierten Satz hinzu
  • "replace": Claude Code zeigt nur Ihre Verben
• Standard: nicht gesetzt, daher verwendet Claude Code die integrierten Verben

Dieses Beispiel fügt dem integrierten Satz zwei Verben hinzu:

{
  "spinnerVerbs": {
    "mode": "append",
    "verbs": ["Pondering", "Crafting"]
  }
}

Im Modus "replace" mit einem leeren Array verbs behält Claude Code die integrierten Verben bei.

statusLine

Einen eigenen Befehl ausführen, um unterhalb des Prompts eine Statuszeile mit Kontext wie dem Modell, den Kosten oder dem Git-Branch zu rendern. Optionale Felder passen den Abstand an, fügen periodische erneute Ausführungen hinzu und blenden die integrierte vim-Modusanzeige aus, wenn Ihr Skript vim.mode selbst rendert.

• Geltungsbereich: Any file. Wenn allowManagedHooksOnly eingeschaltet ist oder disableAllHooks außerhalb verwalteter Einstellungen gesetzt ist, wird nur der Wert aus den verwalteten Einstellungen ausgeführt.
• Typ: Objekt mit type auf "command" gesetzt und einem String command, dazu optional padding als Anzahl von Zeichen, refreshInterval als Anzahl von Sekunden, mindestens 1, und hideVimModeIndicator als Boolean
• Standard: nicht gesetzt, daher keine Statuszeile

Dieses Beispiel gibt den Modellnamen und die Kontextnutzung aus und fügt zwei Zeichen horizontalen Abstand hinzu:

{
  "statusLine": {
    "type": "command",
    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'",
    "padding": 2
  }
}

Das Beispiel erfordert ein installiertes jq und läuft in einer Shell. Entsprechungen für PowerShell und Git Bash finden Sie unter Windows-Konfiguration; die vollständige Einrichtung finden Sie unter Eine Statuszeile manuell konfigurieren.

subagentStatusLine

Wenn Claude Subagenten ausführt, listet Claude Code sie in einer Aufgabenanzeige unterhalb des Prompts auf, eine Zeile pro Subagent mit name · description · token count. Mit diesem Schlüssel können Sie einen eigenen Befehl ausführen, um diese Zeilen umzuschreiben, zum Beispiel um die Kontextnutzung jedes Subagenten als Prozentsatz anzuzeigen. Bei jeder Aktualisierung sendet Claude Code die sichtbaren Zeilen als ein JSON-Objekt auf stdin, mit einem Array tasks, das für jeden Subagenten id, name, status, model, tokenCount und mehr enthält, und ersetzt die Zeile für jede id, die Sie als {"id", "content"}-Zeile zurückschreiben. Zeilen, die Sie nicht zurückschreiben, behalten die Standarddarstellung.

• Geltungsbereich: Any file. Wenn allowManagedHooksOnly eingeschaltet ist oder disableAllHooks außerhalb verwalteter Einstellungen gesetzt ist, wird nur der Wert aus den verwalteten Einstellungen ausgeführt.
• Typ: Objekt mit type auf "command" gesetzt und einem String command
• Standard: nicht gesetzt, daher rendert Claude Code die Standardzeilen

{
  "subagentStatusLine": {
    "type": "command",
    "command": "jq -c '.tasks[] | {id, content: \"\\(.name): \\(.tokenCount) tokens\"}'"
  }
}

Siehe Statuszeilen für Subagenten.

syntaxHighlightingDisabled

Claude Code färbt Code in den Diffs, Codeblöcken und Dateivorschauen, die es im Terminal anzeigt, mit seinem integrierten Highlighter sprachabhängig ein; dabei ist weder ein Plugin noch ein Language Server beteiligt. Setzen Sie diesen Schlüssel auf true, um sie stattdessen als einfachen Text anzuzeigen, zum Beispiel wenn die Farben nicht zu Ihrem Terminal-Theme passen oder einen Screenreader verlangsamen.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Claude Code schaltet die Syntaxhervorhebung in Diffs, Codeblöcken und Dateivorschauen aus
  • false: Claude Code hebt die Syntax hervor
• Standard: false

{
  "syntaxHighlightingDisabled": true
}

terminalProgressBarEnabled

Manche Terminals können für das darin laufende Programm eine Fortschrittsanzeige auf dem Tab oder in der Taskleiste anzeigen. Während Claude arbeitet, meldet Claude Code dem Terminal einen laufenden Zustand, sodass Sie von einem anderen Tab oder Fenster aus sehen können, ob die Sitzung noch beschäftigt ist. Die Anzeige bleibt nach dem Ende des Turns sichtbar, solange Hintergrund-Subagenten oder dynamische Workflows noch laufen, und verschwindet, sobald die Sitzung im Leerlauf ist.

Claude Code meldet sie nur in Terminals, die die Anzeige unterstützen: ConEmu, Ghostty 1.2.0 oder höher und iTerm2 3.6.6 oder höher. Setzen Sie diesen Schlüssel auf false, damit Claude Code sie nicht mehr meldet. Erscheint in /config als Terminal progress bar.

• Geltungsbereich: Any file. Ein Wert in ~/.claude.json aus einer älteren Version gilt, wenn keine Einstellungsdatei den Schlüssel setzt.
• Typ: Boolean
  • true: Sie sehen die Terminal-Fortschrittsanzeige in Terminals, die sie unterstützen
  • false: Claude Code blendet die Terminal-Fortschrittsanzeige aus
• Standard: true

{
  "terminalProgressBarEnabled": false
}

terminalTitleFromRename

Claude Code setzt den Titel Ihres Terminal-Tabs. Standardmäßig verwendet es einen Titel, den es aus der Konversation generiert, und sobald Sie der Sitzung mit /rename oder --name einen Namen geben, zeigt der Tab stattdessen diesen Namen. Setzen Sie diesen Schlüssel auf false, um den generierten Titel auf dem Tab zu behalten, auch nachdem Sie die Sitzung benannt haben. Der Name selbst gilt weiterhin, sodass /resume <name> und die Sitzungsauswahl ihn finden.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Der Titel des Terminal-Tabs zeigt den von Ihnen festgelegten Sitzungsnamen
  • false: Der Tab behält den Titel, den Claude Code aus Ihrer Konversation generiert
• Standard: true

{
  "terminalTitleFromRename": false
}

Damit Claude Code den Terminaltitel überhaupt nicht mehr aktualisiert, setzen Sie stattdessen CLAUDE_CODE_DISABLE_TERMINAL_TITLE auf 1.

theme

Das Farbschema für die Oberfläche wählen. Erscheint in /config als Theme.

• Geltungsbereich: Any file. Ein Wert in ~/.claude.json aus einer älteren Version gilt, wenn keine Einstellungsdatei den Schlüssel setzt.
• Typ: String, einer von:
  • "auto": passt sich dem hellen oder dunklen Hintergrund Ihres Terminals an
  • "dark": das dunkle Theme
  • "light": das helle Theme
  • "dark-daltonized": das dunkle Theme mit farbenblindfreundlichen Farben
  • "light-daltonized": das helle Theme mit farbenblindfreundlichen Farben
  • "dark-ansi": das dunkle Theme, das nur die ANSI-Farbpalette Ihres Terminals verwendet
  • "light-ansi": das helle Theme, das nur die ANSI-Farbpalette Ihres Terminals verwendet
  • "custom:<slug>" oder "custom:<plugin-name>:<slug>": ein benutzerdefiniertes Theme aus ~/.claude/themes/ oder aus einem Plugin
• Standard: "dark"

{
  "theme": "light-daltonized"
}

Siehe Ein benutzerdefiniertes Theme erstellen.

timeFormat

Legen Sie fest, wie Claude Code die Uhrzeiten schreibt, die es in der Oberfläche anzeigt, etwa done 6:05 PM am Ende jeder Meldung zur Turn-Dauer und die Zeitstempel im Transkript-Viewer. Um eine Vorgabe auszuwählen, führen Sie /config aus und setzen Time format. Erfordert Claude Code v2.1.257 oder höher.

• Geltungsbereich: Any file
• Typ: String, einer von:
  • "auto": wie nicht gesetzt; jede Uhrzeit behält ihr integriertes Format, das bei der Meldung zur Turn-Dauer Ihrem Gebietsschema folgt
  • "12-hour": eine 12-Stunden-Uhr
  • "24-hour": eine 24-Stunden-Uhr
  • "24-hour-utc": eine 24-Stunden-Uhr in UTC mit Z nach den Minuten, etwa 18:05Z; Claude Code ignoriert timeZone für diese Vorgabe
  • Ein strftime-Muster wie "%H:%M": Claude Code schreibt jede Uhrzeit mit dem Muster. Jeder Wert, der ein % enthält, ist ein Muster, und jeder andere Wert außerhalb der Vorgaben zählt als "auto"
• Standard: "auto"

{
  "timeFormat": "24-hour"
}

/config bietet nur die Vorgaben an; um ein strftime-Muster zu verwenden, fügen Sie den Schlüssel daher einer Einstellungsdatei hinzu. Dieses Beispiel zeigt jede Uhrzeit als zweistellige 24-Stunden-Uhr:

{
  "timeFormat": "%H:%M"
}

Die Meldung zur Turn-Dauer und der Transkript-Viewer zeigen dann Uhrzeiten wie 18:05. Im Transkript-Viewer bildet das Muster den gesamten Zeitstempel, fügen Sie daher Datumsdirektiven hinzu, wenn Sie dort das Datum sehen möchten. Dieses Beispiel stellt das Datum vor die Uhrzeit:

{
  "timeFormat": "%Y-%m-%d %H:%M"
}

Dieselben Oberflächen zeigen dann Uhrzeiten wie 2026-09-01 18:05.

timeZone

Die Uhrzeiten in der Oberfläche in einer anderen Zeitzone als der Ihres Systems anzeigen. Setzen Sie den Schlüssel auf einen IANA-Zeitzonennamen, etwa "UTC" oder "Europe/Dublin". Die Uhrzeiten, die timeFormat steuert, werden dann in dieser Zone angezeigt. Wenn timeFormat auf "24-hour-utc" steht, bleiben die Uhrzeiten in UTC, und Claude Code ignoriert diesen Schlüssel. /config hat keine Zeile für diesen Schlüssel, setzen Sie ihn daher in einer Einstellungsdatei. Erfordert Claude Code v2.1.257 oder höher.

• Geltungsbereich: Any file
• Typ: String, ein IANA-Zeitzonenname. Wenn Claude Code den Namen nicht erkennt, verwendet es Ihre Systemzeitzone
• Standard: nicht gesetzt, daher werden Uhrzeiten in Ihrer Systemzeitzone angezeigt

{
  "timeZone": "Europe/Dublin"
}

tui

Den Renderer der Terminal-Oberfläche wählen. Verwenden Sie "fullscreen" für den flackerfreien Alt-Screen-Renderer mit virtualisiertem Scrollback oder "default" für den klassischen Main-Screen-Renderer. Wenn Sie /tui fullscreen oder /tui default ausführen, wird dieser Schlüssel für Sie geschrieben.

• Geltungsbereich: Any file
• Typ: String, einer von:
  • "default": der klassische Main-Screen-Renderer
  • "fullscreen": der flackerfreie Alt-Screen-Renderer mit virtualisiertem Scrollback
• Standard: nicht gesetzt, daher wählt Claude Code den Renderer für Sie
• Überschreibungen pro Sitzung: CLAUDE_CODE_NO_FLICKER und CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN haben für eine Sitzung Vorrang vor diesem Schlüssel: CLAUDE_CODE_NO_FLICKER=1 schaltet den Vollbildmodus ein, und CLAUDE_CODE_NO_FLICKER=0 oder CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 schaltet ihn aus; wenn beide gesetzt sind, schaltet Claude Code ihn aus

{
  "tui": "fullscreen"
}

Unter tmux -CC oder über SSH zu Windows behält Claude Code den klassischen Renderer bei, sofern Sie nicht CLAUDE_CODE_NO_FLICKER=1 setzen. Hintergrundsitzungen, die aus der Agentenansicht geöffnet werden, verwenden unabhängig von dieser Einstellung immer den Vollbild-Renderer.

verbose

Standardmäßig fasst das Transkript jeden Tool-Aufruf zu einer kurzen Zusammenfassung zusammen, etwa dem Befehl, den Claude ausgeführt hat, und der Zeilenanzahl seiner Ausgabe, und Sie drücken Ctrl+O, um das gesamte Transkript in die erweiterte Ansicht umzuschalten, wenn Sie die Details sehen möchten. Setzen Sie diesen Schlüssel auf true, um die vollständige Ein- und Ausgabe jedes Tool-Aufrufs direkt beim Auftreten inline anzuzeigen, was beim Debugging eines Hooks, eines MCP-Servers oder eines langen Shell-Befehls nützlich ist. Erscheint in /config als Verbose output.

• Geltungsbereich: Any file. Ein Wert in ~/.claude.json aus einer älteren Version gilt, wenn keine Einstellungsdatei den Schlüssel setzt.
• Typ: Boolean
  • true: Sie sehen die vollständige Tool-Ausgabe
  • false: Sie sehen gekürzte Zusammenfassungen der Tool-Ausgabe
• Standard: false
• Überschreibungen pro Sitzung: --verbose hat für eine Sitzung Vorrang vor diesem Schlüssel

{
  "verbose": true
}

Ein viewMode-Wert oder eine dauerhafte /focus-Auswahl überschreibt diesen Schlüssel in jeder Sitzung.

viewMode

Die Transkriptansicht festlegen, mit der Claude Code startet: "default", "verbose" oder "focus". Wenn gesetzt, überschreibt der Schlüssel sowohl die dauerhafte /focus-Auswahl als auch die Einstellung verbose.

• Geltungsbereich: Any file
• Typ: String, einer von:
  • "default": das normale Transkript mit gekürzter Tool-Ausgabe
  • "verbose": das Transkript mit vollständiger Tool-Ausgabe
  • "focus": nur Ihr letzter Prompt, eine einzeilige Zusammenfassung der Tool-Aufrufe mit Diffstats der Bearbeitungen und die abschließende Antwort. Die Fokusansicht erfordert den Vollbild-Renderer
• Standard: nicht gesetzt, daher gelten die Einstellung verbose und Ihre letzte /focus-Auswahl
• Überschreibungen pro Sitzung: --verbose hat für eine Sitzung Vorrang vor diesem Schlüssel

{
  "viewMode": "focus"
}

vimInsertModeRemaps

Zwei-Tasten-Sequenzen im INSERT-Modus im vim-Editor-Modus auf Escape abbilden. Jeder Schlüssel besteht aus genau zwei druckbaren Zeichen, die nacheinander eingegeben werden, und "<Esc>" ist das einzige unterstützte Ziel; Claude Code ignoriert andere Einträge.

• Geltungsbereich: User or managed. Ein Repository kann Ihre Tastenanschläge nicht umbelegen.
• Typ: Objekt, das eine Sequenz aus zwei Zeichen auf "<Esc>" abbildet
• Standard: nicht gesetzt

{
  "vimInsertModeRemaps": {
    "jj": "<Esc>"
  }
}

Hat keine Wirkung, sofern editorMode nicht "vim" ist. Siehe Tastensequenzen im INSERT-Modus umbelegen.

voice

Sprachdiktat einschalten und festlegen, wie sich die Diktiertaste verhält. Claude Code schreibt dieses Objekt für Sie, wenn Sie /voice ausführen.

• Geltungsbereich: Any file
• Typ: Objekt mit enabled als Boolean, autoSubmit als Boolean, das nur im Haltemodus gilt, und mode, einer von:
  • "hold": Sie halten die Diktiertaste beim Sprechen gedrückt und lassen sie los, um zu stoppen
  • "tap": Sie tippen die Taste einmal an, um die Aufnahme zu starten, und erneut, um zu senden
• Standard: nicht gesetzt, daher ist das Diktat aus; wenn enabled auf true steht und mode nicht gesetzt ist, verwendet Claude Code "hold"

Dieses Beispiel schaltet das Diktat ein und legt fest, dass die Taste einmal angetippt wird, um die Aufnahme zu starten, und erneut, um zu senden:

{
  "voice": {
    "enabled": true,
    "mode": "tap"
  }
}

autoSubmit sendet den Prompt, wenn Sie die Taste im Haltemodus loslassen. Sprachdiktat erfordert ein claude.ai-Konto.

voiceEnabled

[!WARNING]

Seit v2.1.92 veraltet, als das Objekt voice diesen Schlüssel ersetzt hat. Claude Code liest ihn weiterhin, damit ältere Einstellungsdateien funktionieren, neue Konfigurationen sollten jedoch voice.enabled setzen.

Sprachdiktat mit der einfachen Boolean-Form einschalten, die älter ist als das Objekt voice. Wenn beide gesetzt sind, gilt voice.enabled.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Sprachdiktat ist eingeschaltet, wenn Sie mit einem claude.ai-Konto angemeldet sind und die Richtlinie Ihrer Organisation Sprache zulässt, sofern voice.enabled nicht gesetzt ist
  • false: Sprachdiktat ist ausgeschaltet, sofern voice.enabled nicht gesetzt ist
• Standard: nicht gesetzt

{
  "voiceEnabled": true
}

wheelScrollAccelerationEnabled

Die Scrollgeschwindigkeit des Mausrads bei schnellem Scrollen im Vollbild-Rendering beschleunigen. Setzen Sie den Schlüssel auf false für eine konstante Scrollrate pro Mausradraste.

• Geltungsbereich: Any file
• Typ: Boolean
  • true: Claude Code beschleunigt die Scrollgeschwindigkeit des Mausrads bei schnellem Scrollen
  • false: Claude Code scrollt mit einer konstanten Rate pro Mausradraste
• Standard: true

{
  "wheelScrollAccelerationEnabled": false
}

Git und Zuordnung

Steuern Sie die Zuordnung, die Claude Code zu Commits und Pull Requests hinzufügt, und wie sie mit Git funktioniert.

attribution

Passen Sie die Zuordnung an, die Claude Code zu Git-Commits und Pull Requests hinzufügt. Commits erhalten standardmäßig einen Git-Trailer wie Co-Authored-By; Pull-Request-Beschreibungen erhalten Klartext. Legen Sie jeden Teil separat mit den folgenden Unterschlüsseln fest.

• Bereich: Any file
• Typ: Objekt mit commit- und pr-Zeichenketten und einem sessionUrl-Boolean, oder false, um alle Zuordnungen auszublenden. Der Wert false erfordert Claude Code v2.1.281 oder später; frühere Versionen lehnen ihn ab und überspringen die gesamte Benutzer-, Projekt- oder lokale Einstellungsdatei, die ihn enthält
• Standard: nicht gesetzt, daher verwendet Claude Code die unter jedem Unterschlüssel angezeigte Standard-Zuordnung

Um alle Zuordnungen auszublenden, setzen Sie attribution auf false. In einer Einstellungsdatei, die auch frühere Versionen lesen, setzen Sie stattdessen commit und pr auf leere Zeichenketten und sessionUrl auf false.

Dieses Beispiel ersetzt die Commit-Zuordnung, entfernt die Pull-Request-Zuordnung und löscht den Sitzungslink:

{
  "attribution": {
    "commit": "Generated with AI\n\nCo-Authored-By: AI <ai@example.com>",
    "pr": "",
    "sessionUrl": false
  }
}

Sobald Sie commit oder pr setzen, ignoriert Claude Code die veraltete Einstellung includeCoAuthoredBy und verwendet seinen Standard-Text für denjenigen der beiden, den Sie nicht gesetzt haben.

Claude Code teilt Claude mit, dass Ihre eigenen Anweisungen zur Zuordnung, wie eine CLAUDE.md oder Memory-Regel, Vorrang vor diesen Commit- und PR-Zeilen haben, es sei denn, die Zeile ist in verwalteten Einstellungen gesetzt.

includeCoAuthoredBy

[!WARNING]

Veraltet seit v2.0.62, als attribution es ersetzte. Claude Code liest es immer noch, aber neue Konfigurationen sollten attribution setzen.

Verwenden Sie stattdessen attribution, das diesen Schlüssel ersetzt und es Ihnen ermöglicht, den Commit-Trailer, den Pull-Request-Text und den Sitzungslink separat zu ändern oder auszublenden. Claude Code respektiert immer noch includeCoAuthoredBy: false aus Einstellungsdateien, die attribution vorausgehen, ignoriert es aber, sobald Sie attribution.commit oder attribution.pr setzen.

• Bereich: Any file
• Typ: Boolean
  • true: dasselbe wie nicht gesetzt; Claude Code fügt den Commit-Trailer und den Pull-Request-Zuordnungstext hinzu
  • false: Claude Code lässt sowohl den Commit-Trailer als auch den Pull-Request-Zuordnungstext weg, es sei denn, attribution setzt commit oder pr, in welchem Fall die attribution-Regeln gelten
• Standard: true

{
  "includeCoAuthoredBy": false
}

Um alle Zuordnungen auszublenden, siehe attribution.

includeGitInstructions

Claude Code gibt Claude zwei Git-bezogene Kontextteile: seine integrierten Anweisungen zum Schreiben von Commits und Pull Requests in der Bash-Tool-Beschreibung und einen Git-Status-Snapshot Ihres Repositorys. Der Snapshot enthält den aktuellen Branch, den Haupt-Branch, die Ausgabe von git status und aktuelle Commits. Claude Code liest ihn, wenn eine Konversation beginnt.

Setzen Sie diesen Schlüssel auf false, um beide auszulassen, zum Beispiel wenn Sie Ihre eigenen Git-Workflow-Skills verwenden.

• Bereich: Any file
• Typ: Boolean
  • true: Claude Code enthält seine integrierten Commit- und Pull-Request-Workflow-Anweisungen und den Git-Status-Snapshot. Cloud-Sitzungen enthalten niemals den Snapshot
  • false: Claude Code lässt beide aus
• Standard: true
• Sitzungsspezifische Überschreibungen: CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS hat Vorrang vor diesem Schlüssel für eine Sitzung

{
  "includeGitInstructions": false
}

Wenn Sie den System-Prompt im nicht interaktiven Modus oder im Agent SDK ersetzen, startet die Sitzung ohne den Snapshot, auch wenn dieser Schlüssel true ist:

• -p-Ausführungen: Sie ersetzen den Prompt, wenn Sie --system-prompt oder --system-prompt-file übergeben. Sie ersetzen ihn auch, wenn Sie einen benutzerdefinierten Agenten mit eigenem Prompt ausführen, ausgewählt mit --agent oder der Einstellung agent. Um den Snapshot außerhalb des Bare-Modus beizubehalten, führen Sie die Sitzung ohne benutzerdefinierten Agenten aus und fügen Ihre Anweisungen mit --append-system-prompt hinzu, anstatt den Prompt zu ersetzen.
• Agent SDK: Sie ersetzen den Prompt durch einen benutzerdefinierten System-Prompt oder einen benutzerdefinierten Hauptthread-Agenten. Wenn Sie keinen System-Prompt festlegen, verwendet das SDK seinen minimalen Standard, und die Sitzung startet ebenfalls ohne den Snapshot. Um den Snapshot außerhalb des Bare-Modus beizubehalten, verwenden Sie das Preset claude_code ohne benutzerdefinierten agent.

prUrlTemplate

Richten Sie die PR-Links, die Claude Code in der Fußzeilenbadge und in Tool-Ergebnis-Zusammenfassungen rendert, auf ein internes Code-Review-Tool statt auf github.com aus. Claude Code ersetzt {host}, {owner}, {repo}, {number} und {url} aus der PR-URL. GitLab-Merge-Request-Links auf beiden Oberflächen behalten ihre GitLab-URL.

• Bereich: Any file
• Typ: Zeichenkette, eine URL-Vorlage mit einem der fünf Platzhalter
• Standard: nicht gesetzt

{
  "prUrlTemplate": "https://reviews.example.com/{owner}/{repo}/pull/{number}"
}

Claude Code wendet die Vorlage nur auf die Links an, die es selbst rendert; eine PR-Nummer, die Claude in einer Nachricht schreibt, wie #123, bleibt so, wie Claude sie geschrieben hat. Eine URL, die nicht die Form /pull/<number> hat, wird unverändert gelassen.

attribution.commit

Legen Sie den Zuordnungstext fest, den Claude Code zu Git-Commits hinzufügt, einschließlich aller Trailer. Setzen Sie ihn auf eine leere Zeichenkette, um die Commit-Zuordnung auszublenden.

• Bereich: Any file
• Typ: Zeichenkette
• Standard: nicht gesetzt, daher fügt Claude Code Co-Authored-By: <name> <noreply@anthropic.com> hinzu. Der Name ist das Modell, das beim Erstellen des Commits verwendet wird, wie Claude Sonnet 5. Wenn ein Subagent den Commit erstellt, nennt der Trailer das Modell des Subagenten.
  • Wenn Claude Code das Modell als Claude-Modell erkennt, aber seine genaue Version nicht bestätigen kann, schreibt es nur Claude.
  • Wenn es die Modell-ID nicht mit einem Claude-Modell abgleichen kann, wie ein Drittanbieter-Modell, das über eine benutzerdefinierte ANTHROPIC_BASE_URL bereitgestellt wird, schreibt es Claude Code.

Dieses Beispiel ersetzt den Standard-Trailer durch eine benutzerdefinierte Zeile und einen benutzerdefinierten Co-Authored-By-Trailer:

{
  "attribution": {
    "commit": "Generated with AI\n\nCo-Authored-By: AI <ai@example.com>"
  }
}