Claude Code-Einstellungen

​

Konfigurationsbereiche

​

Verfügbare Bereiche

​

Wann sollte jeder Bereich verwendet werden

• Sicherheitsrichtlinien, die organisationsweit durchgesetzt werden müssen
• Compliance-Anforderungen, die nicht überschrieben werden können
• Standardisierte Konfigurationen, die von IT/DevOps bereitgestellt werden

• Persönliche Voreinstellungen, die Sie überall haben möchten (Designs, Editor-Einstellungen)
• Tools und Plugins, die Sie in allen Projekten verwenden
• API-Schlüssel und Authentifizierung (sicher gespeichert)

• Teamübergreifend gemeinsame Einstellungen (Berechtigungen, Hooks, MCP-Server)
• Plugins, die das gesamte Team haben sollte
• Standardisierung von Tools über Mitarbeiter hinweg

• Persönliche Überschreibungen für ein bestimmtes Projekt
• Testen von Konfigurationen vor dem Teilen mit dem Team
• Maschinenspezifische Einstellungen, die für andere nicht funktionieren

​

Wie Bereiche interagieren

1. Verwaltet (höchste) - kann von nichts überschrieben werden
2. Befehlszeilenargumente - temporäre Sitzungsüberschreibungen
3. Lokal - überschreibt Projekt- und Benutzereinstellungen
4. Projekt - überschreibt Benutzereinstellungen
5. Benutzer (niedrigste) - gilt, wenn nichts anderes die Einstellung angibt

​

Was verwendet Bereiche

​

Einstellungsdateien

• 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 Voreinstellungen und Experimente. Claude Code konfiguriert Git so, dass .claude/settings.local.json ignoriert wird, wenn sie erstellt wird.
• Verwaltete Einstellungen: Für Organisationen, die zentrale Kontrolle benötigen, unterstützt Claude Code mehrere Bereitstellungsmechanismen für verwaltete Einstellungen. Alle verwenden das gleiche JSON-Format und können nicht durch Benutzer- oder Projekteinstellungen überschrieben werden:
  • Serververwaltete Einstellungen: von Anthropics Servern über die Claude.ai-Administratorkonsole bereitgestellt. Siehe serververwaltete Einstellungen.
  • MDM/OS-Richtlinien: über native Geräteverwaltung auf macOS und Windows bereitgestellt:
    • macOS: com.anthropic.claudecode verwaltete Präferenzdomäne. Die Schlüssel der obersten Ebene der plist spiegeln managed-settings.json wider, mit verschachtelten Einstellungen als Wörterbücher und Arrays als plist-Arrays. Bereitstellung über Konfigurationsprofile in Jamf, Iru (Kandji) oder ähnlichen MDM-Tools.
    • Windows: HKLM\SOFTWARE\Policies\ClaudeCode Registrierungsschlüssel mit einem Settings-Wert (REG_SZ oder REG_EXPAND_SZ) mit JSON (bereitgestellt über Gruppenrichtlinie oder Intune)
    • Windows (Benutzerebene): HKCU\SOFTWARE\Policies\ClaudeCode (niedrigste Richtlinienpriorität, wird nur verwendet, wenn keine Admin-Quelle vorhanden ist)
  • Dateibasiert: managed-settings.json und managed-mcp.json in Systemverzeichnissen bereitgestellt:
    • macOS: /Library/Application Support/ClaudeCode/
    • Linux und WSL: /etc/claude-code/
    • Windows: C:\Program Files\ClaudeCode\
    Der veraltete Windows-Pfad C:\ProgramData\ClaudeCode\managed-settings.json wird ab v2.1.75 nicht mehr unterstützt. Administratoren, die Einstellungen an diesem Speicherort bereitgestellt haben, müssen Dateien zu C:\Program Files\ClaudeCode\managed-settings.json migrieren.
    Dateibasierte verwaltete Einstellungen unterstützen auch ein Drop-in-Verzeichnis unter managed-settings.d/ im gleichen Systemverzeichnis neben managed-settings.json. Dies ermöglicht es separaten Teams, unabhängige Richtlinienfragmente bereitzustellen, ohne Änderungen an einer einzelnen Datei zu koordinieren. Nach der systemd-Konvention wird managed-settings.json zuerst als Basis zusammengeführt, dann werden alle *.json-Dateien im Drop-in-Verzeichnis alphabetisch sortiert und oben zusammengeführt. Spätere Dateien überschreiben frühere für Skalarwerte; Arrays werden verkettet und dedupliziert; Objekte werden tiefgreifend zusammengeführt. Versteckte Dateien, die mit . beginnen, werden ignoriert. Verwenden Sie numerische Präfixe, um die Zusammenführungsreihenfolge zu steuern, z. B. 10-telemetry.json und 20-security.json.
  Siehe verwaltete Einstellungen und Verwaltete MCP-Konfiguration für Details. Dieses Repository enthält Starter-Bereitstellungsvorlagen für Jamf, Iru (Kandji), Intune und Gruppenrichtlinie. Verwenden Sie diese als Ausgangspunkte und passen Sie sie an Ihre Anforderungen an.
  Verwaltete Bereitstellungen können auch Plugin-Marketplace-Ergänzungen mit strictKnownMarketplaces einschränken. Weitere Informationen finden Sie unter Verwaltete Marketplace-Einschränkungen.
• Andere Konfiguration wird in ~/.claude.json gespeichert. Diese Datei enthält Ihre OAuth-Sitzung, MCP-Server-Konfigurationen für Benutzer- und lokale Bereiche, projektbezogenen Status (zulässige Tools, Vertrauenseinstellungen) und verschiedene Caches. Projektbezogene MCP-Server werden separat in .mcp.json gespeichert.

{
  "$schema": "https://json.schemastore.org/claude-code-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"
  },
  "companyAnnouncements": [
    "Welcome to Acme Corp! Review our code guidelines at docs.acme.com",
    "Reminder: Code reviews required for all PRs",
    "New security policy in effect"
  ]
}

​

Wenn Änderungen wirksam werden

• model: Verwenden Sie /model, um während der Sitzung zu wechseln
• outputStyle: Teil der Systemaufforderung, die beim /clear oder Neustart neu erstellt wird

​

Verfügbare Einstellungen

​

Globale Konfigurationseinstellungen

​

Worktree-Einstellungen

​

Berechtigungseinstellungen

​

Berechtigungsregelsyntax

​

Sandbox-Einstellungen

​

Sandbox-Pfadpräfixe

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker *"],
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org", "registry.yarnpkg.com"],
      "deniedDomains": ["uploads.github.com"],
      "allowUnixSockets": [
        "/var/run/docker.sock"
      ],
      "allowLocalBinding": true
    }
  }
}

• sandbox.filesystem-Einstellungen (oben gezeigt): Steuern Sie Pfade an der OS-Level-Sandbox-Grenze. Diese Einschränkungen gelten für alle Subprozess-Befehle (z. B. kubectl, terraform, npm), nicht nur für Claudes Datei-Tools.
• Berechtigungsregeln: Verwenden Sie Edit Allow/Deny-Regeln, um den Zugriff auf Claudes Datei-Tool zu steuern, Read Deny-Regeln, um Lesevorgänge zu blockieren, und WebFetch Allow/Deny-Regeln, um Netzwerk-Domänen zu steuern. Pfade aus diesen Regeln werden auch in die Sandbox-Konfiguration zusammengeführt.

​

Zuschreibungseinstellungen

• Commits verwenden Git-Trailer (wie Co-Authored-By) standardmäßig, die angepasst oder deaktiviert werden können
• Pull-Request-Beschreibungen sind Klartext

🤖 Generated with [Claude Code](https://claude.com/claude-code)

   Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

🤖 Generated with [Claude Code](https://claude.com/claude-code)

{
  "attribution": {
    "commit": "Generated with AI\n\nCo-Authored-By: AI <ai@example.com>",
    "pr": ""
  }
}

​

Dateivorschlag-Einstellungen

{
  "fileSuggestion": {
    "type": "command",
    "command": "~/.claude/file-suggestion.sh"
  }
}

{"query": "src/comp"}

src/components/Button.tsx
src/components/Modal.tsx
src/components/Form.tsx

#!/bin/bash
query=$(cat | jq -r '.query')
your-repo-file-index --query "$query" | head -20

​

Hook-Konfiguration

• Verwaltete Hooks und SDK-Hooks werden geladen
• Hooks von Plugins, die in verwalteten Einstellungen enabledPlugins erzwungen aktiviert sind, werden geladen. Dies ermöglicht es Administratoren, überprüfte Hooks über einen Organisations-Marketplace zu verteilen, während alles andere blockiert wird. Vertrauen wird durch vollständige plugin@marketplace ID gewährt, daher bleibt ein Plugin mit dem gleichen Namen aus einem anderen Marketplace blockiert
• Benutzer-Hooks, Projekt-Hooks und alle anderen Plugin-Hooks werden blockiert

{
  "allowedHttpHookUrls": ["https://hooks.example.com/*", "http://localhost:*"]
}

{
  "httpHookAllowedEnvVars": ["MY_TOKEN", "HOOK_SECRET"]
}

​

Berechnen Sie verwaltete Einstellungen mit einem Policy Helper

{
  "managedSettings": {
    "permissions": { "deny": ["Read(//etc/secrets/**)"] }
  },
  "claudeMd": "# Organization context\n...",
  "appendSystemPrompt": "Always cite the internal style guide."
}

​

Einstellungspriorität

1. Verwaltete Einstellungen (serververwaltete, MDM/OS-Richtlinien oder verwaltete Einstellungen)
   • Richtlinien, die von IT über Server-Bereitstellung, MDM-Konfigurationsprofile, Registry-Richtlinien oder verwaltete Einstellungsdateien bereitgestellt werden
   • Können nicht durch andere Ebenen überschrieben werden, einschließlich Befehlszeilenargumenten
   • Innerhalb der verwalteten Ebene ist die Priorität: serververwaltete > MDM/OS-Richtlinien > dateibasierte (managed-settings.d/*.json + managed-settings.json) > HKCU-Registry (nur Windows). Nur eine verwaltete Quelle wird verwendet; Quellen werden nicht zusammengeführt. Innerhalb der dateibasierten Ebene werden Drop-in-Dateien und die Basisdatei zusammengeführt.
2. Befehlszeilenargumente
   • Temporäre Überschreibungen für eine bestimmte Sitzung. JSON, das über --settings <file-or-json> übergeben wird, wird mit dateibasierten Einstellungen unter Verwendung der gleichen Regeln wie die anderen Ebenen zusammengeführt: Ein hier gesetzter Schlüssel überschreibt den gleichen Schlüssel in lokalen, Projekt- oder Benutzereinstellungen, und das Weglassen eines Schlüssels lässt den Wert der niedrigeren Ebene bestehen
3. Lokale Projekteinstellungen (.claude/settings.local.json)
   • Persönliche projektspezifische Einstellungen
4. Gemeinsame Projekteinstellungen (.claude/settings.json)
   • Teamübergreifend gemeinsame Projekteinstellungen in der Versionskontrolle
5. Benutzereinstellungen (~/.claude/settings.json)
   • Persönliche globale Einstellungen

​

Aktive Einstellungen überprüfen

​

Wichtige Punkte zum Konfigurationssystem

• Speicherdateien (CLAUDE.md): Enthalten Anweisungen und Kontext, die Claude beim Start lädt
• Einstellungsdateien (JSON): Konfigurieren Sie Berechtigungen, Umgebungsvariablen und Werkzeugverhalten
• Skills: Benutzerdefinierte Aufforderungen, die mit /skill-name aufgerufen oder von Claude automatisch geladen werden können
• MCP-Server: Erweitern Sie Claude Code mit zusätzlichen Tools und Integrationen
• Priorität: Höherrangige Konfigurationen (Verwaltet) überschreiben niedrigere (Benutzer/Projekt)
• Vererbung: Einstellungen werden zusammengeführt, wobei spezifischere Einstellungen breitere ergänzen oder überschreiben

​

Systemaufforderung

​

Ausschließen sensibler Dateien

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

​

Subagent-Konfiguration

• Benutzer-Subagents: ~/.claude/agents/ - Verfügbar über alle Ihre Projekte
• Projekt-Subagents: .claude/agents/ - Spezifisch für Ihr Projekt und können mit Ihrem Team geteilt werden

​

Plugin-Konfiguration

​

Plugin-Einstellungen

{
  "enabledPlugins": {
    "formatter@acme-tools": true,
    "deployer@acme-tools": true,
    "analyzer@security-plugins": false
  },
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": {
        "source": "github",
        "repo": "acme-corp/claude-plugins"
      }
    }
  }
}

​

enabledPlugins

• Benutzereinstellungen (~/.claude/settings.json): Persönliche Plugin-Voreinstellungen
• Projekteinstellungen (.claude/settings.json): Projektspezifische Plugins, die mit dem Team geteilt werden
• Lokale Einstellungen (.claude/settings.local.json): Pro-Maschinen-Überschreibungen (nicht eingecheckt)
• Verwaltete Einstellungen (managed-settings.json): Organisationsweite Richtlinien-Überschreibungen, die die Installation auf allen Ebenen blockieren und das Plugin aus dem Marketplace ausblenden

{
  "enabledPlugins": {
    "code-formatter@team-tools": true,
    "deployment-tools@team-tools": true,
    "experimental-features@personal": false
  }
}

​

extraKnownMarketplaces

1. Teamkollegen werden aufgefordert, den Marketplace zu installieren, wenn sie dem Ordner vertrauen
2. Teamkollegen werden dann aufgefordert, Plugins aus diesem Marketplace zu installieren
3. Benutzer können unerwünschte Marketplaces oder Plugins überspringen (in Benutzereinstellungen gespeichert)
4. Die Installation respektiert Vertrauensgrenzen und erfordert explizite Zustimmung

{
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": {
        "source": "github",
        "repo": "acme-corp/claude-plugins"
      }
    },
    "security-plugins": {
      "source": {
        "source": "git",
        "url": "https://git.example.com/security/plugins.git"
      }
    }
  }
}

• github: GitHub-Repository (verwendet repo)
• git: Beliebige Git-URL (verwendet url)
• directory: Lokaler Dateisystem-Pfad (verwendet path, nur für Entwicklung)
• hostPattern: Regex-Muster zum Abgleichen von Marketplace-Hosts (verwendet hostPattern)
• settings: Inline-Marketplace, der direkt in settings.json deklariert wird, ohne ein separates gehostetes Repository (verwendet name und plugins)

{
  "extraKnownMarketplaces": {
    "team-tools": {
      "source": {
        "source": "settings",
        "name": "team-tools",
        "plugins": [
          {
            "name": "code-formatter",
            "source": {
              "source": "github",
              "repo": "acme-corp/code-formatter"
            }
          }
        ]
      }
    }
  }
}

​

strictKnownMarketplaces

• macOS: /Library/Application Support/ClaudeCode/managed-settings.json
• Linux und WSL: /etc/claude-code/managed-settings.json
• Windows: C:\Program Files\ClaudeCode\managed-settings.json

• Nur in verwalteten Einstellungen verfügbar (managed-settings.json)
• Kann nicht durch Benutzer- oder Projekteinstellungen überschrieben werden (höchste Priorität)
• Durchgesetzt VOR Netzwerk-/Dateisystem-Operationen (blockierte Quellen werden nie ausgeführt)
• Verwendet exakte Übereinstimmung für Quellspezifikationen (einschließlich ref, path für Git-Quellen), außer hostPattern und pathPattern, die Regex-Abgleich verwenden

• undefined (Standard): Keine Einschränkungen - Benutzer können jeden Marketplace hinzufügen
• Leeres Array []: Vollständiger Lockdown - Benutzer können keine neuen Marketplaces hinzufügen
• Liste von Quellen: Benutzer können nur Marketplaces hinzufügen, die genau übereinstimmen

1. GitHub-Repositories:

{ "source": "github", "repo": "acme-corp/approved-plugins" }
{ "source": "github", "repo": "acme-corp/security-tools", "ref": "v2.0" }
{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }

2. Git-Repositories:

{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git" }
{ "source": "git", "url": "https://bitbucket.org/acme-corp/plugins.git", "ref": "production" }
{ "source": "git", "url": "ssh://git@git.example.com/plugins.git", "ref": "v3.1", "path": "approved" }

3. URL-basierte Marketplaces:

{ "source": "url", "url": "https://plugins.example.com/marketplace.json" }
{ "source": "url", "url": "https://cdn.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }

4. NPM-Pakete:

{ "source": "npm", "package": "@acme-corp/claude-plugins" }
{ "source": "npm", "package": "@acme-corp/approved-marketplace" }

5. Dateipfade:

{ "source": "file", "path": "/usr/local/share/claude/acme-marketplace.json" }
{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }

6. Verzeichnispfade:

{ "source": "directory", "path": "/usr/local/share/claude/acme-plugins" }
{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }

7. Host-Muster-Abgleich:

{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }
{ "source": "hostPattern", "hostPattern": "^gitlab\\.internal\\.example\\.com$" }

• github: passt immer gegen github.com
• git: extrahiert Hostname aus der URL (unterstützt sowohl HTTPS als auch SSH-Formate)
• url: extrahiert Hostname aus der URL
• npm, file, directory: nicht unterstützt für Host-Muster-Abgleich

8. Pfad-Muster-Abgleich:

{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }
{ "source": "pathPattern", "pathPattern": ".*" }

{
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "acme-corp/approved-plugins"
    },
    {
      "source": "github",
      "repo": "acme-corp/security-tools",
      "ref": "v2.0"
    },
    {
      "source": "url",
      "url": "https://plugins.example.com/marketplace.json"
    },
    {
      "source": "npm",
      "package": "@acme-corp/compliance-plugins"
    }
  ]
}

{
  "strictKnownMarketplaces": []
}

{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}

• Das repo oder url muss genau übereinstimmen
• Das ref-Feld muss genau übereinstimmen (oder beide sind undefined)
• Das path-Feld muss genau übereinstimmen (oder beide sind undefined)

// Diese sind UNTERSCHIEDLICHE Quellen:
{ "source": "github", "repo": "acme-corp/plugins" }
{ "source": "github", "repo": "acme-corp/plugins", "ref": "main" }

// Diese sind auch UNTERSCHIEDLICH:
{ "source": "github", "repo": "acme-corp/plugins", "path": "marketplace" }
{ "source": "github", "repo": "acme-corp/plugins" }

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "acme-corp/plugins" }
  ]
}

{
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": { "source": "github", "repo": "acme-corp/plugins" }
    }
  }
}

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "acme-corp/plugins" }
  ],
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": { "source": "github", "repo": "acme-corp/plugins" }
    }
  }
}

• Einschränkungen werden VOR Netzwerkanfragen oder Dateisystem-Operationen überprüft
• Wenn blockiert, sehen Benutzer klare Fehlermeldungen, die angeben, dass die Quelle durch verwaltete Richtlinie blockiert ist
• Die Einschränkung wird beim Hinzufügen und beim Installieren, Aktualisieren, Aktualisieren und automatischen Aktualisieren von Plugins durchgesetzt. Ein Marketplace, der vor dem Festlegen der Richtlinie hinzugefügt wurde, kann nicht mehr zum Installieren oder Aktualisieren von Plugins verwendet werden, sobald seine Quelle nicht mehr mit der Allowlist übereinstimmt
• Verwaltete Einstellungen haben die höchste Priorität und können nicht überschrieben werden

​

strictPluginOnlyCustomization

{
  "strictPluginOnlyCustomization": ["skills", "hooks"]
}

​

Verwalten von Plugins

• Durchsuchen Sie verfügbare Plugins aus Marketplaces
• Installieren/Deinstallieren Sie Plugins
• Aktivieren/Deaktivieren Sie Plugins
• Zeigen Sie Plugin-Details an (bereitgestellte Skills, Agents, Hooks)
• Fügen Sie Marketplaces hinzu/entfernen Sie sie

​

Umgebungsvariablen

​

Tools, die Claude zur Verfügung stehen

​

Siehe auch

• Berechtigungen: Berechtigungssystem, Regelsyntax, werkzeugspezifische Muster und verwaltete Richtlinien
• Authentifizierung: Richten Sie Benutzerzugriff auf Claude Code ein
• Konfiguration debuggen: Diagnostizieren Sie, warum eine Einstellung, ein Hook oder ein MCP-Server nicht wirksam wird
• Troubleshooting bei Installation und Anmeldung: Installations-, Authentifizierungs- und Plattformprobleme