Claude Code-Einstellungen

​

Einstellungsdateien

• Benutzereinstellungen sind 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 Vorlieben und Experimente. Claude Code konfiguriert git so, dass .claude/settings.local.json ignoriert wird, wenn sie erstellt wird.
• Für Enterprise-Bereitstellungen von Claude Code unterstützen wir auch von Unternehmen verwaltete Richtlinieneinstellungen. Diese haben Vorrang vor Benutzer- und Projekteinstellungen. Systemadministratoren können Richtlinien für folgende Orte bereitstellen:
  • macOS: /Library/Application Support/ClaudeCode/managed-settings.json
  • Linux und WSL: /etc/claude-code/managed-settings.json
  • Windows: C:\ProgramData\ClaudeCode\managed-settings.json
• Enterprise-Bereitstellungen können auch verwaltete MCP-Server konfigurieren, die benutzerkonfigurierte Server überschreiben. Siehe Enterprise-MCP-Konfiguration:
  • macOS: /Library/Application Support/ClaudeCode/managed-mcp.json
  • Linux und WSL: /etc/claude-code/managed-mcp.json
  • Windows: C:\ProgramData\ClaudeCode\managed-mcp.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

​

Berechtigungseinstellungen

​

Sandbox-Einstellungen

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker"],
    "network": {
      "allowUnixSockets": [
        "/var/run/docker.sock"
      ],
      "allowLocalBinding": true
    }
  },
  "permissions": {
    "deny": [
      "Read(.envrc)",
      "Read(~/.aws/**)"
    ]
  }
}

• Read-Ablehnungsregeln blockieren Dateileser in der Sandbox
• Edit-Zulassungsregeln erlauben Dateischreibvorgänge (zusätzlich zu den Standardeinstellungen, z. B. das aktuelle Arbeitsverzeichnis)
• Edit-Ablehnungsregeln blockieren Schreibvorgänge innerhalb zulässiger Pfade

• WebFetch-Zulassungsregeln erlauben Netzwerkdomänen
• WebFetch-Ablehnungsregeln blockieren Netzwerkdomänen

​

Einstellungspriorität

1. Von Unternehmen verwaltete Richtlinien (managed-settings.json)
   • Von IT/DevOps bereitgestellt
   • 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. Gemeinsame Projekteinstellungen (.claude/settings.json)
   • Team-gemeinsame Projekteinstellungen in der Versionskontrolle
5. Benutzereinstellungen (~/.claude/settings.json)
   • Persönliche globale Einstellungen

​

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
• Schrägstrich-Befehle: Benutzerdefinierte Befehle, die während einer Sitzung mit /command-name aufgerufen werden können
• MCP-Server: Erweitern Sie Claude Code mit zusätzlichen Tools und Integrationen
• Priorität: Höherrangige Konfigurationen (Enterprise) überschreiben niedrigere (Benutzer/Projekt)
• Vererbung: Einstellungen werden zusammengeführt, wobei spezifischere Einstellungen breitere ergänzen oder überschreiben

​

Verfügbarkeit der Systemaufforderung

​

Ausschluss vertraulicher Dateien

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

​

Subagent-Konfiguration

• 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

​

Plugin-Konfiguration

​

Plugin-Einstellungen

{
  "enabledPlugins": {
    "formatter@company-tools": true,
    "deployer@company-tools": true,
    "analyzer@security-plugins": false
  },
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": "github",
      "repo": "company/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 committed)

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

​

extraKnownMarketplaces

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

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

• github: GitHub-Repository (verwendet repo)
• git: Beliebige Git-URL (verwendet url)
• directory: Lokaler Dateisystempfad (verwendet path, nur für Entwicklung)

​

Verwalten von Plugins

• Durchsuchen Sie verfügbare Plugins von Marktplätzen
• Installieren/Deinstallieren Sie Plugins
• Aktivieren/Deaktivieren Sie Plugins
• Zeigen Sie Plugin-Details an (bereitgestellte Befehle, Agenten, Hooks)
• Fügen Sie Marktplätze hinzu/entfernen Sie sie

​

Umgebungsvariablen

​

Für Claude verfügbare Tools

​

Erweitern von Tools mit Hooks

​

Siehe auch

• Identität und Zugriffsverwaltung - Erfahren Sie mehr über das Berechtigungssystem von Claude Code
• IAM und Zugriffskontrolle - Enterprise-Richtlinienverwaltung
• Fehlerbehebung - Lösungen für häufige Konfigurationsprobleme