Serververwaltete Einstellungen konfigurieren

​

Anforderungen

• 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

​

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

• 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

​

Zugriffskontrolle

• Primärer Eigentümer
• Eigentümer

​

Nur verwaltete Einstellungen

​

Aktuelle 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.

​

Bereitstellung der Einstellungen

​

Vorrang der Einstellungen

​

Ausnahmen pro Schlüssel über verwaltete Quellen hinweg

• Quellenübergreifende Sperrschlüssel: eine kleine Gruppe von Schlüsseln, etwa die Sperren für die Sandbox-Allowlist, die auf der Seite zu verwalteten Einstellungen aufgeführt sind. Claude Code berücksichtigt sie, wenn eine beliebige von Admins gesteuerte verwaltete Quelle sie festlegt; die vom Benutzer beschreibbare HKCU-Registry-Ebene ist ausgenommen. Wenn ein policyHelper verwaltete Einstellungen liefert, ist seine Ausgabe die einzige Quelle, die diese Prüfungen lesen, abgesehen von forceRemoteSettingsRefresh, das Claude Code beim Start direkt aus den Admin-Quellen liest.
• Der env-Block: Abgesehen von der Telemetrie-Einheit und den mit einem Anmeldedaten-Schlüssel gekoppelten Routing-Variablen, die beide unten behandelt werden, wird er pro Schlüssel über die von Admins gesteuerten Quellen zusammengeführt. Für jede Umgebungsvariable gilt die Quelle mit der höchsten Priorität, die sie definiert, und niedrigere Admin-Quellen ergänzen Variablen, die die höheren Quellen nicht setzen. Ein endpunktgesteuerter env-Eintrag gilt daher immer dann, wenn die servergesteuerte Konfiguration diese Variable nicht setzt oder solange ein zwischengespeicherter Serverwert dafür bis zur Bestätigung durch den Server zurückgehalten wird. Erfordert Claude Code v2.1.223 oder höher. Vor v2.1.223 wendet Claude Code nur den gesamten env-Block der ausgewählten Quelle an.
  • Telemetrie-Einheit: Die OTEL_EXPORTER_OTLP_*-Exporter-Schlüssel, die OTEL_LOG_*-Schalter zur Inhaltserfassung, OTEL_LOGS_EXPORTER sowie die Beta-Tracing-Variablen ENABLE_BETA_TRACING_DETAILED und BETA_TRACING_ENDPOINT folgen als Einheit der höchsten Quelle, die eine von ihnen setzt. Eine Quelle, die den Anmeldedaten-Schlüssel otelHeadersHelper liefert, beansprucht die Einheit ebenfalls, setzt diese Variablen aber nur, wenn sie die ausgewählte Quelle ist: Eine nicht ausgewählte Quelle, die den Schlüssel liefert, trägt keine davon bei und hindert dennoch niedrigere Quellen daran, sie zu ergänzen. In jedem Fall kann ein Exporter-Endpunkt aus einer Quelle nie mit Anmeldedaten aus einer anderen kombiniert werden.
  • An Anmeldedaten gekoppeltes Routing: Eine Quelle, die Routing-Variablen mit einem Anmeldedaten-Schlüssel koppelt, der nur aus der ausgewählten Quelle gilt, etwa apiKeyHelper oder otelHeadersHelper, trägt diese Routing-Variablen nur bei, wenn sie den Platz gewinnt.
• allowedProviders: Eine auf dem Rechner festgelegte Liste und eine servergesteuerte Liste werden so kombiniert, wie es der Hinweis zum Geltungsbereich in ihrem Eintrag angibt. Erfordert Claude Code v2.1.285 oder höher
• Schlüssel für die First-Party-Anmeldung: forceLoginOrgUUID sowie die Werte "claudeai" und "console" von forceLoginMethod. Wenn Sie zusätzlich eine MDM-Richtlinie oder eine Datei mit verwalteten Einstellungen bereitstellen, setzen Sie sie dort und in den servergesteuerten Einstellungen von claude.ai, bis alle Clients v2.1.299 oder höher ausführen. Wo Sie die Schlüssel danach setzen und welcher Quelle Wert gilt, erfahren Sie unter Welche verwaltete Quelle Anmeldeschlüssel liefert.
• Schlüssel für die Gateway-Anmeldung: Claude Code liest forceLoginGatewayUrl, gatewayInternalNetworks oder den Wert "gateway" von forceLoginMethod nie aus servergesteuerten Einstellungen, sodass ein dort gesetzter Wert weder gilt noch einen in einer MDM-Richtlinie oder Datei mit verwalteten Einstellungen gesetzten Wert verdeckt. Der Eintrag managedSourcesBehavior gibt an, welche Admin-Quelle auf dem Rechner sie liefert.

​

Abruf- und Caching-Verhalten

• Wenn sich ein Entwickler beim Start anmeldet, etwa beim ersten Lauf oder nach /logout, wartet Claude Code bis zu fünf Sekunden auf den Abruf, bevor es die Sitzung öffnet. Trifft die Richtlinie rechtzeitig ein, setzt Claude Code sie ab dem ersten Bildschirm durch und zeigt dort Ihre companyAnnouncements an. Benötigt die Payload eine Sicherheitsgenehmigung, beendet Claude Code das Warten und wendet die Payload an, sobald der Entwickler sie genehmigt
• Bei jedem anderen Start und wenn diese fünfsekündige Wartezeit abläuft, öffnet Claude Code die Sitzung, während der Abruf weiterläuft. Es vergeht also ein kurzer Zeitraum, bevor die Einstellungen geladen werden und die Einschränkungen wirksam werden
• Schlägt der Abruf fehl, fährt Claude Code ohne servergesteuerte Einstellungen fort und warnt in interaktiven Sitzungen, dass keine Remote-Richtlinie gilt; endpunktgesteuerte Einstellungen gelten weiterhin. Wenn eine verwaltete Quelle forceRemoteSettingsRefresh setzt, beendet sich Claude Code stattdessen

• Zwischengespeicherte Einstellungen gelten sofort beim Start, mit Ausnahme der zwischengespeicherten Werte modelPricing und managedMcpServers, der Umgebungsvariablen, die Claude Code zurückhält, bis der Server die Payload bestätigt, des Entfernens, Umpositionierens oder Deaktivierens des integrierten Wächters durch eine zwischengespeicherte Plugin-Liste sowie, auf einem Rechner, auf dem eine endpunktgesteuerte Quelle eigene Plugins auflistet oder aktiviert, des Status als Plugin der Organisation bei einem Plugin, das nur eine zwischengespeicherte Liste aktiviert
• Ein zwischengespeichertes modelPricing gilt erst, wenn der Abruf der Sitzung die Payload bestätigt. Bis dahin basieren die Kostenangaben, die Entwickler in /usage und in der Statuszeile sehen, auf Listenpreisen
• Ein zwischengespeicherter managedMcpServers-Block gilt erst, wenn der Abruf der Sitzung die Payload bestätigt. Claude Code wartet bis zu 30 Sekunden auf diesen Abruf, bevor es MCP-Server verbindet. Schlägt der Abruf fehl oder tritt eine Zeitüberschreitung auf, startet die Sitzung ohne die Server der Organisation, /status weist darauf hin, und die Server werden verbunden, sobald ein späterer Abruf sie bestätigt. Unter Wann bereitgestellte Server verbunden werden finden Sie das vollständige Verhalten, einschließlich des ersten Starts. Erfordert Claude Code v2.1.259 oder höher
• Ein zwischengespeicherter Wert für prependPlugins, appendPlugins oder enabledPlugins kann den integrierten Wächter erst entfernen, umpositionieren oder ausschalten, wenn der Abruf der Sitzung die Payload bestätigt
• Auf einem Rechner, auf dem eine endpunktgesteuerte Quelle eigene Plugins auflistet oder aktiviert, gilt ein Plugin, das nur eine zwischengespeicherte Liste aktiviert, als Plugin des Benutzers und nicht als Plugin Ihrer Organisation, bis der Abruf die Payload bestätigt
• Claude Code ruft im Hintergrund aktuelle Einstellungen ab
• Zwischengespeicherte Einstellungen bleiben bei Netzwerkausfällen erhalten. Schlägt der Abruf beim Start fehl, warnt Claude Code in interaktiven Sitzungen, dass die zwischengespeicherte Richtlinie gilt
• Bis ein Abruf erfolgreich ist, bleiben die beim Start zurückgehaltenen Werte zurückgehalten

• Proxy- und TLS-Konfiguration, etwa HTTPS_PROXY, NODE_EXTRA_CA_CERTS und die mTLS-Client-Zertifikatsvariablen CLAUDE_CODE_CLIENT_CERT und CLAUDE_CODE_CLIENT_KEY
• API-Routing und Anbieterauswahl, einschließlich ANTHROPIC_BASE_URL, der Variablen zur Anbieterauswahl wie CLAUDE_CODE_USE_BEDROCK und CLAUDE_CODE_USE_VERTEX sowie der Endpunkt-URLs der Anbieter wie ANTHROPIC_BEDROCK_BASE_URL
• Anmeldedaten für die Authentifizierung, etwa ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN und CLAUDE_CODE_OAUTH_TOKEN
• Der Selektor für das Konfigurationsverzeichnis CLAUDE_CONFIG_DIR
• Selektoren für Anmeldedatenquelle und Konfigurationsverzeichnis, in Claude Code v2.1.223 oder höher: die Variablen für Workload Identity Federation wie ANTHROPIC_FEDERATION_RULE_ID und ANTHROPIC_IDENTITY_TOKEN, die Selektoren für Profil und Konfigurationsverzeichnis ANTHROPIC_PROFILE und ANTHROPIC_CONFIG_DIR sowie die Verzeichnisvariablen des Betriebssystems HOME, XDG_CONFIG_HOME, APPDATA und USERPROFILE

​

Ungültige Einträge in gelieferten Einstellungen

• Ein Start, der auf dem Cache unter ~/.claude/remote-settings.json läuft, behandelt ungültige Einträge so wie der Abruf, der den Cache geschrieben hat:
  • Einträge, die die Validierung nicht bestanden haben, bleiben verworfen.
  • Schlüssel, die Fail-Closed behandelt werden, behalten ihre strengeren Werte.
  • Ein ungültiger Wert für cleanupPeriodDays oder desktopSessionCleanupPeriodDays bleibt in der zwischengespeicherten Kopie und wird nie angewendet.
• Claude Code wendet nichts aus einer Payload an und lässt den Cache unverändert, wenn alle drei der folgenden Bedingungen zutreffen:
  • Jede Einstellung in der Payload besteht die Validierung nicht.
  • Keine davon fällt auf einen strengeren Wert zurück.
  • Die Payload enthält einen anderen Schlüssel als diese beiden Aufbewahrungsschlüssel.
  Der Hinweis beim Start, /status und claude doctor melden dann den fehlgeschlagenen Ladevorgang mit der Ursache no setting in the server response could be applied as written, und dieser Eintrag gibt an, mit welcher Richtlinie die Sitzung läuft. Clients, die einen Fail-Closed-Start erzwingen, beenden sich stattdessen beim Start.
• Der Dialog zur Sicherheitsgenehmigung bewertet die bereinigte Payload, sodass ein entfernter ungültiger Eintrag nie zur Genehmigung angezeigt und nie ausgeführt wird.

​

Fail-Closed-Start erzwingen

• Wenn das Gateway einen betreuten interaktiven Start mit 401 beantwortet und diese Einstellung deaktiviert ist, hat das Gateway diese Anmeldung beendet. Claude Code gibt Cloud gateway session expired — run /login to reconnect. aus und öffnet die Sitzung ohne Gateway-Anmeldung, 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, beendet sich der Client mit einem Fehler.

{
  "forceRemoteSettingsRefresh": true
}

​

Dialoge zur Sicherheitsgenehmigung

• Einstellungen mit Shell-Befehlen: Einstellungen, die Shell-Befehle ausführen, etwa apiKeyHelper, statusLine und otelHeadersHelper
• Einstellungen für Sandbox-Binärdateien: sandbox.bwrapPath, sandbox.socatPath und sandbox.ripgrep. Jede dieser Einstellungen verweist auf eine ausführbare Datei, und Claude Code führt diese Datei aus
• Einstellungen für Sandbox-Netzwerk und -Isolation: Sandbox-Einstellungen, mit denen der Sandbox-Proxy Datenverkehr lesen, umleiten oder authentifizieren kann oder die die Isolation der Sandbox abschwächen: sandbox.network.tlsTerminate, sandbox.network.httpProxyPort, sandbox.network.socksProxyPort, sandbox.credentials, sandbox.allowAppleEvents, sandbox.allowNestedUserNamespaces, 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: gelieferte env-Variablen, die die Genehmigung des Benutzers erfordern, etwa Proxy- und Base-URL-Variablen; siehe Umgebungsvariablen und der Genehmigungsdialog
• Hook-Konfigurationen: jede Hook-Definition

​

Speicherung der Genehmigung

• Eine mit /login oder claude auth login gespeicherte claude.ai-Anmeldung oder die Console-Anmeldung ohne Schlüssel: eine Genehmigung pro Organisation, die dem Konto zugeordnet ist, das zuletzt genehmigt hat.
• Eine Anmeldung über ein Claude apps gateway: eine Genehmigung pro Gateway. Wenn Sie sich beim selben Gateway ab- und wieder anmelden, zeigt Claude Code den Dialog nicht erneut an, solange die genehmigungspflichtigen Einstellungen 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 dasselbe Gateway akzeptieren. Für ein Loopback-Entwicklungs-Gateway, das über einfaches HTTP erreicht wird, speichert Claude Code keine Genehmigung, sodass der Dialog nach jeder Anmeldung erneut erscheint.
• Alle anderen Anmeldedaten, etwa ein API-Schlüssel oder CLAUDE_CODE_OAUTH_TOKEN: eine Genehmigung für die gelieferten Einstellungen, die zusammen mit der zwischengespeicherten Kopie der Einstellungen in diesem Konfigurationsverzeichnis abgelegt wird. Claude Code zeigt den Dialog erneut an, wenn sich die genehmigungspflichtigen Einstellungen ändern, und nachdem Sie /logout oder claude auth logout ausgeführt haben, da beide Befehle die zwischengespeicherte Kopie löschen.

• 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, solange diese Einstellungen unverändert sind, es sei denn, ein anderes Konto hat sie zwischenzeitlich für diese Organisation im selben Konfigurationsverzeichnis genehmigt.
• Wenn Sie sich mit einem anderen Konto bei derselben Organisation anmelden, zeigt Claude Code den Dialog erneut an, auch wenn die Einstellungen unverändert sind. Die Genehmigung dieses Kontos ersetzt die vorherige, sodass Claude Code den Dialog noch einmal anzeigt, wenn Sie zurückwechseln.

• Eine interaktive Sitzung, die den Dialog nicht anzeigen kann: Claude Code wendet die gelieferten Einstellungen nicht an und behält die zuletzt genehmigten Einstellungen bei. Der Dialog erscheint in der nächsten Sitzung, die ihn anzeigen kann.
• claude install oder claude update: Claude Code zeigt den Dialog während keines der beiden Befehle an. Der Befehl läuft mit den zuletzt genehmigten Einstellungen, und der Dialog erscheint in Ihrer nächsten interaktiven Sitzung. Wenn Claude Code beim Start auf den Einstellungsabruf wartet, etwa wenn forceRemoteSettingsRefresh gesetzt ist oder bei einer Bereitstellung mit Claude apps gateway, zeigt es den Dialog stattdessen während des Befehls an, und eine über eine Pipe ausgeführte Installation 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 claude plugin-Befehl, der in ein Terminal ausgibt, aber nicht von der Tastatur lesen kann: Wenn Claude Code beim Start nicht auf den Einstellungsabruf wartet, wendet der Befehl die gelieferten Einstellungen nicht an. Ohne zwischengespeicherte Einstellungen bricht ein Befehl, der Ihre Plugins oder Marketplaces ändert, mit einem Fehler ab. Mit zwischengespeicherten Einstellungen läuft er mit den zuletzt genehmigten Einstellungen. Der Dialog erscheint, wenn Sie das nächste Mal claude in einem Terminal ausführen. Der Befehl kann nicht von der Tastatur lesen, wenn Sie seine Eingabe per Pipe übergeben oder umleiten und er unter macOS und Linux außerdem /dev/tty nicht öffnen kann. Wenn Sie auch seine Ausgabe per Pipe weiterleiten oder umleiten, ist der Lauf stattdessen nicht interaktiv, und die gelieferten Einstellungen gelten nur für diesen Lauf.
• Ein Fehler schließt den Dialog, bevor Sie antworten: Claude Code wendet die gelieferten Einstellungen nicht an und behält die zuletzt genehmigten Einstellungen bei. Der Dialog wird in der nächsten Sitzung, die ihn anzeigen kann, erneut angezeigt.
• Ein nicht interaktiver Lauf, etwa claude -p, eine Agent SDK-Sitzung oder eine Sitzung im Chat-Bereich der VS Code-Erweiterung oder im Code-Tab der Desktop-App: Claude Code kann den Dialog nicht anzeigen. Wenn die gelieferten Einstellungen eine Genehmigung erfordern würden, gelten sie nur für diesen Lauf. Claude Code speichert die Einstellungen weder als genehmigt noch schreibt es sie in den lokalen Cache, und die nächste interaktive Sitzung zeigt den Dialog an. Bis ein Benutzer in einer interaktiven Sitzung zustimmt, ruft jeder nicht interaktive Lauf die Einstellungen beim Start erneut ab.

​

Umgebungsvariablen und der Genehmigungsdialog

• Schalter für Funktionen und Befehle
• Einstellungen für Modellauswahl und -verhalten, etwa ANTHROPIC_MODEL, DISABLE_PROMPT_CACHING und CLAUDE_CODE_EFFORT_LEVEL
• Einstellungen für Kontextfenster und Komprimierung, etwa DISABLE_AUTO_COMPACT, aber nicht CLAUDE_CODE_DISABLE_1M_CONTEXT
• Optionen für die Terminal-Oberfläche und Barrierefreiheit
• Numerische Limits, Budgets und Timeouts

• Eine Proxy- oder Base-URL-Variable
• OTEL_EXPORTER_OTLP_ENDPOINT
• CLAUDE_CODE_DISABLE_1M_CONTEXT

​

Plattformverfügbarkeit

• 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.

• OAuth-Token: Generieren Sie ein Token mit claude setup-token, autorisieren Sie es für Ihre Team- oder Enterprise-Organisation und setzen Sie es als CLAUDE_CODE_OAUTH_TOKEN in der Umgebung des Jobs. Entfernen Sie aus dieser Umgebung alle Anmeldedaten, die Vorrang vor dem Token haben, etwa ANTHROPIC_API_KEY.
• Endpunktverwaltete Einstellungen: Stellen Sie eine verwaltete Einstellungsdatei auf dem Computer bereit, auf dem der Job ausgeführt wird.

​

Audit-Protokollierung

​

Sicherheitsüberlegungen

​

Siehe auch

• 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