Wenn Ihre Entwickler die Claude Code CLI verwenden, richten Sie sie separat von der Desktop-App ein. Die Desktop-App bezieht ihre Anbietereinstellungen aus ihrer Claude Desktop auf 3P-Konfiguration, nicht aus ANTHROPIC_BASE_URL oder settings.json, und übergibt sie an die Code-Sitzungen, die sie startet. Die CLI liest Umgebungsvariablen, Einstellungsdateien und von Claude Code verwaltete Einstellungen, die einen separaten Richtlinienschlüssel verwenden.
Diese Anleitung ist für Administratoren von Organisationen mit Claude Enterprise-Plänen.
Dieser Artikel ist Teil von Migration von Claude Enterprise zu Claude Desktop bei einem Cloud-Anbieter, das die Begriffe Wave, Überlappungszeitraum und Stichtag definiert.
Die CLI und alles, was lokal ausgeführt wird, funktioniert bei jedem Anbieter. Nach der Migration melden sich Entwickler anders an, Ihre Richtlinien erreichen ihre Computer anders, und einige Funktionen sind nicht verfügbar.
Verbinden Sie die CLI mit Ihrem Anbieter
Legen Sie die Anbietervariablen für Amazon Bedrock, Google Cloud, Microsoft Foundry oder ein LLM-Gateway fest. Entwickler benötigen keine claude.ai-Browser-Anmeldung. Mit einem Gateway legen Sie sowohl die Basis-URL als auch eine Gateway-Anmeldeinformation fest. Mit nur der Basis-URL bleibt eine gespeicherte claude.ai-Anmeldung die aktive Anmeldeinformation, sodass ihre Limits und Abrechnung weiterhin gelten. Vor einem Team-Rollout fixieren Sie Ihre Modellversionen.
Richtlinie an jedes Gerät übermitteln
Vom Server verwaltete Einstellungen gelten nicht, wenn ein Drittanbieter-Anbieter oder eine benutzerdefinierte Basis-URL festgelegt ist. Verschieben Sie diese Richtlinien zu verwalteten Einstellungen auf dem Gerät. Sie können sie als managed-settings.json-Datei, das com.anthropic.claudecode macOS-Profil oder den HKLM\SOFTWARE\Policies\ClaudeCode-Registrierungsschlüssel übermitteln. Sie haben Vorrang vor Benutzer- und Projekteinstellungen, mit Ausnahme einiger sicherheitsempfindlicher Schlüssel, bei denen ein strengerer Wert von einer niedrigeren Ebene weiterhin zählt.
Beschränken Sie, welche Anbieter ein Computer verwenden kann: Legen Sie
allowedProvidersfest (Claude Code v2.1.285 oder später). Während des Überlappungszeitraums ermöglicht eine Liste wie["anthropic", "bedrock"]Entwicklern, beide zu verwenden. Nach der Migration listen Sie nur den neuen Anbieter auf. Behalten Sie „anthropic“ auf Computern, auf denen Benutzer in Claude Desktop bei claude.ai angemeldet bleiben, da ihre Cowork-Sitzungen ohne sie abgelehnt werden. Für ein Gateway, das überANTHROPIC_BASE_URLerreichbar ist, listen Sie"customEndpoint"auf und geben Sie die Gateway-URL imenv-Block derselben verwalteten Quelle ein.Entfernen Sie alte Anmeldungseinstellungen: Mit Gateway-Anmeldeinformationen entfernen Sie
forceLoginMethodundforceLoginOrgUUID, da jeder Schlüssel Gateway-Anmeldeinformationen beim Start blockiert. Bei einem Cloud-Anbieter blockieren diese Schlüssel eine Sitzung nur, während bestimmte Anmeldeinformationen noch auf dem Computer vorhanden sind:ANTHROPIC_API_KEY,ANTHROPIC_AUTH_TOKEN, eineapiKeyHelper-Anmeldeinformation oder ein API-Schlüssel, der durch eine frühere Claude Console-Anmeldung gespeichert wurde.
Entwickler können /status ausführen, um den aktiven Anbieter und die Herkunft ihrer Einstellungen zu sehen. Für Telemetrie, Netzwerk-Hosts und Updates siehe Datennutzung, Enterprise-Netzwerkkonfiguration und Erweiterte Einrichtung.
Kosten und Nutzung verfolgen
Bei Bedrock, Google Cloud und Foundry wird die Nutzung pro Token zu Ihrem Cloud-Konto abgerechnet, und Kostenkontrolle erfolgt in Ihrer Cloud-Abrechnungskonsole. Über ein Gateway wird die Nutzung pro Token dem Besitzer der Anmeldeinformation abgerechnet, die das Gateway weiterleitet. Die claude.ai-Analyse-Dashboards und die Claude Code Analytics API decken diese Nutzung nicht ab. Für die Berichterstellung nach Benutzer verwenden Sie OpenTelemetry oder ein LLM-Gateway.
Was für Entwickler erhalten bleibt
Element | Nach der Migration | Was zu tun ist |
Einstellungen, | Sie bleiben erhalten. Sie befinden sich in | Nichts, es sei denn, Sie melden sich ab (siehe unten). Lassen Sie diese Ordner während einer Bereinigung an Ort und Stelle. |
Lokale Sitzungstranskripte | Sie bleiben in | Testen Sie das Fortsetzen einer Sitzung in Ihrem Pilotprojekt. Bei Bedrock, Google Cloud und Foundry wird das frühere Modell der Sitzung nicht wiederhergestellt. Wenn ein Gateway-Upstream eine frühere Thinking-Signatur ablehnt, verwirft Claude Code die früheren Thinking-Blöcke und versucht es erneut. |
Cloud-Sitzungen | Anthropic speichert sie unter dem Claude-Konto. | Vor der Migration rufen Sie jede benötigte Sitzung mit |
Konnektoren von claude.ai | Nicht geladen, wenn ein Drittanbieter-Anbieter aktiv ist. | Fügen Sie sie als MCP-Server im Benutzer- oder Projektbereich hinzu, oder stellen Sie sie über verwaltete MCP-Konfiguration bereit. Einige von Anthropic gehostete Konnektoren wie Microsoft 365, Gmail und Google Calendar unterstützen die Anmeldung von einem Server, den Sie selbst hinzufügen, nicht, daher planen Sie einen anderen Server für diese. |
Fähigkeiten, die von claude.ai synchronisiert werden | Fähigkeitssynchronisierung wird nicht ausgeführt in Sitzungen auf Bedrock, Google Cloud oder Foundry oder wenn eine Gateway-Anmeldeinformation die claude.ai-Anmeldung ersetzt. Früher synchronisierte Fähigkeiten bleiben auf der Festplatte in | Kopieren Sie jede Fähigkeit, auf die Sie angewiesen sind, von |
Plugins, die von claude.ai synchronisiert werden | Weder heruntergeladen noch geladen in Sitzungen auf Bedrock, Google Cloud oder Foundry, da diese Sitzungen keine Feature-Flags von Anthropic abrufen. Dasselbe gilt, wenn | Installieren Sie sie von einem Marketplace neu, falls dieser sie führt. |
Funktionen, die eine claude.ai-Anmeldung benötigen | Von einem Anbieter nicht erreichbar. Diese umfassen Cloud-Sitzungen, Routinen, verwaltete Code Review, Ultrareview, Remote Control, die Chrome-Erweiterung und Sprachdiktat. Kanäle und das Analyse-Dashboard sind auch auf Bedrock, Google Cloud und Foundry nicht verfügbar. Ebenso der Advisor und Code Mode. Die Web-Suche der CLI ist auf Bedrock nicht verfügbar. Fast Mode ist auf Bedrock und Foundry nicht verfügbar, und auf Google Cloud ist es auf Claude Fable 5.2 beschränkt. | Verwenden Sie |
Worauf Sie während des Überlappungszeitraums achten sollten
Vom Server verwaltete Einstellungen haben Vorrang in Sitzungen, die sich noch mit claude.ai authentifizieren. Standardmäßig verwendet Claude Code diese und überspringt die verwalteten Einstellungen auf dem Gerät, mit einigen Ausnahmen wie dem
env-Block undallowedProviders. Wenn einige Entwickler bei claude.ai bleiben, verwenden Sie vom Server verwaltete Einstellungen für sie und eine Datei oder OS-Richtlinie für alle anderen.Eine gespeicherte claude.ai-Anmeldung bleibt auf dem Computer. Cloud-Anbieter-Anmeldeinformationen haben Vorrang vor ihr, und
/logoutist nicht verfügbar, sobald ein Cloud-Anbieter aktiv ist. Wenn Sie die Anmeldung entfernt haben möchten, lassen Sie Entwickler sich abmelden, bevor Sie die Anbietereinstellungen bereitstellen. Das Abmelden entfernt auch gespeicherte MCP-Server-Anmeldungen und Plugin-Geheimnisse, sodass sie diese erneut autorisieren müssen. Mit einer Gateway-Anmeldeinformation bleibt/logoutverfügbar, und Sie können es ausführen, um die gespeicherte Anmeldung zu löschen.CLI-Richtlinie kann einen Teil Ihrer Desktop-Richtlinie überschreiben. Standardmäßig ignoriert eine Desktop Code-Sitzung die verwalteten Richtlinienwerte, die die Desktop-App bereitstellt, wenn ein Computer Claude Code verwaltete Einstellungen hat. Um beide zu verwenden, siehe
parentSettingsBehaviorin Verwaltete Einstellungen bereitstellen.
Checkliste für Entwickler
Vor der Migration
Aktualisieren Sie Claude Code auf die Version, die Ihre Administratoren angeben.
Rufen Sie alle benötigten Cloud-Sitzungen mit
claude --teleportins Terminal ab. Stellen Sie zunächst sicher, dass der Branch der Sitzung in die Remote gepusht wird, und bereinigen Sie Ihren Arbeitsbaum.Listen Sie die claude.ai-Konnektoren auf, die Sie verwenden, damit sie als MCP-Server hinzugefügt werden können.
Kopieren Sie jede Fähigkeit, auf die Sie angewiesen sind, aus
~/.claude/skills/synced/, und listen Sie die synchronisierten Plugins auf, die Sie neu installieren müssen.
Am Tag der Migration
Melden Sie sich bei Ihrem Cloud-Anbieter so an, wie Ihre Administratoren es beschreiben, z. B. mit
aws sso login,gcloud auth application-default loginoderaz login.Starten Sie
claudeund führen Sie/statusaus. Überprüfen Sie den Anbieter, das Modell und die Einstellungsquelle.Öffnen Sie eine aktuelle Sitzung mit
claude --resumeerneut und bestätigen Sie, dass sie antwortet.Teilen Sie Ihren Administratoren alle fehlenden Tools oder Konnektoren mit.
