Verwaltete Einstellungen bereitstellen

​

Stellen Sie eine verwaltete Einstellungsdatei bereit

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./secrets/**)"
    ],
    "disableBypassPermissionsMode": "disable"
  },
  "allowManagedPermissionRulesOnly": true
}

​

Wählen Sie einen Bereitstellungsmechanismus

• Bereitstellungssteuerelemente: policyHelper, wslInheritsWindowsSettings und managedSourcesBehavior
• Gateway-Anmeldeschlüssel: forceLoginGatewayUrl und der "gateway"-Wert von forceLoginMethod

​

Wo und wann eine Richtlinie angewendet wird

• Oberflächen: Auf dem Rechner des Entwicklers lesen das Terminal, die VS Code- und JetBrains-Erweiterungen, die Registerkarte „Code” der Desktop-App und Agent SDK-Sitzungen alle diese Quellen. Agent SDK-Sitzungen laden verwaltete Einstellungen auch dann, wenn settingSources die Benutzer-, Projekt- und lokalen Dateien ausschließt.
• Cloud-Sitzungen: Eine Sitzung in einer von Anthropic gehosteten Umgebung liest kein MDM-Profil oder keine Datei eines Geräts, daher muss die Richtlinie dafür aus serververwalteten Einstellungen stammen. Eine Sitzung in einer selbstgehosteten Umgebung liest auch die verwaltete Einstellungsdatei in ihrem Runner-Image, standardmäßig nur wenn serververwaltete Einstellungen keinen Richtlinienschlüssel bereitstellen, mit Ausnahme der Schlüssel, die Claude Code aus jeder Admin-Quelle liest. Wie Claude Code verwaltete Quellen kombiniert behandelt das Opt-in, das beide anwendet.
• Cowork-Sitzungen: Cowork in der Claude Desktop-App führt ihre Sitzungen auf Claude Code aus. In einer Cowork-Sitzung ruft Claude Code niemals serververwaltete Einstellungen aus der claude.ai-Verwaltungskonsole ab, auch wenn sich der Benutzer mit einem Team- oder Enterprise-Konto anmeldet, daher hängt die angewendete Richtlinie davon ab, wo die Sitzung ausgeführt wird:
  • Auf dem Rechner des Benutzers: Standardmäßig liest Claude Code in einer Cowork-Sitzung die MDM- oder Richtlinie auf Betriebssystemebene und die verwaltete Einstellungsdatei auf diesem Gerät, daher stellen Sie die Richtlinie dort bereit.
  • In einer vollständigen VM-Sandbox: Wenn Ihre Claude Desktop-verwaltete Konfiguration requireCoworkFullVmSandbox setzt, wird Claude Code in einer virtuellen Maschine ausgeführt, in der die MDM-Richtlinie und die verwaltete Einstellungsdatei des Geräts nicht vorhanden sind.
  • Remote-Cowork-Sitzungen: Diese werden auf von Anthropic verwalteten VMs ausgeführt, wo Claude Code keine Geräterichtlinie zum Lesen hat.
  Die Tabelle Oberflächenabdeckung vergleicht Cowork mit den anderen Oberflächen.
• Laufende Sitzungen: Eine Sitzung nimmt die meisten Änderungen nach dem Zeitplan in der Tabelle ohne Neustart auf. Claude Code liest forceRemoteSettingsRefresh und requiredMinimumVersion nur beim Sitzungsstart, aktiviert einen neuen oder geänderten policyHelper-Eintrag beim nächsten Start und liest einige benutzerbearbeitbare Schlüssel einmal beim Sitzungsstart.
• Änderungen, die Genehmigung benötigen: Abgesehen von den Updates, die auf den nächsten Start warten, wartet eine serververwaltete Änderung an einer Einstellung, die Genehmigung benötigt, wie ein Hook oder eine env-Variable, darauf, dass der Entwickler den Dialog in einer interaktiven Sitzung akzeptiert, und wird für den aktuellen Lauf in einer Sitzung angewendet, die eine IDE-Erweiterung oder das Agent SDK hostet. Andere serververwaltete Änderungen werden bei der nächsten Abfrage angewendet.
• Langlebige Sitzungen: Eine Sitzung, die wochenlang offen bleibt, kann immer noch hinter einem Rollout zurückbleiben. requiredMinimumVersion blockiert den Start einer veralteten Binärdatei und beendet keine bereits laufende Sitzung.

​

Wo jeder Mechanismus die Richtlinie speichert

• Serververwaltete: Anthropics Server oder Ihr Gateway halten die Richtlinie. Claude Code behält einen lokalen Cache, den es beim Start anwendet und bei jedem erfolgreichen Abruf ersetzt.
• macOS-Konfigurationsprofil: die verwaltete Präferenzdomäne com.anthropic.claudecode. Verwenden Sie die gleichen Top-Level-Schlüssel wie managed-settings.json, mit verschachtelten Einstellungen als Wörterbücher und Listen als plist-Arrays.
• Windows HKLM-Registrierung: das JSON als REG_SZ- oder REG_EXPAND_SZ-Wert namens Settings unter HKLM\SOFTWARE\Policies\ClaudeCode.
• Dateibasiert: managed-settings.json, ein optionales managed-settings.d/-Verzeichnis und managed-mcp.json im Systemverzeichnis: /Library/Application Support/ClaudeCode/ auf macOS, /etc/claude-code/ auf Linux und WSL und C:\Program Files\ClaudeCode\ auf Windows. Claude Code liest den Legacy-Windows-Pfad C:\ProgramData\ClaudeCode\managed-settings.json nicht.
• Windows HKCU-Registrierung: der gleiche Settings-Wert unter HKCU\SOFTWARE\Policies\ClaudeCode.

​

Teilen Sie eine dateibasierte Richtlinie auf Teams auf

• Einzelne Werte, wie "model": "opus" oder "cleanupPeriodDays": 7: Der Wert der späteren Datei ersetzt den früheren
• Listen, wie permissions.deny oder sandbox.network.allowedDomains: Die beiden Listen kombinieren, mit entfernten Duplikaten
• Verschachtelte Blöcke, wie env oder sandbox: Die beiden Blöcke führen Schlüssel für Schlüssel zusammen, und jeder Schlüssel darin folgt den gleichen Regeln
• fallbackModel: Die spätere Kette ersetzt die frühere ganz
• extraKnownMarketplaces: Ein späterer Eintrag mit dem gleichen Namen ersetzt den früheren ganz
• modelPicker: Die spätere Aufstellung ersetzt die frühere ganz

​

Wie Claude Code verwaltete Quellen kombiniert

• "first-wins", die Standardeinstellung: Claude Code verwendet die höchstrangige Quelle, die mindestens einen Richtlinienschlüssel bereitstellt, und ignoriert den Rest, anstatt sie zusammenzuführen, mit Ausnahme der wenigen Schlüssel in Schlüssel, die aus jeder Admin-Quelle gelesen werden. Claude Code zeigt keine Warnung für die Quellen, die es überspringt; /status nennt die Quelle, die es verwendet, und die, die es übersprungen hat.
• "merge": Claude Code wendet jede Admin-Quelle an, die einen Richtlinienschlüssel bereitstellt, und kombiniert sie nach Art des Schlüssels: Bei den meisten Schlüsseln gilt der Wert der höherrangigen Quelle, Listen vereinigen sich und Sperren nehmen den strengsten Wert. Komponieren Sie jede verwaltete Quelle sagt, wo der Schlüssel zu setzen ist und wie sich jede Art von Schlüssel kombiniert. Erfordert Claude Code v2.1.242 oder später.

• Richtlinienschlüssel: Jeder Einstellungsschlüssel außer den zwei Steuerschlüsseln, wslInheritsWindowsSettings und managedSourcesBehavior. Eine verwaltete Einstellungsdatei oder MDM-Richtlinie, die nur diese enthält, zählt nicht, und Claude Code geht zur nächsten Quelle über.
• Admin-Quelle: Eine der ersten drei Quellen unten. Die HKCU-Registrierung ist benutzerbearbeitbar und ist keine.

1. Remote-Einstellungen, bereitgestellt von claude.ai als serververwaltete Einstellungen oder von einem Claude-Apps-Gateway. Claude Code ruft diese Quelle nur ab, wenn sich die Sitzung direkt mit Anthropics API mit einem berechtigten Login oder Schlüssel authentifiziert oder sich bei einem Gateway mit /login anmeldet. Bei anderen Anbietern oder wenn ANTHROPIC_BASE_URL auf etwas anderes als Anthropics API zeigt, beginnt es bei der nächsten Quelle
2. MDM- oder Richtlinien auf Betriebssystemebene: die macOS-plist oder der HKLM-Registrierungsschlüssel
3. Verwaltete Einstellungsdateien, managed-settings.d/*.json und managed-settings.json zusammengeführt
4. Die HKCU-Registrierung, auf Windows und auf WSL, sobald der HKLM-Registrierungsschlüssel oder die Windows-verwaltete Einstellungsdatei wslInheritsWindowsSettings einschaltet und der HKCU-Wert es auch setzt. Claude Code liest ihn nur, wenn keine Quelle darüber einen Richtlinienschlüssel bereitstellt und keine vom Host bereitgestellten übergeordneten Einstellungen einen restriktiven Schlüssel liefern

​

Schlüssel, die aus jeder Admin-Quelle gelesen werden

• sandbox.network.allowManagedDomainsOnly und sandbox.filesystem.allowManagedReadPathsOnly: Ein true in einer Admin-Quelle schaltet die Sperre ein. Während eine Sperre eingeschaltet ist, vereinigt Claude Code die Zulassungsliste, die sie sperrt, sandbox.network.allowedDomains zusammen mit WebFetch(domain:...)-Zulassungsregeln oder sandbox.filesystem.allowRead, über jede Admin-Quelle. Ohne die Sperre behandelt Claude Code die Zulassungsliste wie jeden anderen Schlüssel, daher wird unter "first-wins" die Zulassungsliste einer nicht ausgewählten Admin-Quelle ignoriert
• allowAllClaudeAiMcps
• Die Sandbox-Binärpfade sandbox.bwrapPath und sandbox.socatPath
• Die Sandbox-ripgrep-Binärdatei, sandbox.ripgrep
• sandbox.filesystem.disabled und sandbox.network.strictAllowlist
• useAutoModeDuringPlan und syncClaudeAiSkills, wobei ein false aus einer Admin-Quelle das Verhalten ausschaltet. Ein false in den Benutzer- oder lokalen Einstellungen des Entwicklers schaltet es auch aus; jeder Schlüssel kann nur verweigern
• enableArtifact, wobei ein false aus einer Admin-Quelle das Artifact-Tool ausschaltet. Ein false in den Benutzer-, Projekt- oder lokalen Einstellungen des Entwicklers schaltet es auch aus, und keine Quelle schaltet es wieder ein; siehe welche niedrigeren Werte dennoch zählen. Erfordert Claude Code v2.1.242 oder später
• Ein Commit-Trailer-Opt-out in attribution oder im veralteten includeCoAuthoredBy aus einer beliebigen Ebene
• forceRemoteSettingsRefresh
• env, zusammengeführt pro Variable über die Admin-Quellen: Jede Variable kommt aus der höchstpriorität Quelle, die sie definiert, daher füllen niedrigere Quellen Variablen, die höhere nicht setzen. Einige Variablen folgen ihren eigenen Regeln; Pro-Schlüssel-Ausnahmen über verwaltete Quellen nennt jede. Erfordert Claude Code v2.1.223 oder später. Vor v2.1.223 wendete Claude Code nur den ganzen env-Block der ausgewählten Quelle an

​

Komponieren Sie jede verwaltete Quelle

​

Berechnen Sie die Richtlinie mit einem Helper-Programm

• Das ausgegebene managedSettings-Objekt ist die einzige verwaltete Einstellung für die Sitzung, einschließlich für die Schlüssel, die es sonst aus jeder Admin-Quelle liest, mit Ausnahme von forceRemoteSettingsRefresh, das Claude Code in jeder Admin-Quelle beim Start überprüft, bevor der Helper läuft. Für welche Helper-Läufe fehlschlagen und was Claude Code macht, wenn einer es tut, siehe Helper-Fehler

​

Lassen Sie einen Embedding-Host Richtlinie hinzufügen

• Wenn eine Admin-Quelle allowManagedPermissionRulesOnly setzt, löscht Claude Code vom Host bereitgestellte Zulassungsregeln und additionalDirectories beim Lesen, auch wenn eine höherpriorität Quelle den Schlüssel nicht setzt. Die Auswirkung des Schlüssels auf Ihre eigenen Berechtigungsregeln kommt aus den verwalteten Einstellungen, die Claude Code anwendet, oder aus übergeordneten Einstellungen, die Sie zusammenführen möchten
• Claude Code erzwingt den Wert forceLoginOrgUUID oder allowedMcpServers in den verwalteten Einstellungen, die es anwendet, und blockiert einen vom Host bereitgestellten. Ein Wert in einer niedrigeren Admin-Quelle, die Claude Code nicht anwendet, wendet sich weder an noch blockiert den Wert des Hosts. Der Eintrag managedSourcesBehavior sagt, welche Quelle jeden Schlüssel unter "merge" liefert. Vor v2.1.223 blockierte ein Wert in einer Admin-Quelle den Wert des Hosts
• Ein availableModels-Wert folgt der gleichen Regel wie allowedMcpServers

​

Behalten Sie Cowork-Ordnerzugriff, wenn nur verwaltete Regeln gelten

{
  "allowManagedPermissionRulesOnly": true,
  "permissions": {
    "allow": [
      "Edit(~/CoworkProjects/**)"
    ]
  }
}

​

Was ein Entwickler ändern kann

• Das Modell für eine Sitzung: Ein verwaltetes model ist ein Standard, keine Sperre. --model und ANTHROPIC_MODEL wählen immer noch das Modell für diese Sitzung, daher stellen Sie availableModels bereit, um die Auswahl einzuschränken.
• Lokale Administratorrechte: Ein Entwickler, der Administrator auf dem Rechner ist, kann die verwaltete Quelle selbst bearbeiten, weshalb MDM-Tools das Profil oder die Datei nach einem Zeitplan erneut bereitstellen können und weshalb der HKLM-Registrierungsschlüssel und die macOS-verwaltete Präferenzdomäne existieren.
• Der serververwaltete Cache: Serververwaltete Einstellungen stammen von Anthropics Servern, und eine Bearbeitung des lokalen Cache dauert nur bis zum nächsten erfolgreichen Abruf.
• Andere Tools: Verwaltete Einstellungen binden nur Claude Code. Ein Entwickler, der die API von einem anderen Tool aufruft, unterliegt ihnen nicht.

​

Überprüfen Sie, dass eine Richtlinie in Kraft ist

​

Lesen Sie die Quelle in /status

• (remote): Serververwaltete Einstellungen von claude.ai oder einem Gateway
• (plist) oder (HKLM): Eine MDM- oder Betriebssystemrichtlinie
• (file), (drop-ins) oder (file + drop-ins): managed-settings.json, das Drop-in-Verzeichnis oder beide
• (remote + file, merged) oder eine andere Liste, die mit , merged endet: Ihre Organisation komponiert jede verwaltete Quelle, und Claude Code führte die aufgelisteten Quellen in die Richtlinie zusammen. Eine niedrigere Quelle kann immer noch env-Variablen liefern, ohne in der Liste zu erscheinen. Erfordert Claude Code v2.1.242 oder später
• (HKCU): Der benutzerbearbeitbare Registrierungs-Fallback
• (parent process): Ein Embedding-Host lieferte restriktive Einstellungen
• (helper): Ein policyHelper, der von der ausgewählten MDM- oder Dateiqu konfiguriert wurde

• Die Zeile fehlt: Claude Code fand keine verwaltete Quelle, die einen Richtlinienschlüssel bereitstellt. Wenn Sie eine verwaltete Einstellungsdatei bereitgestellt haben, überprüfen Sie, dass sie sich am Pfad für das Betriebssystem befindet und dass sie einen Richtlinienschlüssel anstelle nur der Steuerschlüssel enthält. Eine Datei, die kein gültiges JSON ist, erzeugt diesen Zustand nicht; Claude Code weigert sich zu starten stattdessen. Wenn Sie stattdessen über serververwaltete Einstellungen bereitgestellt haben, führen Sie claude doctor aus, das das Abrufergebnis meldet.
• Die Zeile nennt eine Quelle, die nicht die ist, die Sie bereitgestellt haben: Eine höherpriorität Quelle ist vorhanden und Claude Code ignorierte Ihre, und Skipped sources listet sie auf. Wie Claude Code verwaltete Quellen kombiniert gibt die Reihenfolge.

​

Finden Sie Einträge, die Claude Code gelöscht hat

• Verwaltete Einstellungsdatei oder Drop-in-Datei: Die Datei ist kein gültiges JSON oder ihre Top-Ebene ist kein Objekt
• MDM-plist: macOS’s plutil meldet die plist als fehlerhaft oder ihr konvertierter Inhalt ist kein JSON-Objekt
• HKLM-Registrierungswert: Der Settings-Wert ist keine Zeichenkette, ist leer oder enthält kein JSON-Objekt

• Eine fehlende Datei, ein fehlendes Profil oder ein fehlender Registrierungswert ist kein Fehler; Claude Code läuft ohne diese Quelle.
• Eine leere verwaltete Einstellungsdatei zählt als {}.
• Ein fehlerhafter Wert im benutzerbearbeitbaren HKCU-Registrierungsschlüssel blockiert niemals den Start. Claude Code meldet ihn stattdessen als Hinweis in /status und claude doctor.

• Interaktive Sitzungen zeigen beim Start einen Dialog mit den ungültigen Einträgen.
• Nicht-interaktive Läufe mit -p drucken eine Zusammenfassung auf stderr.
• claude doctor listet jeden ungültigen Eintrag mit seiner Quelle und seinem Feld auf.

​

Schlüssel, die geschlossen fehlschlagen

​

Schlüssel, die nur eine verwaltete Quelle setzen kann

​

Schalten Sie Telemetrie für Ihre Organisation aus

{
  "env": {
    "DISABLE_TELEMETRY": "1"
  }
}

​

Siehe auch

• Richten Sie Claude Code für Ihre Organisation ein: Entscheiden Sie, was durchgesetzt werden soll und wie
• Serververwaltete Einstellungen: Liefern Sie Richtlinie aus der claude.ai-Konsole oder einem Gateway
• Verwaltete MCP-Konfiguration: Steuern Sie, welche MCP-Server Entwickler verwenden können
• Alle Einstellungen: Jeder Schlüssel, mit ob eine verwaltete Quelle ihn setzen kann
• Beispiel-Einstellungsdateien: Eine vollständige managed-settings.json, die die Form der verwalteten Schlüssel zeigt