Konfigurieren Sie Claude Code mit globalen und projektspezifischen Einstellungen sowie Umgebungsvariablen.
/config
ausführen, wenn Sie die interaktive REPL verwenden.
settings.json
ist unser offizieller Mechanismus zur Konfiguration von Claude
Code durch hierarchische Einstellungen:
~/.claude/settings.json
definiert und gelten für alle
Projekte..claude/settings.json
für Einstellungen, die in die Versionskontrolle eingecheckt und mit Ihrem Team geteilt werden.claude/settings.local.json
für Einstellungen, die nicht eingecheckt werden, nützlich für persönliche Präferenzen und Experimente. Claude Code wird git so konfigurieren, dass .claude/settings.local.json
ignoriert wird, wenn es erstellt wird./Library/Application Support/ClaudeCode/managed-settings.json
/etc/claude-code/managed-settings.json
C:\ProgramData\ClaudeCode\managed-settings.json
settings.json
unterstützt eine Reihe von Optionen:
Schlüssel | Beschreibung | Beispiel |
---|---|---|
apiKeyHelper | Benutzerdefiniertes Skript, das in /bin/sh ausgeführt wird, um einen Auth-Wert zu generieren. Dieser Wert wird als X-Api-Key und Authorization: Bearer Header für Modellanfragen gesendet | /bin/generate_temp_api_key.sh |
cleanupPeriodDays | Wie lange Chat-Transkripte lokal basierend auf dem letzten Aktivitätsdatum aufbewahrt werden (Standard: 30 Tage) | 20 |
env | Umgebungsvariablen, die auf jede Sitzung angewendet werden | {"FOO": "bar"} |
includeCoAuthoredBy | Ob die co-authored-by Claude Byline in Git-Commits und Pull-Requests eingeschlossen werden soll (Standard: true ) | false |
permissions | Siehe Tabelle unten für die Struktur der Berechtigungen. | |
hooks | Konfigurieren Sie benutzerdefinierte Befehle, die vor oder nach Tool-Ausführungen ausgeführt werden. Siehe Hooks-Dokumentation | {"PreToolUse": {"Bash": "echo 'Running command...'"}} |
disableAllHooks | Alle Hooks deaktivieren | true |
model | Das Standardmodell für Claude Code überschreiben | "claude-3-5-sonnet-20241022" |
statusLine | Eine benutzerdefinierte Statuszeile zur Anzeige von Kontext konfigurieren. Siehe statusLine-Dokumentation | {"type": "command", "command": "~/.claude/statusline.sh"} |
outputStyle | Einen Ausgabestil konfigurieren, um die Systemaufforderung anzupassen. Siehe Ausgabestile-Dokumentation | "Explanatory" |
forceLoginMethod | Verwenden Sie claudeai , um die Anmeldung auf Claude.ai-Konten zu beschränken, console , um die Anmeldung auf Anthropic Console (API-Nutzungsabrechnung) Konten zu beschränken | claudeai |
forceLoginOrgUUID | Geben Sie die UUID einer Organisation an, um sie während der Anmeldung automatisch auszuwählen und den Organisationsauswahlschritt zu umgehen. Erfordert, dass forceLoginMethod gesetzt ist | "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" |
enableAllProjectMcpServers | Alle MCP-Server, die in Projekt-.mcp.json -Dateien definiert sind, automatisch genehmigen | true |
enabledMcpjsonServers | Liste spezifischer MCP-Server aus .mcp.json -Dateien, die genehmigt werden sollen | ["memory", "github"] |
disabledMcpjsonServers | Liste spezifischer MCP-Server aus .mcp.json -Dateien, die abgelehnt werden sollen | ["filesystem"] |
awsAuthRefresh | Benutzerdefiniertes Skript, das das .aws -Verzeichnis modifiziert (siehe erweiterte Anmeldedatenkonfiguration) | aws sso login --profile myprofile |
awsCredentialExport | Benutzerdefiniertes Skript, das JSON mit AWS-Anmeldedaten ausgibt (siehe erweiterte Anmeldedatenkonfiguration) | /bin/generate_aws_grant.sh |
Schlüssel | Beschreibung | Beispiel |
---|---|---|
allow | Array von Berechtigungsregeln, um Tool-Verwendung zu erlauben. Hinweis: Bash-Regeln verwenden Präfix-Matching, nicht Regex | [ "Bash(git diff:*)" ] |
ask | Array von Berechtigungsregeln, um bei Tool-Verwendung nach Bestätigung zu fragen. | [ "Bash(git push:*)" ] |
deny | Array von Berechtigungsregeln, um Tool-Verwendung zu verweigern. Verwenden Sie dies auch, um sensible Dateien vom Claude Code-Zugriff auszuschließen. Hinweis: Bash-Muster sind Präfix-Matches und können umgangen werden (siehe Bash-Berechtigungsbeschränkungen) | [ "WebFetch", "Bash(curl:*)", "Read(./.env)", "Read(./secrets/**)" ] |
additionalDirectories | Zusätzliche Arbeitsverzeichnisse, auf die Claude Zugriff hat | [ "../docs/" ] |
defaultMode | Standard-Berechtigungsmodus beim Öffnen von Claude Code | "acceptEdits" |
disableBypassPermissionsMode | Auf "disable" setzen, um zu verhindern, dass der bypassPermissions -Modus aktiviert wird. Siehe verwaltete Richtlinieneinstellungen | "disable" |
managed-settings.json
)
.claude/settings.local.json
)
.claude/settings.json
)
~/.claude/settings.json
)
/befehlsname
aufgerufen werden können--append-system-prompt
, um benutzerdefinierte Anweisungen zu Claude Codes Verhalten hinzuzufügen.permissions.deny
in Ihrer .claude/settings.json
-Datei:
ignorePatterns
-Konfiguration. Dateien, die diesen Mustern entsprechen, sind für Claude Code völlig unsichtbar und verhindern jede versehentliche Preisgabe sensibler Daten.
~/.claude/agents/
- Verfügbar in allen Ihren Projekten.claude/agents/
- Spezifisch für Ihr Projekt und können mit Ihrem Team geteilt werdensettings.json
konfiguriert werden. Dies ist nützlich als Möglichkeit, Umgebungsvariablen für jede Sitzung automatisch zu setzen oder eine Reihe von Umgebungsvariablen für Ihr gesamtes Team oder Ihre Organisation bereitzustellen.Variable | Zweck |
---|---|
ANTHROPIC_API_KEY | API-Schlüssel, der als X-Api-Key -Header gesendet wird, typischerweise für das Claude SDK (für interaktive Nutzung führen Sie /login aus) |
ANTHROPIC_AUTH_TOKEN | Benutzerdefinierter Wert für den Authorization -Header (der Wert, den Sie hier setzen, wird mit Bearer vorangestellt) |
ANTHROPIC_CUSTOM_HEADERS | Benutzerdefinierte Header, die Sie zur Anfrage hinzufügen möchten (im Format Name: Wert ) |
ANTHROPIC_DEFAULT_HAIKU_MODEL | Siehe Modellkonfiguration |
ANTHROPIC_DEFAULT_OPUS_MODEL | Siehe Modellkonfiguration |
ANTHROPIC_DEFAULT_SONNET_MODEL | Siehe Modellkonfiguration |
ANTHROPIC_MODEL | Name der zu verwendenden Modelleinstellung (siehe Modellkonfiguration) |
ANTHROPIC_SMALL_FAST_MODEL | [VERALTET] Name des Haiku-Klasse-Modells für Hintergrundaufgaben |
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION | AWS-Region für das Haiku-Klasse-Modell bei Verwendung von Bedrock überschreiben |
AWS_BEARER_TOKEN_BEDROCK | Bedrock-API-Schlüssel für Authentifizierung (siehe Bedrock-API-Schlüssel) |
BASH_DEFAULT_TIMEOUT_MS | Standard-Timeout für lang laufende Bash-Befehle |
BASH_MAX_OUTPUT_LENGTH | Maximale Anzahl von Zeichen in Bash-Ausgaben, bevor sie in der Mitte gekürzt werden |
BASH_MAX_TIMEOUT_MS | Maximaler Timeout, den das Modell für lang laufende Bash-Befehle setzen kann |
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR | Nach jedem Bash-Befehl zum ursprünglichen Arbeitsverzeichnis zurückkehren |
CLAUDE_CODE_API_KEY_HELPER_TTL_MS | Intervall in Millisekunden, in dem Anmeldedaten aktualisiert werden sollen (bei Verwendung von apiKeyHelper ) |
CLAUDE_CODE_CLIENT_CERT | Pfad zur Client-Zertifikatsdatei für mTLS-Authentifizierung |
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE | Passphrase für verschlüsselten CLAUDE_CODE_CLIENT_KEY (optional) |
CLAUDE_CODE_CLIENT_KEY | Pfad zur privaten Client-Schlüsseldatei für mTLS-Authentifizierung |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | Entspricht dem Setzen von DISABLE_AUTOUPDATER , DISABLE_BUG_COMMAND , DISABLE_ERROR_REPORTING und DISABLE_TELEMETRY |
CLAUDE_CODE_DISABLE_TERMINAL_TITLE | Auf 1 setzen, um automatische Terminal-Titel-Updates basierend auf Gesprächskontext zu deaktivieren |
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL | Auto-Installation von IDE-Erweiterungen überspringen |
CLAUDE_CODE_MAX_OUTPUT_TOKENS | Die maximale Anzahl von Ausgabe-Tokens für die meisten Anfragen festlegen |
CLAUDE_CODE_SKIP_BEDROCK_AUTH | AWS-Authentifizierung für Bedrock überspringen (z.B. bei Verwendung eines LLM-Gateways) |
CLAUDE_CODE_SKIP_VERTEX_AUTH | Google-Authentifizierung für Vertex überspringen (z.B. bei Verwendung eines LLM-Gateways) |
CLAUDE_CODE_SUBAGENT_MODEL | Siehe Modellkonfiguration |
CLAUDE_CODE_USE_BEDROCK | Bedrock verwenden |
CLAUDE_CODE_USE_VERTEX | Vertex verwenden |
DISABLE_AUTOUPDATER | Auf 1 setzen, um automatische Updates zu deaktivieren. Dies hat Vorrang vor der autoUpdates -Konfigurationseinstellung. |
DISABLE_BUG_COMMAND | Auf 1 setzen, um den /bug -Befehl zu deaktivieren |
DISABLE_COST_WARNINGS | Auf 1 setzen, um Kostenwarnmeldungen zu deaktivieren |
DISABLE_ERROR_REPORTING | Auf 1 setzen, um sich von Sentry-Fehlerberichterstattung abzumelden |
DISABLE_NON_ESSENTIAL_MODEL_CALLS | Auf 1 setzen, um Modellaufrufe für nicht-kritische Pfade wie Flavor-Text zu deaktivieren |
DISABLE_TELEMETRY | Auf 1 setzen, um sich von Statsig-Telemetrie abzumelden (beachten Sie, dass Statsig-Events keine Benutzerdaten wie Code, Dateipfade oder Bash-Befehle enthalten) |
HTTP_PROXY | HTTP-Proxy-Server für Netzwerkverbindungen angeben |
HTTPS_PROXY | HTTPS-Proxy-Server für Netzwerkverbindungen angeben |
MAX_MCP_OUTPUT_TOKENS | Maximale Anzahl von Tokens, die in MCP-Tool-Antworten erlaubt sind. Claude Code zeigt eine Warnung an, wenn die Ausgabe 10.000 Tokens überschreitet (Standard: 25000) |
MAX_THINKING_TOKENS | Ein Denkbudget für das Modell erzwingen |
MCP_TIMEOUT | Timeout in Millisekunden für MCP-Server-Start |
MCP_TOOL_TIMEOUT | Timeout in Millisekunden für MCP-Tool-Ausführung |
NO_PROXY | Liste von Domains und IPs, an die Anfragen direkt gestellt werden, unter Umgehung des Proxys |
USE_BUILTIN_RIPGREP | Auf 0 setzen, um system-installiertes rg anstelle des mit Claude Code enthaltenen rg zu verwenden |
VERTEX_REGION_CLAUDE_3_5_HAIKU | Region für Claude 3.5 Haiku bei Verwendung von Vertex AI überschreiben |
VERTEX_REGION_CLAUDE_3_5_SONNET | Region für Claude Sonnet 3.5 bei Verwendung von Vertex AI überschreiben |
VERTEX_REGION_CLAUDE_3_7_SONNET | Region für Claude 3.7 Sonnet bei Verwendung von Vertex AI überschreiben |
VERTEX_REGION_CLAUDE_4_0_OPUS | Region für Claude 4.0 Opus bei Verwendung von Vertex AI überschreiben |
VERTEX_REGION_CLAUDE_4_0_SONNET | Region für Claude 4.0 Sonnet bei Verwendung von Vertex AI überschreiben |
VERTEX_REGION_CLAUDE_4_1_OPUS | Region für Claude 4.1 Opus bei Verwendung von Vertex AI überschreiben |
claude config list
claude config get <schlüssel>
claude config set <schlüssel> <wert>
claude config add <schlüssel> <wert>
claude config remove <schlüssel> <wert>
config
Ihre Projektkonfiguration. Um Ihre globale Konfiguration zu verwalten, verwenden Sie das Flag --global
(oder -g
).
claude config set -g <schlüssel> <wert>
:
Schlüssel | Beschreibung | Beispiel |
---|---|---|
autoUpdates | VERALTET. Verwenden Sie stattdessen die Umgebungsvariable DISABLE_AUTOUPDATER . | false |
preferredNotifChannel | Wo Sie Benachrichtigungen erhalten möchten (Standard: iterm2 ) | iterm2 , iterm2_with_bell , terminal_bell oder notifications_disabled |
theme | Farbthema | dark , light , light-daltonized oder dark-daltonized |
verbose | Ob vollständige Bash- und Befehlsausgaben angezeigt werden sollen (Standard: false ) | true |
Tool | Beschreibung | Berechtigung erforderlich |
---|---|---|
Bash | Führt Shell-Befehle in Ihrer Umgebung aus | Ja |
Edit | Macht gezielte Bearbeitungen an bestimmten Dateien | Ja |
Glob | Findet Dateien basierend auf Musterabgleich | Nein |
Grep | Sucht nach Mustern in Dateiinhalten | Nein |
MultiEdit | Führt mehrere Bearbeitungen an einer einzelnen Datei atomisch durch | Ja |
NotebookEdit | Modifiziert Jupyter-Notebook-Zellen | Ja |
NotebookRead | Liest und zeigt Jupyter-Notebook-Inhalte an | Nein |
Read | Liest den Inhalt von Dateien | Nein |
Task | Führt einen Sub-Agent aus, um komplexe, mehrstufige Aufgaben zu bewältigen | Nein |
TodoWrite | Erstellt und verwaltet strukturierte Aufgabenlisten | Nein |
WebFetch | Ruft Inhalte von einer angegebenen URL ab | Ja |
WebSearch | Führt Websuchen mit Domain-Filterung durch | Ja |
Write | Erstellt oder überschreibt Dateien | Ja |
/allowed-tools
oder in Berechtigungseinstellungen konfiguriert werden. Siehe auch Tool-spezifische Berechtigungsregeln.