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.
Beispiel settings.json
{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}

Verfügbare Einstellungen

settings.json unterstützt eine Reihe von Optionen:

SchlüsselBeschreibungBeispiel
apiKeyHelperBenutzerdefiniertes 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
cleanupPeriodDaysWie lange Chat-Transkripte lokal aufbewahrt werden sollen (Standard: 30 Tage)20
envUmgebungsvariablen, die auf jede Sitzung angewendet werden{"FOO": "bar"}
includeCoAuthoredByOb die co-authored-by Claude Byline in Git-Commits und Pull-Requests eingeschlossen werden soll (Standard: true)false
permissionsallow und deny Schlüssel sind eine Liste von Berechtigungsregeln{"allow": [ "Bash(npm run lint)" ]}

Einstellungsrangfolge

Einstellungen werden in der Reihenfolge ihrer Priorität angewendet:

  1. Unternehmensrichtlinien (siehe IAM-Dokumentation)
  2. Befehlszeilenargumente
  3. Lokale Projekteinstellungen
  4. Geteilte Projekteinstellungen
  5. 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.

VariableZweck
ANTHROPIC_API_KEYAPI-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_TOKENBenutzerdefinierter Wert für die Authorization und Proxy-Authorization Header (der Wert, den Sie hier setzen, wird mit Bearer vorangestellt)
ANTHROPIC_CUSTOM_HEADERSBenutzerdefinierte Header, die Sie zur Anfrage hinzufügen möchten (im Format Name: Value)
ANTHROPIC_MODELName des benutzerdefinierten Modells, das verwendet werden soll (siehe Modellkonfiguration)
ANTHROPIC_SMALL_FAST_MODELName des Haiku-Klasse-Modells für Hintergrundaufgaben
BASH_DEFAULT_TIMEOUT_MSStandard-Timeout für lang laufende Bash-Befehle
BASH_MAX_TIMEOUT_MSMaximaler Timeout, den das Modell für lang laufende Bash-Befehle setzen kann
BASH_MAX_OUTPUT_LENGTHMaximale Anzahl von Zeichen in Bash-Ausgaben, bevor sie in der Mitte gekürzt werden
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIRKehrt nach jedem Bash-Befehl zum ursprünglichen Arbeitsverzeichnis zurück
CLAUDE_CODE_API_KEY_HELPER_TTL_MSIntervall in Millisekunden, in dem Anmeldedaten aktualisiert werden sollen (bei Verwendung von apiKeyHelper)
CLAUDE_CODE_MAX_OUTPUT_TOKENSSetzt die maximale Anzahl von Ausgabe-Token für die meisten Anfragen
CLAUDE_CODE_USE_BEDROCKBedrock verwenden (siehe Bedrock & Vertex)
CLAUDE_CODE_USE_VERTEXVertex verwenden (siehe Bedrock & Vertex)
CLAUDE_CODE_SKIP_BEDROCK_AUTHAWS-Authentifizierung für Bedrock überspringen (z.B. bei Verwendung eines LLM-Gateways)
CLAUDE_CODE_SKIP_VERTEX_AUTHGoogle-Authentifizierung für Vertex überspringen (z.B. bei Verwendung eines LLM-Gateways)
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICEntspricht dem Setzen von DISABLE_AUTOUPDATER, DISABLE_BUG_COMMAND, DISABLE_ERROR_REPORTING und DISABLE_TELEMETRY
DISABLE_AUTOUPDATERAuf 1 setzen, um den automatischen Updater zu deaktivieren
DISABLE_BUG_COMMANDAuf 1 setzen, um den /bug Befehl zu deaktivieren
DISABLE_COST_WARNINGSAuf 1 setzen, um Kostenwarnmeldungen zu deaktivieren
DISABLE_ERROR_REPORTINGAuf 1 setzen, um sich von der Sentry-Fehlerberichterstattung abzumelden
DISABLE_NON_ESSENTIAL_MODEL_CALLSAuf 1 setzen, um Modellaufrufe für nicht-kritische Pfade wie Flavor-Text zu deaktivieren
DISABLE_TELEMETRYAuf 1 setzen, um sich von der Statsig-Telemetrie abzumelden (beachten Sie, dass Statsig-Ereignisse keine Benutzerdaten wie Code, Dateipfade oder Bash-Befehle enthalten)
HTTP_PROXYHTTP-Proxy-Server für Netzwerkverbindungen angeben
HTTPS_PROXYHTTPS-Proxy-Server für Netzwerkverbindungen angeben
MAX_THINKING_TOKENSErzwingt ein Denkbudget für das Modell
MCP_TIMEOUTTimeout in Millisekunden für MCP-Server-Startup
MCP_TOOL_TIMEOUTTimeout in Millisekunden für MCP-Tool-Ausführung
MAX_MCP_OUTPUT_TOKENSMaximale 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üsselBeschreibungBeispiel
autoUpdaterStatusAuto-Updater aktivieren oder deaktivieren (Standard: enabled)disabled
preferredNotifChannelWo Sie Benachrichtigungen erhalten möchten (Standard: iterm2)iterm2, iterm2_with_bell, terminal_bell oder notifications_disabled
themeFarbthemadark, light, light-daltonized oder dark-daltonized
verboseOb 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:

ToolBeschreibungBerechtigung erforderlich
AgentFührt einen Sub-Agent aus, um komplexe, mehrstufige Aufgaben zu bewältigenNein
BashFührt Shell-Befehle in Ihrer Umgebung ausJa
EditMacht gezielte Bearbeitungen an bestimmten DateienJa
GlobFindet Dateien basierend auf MusterabgleichNein
GrepSucht nach Mustern in DateiinhaltenNein
LSListet Dateien und Verzeichnisse aufNein
MultiEditFührt mehrere Bearbeitungen an einer einzelnen Datei atomisch durchJa
NotebookEditModifiziert Jupyter-Notebook-ZellenJa
NotebookReadLiest und zeigt Jupyter-Notebook-Inhalte anNein
ReadLiest den Inhalt von DateienNein
TodoReadLiest die Aufgabenliste der aktuellen SitzungNein
TodoWriteErstellt und verwaltet strukturierte AufgabenlistenNein
WebFetchRuft Inhalte von einer angegebenen URL abJa
WebSearchFührt Websuchen mit Domain-Filterung durchJa
WriteErstellt oder überschreibt DateienJa

Berechtigungsregeln können mit /allowed-tools oder in den Berechtigungseinstellungen konfiguriert werden.

Siehe auch