Passer au contenu principal

Migrer les utilisateurs de Claude Code CLI

Si vos développeurs utilisent Claude Code CLI, configurez-le séparément de l'application de bureau. L'application de bureau récupère ses paramètres de fournisseur à partir de sa configuration Claude Desktop sur 3P, et non à partir de ANTHROPIC_BASE_URL ou settings.json, et les transmet aux sessions Code qu'elle démarre. L'interface de ligne de commande lit les variables d'environnement, les fichiers de paramètres et les paramètres gérés de Claude Code, qui utilisent une clé de politique distincte.

Ce guide est destiné aux administrateurs des organisations disposant de plans Claude Enterprise.

Cet article fait partie de Migrer de Claude Enterprise vers Claude Desktop sur un fournisseur cloud, qui définit les termes vague, période de chevauchement et date limite.

L'interface de ligne de commande et tout ce qui s'exécute localement fonctionnent sur tous les fournisseurs. Après la migration, les développeurs se connectent différemment, vos politiques atteignent leurs ordinateurs différemment et certaines fonctionnalités ne sont pas disponibles.

Connecter l'interface de ligne de commande à votre fournisseur

Définissez les variables de fournisseur pour Amazon Bedrock, Google Cloud, Microsoft Foundry ou une passerelle LLM. Les développeurs n'ont pas besoin d'une connexion au navigateur claude.ai. Avec une passerelle, définissez à la fois l'URL de base et une identifiant de passerelle. Avec uniquement l'URL de base, une connexion claude.ai enregistrée reste l'identifiant actif, ses limites et sa facturation s'appliquent toujours. Avant un déploiement d'équipe, épinglez vos versions de modèle.

Livrer la politique à chaque appareil

Les paramètres gérés par le serveur ne s'appliquent pas quand un fournisseur tiers ou une URL de base personnalisée est défini. Déplacez ces politiques vers les paramètres gérés sur l'appareil. Vous pouvez les livrer sous forme de fichier managed-settings.json, du profil macOS com.anthropic.claudecode ou de la clé de registre HKLM\SOFTWARE\Policies\ClaudeCode. Ils ont priorité sur les paramètres utilisateur et projet, sauf pour quelques clés sensibles à la sécurité où une valeur plus stricte d'un niveau inférieur compte toujours.

  • Limiter les fournisseurs qu'un ordinateur peut utiliser : Définissez allowedProviders (Claude Code v2.1.285 ou version ultérieure). Pendant la période de chevauchement, une liste telle que ["anthropic", "bedrock"] permet aux développeurs d'utiliser l'un ou l'autre. Après la migration, listez uniquement le nouveau fournisseur. Conservez « anthropic » sur les ordinateurs où les utilisateurs restent connectés à claude.ai dans Claude Desktop, car leurs sessions Cowork sont refusées sans cela. Pour une passerelle accessible via ANTHROPIC_BASE_URL, listez "customEndpoint" et mettez l'URL de la passerelle dans le bloc env de la même source gérée.

  • Supprimer les anciens paramètres de connexion : Avec les identifiants de passerelle, supprimez forceLoginMethod et forceLoginOrgUUID, car l'une ou l'autre clé bloque les identifiants de passerelle au démarrage. Sur un fournisseur cloud, ces clés bloquent une session uniquement tant que certains identifiants sont toujours sur l'ordinateur : ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, un identifiant apiKeyHelper ou une clé API enregistrée par une connexion Claude Console antérieure.

Les développeurs peuvent exécuter /status pour voir le fournisseur actif et d'où proviennent leurs paramètres. Pour la télémétrie, les hôtes réseau et les mises à jour, consultez Utilisation des données, Configuration réseau d'entreprise et Configuration avancée.

Suivre les coûts et l'utilisation

Sur Bedrock, Google Cloud et Foundry, l'utilisation est facturée par jeton à votre compte cloud, et les contrôles de coûts se trouvent dans votre console de facturation cloud. Via une passerelle, l'utilisation est facturée par jeton à celui qui possède l'identifiant que la passerelle transmet. Les tableaux de bord d'analyse claude.ai et l'API Claude Code Analytics ne couvrent pas cette utilisation. Pour la création de rapports par utilisateur, utilisez OpenTelemetry ou une passerelle LLM.

Ce qui est conservé pour les développeurs

Élément

Après la migration

Que faire

Paramètres, CLAUDE.md, mémoire automatique, compétences, sous-agents, commandes, crochets, plugins et serveurs MCP

Ils restent. Ils se trouvent dans ~/.claude, ~/.claude.json et le dossier du projet.

Rien, sauf si vous vous déconnectez (voir ci-dessous). Laissez ces dossiers en place lors de tout nettoyage.

Transcriptions de session locale

Elles restent dans ~/.claude/projects/ jusqu'à ce que cleanupPeriodDays les supprime. La valeur par défaut est 30 jours. claude --continue et claude --resume les rouvrent.

Testez la reprise d'une session dans votre projet pilote. Sur Bedrock, Google Cloud et Foundry, le modèle antérieur de la session n'est pas restauré. Si l'amont d'une passerelle rejette une signature de réflexion antérieure, Claude Code supprime les blocs de réflexion antérieurs et réessaie.

Sessions cloud

Anthropic les stocke sous le compte Claude. --cloud n'est pas disponible quand Claude Code est configuré pour un fournisseur tiers, et --resume ne liste pas les sessions cloud.

Avant la migration, extrayez chaque session dont vous avez besoin dans le terminal avec --teleport. Cela crée une copie locale. Cela nécessite une connexion claude.ai, un arbre de travail propre, un checkout du même référentiel et la branche de la session poussée vers le serveur distant.

Connecteurs de claude.ai

Non chargés quand un fournisseur tiers est actif.

Ajoutez-les en tant que serveurs MCP à portée utilisateur ou projet, ou déployez-les via la configuration MCP gérée. Certains connecteurs hébergés par Anthropic, tels que Microsoft 365, Gmail et Google Calendar, ne supportent pas la connexion à partir d'un serveur que vous ajoutez vous-même, alors planifiez un serveur différent pour ceux-ci.

Compétences synchronisées à partir de claude.ai

La synchronisation des compétences ne s'exécute pas dans les sessions sur Bedrock, Google Cloud ou Foundry, ou quand un identifiant de passerelle remplace la connexion claude.ai. Les compétences synchronisées antérieurement restent sur le disque dans ~/.claude/skills/synced/.

Copiez toute compétence sur laquelle vous comptez de ~/.claude/skills/synced/ vers ~/.claude/skills/.

Plugins synchronisés à partir de claude.ai

Ni téléchargés ni chargés dans les sessions sur Bedrock, Google Cloud ou Foundry, car ces sessions ne récupèrent pas les indicateurs de fonctionnalité d'Anthropic. Il en va de même quand ANTHROPIC_AUTH_TOKEN ou apiKeyHelper fournit l'identifiant.

Réinstallez-les à partir d'une place de marché, si l'une d'elles les propose.

Fonctionnalités qui nécessitent une connexion claude.ai

Non accessibles à partir d'un fournisseur. Celles-ci incluent les sessions cloud, les routines, la révision de code gérée, Ultrareview, le contrôle à distance, l'extension Chrome et la dictée vocale. Les canaux et le tableau de bord d'analyse ne sont également pas disponibles sur Bedrock, Google Cloud et Foundry. Il en va de même pour l'Advisor et le Code Mode. La recherche Web de l'interface de ligne de commande n'est pas disponible sur Bedrock. Le mode rapide n'est pas disponible sur Bedrock et Foundry, et sur Google Cloud, il est limité à Claude Fable 5.2.

Utilisez /loop pour la planification, GitHub Actions ou GitLab CI/CD pour les exécutions cloud (GitHub Actions uniquement sur Foundry) et /code-review local. Décidez si les développeurs ont toujours besoin de sièges Team ou Enterprise.

À surveiller pendant la période de chevauchement

Liste de contrôle pour les développeurs

Avant la migration

  • Mettez à jour Claude Code vers la version que vos administrateurs spécifient.

  • Extrayez toute session cloud dont vous avez besoin dans le terminal avec claude --teleport. Assurez-vous d'abord que la branche de la session est poussée vers le serveur distant et nettoyez votre arbre de travail.

  • Listez les connecteurs claude.ai que vous utilisez, afin qu'ils puissent être ajoutés en tant que serveurs MCP.

  • Copiez toute compétence sur laquelle vous comptez hors de ~/.claude/skills/synced/ et listez les plugins synchronisés que vous devrez réinstaller.

Le jour de votre migration

  1. Connectez-vous à votre fournisseur cloud de la manière décrite par vos administrateurs, par exemple avec aws sso login, gcloud auth application-default login ou az login.

  2. Démarrez claude et exécutez /status. Vérifiez le fournisseur, le modèle et la source des paramètres.

  3. Rouvrez une session récente avec claude --resume et confirmez qu'elle répond.

  4. Informez vos administrateurs de tout outil ou connecteur manquant.

Avez-vous trouvé la réponse à votre question ?