Source: https://aiprimetech.io/fr/blog/cc-switch-claude-code-account-provider-manager/ Juil. 22, 2026 · 6 min · Outils # CC Switch pour Claude Code : gestion des comptes, des fournisseurs et des configurations A Par [AI Prime Tech](https://aiprimetech.io/fr/) · Avec l’aide de l’IA À 9:05 du matin, vous configurez Claude Code pour utiliser une passerelle d’entreprise. À 11:30, vous avez besoin d’un compte Anthropic personnel. Après le déjeuner, le dépôt d’un client nécessite ses propres serveurs MCP et alias de modèles. À la fin de la journée, ~/.claude/settings.json a été modifié trois fois, un shell contient encore un ancien jeton et personne ne sait avec certitude quel point de terminaison recevra la prochaine requête. CC Switch répond à ce problème opérationnel avec des profils nommés gérés depuis une application de bureau. Au lieu de déplacer manuellement les identifiants, les URL des fournisseurs, les définitions MCP et les fichiers de configuration propres à chaque agent, vous sélectionnez le profil qui doit être actif. Le point technique important est qu’il s’agit de gestion de configuration, et non de virtualisation des comptes : Claude Code continue de lire ses fichiers locaux habituels et ses paramètres d’environnement, tandis que CC Switch coordonne ce qui y est écrit. Ce gain de confort est considérable, mais la frontière de confiance l’est tout autant. Un utilitaire capable de changer de compte développeur doit pouvoir lire ou écrire les identifiants de ces comptes. Avant de l’adopter, vous devez savoir précisément quels fichiers il modifie, où se trouve sa propre base de données et comment ces fichiers sont protégés. ## Ce que fait réellement CC Switch pour la gestion de Claude Code CC Switch est un gestionnaire de configuration de bureau open source pour les agents de programmation. Les intégrations prises en charge se sont enrichies au fil du temps : consultez donc le dépôt actuel et les notes de version avant de vous appuyer sur une liste fixe. Claude Code est une intégration majeure ; les versions actuelles ciblent également d’autres agents de programmation en ligne de commande, comme Codex et Gemini CLI. Pour Claude Code, un profil de fournisseur regroupe généralement : - Un point de terminaison API compatible avec Anthropic - Une clé API ou un jeton d’authentification - Des correspondances de modèles ou des valeurs d’environnement liées aux modèles - Des variables d’environnement supplémentaires - Des définitions de serveurs MCP - Les paramètres de Claude Code qui doivent être associés au profil C’est utile lorsque « compte » ne désigne pas simplement une connexion à Anthropic. Dans les déploiements réels, les développeurs peuvent alterner entre : - Un accès direct à l’API Anthropic - La passerelle API authentifiée d’une organisation - Un fournisseur tiers compatible avec Anthropic - Des comptes de facturation distincts pour les usages personnels, la préproduction et la production - Un proxy local ou distant exposant une sémantique de requêtes compatible CC Switch centralise ces choix et active la configuration sélectionnée. Il ne fait pas fonctionner tous les points de terminaison compatibles de manière identique. Les différences concernant les noms de modèles, les en-têtes d’authentification, les limites de débit, la mise en cache des prompts et les champs API non pris en charge restent du ressort du fournisseur. | Approche | Effort de changement | Identifiants exposés à | Gestion MCP | Usage le plus adapté | Exports dans le shell | Faible au départ, sujet aux erreurs ensuite | Shell, historique, processus enfants | Manuelle | Un compte temporaire | Fichiers de configuration modifiés à la main | Modéré | Éditeur, sauvegardes, fichiers locaux | Manuelle | Configuration stable avec un seul fournisseur | Scripts d’encapsulation | Faible après la configuration | Script ou gestionnaire de secrets | Dépendante du script | Équipes prêtes à maintenir des outils | Profils CC Switch | Faible grâce à l’interface de bureau | CC Switch et fichiers de configuration des agents | Interface centralisée | Plusieurs comptes, fournisseurs ou agents | Gestionnaire de secrets externe et scripts d’encapsulation | Coût de configuration le plus élevé | Gestionnaire de secrets et processus en cours d’exécution | Personnalisée | Contrôles stricts en entreprise Le tableau met en évidence le compromis : CC Switch réduit les erreurs de manipulation, mais devient une application locale privilégiée supplémentaire. ## Installation et plateformes prises en charge CC Switch est distribué via la page GitHub Releases du projet. Le dépôt indique actuellement une prise en charge sur ordinateur pour macOS, Windows et Linux, avec des artefacts de publication qui varient selon la plateforme et la version. Vérifiez les fichiers joints à la version que vous comptez déployer ; l’existence du code source ne garantit pas que chaque version soit compilée pour toutes les versions de système d’exploitation, architectures de processeur ou formats de paquet. Sur macOS, le projet propose une procédure utilisant un cask Homebrew : ``` brew tap farion1231/cc-switch brew install --cask cc-switch ``` Avant d’utiliser un binaire téléchargé dans un environnement administré, vérifiez ce que Homebrew a installé : ``` brew info --cask cc-switch brew list --cask cc-switch codesign -dv --verbose=4 "/Applications/CC Switch.app" 2>&1 ``` Les utilisateurs de Windows et de Linux doivent récupérer le programme d’installation ou le paquet parmi les fichiers publiés avec la version. Les noms de paquets et les canaux peuvent changer ; j’évite donc d’intégrer une commande potentiellement obsolète pour winget, Scoop, .deb ou AppImage dans les scripts d’initialisation des postes de travail sans fixer et tester la version exacte. Pour un déploiement maîtrisé : - Fixez une version de CC Switch. - Consignez la somme de contrôle attendue pour cette version. - Testez-la avec une configuration Claude Code jetable. - Inventoriez tous les fichiers modifiés lors de l’activation d’un profil. - Définissez un processus de mise à niveau au lieu de suivre silencieusement la dernière version. Un simple instantané avant l’installation peut aider : ``` mkdir -p /tmp/claude-config-before cp -R ~/.claude /tmp/claude-config-before/ 2>/dev/null || true # Install CC Switch, create a test profile, and activate it. diff -ru /tmp/claude-config-before/.claude ~/.claude || true ``` Cela permet de détecter des comportements que la documentation peut omettre, notamment des réécritures de mise en forme, des champs supprimés ou des entrées MCP fusionnées à un niveau de portée inattendu. ## Création et changement de profils de fournisseur Un profil doit représenter un contexte cohérent de sécurité et de facturation. J’utilise des noms qui rendent leur impact explicite, tels que : - anthropic-personal - company-gateway-dev - customer-a-restricted - local-proxy-test Évitez les libellés comme default-2. Lorsqu’un incident survient en production, le nom du profil actif doit répondre à la question « où cette requête sera-t-elle envoyée ? » sans qu’il soit nécessaire d’ouvrir un éditeur. Un profil Claude Code utilisant une passerelle compatible avec Anthropic pourrait produire des paramètres conceptuellement similaires à ceux-ci : ``` { "env": { "ANTHROPIC_BASE_URL": "https://ai-gateway.example.com/anthropic", "ANTHROPIC_AUTH_TOKEN": "${TOKEN_MANAGED_BY_PROFILE}", "ANTHROPIC_MODEL": "company-claude-default" }, "permissions": { "defaultMode": "default" } } ``` Les variables exactes requises dépendent du fournisseur et de la version de Claude Code. Certains services attendent ANTHROPIC_API_KEY ; certaines intégrations de passerelle utilisent ANTHROPIC_AUTH_TOKEN. Ne renseignez pas les deux simplement pour augmenter les « chances » que l’authentification fonctionne. Déterminez quel identifiant Claude Code privilégiera, car une valeur obsolète de priorité supérieure peut acheminer les requêtes sous le mauvais compte. Après le changement, démarrez un nouveau processus Claude Code : ``` claude ``` Il est facile de mal comprendre ce qui se passe réellement lorsque vous changez de profil alors que Claude Code est déjà en cours d’exécution. L’utilitaire peut mettre à jour les fichiers sur le disque, mais il ne peut pas remplacer de manière fiable les valeurs d’environnement déjà héritées par un processus en cours d’exécution. Les sessions existantes peuvent donc continuer à utiliser leur fournisseur d’origine jusqu’à leur redémarrage. Validez la configuration effective sans afficher de secrets : ``` python3 - <<'PY' import json from pathlib import Path path = Path.home() / ".claude" / "settings.json" data = json.loads(path.read_text()) env = data.get("env", {}) for key, value in sorted(env.items()): if "KEY" in key or "TOKEN" in key or "SECRET" in key: value = "" print(f"{key}={value}") PY ``` Un piège courant consiste à vérifier uniquement que Claude répond. Un proxy compatible peut renvoyer une réponse valide tout en associant silencieusement le modèle demandé à un autre modèle. Vérifiez les journaux de requêtes du fournisseur ou la piste d’audit de la passerelle lorsque l’identité du modèle est importante. ## Paramètres MCP entre agents C’est dans la configuration MCP que la centralisation devient plus utile qu’un simple sélecteur de jeton. Un développeur peut avoir configuré des serveurs de système de fichiers, de suivi des tickets, de base de données et de navigateur dans plusieurs agents, chacun avec son propre schéma ou emplacement de stockage. Une définition de serveur MCP typique contient une commande et des arguments : ``` { "mcpServers": { "project-files": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/Users/alex/work/customer-a" ] } } } ``` Considérez cela comme une configuration exécutable. L’activation du profil peut permettre à un agent de lancer npx, d’exécuter un paquet et d’exposer le répertoire spécifié à la couche d’outils accessible au modèle. En pratique, je sépare les profils MCP selon la sensibilité des dépôts : - Un profil général expose la documentation et les outils à faible risque. - Un profil client expose uniquement le répertoire de travail de ce client. - Les serveurs de base de données et de contrôle de la production ne sont pas activés globalement. - La portée des jetons utilisés par les serveurs MCP est définie indépendamment de celle du jeton du fournisseur de modèles. Comparez également le résultat généré par CC Switch avec la commande MCP native de l’agent, lorsqu’elle est disponible. Pour Claude Code, inspectez les serveurs actifs après le changement : ``` claude mcp list ``` Ne supposez pas qu’un objet MCP JSON puisse être copié tel quel dans tous les agents de programmation. CC Switch peut uniformiser la gestion dans son interface, mais chaque agent en aval conserve son propre schéma, ses règles de portée et son comportement de cycle de vie. ## Où les identifiants sont stockés Deux couches de stockage doivent être auditées : - Les données de l’application CC Switch, utilisées pour conserver les profils. - La configuration native de l’agent de programmation, écrite ou mise à jour lors de l’activation d’un profil. CC Switch utilise un stockage local des données de l’application plutôt qu’un service de comptes hébergé. Le chemin exact dépend de la plateforme et a changé au fil de l’évolution de l’application ; déterminez-le donc à partir de la version installée plutôt que de vous fier à un chemin copié depuis un ancien ticket. Les répertoires racines courants des données d’application des systèmes d’exploitation sont : ``` macOS: ~/Library/Application Support/ Windows: %APPDATA% Linux: ~/.local/share/ or an XDG data directory ``` Effectuez une recherche sans afficher le contenu des identifiants : ``` find "$HOME/Library/Application Support" \ -maxdepth 3 -iname '*cc*switch*' -print 2>/dev/null find "${XDG_DATA_HOME:-$HOME/.local/share}" \ -maxdepth 3 -iname '*cc*switch*' -print 2>/dev/null ``` Pour Claude Code, examinez ~/.claude/, en particulier settings.json, ainsi que la configuration Claude au niveau du projet, le cas échéant. Les autres agents utilisent généralement des répertoires distincts, tels que ~/.codex/ ou ~/.gemini/, mais les noms de fichiers et les formats des identifiants dépendent de la version de l’agent. Ne supposez pas que « stocké localement » signifie « chiffré ». À moins que votre version installée de CC Switch n’utilise explicitement un coffre d’identifiants du système d’exploitation pour le secret concerné, considérez que sa base de données applicative et les fichiers d’agent générés peuvent être lisibles en clair par votre compte utilisateur. Vérifiez-le en inspectant les fichiers et en examinant le code du dépôt, tout en veillant à ne pas coller de secrets dans des terminaux, des tickets ou des sessions de chat. ## Implications de sécurité de l’accès aux jetons sur le poste de travail CC Switch fonctionne nécessairement avec les autorisations de votre compte utilisateur sur le poste de travail. Si ce compte peut lire un jeton, un logiciel malveillant ou un autre processus exécuté sous le même compte peut également être en mesure de le lire. CC Switch ne supprime pas les exigences de sécurité des postes de travail. Les principaux risques sont les suivants : - Concentration des identifiants : Plusieurs jetons de fournisseurs peuvent coexister dans un même stockage local de profils. - Écrasement de la configuration : L’activation d’un profil peut remplacer ou fusionner des fichiers utilisés par un agent. - Fuite via les sauvegardes : Les données de l’application et les fichiers de configuration cachés peuvent se retrouver dans des sauvegardes non chiffrées. - Héritage des processus : Les terminaux déjà ouverts et les agents en cours d’exécution peuvent conserver les identifiants précédents. - Exécution MCP : Un profil peut activer des commandes ayant accès au système de fichiers ou au réseau. - Exposition liée à la chaîne d’approvisionnement : L’installation de mises à jour donne à du nouveau code exécuté sur le poste de travail accès aux jetons stockés. - Divulgation à l’écran et dans les journaux : Les diagnostics de l’interface ou les rapports de bugs peuvent révéler des données sur les points de terminaison et les identifiants. Appliquez des contrôles fondés sur le principe du moindre privilège autour de cet utilitaire : ``` chmod 700 ~/.claude chmod 600 ~/.claude/settings.json ``` Privilégiez les jetons de passerelle à courte durée de vie ou révocables lorsque le fournisseur les prend en charge. Ne placez jamais un identifiant d’administration de production dans un profil créé pour des raisons de commodité. Renouvelez les jetons après avoir retiré une machine du service ; supprimer un profil ne prouve pas que l’identifiant n’a jamais été copié ailleurs. Pour un déploiement en entreprise, j’exigerais : - Des versions verrouillées et examinées - Le chiffrement intégral du disque - Une gestion strictement encadrée des sauvegardes - Des limites de dépenses et des journaux d’audit côté fournisseur - Des jetons distincts pour chaque développeur et chaque environnement - Une procédure de révocation documentée - Un examen périodique des commandes MCP et des chemins exposés CC Switch convient bien aux flux de travail locaux faisant intervenir plusieurs fournisseurs. Il ne convient pas automatiquement aux environnements dont les politiques exigent des secrets protégés par du matériel, des identifiants éphémères ou une configuration imposée de manière centralisée. Dans ces cas, une passerelle d’entreprise et un lanceur adossé à un gestionnaire de secrets peuvent constituer une architecture plus défendable. ## Conseils pratiques - Utilisez CC Switch lorsque les modifications manuelles répétées provoquent des erreurs de compte, de point de terminaison ou de MCP. - Vérifiez les artefacts disponibles pour chaque plateforme dans la version actuelle du projet sur GitHub avant le déploiement. - Donnez à chaque profil un nom qui identifie son fournisseur, son propriétaire et son environnement. - Redémarrez Claude Code après un changement de profil, car les processus en cours d’exécution peuvent conserver les anciennes valeurs. - Inspectez les fichiers générés et utilisez claude mcp list pour vérifier l’état effectif. - Traitez les données locales de CC Switch et les configurations des agents en aval comme des espaces de stockage d’identifiants sensibles. - Délimitez les accès des serveurs MCP avec autant de soin que ceux des jetons API ; ils peuvent exécuter des commandes et exposer des fichiers. - Verrouillez les versions, testez les différences de configuration et maintenez un mécanisme de révocation des jetons. - Gardez les identifiants de production à fort impact hors des outils de changement de profil sur le poste de travail, à moins que les contrôles environnants ne permettent explicitement de gérer ce risque. [Développement](/fr/blog/tag/coding/)[Claude](/fr/blog/tag/claude/)[API](/fr/blog/tag/api/) A [AI Prime Tech](https://aiprimetech.io/fr/) Ce blog est publié par AI Prime Tech. Les articles sont rédigés avec l’aide de l’IA ; vérifiez les détails propres à chaque version, tels que les identifiants de modèles, les prix et les limites, dans la documentation officielle avant de vous y fier. Accédez à l’API Claude à moindre coût Une seule clé API pour Claude Opus 5.5, Sonnet 5, Haiku 4.5 et Fable 5.1, ainsi que GPT-6 modèles. Paiement à l’usage, sans abonnement. [Obtenir votre clé API →](/register) AI Prime Tech est une passerelle API tierce indépendante. Claude™ et Anthropic® sont des marques d’Anthropic, PBC. Aucune affiliation ni approbation n’est sous-entendue.