Serververwaltete Einstellungen konfigurieren

Konfigurieren Sie Claude Code zentral für Ihre Organisation durch serververwaltete Einstellungen, ohne dass eine Geräteverwaltungsinfrastruktur erforderlich ist.

Serververwaltete Einstellungen ermöglichen es Organisationsinhabern, Claude Code zentral über Admin-Einstellungen > Claude Code > Verwaltete Einstellungen in der claude.ai-Konsole zu konfigurieren. Claude Code-Clients rufen diese Einstellungen automatisch ab, wenn sich Benutzer mit geeigneten Anmeldedaten auf einer Plattform authentifizieren, auf der die serververwaltete Bereitstellung unterstützt wird. Siehe Plattformverfügbarkeit für die Anmeldedaten und Plattformen, die sich qualifizieren.

Anforderungen

Um serververwaltete Einstellungen zu verwenden, benötigen Sie:

• Claude for Teams oder Claude for Enterprise Plan
• Die Rolle „Owner" oder „Primary Owner" in Ihrer Claude-Organisation, um die Konfiguration anzuzeigen und zu bearbeiten
• Netzwerkzugriff auf api.anthropic.com

Wählen Sie zwischen serververwalteten und endpunktverwalteten Einstellungen

Claude Code unterstützt zwei Ansätze für zentralisierte Konfiguration. Serververwaltete Einstellungen liefern Konfiguration von Anthropics Servern. Endpunktverwaltete Einstellungen werden direkt auf Geräten über native Betriebssystemrichtlinien (macOS verwaltete Einstellungen, Windows-Registrierung) oder verwaltete Einstellungsdateien bereitgestellt.

Wenn Ihre Geräte in einer MDM- oder Endpunktverwaltungslösung registriert sind, bieten endpunktverwaltete Einstellungen stärkere Sicherheitsgarantien, da die Einstellungsdatei auf Betriebssystemebene vor Benutzermodifikationen geschützt werden kann. Endpunktverwaltete Einstellungen erreichen Cloud-Sitzungen in von Anthropic gehosteten Umgebungen nicht, daher sollten Organisationen, die Claude Code im Web verwenden, auch serververwaltete Einstellungen konfigurieren. Sitzungen in einer selbstgehosteten Umgebung lesen auch die verwaltete Einstellungsdatei im Runner-Image. Die Einstellungspriorität unten gibt an, wann diese Datei gilt.

Serververwaltete Einstellungen konfigurieren

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

{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{ "type": "command", "command": "/usr/local/bin/audit-edit.sh" }
]
}
]
}
}

Einstellungsbereitstellung überprüfen

Um zu bestätigen, dass Einstellungen angewendet werden, bitten Sie einen Benutzer, Claude Code neu zu starten. Wenn die Konfiguration Einstellungen enthält, die den Sicherheitsgenehmigungsdialog auslösen, sieht der Benutzer beim nächsten Abruf der Einstellungen durch Claude Code eine Eingabeaufforderung, die die verwalteten Einstellungen beschreibt: beim nächsten Start oder innerhalb einer Stunde in einer laufenden interaktiven Sitzung. Sie können auch überprüfen, dass verwaltete Berechtigungsregeln aktiv sind, indem Sie einen Benutzer /permissions ausführen lassen, um seine geltenden Berechtigungsregeln anzuzeigen.

Um das Abrufergebnis auf einem bestimmten Computer zu überprüfen, lassen Sie den Benutzer claude doctor ausführen und lesen Sie die Zeile Managed settings (remote). Erfordert Claude Code v2.1.248 oder später. Die Zeile meldet eines von vier Ergebnissen:

• Die bereitgestellten Einstellungen wurden geladen
• Ihre Organisation hat keine serververwalteten Einstellungen konfiguriert
• Der Abruf ist fehlgeschlagen, mit der Ursache und ob eine zwischengespeicherte Richtlinie noch gilt
• Claude Code hat den Abruf übersprungen, mit dem Grund. Siehe Plattformverfügbarkeit für die Anbieter und Konfigurationen, die ihn überspringen

Während der Abruf noch läuft, meldet die Zeile das stattdessen.

In einer laufenden Sitzung zeigt /status die gleiche Zeile nach einem fehlgeschlagenen Abruf an, und für einige übersprungene Abrufe, wie z. B. eine Variable eines Drittanbieter-Anbieters oder eine benutzerdefinierte ANTHROPIC_BASE_URL, die in der Shell des Benutzers exportiert wird.

Zugriffskontrolle

Die folgenden Rollen können serververwaltete Einstellungen verwalten:

• Primärer Eigentümer
• Eigentümer

Beschränken Sie den Zugriff auf vertrauenswürdiges Personal, da Einstellungsänderungen für alle Benutzer in der Organisation gelten.

Nur verwaltete Einstellungen

Die meisten Einstellungsschlüssel funktionieren in jedem Bereich. Eine Handvoll Schlüssel werden nur aus verwalteten Einstellungen gelesen und haben keine Auswirkung, wenn sie in Benutzer- oder Projekteinstellungsdateien platziert werden. Siehe nur verwaltete Einstellungen für die Berechtigung und Plugin-Steuerelemente, oder lesen Sie die Spalte „Bereich" des Alle Einstellungen Index für den vollständigen Satz.

Aktuelle Einschränkungen

Serververwaltete Einstellungen haben die folgenden Einschränkungen:

• Einstellungen gelten einheitlich für alle Benutzer in der Organisation. Konfigurationen pro Gruppe werden noch nicht unterstützt.

• Eine managed-mcp.json Datei kann nicht über serververwaltete Einstellungen verteilt werden. Stellen Sie stattdessen die Richtlinienschlüssel allowedMcpServers und deniedMcpServers dort bereit. Ab Claude Code v2.1.259 können Sie auch Remote-Server mit managedMcpServers bereitstellen, das nur http- und sse-Server akzeptiert und nicht die exklusive Kontrolle übernimmt, wie die Datei es tut.

  Claude Code liest eine managed-mcp.json, die in seinem Systempfad bereitgestellt wird, separat von der Ebene der verwalteten Einstellungen, sodass die Datei weiterhin gilt, wenn serververwaltete Einstellungen in Kraft sind.

• Einstellungen, die auf OS-Ebene-Richtlinienquellen beschränkt sind, wie policyHelper und wslInheritsWindowsSettings, werden nicht berücksichtigt. Stellen Sie sie stattdessen über MDM oder eine System-Datei managed-settings.json bereit. Ein policyHelper, der auf diese Weise bereitgestellt wird, wird nur ausgeführt, wenn seine Quelle die unter Vorrang innerhalb der verwalteten Ebene ausgewählte ist.

Einstellungsbereitstellung

Einstellungspriorität

Serververwaltete Einstellungen und endpunktverwaltete Einstellungen nehmen beide die höchste Ebene in der Claude Code Einstellungshierarchie ein. Keine andere Einstellungsebene kann sie überschreiben, einschließlich Befehlszeilenargumenten, abgesehen von den Ausnahmen zur Priorität verwalteter Einstellungen.

Innerhalb der verwalteten Ebene verwendet Claude Code standardmäßig die erste Quelle, die mindestens einen Richtlinienschlüssel liefert, wobei zuerst serververwaltete Einstellungen überprüft werden und dann endpunktverwaltete Einstellungen, abgesehen von der Ausnahmeregelung für Schlüssel, die als nächstes behandelt wird. Wie Claude Code verwaltete Quellen kombiniert enthält die vollständige Rangfolge, die Ausnahmeregelung für die Steuerschlüssel und die Opt-in-Option, die für jede Quelle gilt.

Wenn die ausgewählte Quelle eine MDM-Richtlinie oder verwaltete Einstellungsdatei ist, deren policyHelper verwaltete Einstellungen liefert, ersetzt die Ausgabe des Helpers diese Quelle als einzige verwaltete Konfiguration für den Lauf. Claude Code konsultiert einen policyHelper, der in MDM oder dateigestützten Einstellungen konfiguriert ist, nicht, während serververwaltete Einstellungen einen Richtlinienschlüssel liefern.

Wenn ein späterer Abruf feststellt, dass die serververwalteten Einstellungen entfernt wurden, führt Claude Code diesen Helper sofort aus, anstatt beim nächsten Start. Der policyHelper Eintrag behandelt, was passiert, wenn dieser Lauf fehlschlägt.

Wenn Sie Ihre serververwaltete Konfiguration in der Admin-Konsole mit der Absicht löschen, auf eine endpunktverwaltete plist oder Registrierungsrichtlinie zurückzugreifen, beachten Sie, dass zwischengespeicherte Einstellungen auf Client-Maschinen bestehen bleiben, bis der nächste erfolgreiche Abruf erfolgt, und die Schlüssel, die nur beim nächsten Start gelten, wie model, bleiben wirksam, bis jeder Client neu gestartet wird. Führen Sie /status aus, um zu sehen, welche verwaltete Quelle aktiv ist.

Ausnahmen pro Schlüssel über verwaltete Quellen hinweg

Drei Arten von Schlüsseln sind Ausnahmen von der Nicht-Zusammenführungsregel:

• Quellübergreifende Sperr-Schlüssel: ein kleiner Satz von Schlüsseln, wie die Sandbox-Zulassungslisten-Sperren, aufgelistet auf der Seite für verwaltete Einstellungen. Claude Code berücksichtigt sie, wenn eine beliebige administratorgesteuerte verwaltete Quelle sie setzt; die benutzerbare HKCU-Registrierungsebene ist ausgeschlossen. Wenn ein policyHelper verwaltete Einstellungen liefert, ist seine Ausgabe die einzige Quelle, die diese Überprüfungen lesen, abgesehen von forceRemoteSettingsRefresh, das Claude Code beim Start direkt aus den administratorgesteuerten Quellen liest.
• Der env-Block: abgesehen von der Telemetrie-Einheit und Routing-Variablen, die mit einem Anmeldedatenschlüssel gekoppelt sind, beide unten behandelt, wird er pro Schlüssel über die administratorgesteuerten Quellen hinweg zusammengeführt. Für jede Umgebungsvariable gewinnt die höchstpriorisierte Quelle, die sie definiert, und niedrigere administratorgesteuerte Quellen füllen Variablen aus, die die höheren Quellen nicht setzen. Ein endpunktverwalteter env-Eintrag gilt daher, wenn die serververwaltete Konfiguration diese Variable nicht setzt, oder während ein zwischengespeicherter Serverwert dafür zurückgehalten wird, bis der Server ihn bestätigt. Erfordert Claude Code v2.1.223 oder später. Vor v2.1.223 wendet Claude Code nur den env-Block der ausgewählten Quelle an.
  • Telemetrie-Einheit: die OTEL_EXPORTER_OTLP_* Exporter-Schlüssel, die OTEL_LOG_* Inhaltserfassungs-Umschalter, OTEL_LOGS_EXPORTER und die Beta-Tracing-Variablen ENABLE_BETA_TRACING_DETAILED und BETA_TRACING_ENDPOINT folgen der höchsten Quelle, die eine von ihnen als Einheit setzt. Eine Quelle, die den otelHeadersHelper Anmeldedatenschlüssel liefert, beansprucht die Einheit auch, landet diese Variablen aber nur, wenn sie die ausgewählte Quelle ist: Eine Quelle, die nicht ausgewählt ist, aber den Schlüssel liefert, trägt keine von ihnen bei und blockiert immer noch niedrigere Quellen davon, sie auszufüllen. In jedem Fall kann ein Exporter-Endpunkt von einer Quelle niemals mit Anmeldedaten von einer anderen gekoppelt werden.
  • Anmeldedaten-gekoppeltes Routing: eine Quelle, die Routing-Variablen mit einem Anmeldedatenschlüssel nur für die ausgewählte Quelle, wie apiKeyHelper oder otelHeadersHelper, koppelt, trägt diese Routing-Variablen nur bei, wenn sie den Slot gewinnt.
• Gateway-Anmeldeschlüssel: Claude Code liest forceLoginGatewayUrl oder den "gateway" Wert von forceLoginMethod niemals aus serververwalteten Einstellungen, daher liefert die Auswahl serververwalteter Einstellungen weder eine Gateway-Anmeldung noch verbirgt eine in einer MDM-Richtlinie oder verwalteten Einstellungsdatei gesetzte. Der managedSourcesBehavior Eintrag sagt, welche administratorgesteuerte Quelle auf der Maschine sie liefert.

Abruf- und Caching-Verhalten

Claude Code ruft Einstellungen beim Start von Anthropics Servern ab und fragt stündlich während aktiver Sitzungen nach Updates ab.

Ein Client, der sich über ein Claude-Apps-Gateway angemeldet hat, ruft seine Einstellungen vom Gateway ab und wartet auf diesen Abruf, bevor die Sitzung beginnt, daher gilt der Abruf in den folgenden Listen nicht dafür. Erzwingen Sie einen Fail-Closed-Start behandelt, was passiert, wenn dieser Abruf fehlschlägt.

Erster Start ohne zwischengespeicherte Einstellungen:

• Wenn sich ein Entwickler beim Start anmeldet, z. B. beim ersten Lauf oder nach /logout, wartet Claude Code bis zu fünf Sekunden auf den Abruf, bevor die Sitzung geöffnet wird. Wenn die Richtlinie rechtzeitig ankommt, erzwingt Claude Code sie vom ersten Bildschirm an und zeigt Ihre companyAnnouncements darauf an. Wenn die Payload Sicherheitsgenehmigung benötigt, beendet Claude Code das Warten und wendet die Payload an, sobald der Entwickler sie genehmigt
• Bei jedem anderen Start und wenn diese fünf-Sekunden-Wartezeit abläuft, öffnet Claude Code die Sitzung, während der Abruf fortgesetzt wird, sodass ein kurzes Fenster verstreicht, bevor die Einstellungen geladen werden und die Einschränkungen wirksam werden
• Wenn der Abruf fehlschlägt, wird Claude Code ohne serververwaltete Einstellungen fortgesetzt und warnt in interaktiven Sitzungen, dass keine Remote-Richtlinie gilt; endpunktverwaltete Einstellungen gelten immer noch. Wenn eine verwaltete Quelle forceRemoteSettingsRefresh setzt, wird Claude Code stattdessen beendet

Nachfolgende Starts mit zwischengespeicherten Einstellungen:

• Zwischengespeicherte Einstellungen werden beim Start sofort angewendet, außer für die zwischengespeicherten modelPricing und managedMcpServers Werte und die Umgebungsvariablen, die Claude Code zurückhält, bis der Server die Payload bestätigt
• Ein zwischengespeichertes modelPricing wird nicht angewendet, bis der Abruf der Sitzung die Payload bestätigt. Bis dahin sind die Kostenzahlen, die Entwickler in /usage und in der Statuszeile sehen, zum Listenpreis
• Ein zwischengespeicherter managedMcpServers Block wird nicht angewendet, bis der Abruf der Sitzung die Payload bestätigt. Claude Code wartet bis zu 30 Sekunden auf diesen Abruf, bevor MCP-Server verbunden werden. Wenn der Abruf fehlschlägt oder das Zeitlimit überschritten wird, startet die Sitzung ohne die Server der Organisation, /status sagt dies, und sie verbinden sich, sobald ein späterer Abruf sie bestätigt. Siehe Wenn bereitgestellte Server verbunden werden für das vollständige Verhalten, einschließlich des ersten Starts. Erfordert Claude Code v2.1.259 oder später
• Claude Code ruft frische Einstellungen im Hintergrund ab
• Zwischengespeicherte Einstellungen bleiben bei Netzwerkfehlern erhalten. Wenn der Startup-Abruf fehlschlägt, warnt Claude Code in interaktiven Sitzungen, dass die zwischengespeicherte Richtlinie wirksam ist
• Bis ein Abruf erfolgreich ist, bleiben die beim Start zurückgehaltenen Werte zurückgehalten

Claude Code hält mehrere Kategorien von Variablen im zwischengespeicherten env-Block zurück, bis der Server die Payload für die Sitzung bestätigt. Dies verhindert, dass ein zwischengespeicherter Proxy-, Zertifizierungsstellen-, Endpunkt- oder Anmeldedatenwert den Einstellungsabruf umleitet, abfängt oder erneut authentifiziert, der die Payload bestätigt. Die Härtung gilt nur für den vom Server abgerufenen Einstellungs-Cache: endpunktverwaltete Einstellungen, die über MDM oder managed-settings.json bereitgestellt werden, sind nicht betroffen. Das Zurückhalten erfordert Claude Code v2.1.198 oder später; vor v2.1.198 wird der gesamte zwischengespeicherte env-Block beim Start angewendet. Die zurückhaltenden Kategorien umfassen:

• Proxy- und TLS-Konfiguration, wie HTTPS_PROXY, NODE_EXTRA_CA_CERTS und die mTLS-Client-Zertifikatvariablen CLAUDE_CODE_CLIENT_CERT und CLAUDE_CODE_CLIENT_KEY
• API-Routing und Anbieterauswahl, einschließlich ANTHROPIC_BASE_URL, der Anbieterauswahlvariablen wie CLAUDE_CODE_USE_BEDROCK und CLAUDE_CODE_USE_VERTEX und der Anbieter-Endpunkt-URLs wie ANTHROPIC_BEDROCK_BASE_URL
• Authentifizierungsanmeldedaten, wie ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN und CLAUDE_CODE_OAUTH_TOKEN
• Der Konfigurationsverzeichnis-Selektor CLAUDE_CONFIG_DIR
• Anmeldedaten-Quellen- und Konfigurationsverzeichnis-Selektoren, in Claude Code v2.1.223 oder später: die Workload Identity Federation-Variablen wie ANTHROPIC_FEDERATION_RULE_ID und ANTHROPIC_IDENTITY_TOKEN, die Profil- und Konfigurationsverzeichnis-Selektoren ANTHROPIC_PROFILE und ANTHROPIC_CONFIG_DIR und die Betriebssystem-Verzeichnisvariablen HOME, XDG_CONFIG_HOME, APPDATA und USERPROFILE

Claude Code liest die Workload Identity Federation-Variablen und die ANTHROPIC_PROFILE und ANTHROPIC_CONFIG_DIR Selektoren nur beim Start, daher wechselt ein vom Server bereitgestellter Wert dafür die Anmeldedatenquelle der Sitzung nicht, auch nachdem der Abruf erfolgreich ist. Um diese Selektoren auf Claude Code v2.1.223 oder später bereitzustellen, verwenden Sie endpunktverwaltete Einstellungen wie MDM oder managed-settings.json. Für CLAUDE_CONFIG_DIR und die Betriebssystem-Verzeichnisvariablen ist das Zurückhalten selbst der Schutz: Der zwischengespeicherte Wert bleibt aus der Umgebung, bis der Server die Payload bestätigt.

Jeder andere Schlüssel im zwischengespeicherten env-Block wird beim Start angewendet. Sobald der Server die Payload bestätigt und Sie sie genehmigen, wenn sie Sicherheitsgenehmigung benötigt, werden die zurückgehaltenen Variablen für den Rest der Sitzung angewendet.

Wenn Ihre Organisation einen Proxy benötigt, um api.anthropic.com zu erreichen, betrifft das Zurückhalten nur den vom Server bereitgestellten env-Block selbst: Ein Proxy, der in einem endpunktverwalteten env-Block über MDM oder managed-settings.json, in der Shell-Umgebung oder in Benutzereinstellungen gesetzt ist, erreicht den Einstellungsabruf. Die endpunktverwaltete Quelle erfordert Claude Code v2.1.223 oder später: Der zwischengespeicherte serververwaltete Proxy-Wert wird zurückgehalten, bis der Abruf ihn bestätigt, daher füllt der endpunktverwaltete Wert pro Schlüssel aus und erreicht den Abruf selbst. Vor v2.1.223 verwenden Sie die Shell-Umgebung oder Benutzereinstellungen, damit der Proxy neben einer zwischengespeicherten Server-Payload gilt. Der erste Start hat keinen Cache, daher ist eine endpunktverwaltete Quelle, die Shell-Umgebung oder Benutzereinstellungen immer noch für den anfänglichen Abruf erforderlich.

Claude Code wendet die meisten Einstellungsaktualisierungen auf laufende Sitzungen ohne Neustart an. Einige Aktualisierungen gelten nur beim nächsten Start, einschließlich OpenTelemetry-Exporter-Konfiguration, des model-Schlüssels und der Entfernung einer Variablen aus dem env-Block.

Ungültige Einträge in bereitgestellten Einstellungen

Wenn ein Teil einer Payload die Schemavalidierung nicht besteht, zeigt Claude Code einen Validierungsfehler an und wendet jede verbleibende gültige Einstellung an; Ungültige Einträge in verwalteten Einstellungen sagt, was es entfernt und welche Schlüssel auf einen strengeren Wert zurückfallen. Erfordert Claude Code v2.1.169 oder später.

Die serververwaltete Bereitstellung fügt diese Verhaltensweisen hinzu:

• Der Cache unter ~/.claude/remote-settings.json speichert die gerettete Payload mit entfernten ungültigen Einträgen, abgesehen von ungültigen cleanupPeriodDays und desktopSessionCleanupPeriodDays Werten, die in der zwischengespeicherten Kopie bleiben und niemals angewendet werden.
• Wenn kein Feld in der Payload gerettet werden kann und die Payload nicht nur diese Aufbewahrungsschlüssel ist, lehnt Claude Code die Payload ab, behält die zuletzt akzeptierten zwischengespeicherten Einstellungen bei und schreibt Remote settings: Settings validation failed - no fields could be salvaged in das Debug-Protokoll. Mit forceRemoteSettingsRefresh gesetzt, wird die CLI stattdessen beendet.
• Der Sicherheitsgenehmigungsdialog bewertet die gerettete Payload, daher wird ein entfernter ungültiger Eintrag niemals zur Genehmigung präsentiert und niemals ausgeführt.

Um Bereitstellungsprobleme zu debuggen, führen Sie claude --debug-file <path> aus und suchen Sie im Protokoll nach Remote settings. Validieren Sie eine Payload-Änderung mit claude doctor auf einem Test-Computer, bevor Sie sie in der Organisation bereitstellen.

Erzwingen Sie einen Fail-Closed-Start

Standardmäßig wird die CLI, wenn der Abruf der Remote-Einstellungen beim Start fehlschlägt, mit den beim letzten erfolgreichen Abruf zwischengespeicherten Einstellungen fortgesetzt, außer für die Werte, die Claude Code zurückhält, bis ein Abruf gelingt. Auf einer Maschine, die sie noch nie abgerufen hat, wird die CLI ohne serververwaltete Einstellungen fortgesetzt und wendet immer noch alle endpunktverwalteten Einstellungen auf dem Gerät an.

Um Clients daran zu hindern, mit zwischengespeicherten oder fehlenden serververwalteten Einstellungen zu starten, setzen Sie forceRemoteSettingsRefresh: true in Ihren verwalteten Einstellungen.

Clients, die sich über ein Claude-Apps-Gateway angemeldet haben, warten auf den Startup-Abruf, unabhängig davon, ob Sie diese Einstellung setzen oder nicht, und handhaben einen fehlgeschlagenen Abruf wie folgt:

• Wenn das Gateway einen beaufsichtigten interaktiven Start mit einem 401 beantwortet und diese Einstellung deaktiviert ist, hat das Gateway diese Anmeldung beendet. Claude Code druckt Cloud gateway session expired — run /login to reconnect. und öffnet die Sitzung vom Gateway abgemeldet, bis der Benutzer /login ausführt.
• Wenn der Abruf auf andere Weise fehlschlägt, oder bei jeder anderen Art von Start außer einem claude auth Unterbefehl, wird der Client mit einem Fehler beendet.

Wenn diese Einstellung in einer Sitzung aktiv ist, die serververwaltete Einstellungen abruft, blockiert die CLI beim Start, bis Remote-Einstellungen neu abgerufen werden. Wenn der Abruf fehlschlägt, wird die CLI beendet, anstatt ohne die Richtlinie fortzufahren. Diese Einstellung perpetuiert sich selbst: Sobald sie vom Server bereitgestellt wird, wird sie auch lokal zwischengespeichert, sodass nachfolgende Starts das gleiche Verhalten erzwingen, auch bevor der erste erfolgreiche Abruf einer neuen Sitzung erfolgt. Eine Sitzung, die serververwaltete Einstellungen nicht abruft, startet ohne zu warten.

Um dies zu aktivieren, fügen Sie den Schlüssel zu Ihrer verwalteten Einstellungskonfiguration hinzu:

{
  "forceRemoteSettingsRefresh": true
}

Sie können diesen Schlüssel auch in einem endpunktverwalteten MDM-Profil oder einer System-Datei managed-settings.json setzen, um Fail-Closed-Verhalten beim ersten Start durchzusetzen, bevor eine Server-Payload bereitgestellt wurde. In Claude Code v2.1.191 oder später ist dieses Flag eine Ausnahme von der Prioritätsregel oben: Claude Code berücksichtigt es, wenn es in einer beliebigen administratorgesteuerten verwalteten Quelle gesetzt ist, auch wenn eine zwischengespeicherte serververwaltete Payload vorhanden ist, daher wird ein MDM-bereitgestellter Wert nicht ignoriert, wenn serververwaltete Einstellungen vorhanden sind.

Wenn ein policyHelper verwaltete Einstellungen liefert, ersetzt seine Ausgabe jede andere verwaltete Quelle für die Schlüssel, die Claude Code nach dem Start liest. Für die Quellen, aus denen Claude Code diesen Schlüssel liest, siehe seinen Einstellungseintrag. Der policyHelper Eintrag sagt, welche Quellen Claude Code den Helper aus liest und wann er ausgeführt wird.

Der Einstellungsabruf sendet auch einen Cache-Control: no-cache Header, sodass zwischengeschaltete HTTP-Proxys keine veraltete Antwort bereitstellen.

Bevor Sie diese Einstellung aktivieren, stellen Sie sicher, dass Ihre Netzwerkrichtlinien die Konnektivität zu api.anthropic.com ermöglichen. Wenn dieser Endpunkt nicht erreichbar ist, wird die CLI beim Start beendet und Benutzer können Claude Code nicht starten.

Die claude auth Unterbefehle wie claude auth login sind von dieser Überprüfung und vom Gateway-Startup-Exit ausgenommen, daher können Benutzer sich erneut authentifizieren, wenn abgelaufene Anmeldedaten der Grund für den fehlgeschlagenen Einstellungsabruf sind.

Sicherheitsgenehmigungsdialoge

Bestimmte Einstellungen, die Sicherheitsrisiken darstellen könnten, erfordern explizite Benutzergenehmigung, bevor Claude Code sie in einer interaktiven Sitzung anwendet:

• Shell-Befehlseinstellungen: Einstellungen, die Shell-Befehle ausführen, wie apiKeyHelper, statusLine und otelHeadersHelper
• Sandbox-Binär-Einstellungen: sandbox.bwrapPath, sandbox.socatPath und sandbox.ripgrep. Jede dieser Einstellungen verweist auf eine ausführbare Datei, und Claude Code führt diese ausführbare Datei aus
• Sandbox-Netzwerk- und Isolationseinstellungen: Sandbox Einstellungen, die dem Sandbox-Proxy ermöglichen, Datenverkehr zu lesen, umzuleiten oder zu authentifizieren, oder die die Isolation der Sandbox schwächen: sandbox.network.tlsTerminate, sandbox.network.httpProxyPort, sandbox.network.socksProxyPort, sandbox.credentials, sandbox.allowAppleEvents, sandbox.enableWeakerNestedSandbox, sandbox.enableWeakerNetworkIsolation, sandbox.filesystem.disabled, sandbox.network.allowAllUnixSockets, sandbox.network.allowUnixSockets und sandbox.network.allowMachLookup. Ein sandbox.credentials Block, der nur deny Regeln enthält, benötigt keine Genehmigung, da er die Sandbox einschränkt, ohne dem Proxy Anmeldedaten zu geben. Vor v2.1.251 wendete Claude Code diese Einstellungen ohne Genehmigung an
• Benutzerdefinierte Umgebungsvariablen: bereitgestellte env Variablen, die die Genehmigung des Benutzers erfordern, wie Proxy- und Base-URL-Variablen; siehe Umgebungsvariablen und der Genehmigungsdialog
• Hook-Konfigurationen: jede Hook-Definition

Wenn diese Einstellungen vorhanden sind, sehen Benutzer einen Sicherheitsdialog, der erklärt, was konfiguriert wird. Benutzer müssen genehmigen, um fortzufahren. Wenn ein Benutzer die Einstellungen ablehnt, wird Claude Code beendet.

Ein verwalteter CLAUDE.md, der durch den claudeMd Schlüssel bereitgestellt wird, benötigt keine Genehmigung, da es Anweisungstext für Claude ist, anstatt ein Befehl, den Claude Code ausführt. Claude Code überprüft immer noch Berechtigungen für die Tools, die Claude bei der Befolgung dieser Anweisungen verwendet. Vor v2.1.260 erforderte ein claudeMd Wert auch Genehmigung.

Genehmigungsspeicher

Claude Code zeichnet Ihre Genehmigung in Ihrem Konfigurationsverzeichnis auf, ~/.claude wenn Sie nicht CLAUDE_CONFIG_DIR setzen. Was es aufzeichnet, hängt von der Anmeldedaten ab, die der Einstellungsabruf verwendet:

• Eine claude.ai-Anmeldung, die durch /login oder claude auth login gespeichert wurde, oder die schlüssellose Console-Anmeldung: eine Genehmigung pro Organisation, gehalten vom Konto, das zuletzt genehmigt hat.

• Eine Claude-Apps-Gateway Anmeldung: eine Genehmigung pro Gateway.

  Wenn Sie sich vom gleichen Gateway ab- und wieder anmelden, zeigt Claude Code den Dialog nicht erneut an, während die Einstellungen, die Genehmigung erfordern, unverändert sind. Claude Code zeigt ihn erneut an, wenn sich diese Einstellungen ändern, wenn Sie sich bei einem anderen Gateway anmelden und wenn Sie ein neues Zertifikat für das gleiche Gateway akzeptieren.

  Claude Code speichert keine Genehmigung für ein Loopback-Entwicklungs-Gateway, das über einfaches HTTP erreicht wird, daher wird der Dialog nach jeder Anmeldung erneut angezeigt.

• Jede andere Anmeldedaten, wie ein API-Schlüssel oder CLAUDE_CODE_OAUTH_TOKEN: eine Genehmigung für die bereitgestellten Einstellungen, die mit der zwischengespeicherten Kopie der Einstellungen in diesem Konfigurationsverzeichnis aufbewahrt werden. Claude Code zeigt den Dialog erneut an, wenn sich die Einstellungen ändern, die Genehmigung erfordern, und nachdem Sie /logout oder claude auth logout ausführen, von denen jeder die zwischengespeicherte Kopie löscht.

Eine Genehmigung für sandbox.credentials oder sandbox.network.tlsTerminate deckt auch die sandbox.network.allowedDomains Einträge in denselben bereitgestellten Einstellungen ab, da beide Einstellungen auf diese Zulassungsliste wirken. Der Dialog wird erneut angezeigt, wenn Ihr Administrator einen dieser Einträge hinzufügt oder entfernt, obwohl sandbox.network.allowedDomains selbst keine Genehmigung erfordert.

Mit einer gespeicherten claude.ai-Anmeldung:

• Wenn Sie sich ab- und wieder anmelden, oder zu einer anderen Organisation wechseln und später zurückkehren, zeigt Claude Code den Dialog nicht erneut an, während diese Einstellungen unverändert sind, es sei denn, ein anderes Konto hat sie für diese Organisation im gleichen Konfigurationsverzeichnis dazwischen genehmigt.
• Wenn Sie sich bei der gleichen Organisation mit einem anderen Konto anmelden, zeigt Claude Code den Dialog erneut an, auch wenn die Einstellungen unverändert sind. Die Genehmigung dieses Kontos ersetzt die vorherige, daher zeigt Claude Code den Dialog erneut an, wenn Sie zurückwechseln.

Claude Code kann den Dialog nicht immer anzeigen. Jeder Fall unten sagt, welche Einstellungen gelten, wenn es nicht kann, und wann Sie den Dialog nächstes Mal sehen:

• Eine interaktive Sitzung, die den Dialog nicht anzeigen kann: Claude Code wendet die bereitgestellten Einstellungen nicht an und behält die zuletzt genehmigten Einstellungen. Der Dialog wird in der nächsten Sitzung angezeigt, die ihn anzeigen kann. Erfordert Claude Code v2.1.211 oder später.
• claude install oder claude update: Claude Code zeigt den Dialog während keinem der beiden Befehle an. Der Befehl wird mit den zuletzt genehmigten Einstellungen ausgeführt, und der Dialog wird in Ihrer nächsten interaktiven Sitzung angezeigt. Wenn Claude Code beim Start auf den Einstellungsabruf wartet, wie mit forceRemoteSettingsRefresh gesetzt oder bei einer Claude-Apps-Gateway Bereitstellung, zeigt es den Dialog stattdessen während des Befehls an, und ein Install-Lauf aus einer Pipe schlägt fehl; siehe Raw mode is not supported während der Installation. Vor v2.1.246 versuchte Claude Code, den Dialog auch während dieser Befehle anzuzeigen.
• Ein Fehler schließt den Dialog, bevor Sie antworten: Claude Code wendet die bereitgestellten Einstellungen nicht an und behält die zuletzt genehmigten Einstellungen. Es zeigt den Dialog erneut in der nächsten Sitzung an, die ihn anzeigen kann.
• Ein nicht-interaktiver Lauf, wie claude -p oder eine Agent SDK-Sitzung: Claude Code kann den Dialog nicht anzeigen, daher wendet es sie an, wenn die bereitgestellten Einstellungen Genehmigung erfordern würden, nur für diesen Lauf an. Es zeichnet sie nicht als genehmigt auf oder schreibt sie in den lokalen Cache, und die nächste interaktive Sitzung zeigt den Dialog. Bis ein Benutzer in einer interaktiven Sitzung genehmigt, ruft jeder nicht-interaktive Lauf die Einstellungen beim Start erneut ab. Vor v2.1.207 speicherte ein nicht-interaktiver Lauf die Einstellungen als genehmigt, daher zeigten spätere interaktive Sitzungen den Dialog dafür nie.

Umgebungsvariablen und der Genehmigungsdialog

Claude Code wendet einige bereitgestellte env Variablen an, ohne dem Benutzer den Genehmigungsdialog anzuzeigen, einschließlich:

• Funktions- und Befehlsumschalter
• Modellauswahl und Verhaltenseinstellungen, wie ANTHROPIC_MODEL, DISABLE_PROMPT_CACHING und CLAUDE_CODE_EFFORT_LEVEL
• Kontextfenster- und Kompaktierungseinstellungen, wie DISABLE_AUTO_COMPACT
• Terminal-UI und Barrierefreiheitsoptionen
• Numerische Grenzen, Budgets und Timeouts

Andere bereitgestellte Variablen können die Genehmigung des Benutzers erfordern, bevor sie wirksam werden; ein nicht leerer Proxy-, Base-URL- oder OTEL_EXPORTER_OTLP_ENDPOINT Wert tut dies immer. Wenn eine bereitgestellte Variable Genehmigung benötigt, benennt der Dialog sie, daher sieht der Benutzer genau, was die Richtlinie zu setzen versucht. Vor v2.1.218 wendete Claude Code weniger Variablen an, ohne den Benutzer zu fragen, daher lösten Einstellungen wie DISABLE_AUTO_COMPACT den Dialog bei jedem nicht leeren Wert aus.

Claude Code entscheidet, ob vier Datenschutz-Umschalter Genehmigung benötigen, anhand des bereitgestellten Werts statt des Variablennamens: CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_ERROR_REPORTING, DISABLE_TELEMETRY und DO_NOT_TRACK. Ein wahrheitsgemäßer Wert wie 1 oder true schaltet nur Tracking, Berichterstattung oder anderen nicht wesentlichen Datenverkehr aus, daher wendet Claude Code ihn an, ohne den Benutzer zu fragen. Für jeden anderen nicht leeren Wert zeigt Claude Code den Dialog an. Vor v2.1.218 wendeten alle außer DO_NOT_TRACK ohne Genehmigung bei jedem Wert an, und DO_NOT_TRACK löste den Dialog bei jedem nicht leeren Wert aus.

Claude Code entscheidet auch, ob API_FORCE_IDLE_TIMEOUT Genehmigung benötigt, anhand des bereitgestellten Werts: Ein wahrheitsgemäßer Wert schaltet nur das Body-Idle-Timeout ein, daher wendet Claude Code ihn an, ohne den Benutzer zu fragen. Für jeden anderen nicht leeren Wert zeigt Claude Code den Dialog an. Vor v2.1.248 löste jeder nicht leere Wert den Dialog aus.

Ob ANTHROPIC_CUSTOM_HEADERS Genehmigung benötigt, hängt auch vom bereitgestellten Wert ab. Header, die nur Anfragen kennzeichnen, wie Accept-Language, werden ohne den Dialog angewendet. Eine Zeile, die eine Anmeldedaten, einen Organisations- oder Mandanten-Selektor, einen Routing- oder Host-Override oder einen API-Verhaltens-Header benennt, wie Authorization, X-Api-Key, Host, anthropic-beta oder die X-Amzn-Bedrock-* Header, benötigt Genehmigung. Ebenso eine Zeile, deren Name kein gültiges HTTP-Header-Token ist, oder deren Wert ein Zeichen enthält, das ein HTTP-Header nicht tragen kann. Die Überprüfung stimmt Wörter im Header-Namen ab, daher benötigt X-Client-Version, das client und version enthält, auch Genehmigung. Vor v2.1.251 wurde jeder ANTHROPIC_CUSTOM_HEADERS Wert ohne sie angewendet.

Ein Falsy-Wert wie 0 oder false für ENABLE_BETA_TRACING_DETAILED oder OTEL_LOG_RAW_API_BODIES wird ohne den Dialog angewendet, da er nur detailliertes Tracing oder Raw-API-Body-Erfassung ausschaltet. Jeder andere nicht leere Wert für eine der beiden Variablen benötigt Genehmigung.

Plattformverfügbarkeit

Serververwaltete Einstellungen erfordern eine direkte Verbindung zu api.anthropic.com. Die Bereitstellung erfordert auch, dass sich die Sitzung mit einer dieser Anmeldedaten authentifiziert:

• Ein Team- oder Enterprise-OAuth-Login
• Ein OAuth-Token, das über CLAUDE_CODE_OAUTH_TOKEN bereitgestellt wird
• Ein direkt konfigurierter API-Schlüssel
• Ein user_oauth Anthropic-Profil, es sei denn, das Profil setzt eine base_url andere als die Anthropic API. Erfordert Claude Code v2.1.257 oder später.

Weder Schlüssel, die von einem apiKeyHelper-Skript zurückgegeben werden, noch Workload Identity Federation-Anmeldedaten lösen den Abruf der Einstellungen aus.

In einer Cowork-Sitzung in der Claude Desktop-App ruft Claude Code keine serververwalteten Einstellungen aus der claude.ai-Admin-Konsole ab, auch wenn sich der Benutzer mit einem Team- oder Enterprise-Konto anmeldet. Wo und wann eine Richtlinie gilt behandelt, welche Richtlinie Cowork-Sitzungen auf dem Computer des Benutzers und Remote-Cowork-Sitzungen erreicht.

Wenn Sie eine CLAUDE_CODE_USE_*-Providervariable oder eine nicht standardmäßige ANTHROPIC_BASE_URL in Ihrer Shell exportieren, überspringt Claude Code den Abruf der Einstellungen für Ihre Sitzungen. claude doctor und /status melden den übersprungenen Abruf und dessen Ursache.

Sie können den Export nicht mit einem serververwalteten env-Block löschen, da der Block durch den Abruf ankommt, den der Export verhindert. Ein endpunktverwalteter Einstellungen-env-Block stellt den Abruf auch nicht wieder her: Claude Code prüft die Berechtigung, bevor es verwaltete env-Blöcke anwendet, sodass die Überschreibung die Providerauswahl der Sitzung ändert, aber der Abruf bleibt übersprungen.

Um die serververwaltete Bereitstellung wiederherzustellen, entfernen Sie den Export aus Ihrer Shell, oder setzen Sie die Variable auf "" in Ihrem Benutzereinstellungen-env-Block, der vor der Berechtigungsprüfung angewendet wird. Um eine Richtlinie durchzusetzen, ohne sich auf Benutzer zu verlassen, die ihre Shells ändern, stellen Sie die Einstellungen stattdessen über den endpunktverwalteten Kanal bereit.

Für Amazon Bedrock-, Google Cloud's Agent Platform-, Microsoft Foundry- und Claude Platform on AWS-Bereitstellungen bietet ein selbstgehostetes Claude-Apps-Gateway die entsprechende Remote-Verwaltung von Einstellungen: Mit dem Gateway angemeldete Clients rufen verwaltete Einstellungen vom Gateway statt von api.anthropic.com ab. Die Fehlerbehandlung unterscheidet sich beim Start: Ein Gateway-Client, der das Gateway nicht erreichen kann, beendet sich mit einem Fehler, anstatt auf zwischengespeicherte Einstellungen zurückzugreifen, während die stündliche Hintergrundaktualisierung auf beiden Kanälen fehleroffen ist.

Audit-Protokollierung

Audit-Log-Ereignisse für Einstellungsänderungen sind über die Compliance-API oder den Audit-Log-Export verfügbar. Kontaktieren Sie Ihr Anthropic-Kontoteam für Zugriff.

Audit-Ereignisse enthalten den Typ der durchgeführten Aktion, das Konto und das Gerät, das die Aktion durchgeführt hat, sowie Verweise auf die vorherigen und neuen Werte.

Sicherheitsüberlegungen

Serververwaltete Einstellungen bieten zentralisierte Richtliniendurchsetzung, funktionieren aber als clientseitige Kontrolle, nicht als Sicherheitsgrenze. Auf nicht verwalteten Geräten benötigt ein Benutzer keinen Admin- oder Sudo-Zugriff, um diese zu umgehen.

Um Bearbeitungen lokaler Einstellungsdateien, einschließlich managed-settings.json, zu protokollieren, verwenden Sie ConfigChange hooks. Claude Code führt diese nicht aus, wenn serververwaltete Einstellungen ankommen oder aktualisiert werden, oder wenn sich ein MDM-Profil oder eine Registrierungsrichtlinie ändert, und ein Hook kann eine policy_settings-Änderung nicht blockieren.

Um einzuschränken, auf welche Organisationen Ihre Benutzer mit den vom Client bereitgestellten Anmeldedaten zugreifen können, siehe Netzwerkzugriffskontrolle mit Tenant Restrictions durchsetzen im Claude Help Center. Für stärkere Durchsetzungsgarantien verwenden Sie endpunktverwaltete Einstellungen auf Geräten, die in einer MDM-Lösung registriert sind.

Siehe auch

Verwandte Seiten zur Verwaltung der Claude Code-Konfiguration:

• Alle Einstellungen: jeder Einstellungsschlüssel
• Endpunktverwaltete Einstellungen: verwaltete Einstellungen, die von der IT auf Geräten bereitgestellt werden
• Authentifizierung: Einrichtung des Benutzerzugriffs auf Claude Code
• Sicherheit: Sicherheitsvorkehrungen und Best Practices