Comment connecter n'importe quel modèle à Claude Code : Gemini, GPT et Grok

Le résumé direct

Connecter un autre modèle à Claude Code, c'est garder le harnais (interface, outils, skills, hooks et MCP) et ne changer que le cerveau qui répond, en pointant l'endpoint de l'API vers un routeur qui traduit l'appel. Claude Code ne parle qu'un seul protocole, celui de l'API Anthropic, mais accepte une autre adresse par la variable ANTHROPIC_BASE_URL. Un routeur open source comme 9router écoute à cette adresse, convertit la requête pour Gemini, GPT/Codex, Grok et d'autres fournisseurs, et renvoie la réponse dans le format que Claude Code attend. Le harnais reste, seul le modèle change. C'est pour qui vit déjà dans le terminal et veut un modèle moins cher pour lire du code, ou un second avis d'un autre éditeur, sans apprendre un nouvel outil. Ce n'est pas un chemin pris en charge par Anthropic, et une partie des fonctions du CLI cesse de s'appliquer quand le modèle de l'autre côté n'est pas Claude.

1. Le harnais et le modèle sont deux choses différentes

Qui utilise Claude Code au quotidien a tendance à appeler l'ensemble « Claude ». En pratique, il y a deux couches. Le harnais est le programme dans le terminal : il lit et édite des fichiers, lance des commandes, charge les skills, déclenche les hooks, parle aux serveurs MCP et garde l'historique de la session. Le modèle est ce qui décide quoi faire de tout cela, tour par tour, de l'autre côté du réseau.

Le harnais ne sait pas qui répond. Il construit une requête au format Anthropic Messages, l'envoie à une adresse et attend des événements de streaming en retour. La documentation officielle indique que, avec ANTHROPIC_BASE_URL pointé vers un gateway, Claude Code « treats the gateway as the Claude API and can't tell which upstream you forward to ». C'est cette cécité qui rend l'échange possible.

C'est pourquoi le travail déjà mis dans la configuration reste utile. Les règles du projet, les serveurs MCP que vous avez déjà branchés (si vous n'en avez encore branché aucun, le guide MCP dans Claude Code et Cursor couvre la base) et les hooks de validation restent les mêmes. Ce qui change, c'est la qualité, le coût et le style de ce qui réfléchit.

Une précision sur le « n'importe quel » du titre : ici, cela veut dire n'importe quel fournisseur que le routeur prend en charge. Le README de 9router liste plus de 40 fournisseurs par clé d'API, dont OpenAI, Anthropic, Gemini et xAI. En dehors de cette liste, il n'y a pas de traduction, et il n'y a pas de magie.

2. Comment le routeur se place au milieu

Le flux a trois pièces :

1. Claude Code envoie la requête à l'adresse définie dans ANTHROPIC_BASE_URL, sur le chemin /v1/messages, comme le décrit le guide de compatibilité.
2. Le routeur la reçoit, lit l'ID du modèle demandé, choisit le fournisseur et convertit le corps vers le format de ce fournisseur (Gemini, OpenAI, xAI).
3. La réponse revient convertie en événements au format Anthropic, et Claude Code poursuit le tour comme si rien n'avait changé.

9router fait cela en local, sur votre machine ou sur un VPS, avec un tableau de bord web pour ajouter les fournisseurs et générer la clé que Claude Code va utiliser. D'après le README, le projet est sous licence MIT, ne facture rien, et vous payez chaque fournisseur directement. Le chiffre de coût que montre le tableau de bord est une estimation de comparaison, pas une facture.

Il existe une alternative qui ne passe pas par un routeur : Anthropic propose elle-même Claude via Amazon Bedrock, Google Cloud Agent Platform et Microsoft Foundry. Ce sont les backends officiels. Mais tous servent des modèles Claude. Si le but est de faire tourner Gemini ou Grok à l'intérieur du harnais, le routeur est la seule pièce qui le résout, et vous en assumez la maintenance.

3. Installer 9router

Le README propose deux chemins. Avec npm, sur Node.js 20 ou plus récent :

npm install -g 9router
9router

Avec Docker, les données persistées dans un dossier de votre répertoire personnel :

docker run -d --name 9router -p 20128:20128 \
  -v "$HOME/.9router:/app/data" \
  -e DATA_DIR=/app/data decolua/9router:latest

Dans les deux cas, le tableau de bord s'ouvre sur http://localhost:20128/dashboard. Le port par défaut est 20128. Si vous le faites tourner sur un VPS, n'exposez pas ce port à internet : laissez le routeur n'écouter que sur localhost et atteignez le tableau de bord par un tunnel SSH. Qui détient la clé du routeur dépense le crédit de tous les fournisseurs qui y sont enregistrés.

Avant de continuer, vérifiez deux choses dans le tableau de bord : qu'il s'est ouvert sans erreur, et qu'il existe une option pour générer une clé d'accès de 9router lui-même. C'est cette clé, et non celle de Gemini ou de xAI, qui va dans Claude Code.

4. Ajouter les fournisseurs

Dans le tableau de bord, chaque fournisseur s'ajoute avec ses propres identifiants. Le chemin sûr, pour tous, est une clé d'API avec facturation à l'usage.

• Gemini : générez une clé de la Gemini API dans la console Google et collez-la dans le fournisseur Gemini de 9router. Le tableau de prix officiel a un niveau gratuit et un niveau payant ; pour un travail de client, utilisez le payant.
• Grok : il passe par une clé de l'API xAI, facturée au token. Sans clé xAI, il n'y a pas de Grok dans le routeur.
• Codex et GPT : la documentation de Codex décrit deux connexions, « Sign in with ChatGPT for subscription access » et une clé d'API, qu'OpenAI facture « at standard API rates ». Utilisez la clé d'API.

Pourquoi ne pas utiliser un abonnement grand public

Le README de 9router propose une connexion OAuth pour les abonnements (ChatGPT/Codex, Claude Code et d'autres). Techniquement, ça marche. Contractuellement, c'est une autre histoire. Les conditions supplémentaires de Google Antigravity le disent sans détour : « Using third party software, tools, or services to access the Service (e.g. using OpenClaw with Antigravity OAuth) is a breach of this Agreement », et elles prévoient la suspension ou la résiliation des comptes Antigravity et Gemini CLI. Du côté d'OpenAI, la documentation d'authentification de Codex liste où la connexion ChatGPT est prise en charge : l'application de bureau, le Codex CLI et l'extension d'IDE. Un routeur tiers n'est pas dans la liste.

En pratique : un abonnement grand public branché sur un routeur peut violer les conditions du fournisseur et vous coûter le compte. Une clé d'API payée à l'usage est le chemin sans ambiguïté, et la facture reste prévisible parce que chaque token a un prix publié.

5. Pointer Claude Code avec un lanceur isolé

Ne touchez pas à votre Claude Code principal. Créez un lanceur qui démarre une instance séparée, avec son propre répertoire de configuration. La documentation officielle décrit CLAUDE_CONFIG_DIR exactement pour cela : il remplace le répertoire par défaut ~/.claude et est « Useful for running multiple accounts side by side ». Connexion, réglages, historique et plugins restent séparés, et aucun ne contamine l'autre.

Enregistrez-le sous ~/bin/claude-roteado et rendez-le exécutable :

#!/usr/bin/env bash
export CLAUDE_CONFIG_DIR="$HOME/.claude-roteado"
export ANTHROPIC_BASE_URL="http://localhost:20128"
export ANTHROPIC_AUTH_TOKEN="$(cat "$HOME/.config/9router.key")"
exec claude "$@"

Trois détails de ce fichier :

• ANTHROPIC_BASE_URL pointe vers la racine du port. Claude Code ajoute /v1/messages tout seul, comme le montre le guide de compatibilité. Le README de 9router mentionne l'endpoint /v1 dans un exemple de config.json ; si votre requête aboutit sur un chemin dupliqué, ajustez ici.
• ANTHROPIC_AUTH_TOKEN porte la clé générée dans le tableau de bord de 9router, envoyée dans l'en-tête Authorization avec le préfixe Bearer. La clé vit dans un fichier lisible seulement par votre utilisateur, jamais écrite dans le script ni versionnée.
• L'abonnement est hors circuit. La documentation officielle explique que, avec un identifiant de gateway actif, les requêtes n'utilisent pas la connexion claude.ai et les limites du forfait ne s'appliquent pas : la facturation va à celui qui possède l'identifiant que le gateway transmet. Dans votre cas, chaque fournisseur enregistré.

Si vous gardez des règles de projet pour plus d'un agent, l'article Rulesync : des règles communes pour Claude Code, Codex et Cursor montre comment ne pas dupliquer les instructions. Le problème ici est un autre : le même CLAUDE.md est désormais lu par des modèles différents, et tous ne suivent pas une règle longue avec la même discipline.

Si ce dont vous avez besoin, c'est que l'agent lise votre ERP, votre boutique ou votre banque par ce même chemin, c'est de l'intégration sur mesure (MCP, webhooks, files d'attente). Décrivez le système et ce que vous voulez automatiser.

Parler du projet

6. Choisir le modèle par variable ou par alias

L'ID du modèle est ce que le routeur utilise pour décider du fournisseur. Le README montre le format avec préfixe, comme cx/ pour Codex. Copiez l'ID exact de la liste de modèles du tableau de bord ; n'inventez pas de noms.

Pour une session entière sur un seul modèle, passez l'ID au démarrage. La documentation de configuration du modèle liste l'ordre : /model dans la session, --model au démarrage, ANTHROPIC_MODEL et le champ model des réglages.

claude-roteado --model "<id-copiado-do-painel>"

Le plus confortable est de remapper les alias. Les variables ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL et ANTHROPIC_DEFAULT_HAIKU_MODEL disent vers où pointent opus, sonnet et haiku. Ajoutez ceci au lanceur :

export ANTHROPIC_DEFAULT_OPUS_MODEL="<id-claude-no-painel>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="<id-codex-no-painel>"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="<id-gemini-flash-no-painel>"

Avec cela, /model sonnet appelle désormais Codex et /model haiku appelle Gemini Flash. D'après la documentation, l'alias haiku est aussi le modèle des tâches de fond, donc les titres de session et les résumés internes vont au modèle le moins cher. Pour les sous-agents, CLAUDE_CODE_SUBAGENT_MODEL définit le défaut : la session principale réfléchit sur un modèle et les sous-agents de recherche tournent sur un autre.

Un détail du sélecteur : la découverte automatique des modèles du gateway ne conserve que les ID qui contiennent « claude » ou « anthropic ». Un ID Gemini ou Grok n'apparaît pas tout seul dans /model. Pour en mettre un dans le menu, utilisez ANTHROPIC_CUSTOM_MODEL_OPTION avec l'ID et ANTHROPIC_CUSTOM_MODEL_OPTION_NAME avec un nom lisible.

7. Quand chaque modèle vaut le coup

La répartition qui a du sens se fait par type de travail, pas par fidélité à une marque :

• Gemini Flash pour la lecture bon marché. Balayer un dépôt, résumer un module, trouver où une fonction est appelée, expliquer un long journal. C'est du travail avec beaucoup de tokens d'entrée et peu de décisions, et le prix d'entrée de Flash est le plus bas du tableau ci-dessous.
• Codex pour les scripts et un second avis. Un script de migration, un test qui manque, ou la relecture d'un diff écrit par Claude. Un autre éditeur se trompe autrement, et cela attrape des bugs que le même modèle laisserait passer.
• Grok comme alternative de raisonnement général, quand vous voulez comparer les réponses sur un problème ouvert.
• Claude pour l'écriture et la refactorisation lourde. Des changements dans beaucoup de fichiers, une refactorisation avec tests, un long travail riche en outils. Le harnais a été conçu autour de lui, et c'est le seul cas où l'effort, le thinking adaptatif et le cache fonctionnent comme la documentation le décrit.

Prix pour 1 million de tokens, d'après les pages officielles lues le 07/10/2026 :

La page de Google annonce déjà un réajustement du Flash à partir du 1er janvier 2027. Vérifiez la page de prix de chaque fournisseur avant de figer un budget ; un tableau d'article vieillit vite.

8. Les limites réelles

La première limite est le support. La documentation officielle est directe : Anthropic « doesn't endorse, maintain, or audit third-party gateway products, and doesn't support routing Claude Code to non-Claude models through any gateway ». Si ça casse, le problème est le vôtre et celui du projet du routeur.

Ensuite, ce qui change dans le comportement, d'après le guide de compatibilité et la page des variables d'environnement :

• L'effort et le thinking ne valent pas pour un autre éditeur. Les niveaux d'effort ne sont listés que pour les modèles Claude. Pour un ID qu'il ne reconnaît pas, Claude Code envoie quand même le raisonnement adaptatif et l'effort, et l'amont peut les rejeter. Quand l'effort est rejeté, le CLI relance la requête sans lui. En pratique, /effort devient de la décoration.
• Le cache de prompt dépend du routeur. Si cache_control n'arrive pas intact, il n'y a pas d'erreur : chaque tour est facturé comme une entrée sans cache. Surveillez la consommation dans le tableau de bord du fournisseur les premiers jours.
• Fenêtre de contexte présumée. Pour un ID inconnu, Claude Code suppose 200K tokens. Si le modèle a une autre fenêtre, indiquez-la avec CLAUDE_CODE_MAX_CONTEXT_TOKENS, sinon le compactage arrive au mauvais moment.
• Fonctions coupées. Avec ANTHROPIC_BASE_URL en dehors d'Anthropic, la recherche d'outils MCP est désactivée par défaut et Remote Control est désactivé depuis la v2.1.196. Avec beaucoup de serveurs MCP, tous les outils se chargent d'un coup et le contexte se remplit plus vite.
• Fonctions qui dépendent du modèle officiel. Le classificateur du mode de permission automatique, le fast mode (dont la vérification va directement à api.anthropic.com) et les longues chaînes d'usage d'outils ont été conçus pour Claude. Avec un autre modèle, ils peuvent échouer ou se comporter autrement. Utilisez la permission manuelle sur l'instance routée.
• Le suivi des instructions est inégal. Les hooks et les skills continuent de tourner, mais la décision d'appeler la bonne skill, de respecter CLAUDE.md et de s'arrêter au bon moment appartient au modèle. Commencez par des tâches petites et révisables.

Enfin, les conditions d'utilisation, déjà traitées dans la section 4. Un routeur avec une clé d'API payée à l'usage reste dans le contrat de chaque fournisseur. Un routeur avec une connexion d'abonnement grand public peut ne pas y rester.

Un prompt prêt à l'emploi pour votre agent

Collez le texte ci-dessous dans le Claude Code que vous utilisez déjà. Il installe 9router, crée le lanceur isolé de cet article sans toucher à votre installation principale, et s'arrête aux étapes qui sont les vôtres, comme ajouter la clé de chaque fournisseur dans le tableau de bord. Remplacez les champs entre < > ou répondez quand il demande.

Tu vas connecter d'autres modèles à Claude Code par un routeur local, en suivant ce déroulé dans l'ordre.
Mes données : mode d'installation <MODE> (npm ou docker) ; fournisseurs <FOURNISSEURS> (gemini, xai,
openai) ; ID copiés de la liste de modèles du tableau de bord : <ID_OPUS>, <ID_SONNET>, <ID_HAIKU>.

Règles :
- N'imprime jamais, ne lis jamais à voix haute, ne colle jamais dans le chat et n'écris jamais
  dans un script la clé de 9router ni celle d'un fournisseur. La clé du routeur vit seulement
  dans ~/.config/9router.key, lisible seulement par moi.
- Utilise des clés d'API payées à l'usage. Ne branche pas de connexion OAuth d'abonnement
  grand public sur le routeur.
- Ne touche pas à ~/.claude ni à la commande claude principale. Montre chaque commande avant
  de la lancer.

1. Prérequis : claude --version. Pour npm, node -v doit être 20 ou plus récent ; pour docker,
   vérifie docker --version.
2. Installation npm : npm install -g 9router puis 9router.
   Installation docker : docker run -d --name 9router -p 20128:20128
   -v "$HOME/.9router:/app/data" -e DATA_DIR=/app/data decolua/9router:latest
3. Réseau : sur un VPS, n'expose pas le port 20128 à internet ; laisse-le sur localhost et
   explique-moi comment ouvrir le tableau de bord par un tunnel SSH.
4. Tableau de bord : demande-moi d'ouvrir http://localhost:20128/dashboard, d'ajouter chaque
   fournisseur avec sa clé d'API et de générer la clé d'accès de 9router lui-même.
5. Clé du routeur : crée ~/.config/9router.key vide avec la permission 600 et demande-moi d'y
   coller la clé avec un éditeur. Vérifie seulement que le fichier n'est pas vide (test -s),
   sans lire le contenu.
6. Lanceur : crée ~/bin/claude-roteado, exécutable, avec ces lignes :
   #!/usr/bin/env bash
   export CLAUDE_CONFIG_DIR="$HOME/.claude-roteado"
   export ANTHROPIC_BASE_URL="http://localhost:20128"
   export ANTHROPIC_AUTH_TOKEN="$(cat "$HOME/.config/9router.key")"
   export ANTHROPIC_DEFAULT_OPUS_MODEL="<ID_OPUS>"
   export ANTHROPIC_DEFAULT_SONNET_MODEL="<ID_SONNET>"
   export ANTHROPIC_DEFAULT_HAIKU_MODEL="<ID_HAIKU>"
   exec claude "$@"
   Si la requête aboutit sur un chemin /v1 dupliqué, ajuste ANTHROPIC_BASE_URL.
7. Réglages : si un modèle a une fenêtre autre que 200K, ajoute CLAUDE_CODE_MAX_CONTEXT_TOKENS.
   Pour qu'un ID sans « claude » dans le nom apparaisse dans /model, utilise
   ANTHROPIC_CUSTOM_MODEL_OPTION et ANTHROPIC_CUSTOM_MODEL_OPTION_NAME.
8. Rappelle-moi : sur l'instance routée, permission manuelle ; l'effort, le fast mode et
   Remote Control n'y valent pas ; surveille la consommation dans le tableau de bord de
   chaque fournisseur les premiers jours.

Validation finale : demande-moi de lancer claude-roteado --model "<ID_SONNET>" et d'envoyer
une question courte. Confirme avec moi que la réponse est revenue, que la requête apparaît
dans le tableau de bord de 9router et que /model sonnet et /model haiku pointent vers les ID
que j'ai choisis. Ensuite lance ls ~/.claude-roteado pour prouver que la configuration est
séparée, et claude --version sur la commande principale.
Ne dis que c'est terminé que lorsque les trois points sont confirmés.

Questions fréquentes

Peut-on utiliser Claude Code avec Gemini ?

Oui, par un routeur qui traduit le format Anthropic Messages vers la Gemini API, comme 9router. Claude Code pointe vers le routeur par ANTHROPIC_BASE_URL, et le routeur appelle Gemini avec votre clé d'API. Anthropic ne prend pas en charge cette configuration.

Qu'est-ce qu'ANTHROPIC_BASE_URL ?

C'est la variable d'environnement qui change l'endpoint de l'API utilisé par Claude Code. La documentation officielle la décrit pour router des requêtes par un proxy ou un gateway. Sans un identifiant de gateway à côté, une connexion claude.ai enregistrée reste l'identifiant actif.

Faut-il payer les API Gemini, OpenAI et xAI ?

Oui, si vous suivez le chemin sûr. 9router est un logiciel libre et ne facture rien ; vous payez chaque fournisseur pour ce que vous consommez. Gemini a un niveau gratuit sur sa page de prix, mais pour du code de client le niveau payant est celui qu'il faut.

Puis-je utiliser mon abonnement ChatGPT ou Gemini dans le routeur ?

Le routeur l'accepte, mais le contrat du fournisseur peut ne pas l'accepter. Les conditions de Google Antigravity qualifient de violation l'accès par un logiciel tiers avec leur OAuth, avec un risque de suspension. OpenAI documente la connexion ChatGPT pour ses propres clients Codex. Utilisez une clé d'API.

L'effort et le thinking fonctionnent-ils encore avec un autre modèle ?

Pas comme avec Claude. La documentation ne liste les niveaux d'effort que pour les modèles Claude, et l'amont d'un autre éditeur peut rejeter ces champs. Claude Code réessaie sans effort quand il reçoit le rejet.

Cela casse-t-il mon installation principale de Claude Code ?

Non, si vous utilisez un lanceur avec son propre CLAUDE_CONFIG_DIR. Connexion, réglages, historique et plugins vivent dans un autre répertoire, et l'instance principale continue de parler directement à Anthropic.

Conclusion

Claude Code vaut par son harnais, et le harnais ne sait pas qui répond. Avec ANTHROPIC_BASE_URL, un routeur comme 9router et un lanceur isolé, Gemini, Codex et Grok entrent dans le même flux de skills, hooks et MCP. Le prix, c'est d'assumer la maintenance du routeur, de perdre l'effort, la certitude du cache et quelques fonctions, et de rester dans les conditions en utilisant des clés d'API. Si ce dont vous avez besoin, c'est un agent qui lit votre ERP, votre boutique ou votre banque, c'est de l'intégration sur mesure (MCP, webhooks, files d'attente) avec des agents d'IA et de l'automatisation dans le terminal. Décrivez le système et ce que vous voulez automatiser.

Parler du projet