Note de l’auteur : magpie et CC Switch modifient tous deux les fichiers de configuration de vos agents en local. Cet article compare leurs choix d’architecture, leur rythme de publication, leurs capacités et leurs publics, et explique pourquoi il faut choisir un seul des deux pour gérer la configuration.
Ces derniers temps, ~/.claude/settings.json se retrouve dans une situation délicate. CC Switch s’en occupe depuis plus d’un an : lors d’un changement de fournisseur, il ne modifie que les champs de connexion et laisse le reste intact. Mais magpie veut lui aussi écrire dans ce fichier pour remplacer le point d’accès par 127.0.0.1:3425. Les deux programmes écrivent donc au même endroit : le dernier à intervenir l’emporte, et les modifications du précédent sont écrasées sans avertissement. Ce fichier de configuration ne peut donc être géré que par un seul programme à la fois.
Les deux projets avancent à des rythmes très différents. Au 28 octobre 2026, le dépôt de publications de magpie avait dépassé les 1 000 numéros de version depuis sa création, le 23 septembre 2026. Pour la seule journée du 27 octobre, l’API GitHub en recensait 87. De son côté, CC Switch est passé de la v3.19.0 (30 juillet 2026) à la v4.0.21 (26 octobre 2026) : 30 versions officielles en trois mois, chacune accompagnée de notes de publication en chinois. « Magpie » signifie « pie » en anglais : cet oiseau annonce donc plusieurs dizaines de mises à jour par jour.
Les avis de la communauté sur magpie sont également partagés. Le 10 octobre 2026, un fil sur linux.do s’intitulait : « magpie est vraiment déroutant à utiliser, je déconseille de changer si vous êtes habitué à CC Switch ». Le lendemain, un autre demandait : « Pourquoi tout le monde recommande magpie ? Je l’ai installé et je ne vois pas vraiment ce qu’il apporte de mieux ». Certains craignent que CC Switch soit remplacé. Notre conclusion : il ne le sera pas, mais magpie a bien attiré une partie de ses utilisateurs.
Cet article n’est pas un tutoriel d’installation et ne cherche pas à désigner un vainqueur absolu. Il vise simplement à clarifier les différences entre les deux approches pour vous aider à choisir lequel garder.
Magpie VS CC Switch : des dizaines de versions par jour contre 30 en trois mois
La différence la plus frappante entre les deux projets concerne leur rythme de publication. Commençons donc par là. Le numéro de version de magpie reste en 0.1.x, mais son numéro de correctif grimpe rapidement. Entre le 3 octobre 2026 à 13 h et le 4 octobre à 14 h, soit en 25 heures, le projet est passé de v0.1.756 à v0.1.859 : 100 versions exactement. Au 28 octobre 2026, la plus récente était la v0.1.1801. L’API GitHub ne renvoie que les 1 000 dernières publications au maximum : les plus anciennes ne sont plus accessibles, ce qui indique que le total continue d’augmenter.
Il faut toutefois préciser ce que représentent ces numéros. Ce sont des numéros de correctif générés par des builds automatiques : un paquet est publié pour presque chaque commit. Cela ne signifie pas qu’il y a eu 1 000 mises à niveau fonctionnelles. Ce rythme révèle deux choses : la maintenance est active et les problèmes sont corrigés rapidement ; mais la branche 0.1.x est encore dans une phase d’expérimentation intensive, et son numéro de version invite à ne pas trop compter sur sa stabilité.
| Indicateur (au 2026-10-28) | magpie | CC Switch |
|---|---|---|
| Création du dépôt | 2026-09-23 | 2025-08-04 |
| Dernière version | v0.1.1801 | v4.0.21 (2026-10-26) |
| Rythme de publication | Jusqu’à 87 versions recensées en une journée, plus de 1 000 au total | 30 versions officielles en trois mois |
| Stars GitHub | Environ 23 800 | Environ 149 000 |
| Outils pris en charge | 68 agents listés dans le README | 12 outils, chacun avec son propre préréglage |
| Mode de maintenance | Pas de PR externes : seuls les mainteneurs peuvent en ouvrir | Collaboration ouverte via les issues et les PR |
Entre les 149 000 stars de l’un et les 100 paquets publiés en une journée par l’autre, on voit que les deux projets n’en sont pas au même stade : CC Switch dispose déjà d’une vaste base d’utilisateurs, tandis que magpie évolue encore très vite. Ce n’est pas une question de travail plus ou moins assidu, mais de rythme et de tolérance au risque. L’auteur de CC Switch indique avoir fermé plus de 500 anciennes issues lors de la refonte 4.0. Magpie a atteint environ 23 800 stars en un peu plus d’un mois, mais popularité et stabilité sont deux choses différentes.
À noter aussi : la page CC Switch du site de documentation APIYI (tutoriel sur docs.apiyi.com) mentionne encore la v3.12.0 et 5 outils. Elle n’est donc plus à jour par rapport au dépôt officiel, qui indique 12 outils et la v4.0.21. Pour les versions, référez-vous à GitHub.
Magpie VS CC Switch : modifier les fichiers de configuration ou passer d’abord par une passerelle locale ?
La différence fondamentale tient à leur approche : CC Switch est centré sur les agents, tandis que magpie est centré sur la passerelle.
Lors d’un changement de fournisseur, CC Switch remplace uniquement les champs de connexion dans les fichiers de configuration des outils : adresse des requêtes, clé et modèle. Les extensions, hooks, MCP, paramètres personnels et commentaires restent intacts. Le fichier d’origine est automatiquement sauvegardé avant la première modification. Claude Code, Codex et Gemini CLI utilisent un mode « commutation » : un seul fournisseur est actif à la fois. OpenCode, OpenClaw, Hermes et Pi utilisent un mode « coexistence » : plusieurs fournisseurs sont inscrits simultanément dans la configuration de l’outil. CC Switch propose aussi un routage local, à activer manuellement. Une fois activé, il permet de convertir les protocoles Anthropic Messages, OpenAI Chat Completions, OpenAI Responses et Gemini Native entre eux, et fournit une file de basculement ainsi qu’un disjoncteur.
De son côté, magpie dirige d’abord les points d’entrée des agents vers 127.0.0.1:3425. Les clés sont stockées dans magpie, puis la passerelle transmet les requêtes au fournisseur en amont. Elle prend en charge la conversion entre quatre protocoles, y compris pour les réponses en streaming, les appels d’outils et les contenus de raisonnement. Elle modifie elle aussi les champs essentiels dans la configuration des agents. Selon les termes du README, magpie modifie la clé qui compte dans la configuration propre à l’agent. L’écriture est atomique et préserve les commentaires, l’ordre et le formatage. Si vous ne voulez pas qu’il modifie les fichiers de configuration, vous pouvez aussi faire pointer OPENAI_BASE_URL, ANTHROPIC_BASE_URL et GOOGLE_GEMINI_BASE_URL vers la passerelle locale, puis utiliser magpie comme clé.
| Critère | magpie | CC Switch |
|---|---|---|
| Positionnement | Passerelle locale + outil de commutation | Gestionnaire de configuration pour ordinateur + routage local facultatif |
| Méthode de commutation | Les requêtes passent par 127.0.0.1:3425 avant d’être envoyées |
Modifie les champs de connexion dans la configuration de chaque outil |
| Tolérance aux pannes des comptes | Cinq modes de groupes de routage + basculement entre plusieurs comptes + Daily warm-up | File de basculement + disjoncteur + surveillance de l’état |
| Gestion au quotidien | Library : instructions, MCP, skills et subagents définis une seule fois | Panneau MCP + Skills + bibliothèque d’invites + gestionnaire de sessions |
| Sessions | Liste affichant le coût de chaque session, avec réouverture dans le terminal en un clic | Analyse en contenu structuré, résumés des tours de conversation, commandes d’export et de restauration |
| Modes d’exécution | Application de bureau, TUI, CLI, interface Web, Docker, Termux | Application de bureau + zone de notification |
Les atouts de magpie : routage, tolérance aux pannes et migration
magpie séduit surtout pour les raisons suivantes :
- Migration facile : la fonction Import de la page des fournisseurs permet d’importer directement ceux de CC Switch. La migration ne prend que quelques minutes. C’est son atout le plus direct face à CC Switch.
- Groupes de routage : un groupe peut être présenté à un agent comme un modèle, par exemple
group/daily-coding. Cinq modes sont proposés : smart, order, rotate, usage et pace. Les sessions qui bénéficient du cache restent associées au compte qui leur a répondu en premier. - Abonnements comme fournisseurs : les abonnements Claude, ChatGPT, Copilot et autres auxquels vous êtes connecté peuvent servir de fournisseurs pour d’autres agents. Cette fonction peut être désactivée dans les paramètres de confidentialité.
- Masquage des données sensibles : les clés, tokens, adresses e-mail et autres informations sont remplacés localement par des espaces réservés avant l’envoi. La fonction est désactivée par défaut. Une fois activée, si le masquage aurait dû s’appliquer mais a échoué, la requête renvoie directement une erreur 503 : le texte original n’est pas transmis.
- Partage sur le réseau local et déploiement : vous pouvez attribuer une clé de passerelle distincte et définir un plafond de dépenses pour chaque client, ou encore exécuter magpie sur un NAS avec Docker.
Les atouts de CC Switch : une gestion quotidienne plus détaillée
CC Switch va plus loin dans les fonctions de gestion au quotidien :
- Panneau MCP unifié : cochez les outils à synchroniser et importez leurs configurations existantes.
- Gestion des Skills : installez-les en un clic depuis GitHub ou un fichier ZIP, et mettez-les toutes à jour en un clic.
- Bibliothèque d’invites : à l’activation, l’invite est écrite dans CLAUDE.md / AGENTS.md. Le contenu déjà présent dans le fichier est d’abord sauvegardé dans la bibliothèque.
- Gestionnaire de sessions : chaque tour est réduit à une ligne de résumé, les étapes ayant échoué apparaissent en rouge et vous pouvez copier une commande de reprise pour continuer la conversation.
- Instantanés de projet : basculez d’un seul coup les fournisseurs, MCP, Skills et invites selon le projet.
La version v4.0.21 permet aussi de basculer entre plusieurs comptes d’abonnement officiels Claude. La connexion suit la procédure officielle et les jetons sont stockés uniquement à l’emplacement utilisé par Claude Code. CC Switch ne les enregistre pas, ne les téléverse pas et précise qu’il n’effectue pas non plus de rotation automatique selon les quotas. Une approche plutôt prudente, à l’opposé de celle de magpie.
Les outils ne font que transmettre les requêtes : modèle et clé pour Magpie et CC Switch
Quel que soit l’outil choisi, son rôle se limite à transmettre les requêtes. Le modèle et la clé API doivent être obtenus séparément. Pour utiliser les outils sans difficulté, il vous faut une clé claude-opus-5-5 fiable. APIYI (apiyi.com) propose à la fois une interface compatible Anthropic et une interface compatible OpenAI, auxquelles les deux outils peuvent se connecter directement.
| Paramètre | Valeur | Remarque |
|---|---|---|
| Adresse compatible Anthropic | https://api.apiyi.com |
Sans /v1, adaptée à Claude Code |
| Adresse compatible OpenAI | https://api.apiyi.com/v1 |
Adaptée à Codex et aux autres outils utilisant le protocole OpenAI |
| Nom du modèle | claude-opus-5-5 |
La version thinking claude-opus-5-5-thinking est au même prix |
| Prix (par million de tokens) | Entrée : 4 $ / sortie : 20 $ / lecture du cache : 0,20 $ | Au 28 octobre 2026 ; consultez la liste des modèles de la plateforme pour connaître les modèles et tarifs en vigueur |
| Points de terminaison et groupes | chat, messages ; groupes ClaudeCode, Default, SVIP, etc. | Choisissez un groupe selon vos besoins |
À noter : les deux outils lisent la même configuration d’agent. CC Switch écrit la clé API dans ~/.claude/settings.json, tandis que Magpie la stocke dans la passerelle. Les deux utilisent au final le même compte en amont. Il suffit donc de changer la clé API une seule fois dans la console APIYI. Vous pouvez également consulter le solde et la consommation au même endroit, sans avoir à renseigner la clé séparément dans chaque outil.
Magpie vs CC Switch : qui devrait rester, qui devrait changer ?
Continuer avec CC Switch
Si vous utilisez surtout Claude Code, avec un ou deux fournisseurs seulement, et que vous privilégiez la stabilité sans vouloir résoudre des problèmes après chaque mise à jour, CC Switch est plus adapté. Il modifie peu de choses, dispose d’un système de sauvegarde complet et, en cas de problème, il suffit d’ouvrir le fichier de configuration pour en comprendre la cause. Les personnes qui organisent régulièrement leurs MCP, Skills et invites, ou qui ont besoin de consulter leurs anciennes sessions, seront aussi plus à l’aise avec son interface et son fonctionnement.
L’auteur de la discussion du 10 octobre le dit sans détour : « Regrouper tous les fournisseurs au même endroit, c’est trop désordonné, ça ne vaut pas du tout le coup de passer à cet outil. Et plus gênant encore : une fois le modèle choisi dans le logiciel, on ne peut plus en changer dans la CLI. » Dans le même fil, une autre personne estime que « pour l’instant, il n’y a pas de fonctionnalité exclusive qui surpasse vraiment CCS ». Ces utilisateurs veulent avant tout changer de fournisseur en un clic, et CC Switch répond déjà à ce besoin.
Passer à magpie
Si vous utilisez plusieurs agents comme Codex, Gemini CLI, OpenCode et Pi, que vous avez plusieurs abonnements et clés API, et que vous souhaitez passer automatiquement de l’un à l’autre lorsque votre quota est épuisé, tout en disposant d’un tableau de bord des coûts, l’approche par passerelle de magpie vous conviendra mieux. Le même jour, une personne écrit dans la discussion : « Je suis passé de ccswitcg à magpie cet après-midi, je n’ai enfin plus besoin de tester la disponibilité de chaque service proxy API un par un. » Dans le fil du 11 octobre, un partisan affirme aussi qu’« ajouter des fournisseurs et passer de l’un à l’autre est plus pratique avec magpie qu’avec CCS, et ses règles de routage sont très puissantes ». Une autre personne signale que CC Switch ne permet pas d’afficher les modèles ni d’en changer correctement dans l’application Codex.
Les retours négatifs sur magpie demandent toutefois à être examinés au cas par cas. Une personne rapporte que le cache de Claude semblait ne plus fonctionner après l’intégration de magpie, entraînant une hausse des coûts. Dans la discussion, une autre soupçonne la couche intermédiaire de filtrer les invites, ce qui aurait conduit au rejet de requêtes. Ces deux retours sont des cas isolés, sans procédure permettant de reproduire le problème : ils ne suffisent donc pas à établir que magpie présente ces défauts. Les informations de cet article se répartissent en trois catégories : les déclarations officielles du projet, les retours isolés de tiers et les points sur lesquels aucune conclusion n’a encore été établie. Il est important de les distinguer.
Magpie VS CC Switch : quel outil choisir selon votre profil ?
| Votre situation | Recommandation | Pourquoi |
|---|---|---|
| Vous utilisez seulement Claude Code avec un ou deux fournisseurs et cherchez la stabilité | CC Switch | Peu de modifications, des sauvegardes et un rythme stable de 30 versions officielles en trois mois |
| Vous utilisez plusieurs agents et comptes et voulez une tolérance automatique aux pannes et un tableau de bord des coûts | magpie | Groupes de routage + basculement automatique + statistiques d’utilisation |
| Vos principaux besoins concernent MCP, les Skills, les invites et la consultation des sessions | CC Switch | Panneau de gestion plus détaillé et analyse des sessions plus complète |
| Vous voulez partager l’accès sur le réseau local, utiliser un NAS ou convertir les protocoles pour des agents non pris en charge | magpie | Passerelle et déploiement Docker |
| Vous voulez les deux | Laissez un seul outil modifier la configuration | Voir la section suivante |
💡 Conseil : si vous hésitez, essayez chaque outil pendant un après-midi avec la même clé API. Pour connecter CC Switch, consultez le tutoriel APIYI
docs.apiyi.com/scenarios/programming/cc-switch. Pour la passerelle unifiée de magpie, consultezhelp.apiyi.com/magpie-unify-claude-code-codex-pi-hermes-api-gateway.html. Suivez les étapes indiquées : inutile de tout découvrir par vous-même.
Installer les deux outils : un seul programme doit gérer settings.json
Revenons au problème évoqué au début. magpie et CC Switch modifient les mêmes fichiers, notamment ~/.claude/settings.json et ~/.codex/config.toml. Si les deux fonctionnent en même temps, changer de fournisseur dans l’un peut écraser silencieusement les réglages de l’autre, sans avertissement. Le fournisseur réellement utilisé par Claude Code dépend alors du dernier programme à avoir écrit dans le fichier.
Pour faire cohabiter les deux outils, il faut décider lequel contrôle les fichiers de configuration : l’un les modifie, tandis que l’autre se limite à les lire ou est fermé après utilisation. Par exemple, vous pouvez laisser CC Switch gérer MCP et les invites, et confier entièrement le changement de fournisseur à magpie, ou faire l’inverse. Les deux programmes ne doivent pas modifier les fichiers chacun de leur côté sur la durée. Si vous envisagez une migration, utilisez la fonction Import de magpie pour importer les fournisseurs de CC Switch, vérifiez que tout est correct, puis fermez l’ancien outil afin d’éviter les écritures simultanées.
Risques et suspension de compte : sauvegardez avant d’utiliser Magpie ou CC Switch
Quelques points à garder en tête :
- Les deux sont des outils tiers open source (sous licence MIT) qui modifient les fichiers de configuration des agents installés sur votre machine. Avant de les installer, sauvegardez manuellement les fichiers comme
~/.claude/settings.jsonet~/.codex/config.toml: ne comptez pas uniquement sur les sauvegardes intégrées aux outils. - L’utilisation des abonnements hors des clients officiels peut contrevenir aux conditions d’utilisation : utiliser un abonnement Claude, ChatGPT ou Copilot en dehors du client officiel peut enfreindre les conditions du fournisseur. La documentation de CC Switch contient d’ailleurs un avertissement similaire. La fonction de magpie qui permet d’utiliser un abonnement comme fournisseur peut être désactivée dans Settings → Privacy.
- Vous assumez les conséquences : configuration écrasée, perte de crédits, risques pour votre compte ou autres conséquences relèvent de votre responsabilité. Cet article ne cautionne aucun des deux outils. Nous vous conseillons de les essayer d’abord avec un compte secondaire ou sur un projet secondaire.
Questions fréquentes (FAQ)
Q1 : Peut-on installer Magpie et CC Switch en même temps ?
Oui, mais ils ne doivent pas modifier la configuration en même temps. Les deux outils écrivent dans le même fichier `~/.claude/settings.json` : il faut donc en désigner un pour les modifications et laisser l’autre en lecture seule ou le fermer.
Q2 : Magpie a publié plus d’un millier de versions en un peu plus d’un mois. Est-ce un signe d’instabilité ?
Il s’agit surtout de numéros de correctifs générés automatiquement, ce qui témoigne d’une maintenance fréquente et de corrections rapides. Cela dit, la branche 0.1.x est encore en phase d’expérimentation. Si la stabilité est essentielle pour vous, mieux vaut attendre encore un peu.
Q3 : Magpie peut-il invalider le cache et faire augmenter les coûts ?
Pour l’instant, seuls quelques utilisateurs l’ont signalé. Il s’agit de cas isolés, sans procédure permettant de reproduire le problème : on ne peut donc pas en tirer de conclusion. En cas de doute, comparez votre tableau de bord d’utilisation avant et après le changement.
Q4 : Faut-il demander une nouvelle clé API quand on change d’outil ?
Non. Les deux outils ne font que transmettre les requêtes : vous pouvez conserver la même clé API. Gérez-la dans la console APIYI sur apiyi.com, puis renseignez-la dans CC Switch ou Magpie.
Q5 : Quelle adresse faut-il renseigner pour claude-opus-5-5 ?
Claude Code utilise le protocole Anthropic : renseignez l’adresse sans `/v1`. Pour Codex et les autres outils utilisant le protocole OpenAI, utilisez l’adresse avec `/v1`. Au 28 octobre 2026, les tarifs sont de 4 $ en entrée, 20 $ en sortie et 0,2 $ pour la lecture du cache, par million de tokens. Consultez la liste des modèles sur apiyi.com pour connaître les tarifs applicables.
Q6 : Magpie va-t-il remplacer CC Switch ?
Non. Les deux outils n’interviennent pas au même niveau : CC Switch gère et permet de changer la configuration des agents, tandis que Magpie fait passer toutes les requêtes par une passerelle locale. Les utilisateurs de CC Switch les plus concernés sont ceux qui cherchent uniquement à changer de fournisseur en un clic.
Magpie VS CC Switch : points clés
- Deux approches différentes : CC Switch réécrit le fichier de configuration, tandis que magpie fait passer les requêtes par une passerelle locale à l’adresse
127.0.0.1:3425. - Deux rythmes différents : au 28 octobre 2026, magpie avait dépassé les 1 000 numéros de version, tandis que CC Switch avait publié 30 versions officielles en trois mois.
- Des points forts distincts : magpie excelle dans le routage, la tolérance aux pannes et la conversion entre protocoles ; CC Switch se distingue par la gestion des MCP, des Skills et des sessions.
- Pas d’écriture simultanée : les deux outils modifient le même fichier settings.json. Un seul peut donc disposer des droits d’écriture.
- Des retours négatifs surtout isolés : les remarques sur le cache ou la censure ne sont pas accompagnées d’étapes permettant de reproduire les problèmes. Elles ne suffisent donc pas à tirer des conclusions.
- Une seule clé à gérer : changez-la depuis la console APIYI ; les deux outils lisent la même configuration de l’agent.
Conclusion
La comparaison entre magpie et CC Switch oppose avant tout deux approches : l’une centrée sur une passerelle, avec des itérations rapides ; l’autre centrée sur la configuration des agents, avec un développement plus progressif. magpie a attiré une partie des utilisateurs qui voulaient simplement changer de fournisseur en un clic, tandis que CC Switch reste plus complet pour la gestion quotidienne. Le débat dans la communauté va probablement se poursuivre, mais pour un utilisateur individuel, le choix est assez simple.
Un seul programme peut gérer ~/.claude/settings.json à la fois. Choisissez un outil en fonction des cinq scénarios présentés plus haut et gardez-le sur la durée : inutile de passer constamment de l’un à l’autre.
Vous pouvez préparer votre accès au modèle et votre clé sur APIYI, à l’adresse apiyi.com. La même clé permet d’accéder à claude-opus-5-5, quel que soit l’outil choisi.
📚 Références
- Dépôt GitHub de magpie : passerelle IA locale unifiée et outil de bascule entre modèles
- Lien :
github.com/yetone/magpie -
Détails : le README contient une liste de 68 agents et présente la passerelle. La version chinoise est disponible dans README.zh-CN.md.
-
Documentation officielle de magpie : fonctionnalités et configuration
- Lien :
usemagpie.ai/docs -
Détails : présentation détaillée des groupes de routage, du masquage des données sensibles et du partage sur le réseau local.
-
Dépôt GitHub de CC Switch : gestionnaire tout-en-un multiplateforme
- Lien :
github.com/farion1231/cc-switch -
Détails : notes de publication et liste des correctifs. C’est la source de référence pour les versions.
-
Site officiel de CC Switch : présentation du produit et téléchargement
- Lien :
ccswitch.io - Détails : liste des outils pris en charge et instructions d’utilisation.
Auteur : équipe technique APIYI
Échanges techniques : contactez-nous depuis la page d’accueil du site APIYI. Pour en savoir plus sur l’intégration, consultez la documentation sur docs.apiyi.com.
