Claude Code Einstellungen

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 bereitstellen für:
  • macOS: /Library/Application Support/ClaudeCode/managed-settings.json
  • Linux und WSL: /etc/claude-code/managed-settings.json
  • Windows: C:\ProgramData\ClaudeCode\managed-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:

​

Berechtigungseinstellungen

​

Einstellungsrangfolge

Einstellungen werden in der Reihenfolge der Priorität angewendet:

1. Unternehmensrichtlinien (siehe IAM-Dokumentation)
2. Befehlszeilenargumente
3. Lokale Projekteinstellungen
4. Geteilte Projekteinstellungen
5. Benutzereinstellungen

​

Subagent-Konfiguration

Claude Code unterstützt benutzerdefinierte KI-Subagenten, die sowohl auf Benutzer- als auch auf Projektebene konfiguriert werden können. Diese Subagenten werden als Markdown-Dateien mit YAML-Frontmatter gespeichert:

• Benutzer-Subagenten: ~/.claude/agents/ - Verfügbar in allen Ihren Projekten
• Projekt-Subagenten: .claude/agents/ - Spezifisch für Ihr Projekt und können mit Ihrem Team geteilt werden

Subagent-Dateien definieren spezialisierte KI-Assistenten mit benutzerdefinierten Prompts und Tool-Berechtigungen. Erfahren Sie mehr über das Erstellen und Verwenden von Subagenten in der Subagenten-Dokumentation.

​

Umgebungsvariablen

Claude Code unterstützt die folgenden Umgebungsvariablen zur Steuerung seines Verhaltens:

​

Konfigurationsoptionen

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>:

​

Für Claude verfügbare Tools

Claude Code hat Zugriff auf eine Reihe mächtiger Tools, die ihm helfen, Ihre Codebasis zu verstehen und zu modifizieren:

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

​

Tools mit Hooks erweitern

Sie können benutzerdefinierte Befehle vor oder nach jeder Tool-Ausführung mit Claude Code Hooks ausführen.

Zum Beispiel könnten Sie automatisch einen Python-Formatierer ausführen, nachdem Claude Python-Dateien modifiziert hat, oder Modifikationen an Produktionskonfigurationsdateien verhindern, indem Sie Write-Operationen zu bestimmten Pfaden blockieren.

​

Siehe auch

• Identitäts- und Zugriffsverwaltung - Erfahren Sie mehr über Claude Codes Berechtigungssystem
• IAM und Zugriffskontrolle - Unternehmensrichtlinienverwaltung
• Fehlerbehebung - Lösungen für häufige Konfigurationsprobleme