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:*)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}

​

Verfügbare Einstellungen

settings.json unterstützt eine Reihe von Optionen:

​

Berechtigungseinstellungen

​

Einstellungsvorrang

Einstellungen werden in der Reihenfolge der Priorität angewendet (höchste zu niedrigste):

1. Von Unternehmen verwaltete Richtlinien (managed-settings.json)

   • Bereitgestellt von IT/DevOps
   • Können nicht überschrieben werden

2. Befehlszeilenargumente

   • Temporäre Überschreibungen für eine bestimmte Sitzung

3. Lokale Projekteinstellungen (.claude/settings.local.json)

   • Persönliche projektspezifische Einstellungen

4. Geteilte Projekteinstellungen (.claude/settings.json)

   • Team-geteilte Projekteinstellungen in der Versionskontrolle

5. Benutzereinstellungen (~/.claude/settings.json)

   • Persönliche globale Einstellungen

Diese Hierarchie stellt sicher, dass Unternehmenssicherheitsrichtlinien immer durchgesetzt werden, während Teams und Einzelpersonen ihre Erfahrung anpassen können.

​

Wichtige Punkte zum Konfigurationssystem

• Speicherdateien (CLAUDE.md): Enthalten Anweisungen und Kontext, die Claude beim Start lädt
• Einstellungsdateien (JSON): Konfigurieren Berechtigungen, Umgebungsvariablen und Tool-Verhalten
• Slash-Befehle: Benutzerdefinierte Befehle, die während einer Sitzung mit /befehlsname aufgerufen werden können
• MCP-Server: Erweitern Claude Code mit zusätzlichen Tools und Integrationen
• Vorrang: Konfigurationen höherer Ebene (Unternehmen) überschreiben solche niedrigerer Ebene (Benutzer/Projekt)
• Vererbung: Einstellungen werden zusammengeführt, wobei spezifischere Einstellungen zu breiteren hinzufügen oder diese überschreiben

​

Verfügbarkeit der Systemaufforderung

​

Sensible Dateien ausschließen

Um zu verhindern, dass Claude Code auf Dateien mit sensiblen Informationen zugreift (z.B. API-Schlüssel, Geheimnisse, Umgebungsdateien), verwenden Sie die Einstellung permissions.deny in Ihrer .claude/settings.json-Datei:

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Read(./build)"
    ]
  }
}

Dies ersetzt die veraltete ignorePatterns-Konfiguration. Dateien, die diesen Mustern entsprechen, sind für Claude Code völlig unsichtbar und verhindern jede versehentliche Preisgabe sensibler Daten.

​

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 <schlüssel>
• Eine Einstellung ändern: claude config set <schlüssel> <wert>
• Zu einer Einstellung hinzufügen (für Listen): claude config add <schlüssel> <wert>
• Aus einer Einstellung entfernen (für Listen): claude config remove <schlüssel> <wert>

Standardmäßig ändert config Ihre Projektkonfiguration. Um Ihre globale Konfiguration zu verwalten, verwenden Sie das Flag --global (oder -g).

​

Globale Konfiguration

Um eine globale Konfiguration zu setzen, verwenden Sie claude config set -g <schlüssel> <wert>:

​

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. Siehe auch Tool-spezifische Berechtigungsregeln.

​

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