Claude Code Konfiguration: 50+ Einstellungen, die du kennen solltest

“Ich nutze Claude Code schon eine Weile, aber ich wusste nicht, dass man das alles einstellen kann!” – Das höre ich regelmässig von Entwicklern in meinen Kursen. Zeit, das zu ändern.

Claude Code ist weit mehr als ein AI-Coding-Assistant. Es ist ein hochgradig konfigurierbares Entwicklungswerkzeug mit über 50 Environment Variables, hierarchischen Settings-Ebenen und granularen Permission Controls. In diesem Artikel zeige ich dir die wichtigsten Konfigurationsmöglichkeiten.

Die Settings-Hierarchie verstehen

Claude Code verwendet ein hierarchisches Konfigurationssystem. Das bedeutet: Einstellungen auf höheren Ebenen überschreiben niedrigere. Die Reihenfolge (von höchster zu niedrigster Priorität):

Enterprise Managed Policies (managed-settings.json) – Von IT/DevOps deployed, nicht überschreibbar
Command Line Arguments – Temporäre Overrides für eine Session
Local Project Settings (.claude/settings.local.json) – Persönliche, nicht commitete Einstellungen
Shared Project Settings (.claude/settings.json) – Team-Settings im Repository
User Settings (~/.claude/settings.json) – Globale persönliche Einstellungen

Praxis-Tipp: Nutze .claude/settings.local.json für Experimente – diese Datei wird automatisch von Git ignoriert.

Die wichtigsten Environment Variables

Hier sind die Environment Variables, die in der Praxis den grössten Unterschied machen:

Performance & Kosten

Variable	Zweck
`MAX_THINKING_TOKENS`	Extended Thinking aktivieren – verbessert komplexe Reasoning-Tasks
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	Maximale Output-Tokens pro Request
`DISABLE_PROMPT_CACHING`	Prompt Caching deaktivieren (spart manchmal Kosten)
`DISABLE_COST_WARNINGS`	Kostenwarnungen ausblenden

Bash & Shell Verhalten

Variable	Zweck
`BASH_DEFAULT_TIMEOUT_MS`	Standard-Timeout für lange Bash-Commands
`BASH_MAX_TIMEOUT_MS`	Maximaler Timeout für Bash-Commands
`BASH_MAX_OUTPUT_LENGTH`	Max. Zeichen in Bash-Outputs vor Truncation
`CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`	Nach jedem Command zum Projekt-Root zurückkehren

Enterprise & Proxy

Variable	Zweck
`HTTP_PROXY` / `HTTPS_PROXY`	Proxy-Server für Netzwerkverbindungen
`NO_PROXY`	Domains, die den Proxy umgehen sollen
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	Telemetry, Auto-Updates, Error Reporting deaktivieren

Alternative Model Provider

Variable	Zweck
`CLAUDE_CODE_USE_BEDROCK`	AWS Bedrock statt Anthropic API nutzen
`CLAUDE_CODE_USE_VERTEX`	Google Vertex AI nutzen
`CLAUDE_CODE_USE_FOUNDRY`	Microsoft Foundry nutzen

Permission Settings: Granulare Kontrolle

Die permissions-Einstellungen in settings.json geben dir präzise Kontrolle darüber, was Claude Code darf und was nicht:

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ],
    "defaultMode": "acceptEdits"
  }
}

Die drei Permission-Typen

allow: Tools/Commands, die ohne Nachfrage ausgeführt werden
ask: Tools, die eine Bestätigung erfordern
deny: Komplett blockierte Tools/Pfade

Security-Tipp: Nutze deny-Regeln für sensitive Dateien wie .env, Credentials und Secrets. Claude Code wird diese Dateien dann komplett ignorieren.

Sandbox Settings: Isolation für mehr Sicherheit

Die Sandbox isoliert Bash-Commands vom Filesystem und Netzwerk. Besonders wichtig für Teams, die mit sensiblem Code arbeiten:

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["git", "docker"],
    "network": {
      "allowUnixSockets": ["/var/run/docker.sock"],
      "allowLocalBinding": true
    }
  }
}

Wichtig: Sandbox ist aktuell nur auf macOS und Linux verfügbar.

Team-Announcements: Kommunikation im Team

Eine unterschätzte Funktion – companyAnnouncements zeigt beim Start Nachrichten an:

{
  "companyAnnouncements": [
    "Willkommen! Unsere Code Guidelines findest du unter docs.company.com",
    "Reminder: Code Reviews sind für alle PRs erforderlich",
    "Neue Security Policy seit 01.02.2026 aktiv"
  ]
}

Perfekt für Onboarding, Policy-Updates oder Team-Announcements.

Hooks: Automatisierung vor und nach Tool-Ausführung

Mit Hooks kannst du eigene Commands ausführen, bevor oder nachdem Claude Code Tools verwendet:

{
  "hooks": {
    "PreToolUse": {
      "Bash": "echo 'Running command...'"
    }
  }
}

Use Cases:

Automatisches Formatting nach File-Edits
Logging/Auditing von Commands
Blocking von bestimmten Operations

Meine Top 5 Konfigurationen für den Alltag

Aus meiner täglichen Arbeit mit Claude Code und dem Teaching an FFHS/TSBE hier meine persönlichen Favoriten:

1. Extended Thinking für komplexe Tasks

export MAX_THINKING_TOKENS=10000

2. Sensitive Files schützen

{
  "permissions": {
    "deny": ["Read(./.env)", "Read(./secrets/**)", "Read(./*.pem)"]
  }
}

3. Projekt-spezifisches Model

{
  "model": "claude-sonnet-4-5-20250929"
}

4. Co-Authored-By in Commits deaktivieren

{
  "includeCoAuthoredBy": false
}

5. Custom Status Line für Kontext

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

Fazit: Investiere 30 Minuten in deine Konfiguration

Die meisten Entwickler nutzen Claude Code “out of the box” – und verschenken damit enormes Potenzial. Eine gut durchdachte Konfiguration macht dich produktiver, schützt sensitive Daten und passt das Tool an deinen Workflow an.

Mein Rat: Nimm dir 30 Minuten Zeit, erstelle eine ~/.claude/settings.json für deine globalen Preferences und eine .claude/settings.json für jedes wichtige Projekt.

Die vollständige Dokumentation findest du unter code.claude.com/docs/en/settings.

Welche Claude Code Einstellungen nutzt du? Schreib mir auf LinkedIn – ich bin gespannt auf eure Setups!