Claude Code : changer de fournisseur — tutoriel CC Switch en 5 minutes

Ce tutoriel porte sur CC Switch v4.0.26 (novembre 2026). Les libellés des boutons peuvent changer dans les versions ultérieures ; le modèle de configuration reste stable.

Changer de fournisseur dans Claude Code implique généralement de modifier ~/.claude/settings.json : l’URL de base, la clé API et parfois le modèle. Avec un seul fournisseur, c’est gérable. Avec deux ou trois, cela devient une petite tâche de maintenance — et le problème peut passer inaperçu, car une ancienne variable ANTHROPIC_* exportée dans votre shell peut prendre le pas sur le fichier que vous venez de modifier.

CC Switch transforme ce changement en une carte sur laquelle il suffit de cliquer. Son préréglage AiHubMix intégré renseigne l’endpoint ; vous n’avez qu’à coller une clé API. Claude Code recharge généralement la modification sans redémarrage. Ce tutoriel vous guide tout au long de la configuration, puis explique ce qu’écrit CC Switch, le piège des variables d’environnement et les cas où le mode direct suffit.

Pour la version courte : installez CC Switch, créez une clé AIHubMix, sélectionnez le préréglage AiHubMix sous Claude Code, collez la clé, ajoutez ANTHROPIC_MODEL=claude-sonnet-5-5 au fournisseur, cliquez sur Basculer, puis exécutez claude -p "1+1, output only the answer" --model claude-sonnet-5-5. La suite de cet article détaille ces étapes.

Qu’est-ce que CC Switch ?

CC Switch est une application de bureau open source (MIT, Tauri + Rust + React) qui permet de gérer les configurations de fournisseurs pour Claude Code, Codex, Gemini CLI, OpenCode et d’autres outils de programmation. Elle propose plus de 90 préréglages de fournisseurs et prend en charge les fournisseurs personnalisés.

C’est plus qu’un simple gestionnaire de clés :

• Le mode direct remplace les champs de clé dans le fichier de configuration du client et permet à celui-ci de communiquer avec le fournisseur.
• Le mode routage exécute une passerelle locale sur 127.0.0.1:15721, avec conversion de format d’API, basculement automatique, vérifications de santé et journaux de requêtes.
• Le mode agrégation rassemble les modèles de plusieurs fournisseurs dans une seule liste /model.

Le dépôt et le manuel d’utilisation sont disponibles sur github.com/farion1231/cc-switch. Seuls ccswitch.io et la page GitHub Releases sont des sources de téléchargement officielles ; tout site qui demande un paiement ou les identifiants de votre compte ne l’est pas.

Avant de commencer

Il vous faut trois éléments :

• Claude Code installé et exécutable depuis un terminal. Vérifiez avec claude --version. S’il n’est pas installé, utilisez le programme d’installation officiel : curl -fsSL https://claude.ai/install.sh | bash, ou npm i -g @anthropic-ai/claude-code avec Node.js 22 ou une version ultérieure.
• Un compte AIHubMix et une clé API. Créez-en une dans la console AIHubMix. La clé commence généralement par sk-.
• Un programme d’installation de CC Switch. Téléchargez-le depuis ccswitch.io ou GitHub Releases.

Étape 1 : installer CC Switch

Au premier lancement, CC Switch importe la configuration Claude Code existante sous le nom de fournisseur default et ajoute un fournisseur officiel. Votre configuration d’origine n’est pas perdue ; vous pouvez revenir en arrière à tout moment.

Si Claude Code n’est pas encore installé, la page Applications de CC Switch permet de l’installer ou de le mettre à niveau.

Étape 2 : créer une clé API AIHubMix

Ouvrez la page des clés API AIHubMix, créez une clé et copiez-la.

Le paramètre fictif AIHUBMIX_API_KEY dans la documentation n’est pas une vraie clé. Si vous le collez tel quel, la requête échoue avec l’erreur 401 invalid key: AIHUBMIX_API_KEY.

Étape 3 : ajouter AIHubMix à Claude Code

1. Sélectionnez Claude Code dans la barre latérale gauche.
2. Cliquez sur le bouton + dans le coin supérieur droit.
3. Recherchez AiHubMix ou trouvez-le dans la catégorie des plateformes tierces.
4. Le nom et l’endpoint sont renseignés automatiquement : https://aihubmix.com. Collez votre clé dans Clé API.
5. Cliquez sur Ajouter.

Le préréglage stocke deux variables d’environnement :

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com"
  }
}

Le préréglage ne définit pas de modèle. Le guide AIHubMix considère ANTHROPIC_MODEL comme une variable essentielle ; ajoutez-la donc au même bloc env avant de basculer :

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

Sans modèle défini, Claude Code envoie son propre ID de modèle par défaut, qui ne fait peut-être pas partie de ceux proposés par AIHubMix.

Deux détails méritent d’être signalés.

N’ajoutez pas /v1 à l’URL de base. Claude Code utilise le protocole Anthropic Messages et construit lui-même le chemin de la requête. https://aihubmix.com est correct ; https://aihubmix.com/v1 est l’URL de base compatible avec OpenAI destinée aux autres clients, et Claude Code lui ajouterait son propre /v1/messages.

Le préréglage utilise ANTHROPIC_API_KEY, tandis que le guide AIHubMix pour Claude Code utilise ANTHROPIC_AUTH_TOKEN. AIHubMix accepte les deux : ANTHROPIC_AUTH_TOKEN envoie un en-tête Bearer, tandis que ANTHROPIC_API_KEY envoie x-api-key. Choisissez-en une. Ne renseignez pas les deux avec des valeurs différentes. Les détails de configuration d’AIHubMix, les ID de modèles et la référence des erreurs figurent dans la documentation AIHubMix pour Claude Code.

Si le préréglage est absent — par exemple dans une ancienne version ou après la suppression de la carte — choisissez Configuration personnalisée et collez le JSON ci-dessus. Le gestionnaire d’endpoint de la carte du fournisseur peut tester la latence ; le préréglage inclut également https://api.aihubmix.com comme endpoint secondaire si aihubmix.com ne se résout pas.

Étape 4 : basculer et vérifier

Dans l’onglet Direct, cliquez sur Basculer sur la carte AiHubMix. Le bouton devient En cours d’utilisation une fois la configuration écrite.

Claude Code recharge automatiquement la configuration ; un redémarrage n’est généralement pas nécessaire. Si la session en cours continue d’utiliser l’ancien fournisseur, quittez-la et relancez-la.

Vérifiez le parcours de bout en bout :

claude -p "1+1, output only the answer" --model claude-sonnet-5-5

Une réponse 2 signifie que la requête est bien parvenue à AIHubMix. Dans une session interactive, la ligne Anthropic base URL de /status devrait afficher https://aihubmix.com.

Pour basculer rapidement, utilisez la barre d’état système : faites un clic droit sur l’icône CC Switch, ouvrez le sous-menu Claude Code, puis cliquez sur un fournisseur. Le titre du sous-menu indique le fournisseur actif et un récapitulatif du quota.

Pour revenir au fournisseur officiel, basculez vers Claude Official, redémarrez Claude Code et suivez la procédure de connexion.

Ce que le changement modifie réellement

En mode direct, CC Switch ne remplace que les champs de connexion et de compatibilité dans ~/.claude/settings.json : ANTHROPIC_*, AWS_*, les sélecteurs de protocole tels que CLAUDE_CODE_USE_BEDROCK, model, apiKeyHelper et quelques options de compatibilité propres au fournisseur, comme CLAUDE_CODE_DISABLE_ARTIFACT et la fenêtre de contexte.

permissions, hooks, enabledPlugins, statusLine, la configuration MCP, les commentaires et tout le reste que vous avez ajouté sont conservés. La liste exacte figure dans la référence du fichier de configuration.

Avant la première réécriture de la configuration d’un outil, CC Switch sauvegarde l’original dans ~/.cc-switch/backups/live-first-write/. Si le JSON est mal formé, l’application refuse de l’écrire, indique la ligne et la colonne concernées et laisse le fichier inchangé.

Le piège : les anciennes variables ANTHROPIC_*

C’est le problème qui donne l’impression que CC Switch n’a pas fonctionné.

Si vous avez suivi auparavant un guide de configuration manuelle et ajouté export ANTHROPIC_BASE_URL=... ou export ANTHROPIC_AUTH_TOKEN=... dans ~/.zshrc ou ~/.bash_profile, ces variables peuvent prendre le pas sur les valeurs écrites par CC Switch. Vous basculez vers la carte AIHubMix, mais les requêtes continuent d’être envoyées à l’ancien endpoint.

CC Switch détecte le conflit. Une bannière jaune en haut de la fenêtre indique que des variables d’environnement peuvent prendre le pas sur votre configuration ; les détails affichent le nom et la valeur de la variable, ainsi que sa source. Supprimer la sélection les supprime et crée d’abord une sauvegarde dans ~/.cc-switch/backups/env-backup-<timestamp>.json.

Pour vérifier manuellement :

grep -n "ANTHROPIC" ~/.zshrc ~/.bash_profile 2>/dev/null

Commentez les anciennes commandes export, puis exécutez source ~/.zshrc ou ouvrez un nouveau terminal. La documentation d’AIHubMix recommande de supprimer les variables globales ANTHROPIC_* lorsque CC Switch gère la configuration. La procédure complète de résolution des conflits figure dans la référence des variables d’environnement.

Alias de modèles et basculement

Avec ANTHROPIC_MODEL défini, le modèle par défaut de Claude Code est Sonnet 5.5. Les alias /model (opus, sonnet, haiku, fable) doivent tout de même être associés aux ID de modèles AIHubMix correspondants si vous voulez qu’ils fonctionnent. Ajoutez ces clés dans env :

La configuration complète du fournisseur se présente alors ainsi :

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1"
  }
}

Ordre de priorité pour la sélection du modèle, du plus prioritaire au moins prioritaire : /model <name> → claude --model <name> → ANTHROPIC_MODEL → le champ model de settings.json. Copiez les ID de modèles depuis la liste des modèles AIHubMix ; ils sont sensibles à la casse.

Quand utiliser le routage ou l’agrégation

Le mode direct est le meilleur choix par défaut pour AIHubMix. L’endpoint prend déjà en charge Anthropic Messages : aucune conversion de protocole n’est nécessaire.

Utilisez le routage si vous voulez une file de basculement automatique ou si vous devez faire passer un fournisseur au format OpenAI par Claude Code. Le routage dirige Claude Code vers http://127.0.0.1:15721, remplace la clé dans la configuration par PROXY_MANAGED et injecte la vraie clé depuis CC Switch. L’application doit rester lancée ; quitter CC Switch rétablit la configuration directe. Les abonnements Claude officiels ne passent pas par le routage ; utilisez le mode direct pour ceux-ci.

Utilisez l’agrégation si vous voulez regrouper les modèles de plusieurs fournisseurs dans une seule liste /model. Le fournisseur par défaut traite les requêtes sans préfixe ; les modèles des autres fournisseurs apparaissent avec le préfixe ccs-. L’agrégation n’active pas de basculement automatique. Elle est disponible uniquement pour Claude Code et Codex, et les abonnements officiels Claude ne sont pas pris en charge en mode agrégation. La liste de modèles ccs- nécessite Claude Code 2.1.243 ou une version ultérieure. Claude Code prend immédiatement en compte les modifications de la liste des modèles ; Codex nécessite un redémarrage complet.

Autres fonctions gérées par CC Switch

• Utilisation : le tableau de bord regroupe les journaux des requêtes acheminées et les journaux des sessions locales. L’analyse des sessions fonctionne sans acheminement et leur coût est calculé à partir du modèle indiqué dans le journal ; les requêtes acheminées sont consignées séparément.
• MCP : un panneau unifié pour les serveurs MCP, synchronisé avec les applications que vous sélectionnez.
• Skills : recherchez, installez et supprimez des skills depuis un seul endroit.
• Sessions : recherchez, consultez, exportez et reprenez des sessions locales.
• Projets : enregistrez le fournisseur, les serveurs MCP, les skills et les fichiers mémoire d’un projet sous forme d’instantané, puis basculez vers l’ensemble correspondant à chaque projet.

Les données sont stockées dans ~/.cc-switch/, au sein d’une base de données SQLite. Les sauvegardes automatiques conservent les 10 versions les plus récentes par défaut, et la synchronisation via WebDAV ou un service compatible S3 est disponible. La base de données et les sauvegardes exportées comprennent les configurations des fournisseurs, y compris leurs clés ; traitez-les donc comme des secrets.

Dépannage

Les messages d’erreur ci-dessous sont repris de la documentation Claude Code d’AIHubMix.

Pour les problèmes qui ne sont pas des erreurs :

• Écran de connexion ou Not logged in : vérifiez /status ; activez Skip Claude Code first-run confirmation sous Settings → App config → Claude Code ; redémarrez ; vérifiez que la clé est bien renseignée.
• Le changement de fournisseur n’a aucun effet : une variable d’environnement obsolète dans le shell ou une session mise en cache peut en être la cause ; ouvrez un nouveau terminal ou redémarrez Claude Code.
• Le test de connexion de la fiche réussit, mais les requêtes échouent : le test vérifie l’accessibilité, pas la clé ni le modèle ; exécutez la commande de bout en bout claude -p.
• Vous voulez revenir au fournisseur officiel : sélectionnez Claude Official, redémarrez Claude Code et reconnectez-vous.

Si la commande claude est introuvable sur macOS, le programme d’installation officiel la place généralement dans ~/.local/bin/claude. Ajoutez export PATH="$HOME/.local/bin:$PATH" au profil de votre shell, puis ouvrez un nouveau terminal.

Liste de vérification

• [ ] Installez CC Switch depuis ccswitch.io ou GitHub Releases.
• [ ] Créez une clé API dans la console AIHubMix.
• [ ] Dans Claude Code → + → AiHubMix → collez la clé → Add.
• [ ] Ajoutez ANTHROPIC_MODEL=claude-sonnet-5-5 au JSON du fournisseur.
• [ ] Cliquez sur Switch et vérifiez que la fiche affiche In use.
• [ ] Supprimez les exports obsolètes ANTHROPIC_* du profil de votre shell.
• [ ] Exécutez claude -p "1+1, output only the answer" --model claude-sonnet-5-5 et vérifiez que la réponse est 2.

Si la dernière commande renvoie 2, le changement de fournisseur est terminé. Il ne vous reste qu’à ajouter les alias de modèles souhaités et à déterminer si vous avez besoin de l’acheminement ou de l’agrégation ; pour la plupart des utilisateurs d’AIHubMix, le mode direct suffit.

FAQ

CC Switch est-il gratuit ?
Oui. Le logiciel est open source sous licence MIT. Vous ne payez que le fournisseur dont vous utilisez l’API.

Le changement de fournisseur supprime-t-il mes hooks, serveurs MCP ou plugins ?
Non. Le changement direct remplace l’endpoint, la clé, le modèle et quelques options propres au fournisseur. Les hooks, les autorisations, les serveurs MCP, les plugins et les paramètres de la barre d’état restent dans le fichier.

CC Switch téléverse-t-il ma clé API ?
Les configurations des fournisseurs sont stockées localement dans ~/.cc-switch/cc-switch.db. Si vous activez la synchronisation WebDAV ou S3, elles sont synchronisées vers un espace de stockage que vous contrôlez. Les bases de données et les sauvegardes contiennent des clés ; traitez-les donc comme des secrets.

Dois-je laisser CC Switch en cours d’exécution ?
Pas en mode direct. L’acheminement et l’agrégation nécessitent que l’application soit en cours d’exécution ; quitter CC Switch rétablit le mode direct dans le client.

Puis-je utiliser Claude Official et AIHubMix en même temps ?
En mode direct, un seul fournisseur peut être actif à la fois. L’agrégation permet de regrouper les modèles de plusieurs fournisseurs dans une même liste, mais l’abonnement officiel Claude n’y est pas pris en charge ; repassez en mode direct pour l’utiliser.

Fonctionne-t-il sous Windows ?
Oui. CC Switch prend en charge Windows 10 et les versions ultérieures, avec un installateur .msi ou une version portable. Linux nécessite glibc 2.35+ et WebKitGTK 4.1.

Pourquoi la fiche du fournisseur indique-t-elle que la connexion fonctionne alors que Claude Code échoue toujours ?
Le test de connexion de la fiche vérifie si l’endpoint est accessible. Il ne valide ni la clé API ni le modèle. Utilisez la commande de bout en bout claude -p pour tester l’ensemble du parcours.

Sources

• Dépôt CC Switch
• Manuel d’utilisation de CC Switch : Ajouter un fournisseur
• Manuel d’utilisation de CC Switch : Changer de fournisseur
• Manuel d’utilisation de CC Switch : Fichiers de configuration
• Documentation AIHubMix : Claude Code