settings.json-Dateien, eine für jeden Ort, an dem Sie eine Einstellung speichern:
- Die
~/.claude/settings.jsoneines Entwicklers - Die
.claude/settings.jsoneines Teams, die im Repository committed ist - Die
managed-settings.jsoneiner Organisation
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.
- Kopierbare Einstellungsdatei
- Was jeder Schlüssel tut
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 festgehalten werden, damit jeder, der es klont, die gleichen Berechtigungen, Hooks und das Plugin-Marketplace erhält. Speichern Sie eine Datei wie diese unter.claude/settings.json am oberen Ende des Repositories. Das sollten Sie vor dem Commit wissen:
- Cloud-Sitzungen außerhalb der Threads eines Projekts lesen sie auch. Eine Cloud-Sitzung mit einem Repository startet innerhalb des Klons, daher gilt die committete Datei auch dort.
- Telemetrie gehört in verwaltete oder persönliche Einstellungen. Claude Code ignoriert die OpenTelemetry-Exporter-Variablen in den Einstellungsdateien eines Repositories, mit Ausnahme einiger Werte, die Telemetrie deaktivieren. Legen Sie diese in verwalteten Einstellungen für Ihre Organisation fest, oder in der
~/.claude/settings.jsonjeder Person. - Allow-Regeln warten auf Vertrauen. Allow-Regeln und
extraKnownMarketplaces-Einträge werden wirksam, nachdem jede Person diesem Ordner selbst vertraut, nicht nur einem ü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.shaus; Wie ein Hook aufgelöst wird zeigt, wie man ihn schreibt. - Regeln entsprechen dem Befehl und Pfad wie geschrieben.
Bash(git push *)entspricht nichtgit -C . push.Read(./.env)allein stoppt die Datei-Tools und Befehle, die die Datei benennen, wiecat .env, aber nichtgrep -rüber das Verzeichnis ausgeführt; dersandbox-Block in dieser Datei schließt diese Lücke, da die Sandbox IhreRead-Deny-Pfade zu dem hinzufügt, was jeder Sandbox-Befehl nicht lesen kann.
- Kopierbare Einstellungsdatei
- Was jeder Schlüssel bewirkt
Speichern Sie diese als
.claude/settings.json am oberen Ende des Repositories und committen Sie sie. Es ist gültiges JSON ohne Kommentare, daher können Sie es so einfügen und die Schlüssel löschen, die Sie nicht möchten..claude/settings.json
Verwaltete Einstellungen einer Organisation
Einemanaged-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:
forceLoginMethodundforceLoginOrgUUIDfixieren die Anmeldemethode und OrganisationavailableModelsundenforceAvailableModelsbeschränken, welche Modelle Sitzungen verwenden könnenpermissions.denyblockiert zwei Dateilesevorgang undcurl-Befehle wie Claude sie schreibt, unddisableBypassPermissionsModeentfernt den Bypass-BerechtigungsmodusallowManagedPermissionRulesOnlyundallowManagedMcpServersOnlymachen die verwaltete Berechtigung und MCP-Zulassungslisten zu den einzigen, die geltenallowedMcpServersfixiert den MCP-Server nach URLstrictKnownMarketplaceserlaubt einen Plugin-Marketplacesandboxführt Befehle in einer Sandbox mit einer festen Netzwerk-Allowlist und ohne Wiederholungsversuch außerhalb der Sandbox aus. Sein SchlüsselfailIfUnavailableverhindert, dass Claude Code dort startet, wo die Sandbox nicht ausgeführt werden kannrequiredMinimumVersionsetzt eine Mindestversion für Claude CodecleanupPeriodDaysverkürzt die Aufbewahrung von Sitzungstranskripten und anderen lokalen Daten auf sieben TagecompanyAnnouncementszeigt eine Nachricht beim Start
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.
- Kopierbare Einstellungsdatei
- Was jeder Schlüssel tut
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