Claude Code-Einstellungen

​

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 Vorlieben und Experimente. Claude Code konfiguriert git so, dass .claude/settings.local.json ignoriert wird, wenn es 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 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
• 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"
  },
  "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"
  ]
}

​

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-Deny-Regeln blockieren Dateileser in der Sandbox
• Edit-Allow-Regeln erlauben Dateischreibvorgänge (zusätzlich zu den Standardeinstellungen, z. B. das aktuelle Arbeitsverzeichnis)
• Edit-Deny-Regeln blockieren Schreibvorgänge innerhalb erlaubter Pfade

• WebFetch-Allow-Regeln erlauben Netzwerkdomänen
• WebFetch-Deny-Regeln blockieren Netzwerkdomänen

​

Einstellungspriorität

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 projektbezogene 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 niedrigerrangige (Benutzer/Projekt)
• Vererbung: Einstellungen werden zusammengeführt, wobei spezifischere Einstellungen breitere ergänzen oder überschreiben

​

Verfügbarkeit der Systemaufforderung

​

Ausschließen 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 Werkzeuge

​

Erweitern von Werkzeugen 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