Skip to main content
Diese Seite enthält drei Beispiel-settings.json-Dateien, eine für jeden Ort, an dem Sie eine Einstellung speichern:
  • Die ~/.claude/settings.json eines Entwicklers
  • Die .claude/settings.json eines Teams, die im Repository committed ist
  • Die managed-settings.json einer Organisation
Jede Datei ist eine plausible Datei für diesen Leser, sodass Sie die Form sehen und die gewünschten Teile kopieren können. Keine davon ist eine empfohlene Grundlage. Jeder Wert stammt aus dem Eintrag des Schlüssels in der Einstellungsreferenz, die seinen Typ, den Standard und den Ort enthält, an dem er gesetzt werden kann. Jedes Beispiel hat zwei Registerkarten. Kopierbare Einstellungsdatei ist die Datei, wie Sie sie speichern würden. Was jeder Schlüssel tut ist dieselbe Datei mit einem Kommentar über jedem Schlüssel; Claude Code akzeptiert keine Kommentare in einer Einstellungsdatei, daher kopieren Sie aus der ersten Registerkarte.

Ihre eigenen Einstellungen

Die persönlichen Einstellungen eines Entwicklers. Sie wählt ein Modell und eine Anstrengung aus, passt das Terminal an und genehmigt vorab einen schreibgeschützten Befehl und einen Dateilesevorgang. Alles, was nicht aufgelistet ist, behält seinen Standard. Eine Datei wie diese geht in ~/.claude/settings.json, wo sie für jedes Projekt gilt, das Sie öffnen.
Speichern Sie dies als ~/.claude/settings.json. Es ist gültiges JSON ohne Kommentare, daher können Sie es einfach einfügen und die Schlüssel löschen, die Sie nicht möchten.
~/.claude/settings.json

Gemeinsame Einstellungen eines Teams

Die gemeinsamen Einstellungen eines Teams, die im Repository committed sind, damit jeder, der es klont, die gleichen Berechtigungen, Hooks, Telemetrie und das Plugin-Marketplace erhält. Speichern Sie eine Datei wie diese unter .claude/settings.json oben im Repository. Drei Dinge, die Sie vor dem Commit wissen sollten:
  • Cloud-Sitzungen lesen sie auch. Eine Cloud-Sitzung auf Claude Code im Web startet von einem Klon des Repositorys, daher gilt die committed Datei auch dort.
  • Allow-Regeln warten auf Vertrauen. Allow-Regeln und extraKnownMarketplaces-Einträge treten in Kraft, nachdem jede Person diesen Ordner selbst vertraut, nicht nur einen übergeordneten Ordner; Deny- und Ask-Regeln gelten in jeder Sitzung, vertraut oder nicht.
  • Der Hook ist ein Skript im Repo. Der Hook dieser Datei führt .claude/hooks/block-rm.sh aus; Wie ein Hook aufgelöst wird führt Sie durch das Schreiben.
Speichern Sie dies als .claude/settings.json oben im Repository und committen Sie es. Es ist gültiges JSON ohne Kommentare, daher können Sie es einfach einfügen und die Schlüssel löschen, die Sie nicht möchten.
.claude/settings.json

Verwaltete Einstellungen einer Organisation

Eine managed-settings.json-Datei, die die Form der verwalteten Schlüssel zeigt, mit einem plausiblen Wert für jeden. Es ist keine empfohlene Richtlinie: Wählen Sie die Schlüssel aus, die Ihren eigenen Anforderungen entsprechen, und legen Sie Ihre eigenen Werte fest. Das Beispiel setzt diese Schlüssel:
  • forceLoginMethod und forceLoginOrgUUID fixieren die Anmeldemethode und Organisation
  • availableModels und enforceAvailableModels beschränken, welche Modelle Sitzungen verwenden können
  • permissions.deny blockiert zwei Dateilesevorgang und curl, und disableBypassPermissionsMode entfernt den Bypass-Berechtigungsmodus
  • allowManagedPermissionRulesOnly und allowManagedMcpServersOnly machen die verwaltete Berechtigung und MCP-Zulassungslisten zu den einzigen, die gelten
  • allowedMcpServers fixiert den MCP-Server nach URL
  • strictKnownMarketplaces erlaubt einen Plugin-Marketplace
  • sandbox sandboxed Befehle mit einer festen Netzwerk-Zulassungsliste und keinem unsandboxed Retry
  • requiredMinimumVersion setzt eine Mindestversion für Claude Code
  • cleanupPeriodDays verkürzt die Aufbewahrung von Sitzungstranskripten und anderen lokalen Daten auf sieben Tage
  • companyAnnouncements zeigt eine Nachricht beim Start
Administratoren stellen eine Datei wie diese als managed-settings.json bereit, oder das gleiche JSON über MDM oder servergesteuerte Einstellungen. Eine bereitgestellte Datei gilt für jeden Computer oder jedes Konto, das sie erreicht. Um einer Gruppe unterschiedliche Werte zu geben, stellen Sie eine andere Datei oder ein anderes Profil für diese Gruppe bereit, da servergesteuerte Einstellungen noch keine Pro-Gruppen-Richtlinie unterstützen.
Stellen Sie dies als managed-settings.json bereit, oder das gleiche JSON über MDM oder die claude.ai-Konsole. Es ist gültiges JSON ohne Kommentare; ersetzen Sie die Beispiel-Organisations-UUID, Server-URL und den Marketplace durch Ihre eigenen und löschen Sie die Schlüssel, die Sie nicht möchten.
managed-settings.json