Zum Hauptinhalt springen

Claude Code CLI-Benutzer verschieben

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 allowedProviders fest (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 über ANTHROPIC_BASE_URL erreichbar ist, listen Sie "customEndpoint" auf und geben Sie die Gateway-URL im env-Block derselben verwalteten Quelle ein.

  • Entfernen Sie alte Anmeldungseinstellungen: Mit Gateway-Anmeldeinformationen entfernen Sie forceLoginMethod und forceLoginOrgUUID, 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, eine apiKeyHelper-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, CLAUDE.md, automatisches Gedächtnis, Fähigkeiten, Subagenten, Befehle, Hooks, Plugins und MCP-Server

Sie bleiben erhalten. Sie befinden sich in ~/.claude, ~/.claude.json und dem Projektordner.

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 ~/.claude/projects/, bis cleanupPeriodDays sie entfernt. Der Standard ist 30 Tage. claude --continue und claude --resume öffnen sie erneut.

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. --cloud ist nicht verfügbar, wenn Claude Code für einen Drittanbieter-Anbieter konfiguriert ist, und --resume listet Cloud-Sitzungen nicht auf.

Vor der Migration rufen Sie jede benötigte Sitzung mit --teleport ins Terminal ab. Dies erstellt eine lokale Kopie. Es benötigt eine claude.ai-Anmeldung, einen sauberen Arbeitsbaum, einen Checkout desselben Repositorys und den in die Remote gepushten Branch der Sitzung.

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 ~/.claude/skills/synced/.

Kopieren Sie jede Fähigkeit, auf die Sie angewiesen sind, von ~/.claude/skills/synced/ in ~/.claude/skills/.

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 ANTHROPIC_AUTH_TOKEN oder apiKeyHelper die Anmeldeinformation bereitstellt.

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 /loop für die Planung, GitHub Actions oder GitLab CI/CD für Cloud-Läufe (nur GitHub Actions auf Foundry), und lokales /code-review. Entscheiden Sie, ob Entwickler noch Team- oder Enterprise-Plätze benötigen.

Worauf Sie während des Überlappungszeitraums achten sollten

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 --teleport ins 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

  1. Melden Sie sich bei Ihrem Cloud-Anbieter so an, wie Ihre Administratoren es beschreiben, z. B. mit aws sso login, gcloud auth application-default login oder az login.

  2. Starten Sie claude und führen Sie /status aus. Überprüfen Sie den Anbieter, das Modell und die Einstellungsquelle.

  3. Öffnen Sie eine aktuelle Sitzung mit claude --resume erneut und bestätigen Sie, dass sie antwortet.

  4. Teilen Sie Ihren Administratoren alle fehlenden Tools oder Konnektoren mit.

Hat dies deine Frage beantwortet?