Claude Code Einstellungen
Konfigurieren Sie Claude Code mit globalen und projektspezifischen Einstellungen sowie Umgebungsvariablen.
Claude Code bietet eine Vielzahl von Einstellungen, um sein Verhalten an Ihre Bedürfnisse anzupassen. Sie können Claude Code konfigurieren, indem Sie den Befehl /config
ausführen, wenn Sie die interaktive REPL verwenden.
Einstellungsdateien
Die Datei settings.json
ist unser offizieller Mechanismus zur Konfiguration von Claude Code durch hierarchische Einstellungen:
- Benutzereinstellungen werden in
~/.claude/settings.json
definiert und gelten für alle Projekte. - Projekteinstellungen werden in Ihrem Projektverzeichnis gespeichert:
.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.
- Für Unternehmensbereitstellungen von Claude Code unterstützen wir auch von Unternehmen verwaltete Richtlinieneinstellungen. Diese haben Vorrang vor Benutzer- und Projekteinstellungen. Systemadministratoren können Richtlinien unter
/Library/Application Support/ClaudeCode/policies.json
auf macOS und/etc/claude-code/policies.json
auf Linux und Windows über WSL bereitstellen.
Verfügbare Einstellungen
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 normalerweise als X-Api-Key , Authorization: Bearer und Proxy-Authorization: Bearer Header für Modellanfragen gesendet | /bin/generate_temp_api_key.sh |
cleanupPeriodDays | Wie lange Chat-Transkripte lokal aufbewahrt werden sollen (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 | allow und deny Schlüssel sind eine Liste von Berechtigungsregeln | {"allow": [ "Bash(npm run lint)" ]} |
Einstellungsrangfolge
Einstellungen werden in der Reihenfolge ihrer Priorität angewendet:
- Unternehmensrichtlinien (siehe IAM-Dokumentation)
- Befehlszeilenargumente
- Lokale Projekteinstellungen
- Geteilte Projekteinstellungen
- Benutzereinstellungen
Umgebungsvariablen
Claude Code unterstützt die folgenden Umgebungsvariablen zur Steuerung seines Verhaltens:
Alle Umgebungsvariablen können auch in settings.json
konfiguriert werden. Dies ist nützlich als Möglichkeit, Umgebungsvariablen automatisch für jede Sitzung zu setzen oder eine Reihe von Umgebungsvariablen für Ihr gesamtes Team oder Ihre Organisation auszurollen.
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 die Authorization und Proxy-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: Value ) |
ANTHROPIC_MODEL | Name des benutzerdefinierten Modells, das verwendet werden soll (siehe Modellkonfiguration) |
ANTHROPIC_SMALL_FAST_MODEL | Name des Haiku-Klasse-Modells für Hintergrundaufgaben |
BASH_DEFAULT_TIMEOUT_MS | Standard-Timeout für lang laufende Bash-Befehle |
BASH_MAX_TIMEOUT_MS | Maximaler Timeout, den das Modell für lang laufende Bash-Befehle setzen kann |
BASH_MAX_OUTPUT_LENGTH | Maximale Anzahl von Zeichen in Bash-Ausgaben, bevor sie in der Mitte gekürzt werden |
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR | Kehrt nach jedem Bash-Befehl zum ursprünglichen Arbeitsverzeichnis zurück |
CLAUDE_CODE_API_KEY_HELPER_TTL_MS | Intervall in Millisekunden, in dem Anmeldedaten aktualisiert werden sollen (bei Verwendung von apiKeyHelper ) |
CLAUDE_CODE_MAX_OUTPUT_TOKENS | Setzt die maximale Anzahl von Ausgabe-Token für die meisten Anfragen |
CLAUDE_CODE_USE_BEDROCK | Bedrock verwenden (siehe Bedrock & Vertex) |
CLAUDE_CODE_USE_VERTEX | Vertex verwenden (siehe Bedrock & Vertex) |
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_DISABLE_NONESSENTIAL_TRAFFIC | Entspricht dem Setzen von DISABLE_AUTOUPDATER , DISABLE_BUG_COMMAND , DISABLE_ERROR_REPORTING und DISABLE_TELEMETRY |
DISABLE_AUTOUPDATER | Auf 1 setzen, um den automatischen Updater zu deaktivieren |
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 der 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 der Statsig-Telemetrie abzumelden (beachten Sie, dass Statsig-Ereignisse 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_THINKING_TOKENS | Erzwingt ein Denkbudget für das Modell |
MCP_TIMEOUT | Timeout in Millisekunden für MCP-Server-Startup |
MCP_TOOL_TIMEOUT | Timeout in Millisekunden für MCP-Tool-Ausführung |
MAX_MCP_OUTPUT_TOKENS | Maximale Anzahl von Token, die in MCP-Tool-Antworten erlaubt sind (Standard: 25000) |
Konfigurationsoptionen
Wir sind dabei, die globale Konfiguration zu settings.json
zu migrieren.
claude config
wird zugunsten von settings.json veraltet sein
Um Ihre Konfigurationen zu verwalten, verwenden Sie die folgenden Befehle:
- Einstellungen auflisten:
claude config list
- Eine Einstellung anzeigen:
claude config get <key>
- Eine Einstellung ändern:
claude config set <key> <value>
- Zu einer Einstellung hinzufügen (für Listen):
claude config add <key> <value>
- Aus einer Einstellung entfernen (für Listen):
claude config remove <key> <value>
Standardmäßig ändert config
Ihre Projektkonfiguration. Um Ihre globale Konfiguration zu verwalten, verwenden Sie das --global
(oder -g
) Flag.
Globale Konfiguration
Um eine globale Konfiguration zu setzen, verwenden Sie claude config set -g <key> <value>
:
Schlüssel | Beschreibung | Beispiel |
---|---|---|
autoUpdaterStatus | Auto-Updater aktivieren oder deaktivieren (Standard: enabled ) | disabled |
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 |
Für Claude verfügbare Tools
Claude Code hat Zugang zu einer Reihe mächtiger Tools, die ihm helfen, Ihre Codebasis zu verstehen und zu modifizieren:
Tool | Beschreibung | Berechtigung erforderlich |
---|---|---|
Agent | Führt einen Sub-Agent aus, um komplexe, mehrstufige Aufgaben zu bewältigen | Nein |
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 |
LS | Listet Dateien und Verzeichnisse auf | 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 |
TodoRead | Liest die Aufgabenliste der aktuellen Sitzung | 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 |
Berechtigungsregeln können mit /allowed-tools
oder in den Berechtigungseinstellungen konfiguriert werden.
Siehe auch
- Identitäts- und Zugriffsverwaltung - Erfahren Sie mehr über das Berechtigungssystem von Claude Code
- IAM und Zugriffskontrolle - Unternehmensrichtlinienverwaltung
- Fehlerbehebung - Lösungen für häufige Konfigurationsprobleme