Source: https://aiprimetech.io/fr/blog/claude-code-router/ Sept. 17, 2026 · 8 min · Open source # Claude Code Router : utiliser Claude Code avec d’autres modèles (et quand une passerelle est plus simple) A Par [AI Prime Tech](https://aiprimetech.io/fr/) · Avec l’aide de l’IA Claude Code Router vous permet de connecter Claude Code à d’autres modèles via une passerelle locale qui gère la sélection des fournisseurs, l’adaptation des protocoles et le routage. Ce guide couvre l’installation, les profils d’agents, les solutions de repli et l’intégration OpenCode Go disponible dans la version v3.1.1 au 17 septembre 2026. Vous découvrirez également dans quels cas une passerelle hébergée nécessite moins d’étapes de configuration locale. ## Ce que fait Claude Code Router Claude Code Router de musistudio, souvent abrégé en CCR, se présente comme une « passerelle locale de modèles et un plan de contrôle pour les agents de programmation ». Il fournit un point de terminaison local stable pour Claude Code et d’autres clients, avec des identifiants de fournisseurs, des règles de routage, des nouvelles tentatives, des solutions de repli ordonnées et des journaux de requêtes. Le [v3.1.1 README](https://raw.githubusercontent.com/musistudio/claude-code-router/v3.1.1/README.md) indique la prise en charge des formats OpenAI Chat et Responses, Anthropic Messages, ainsi que Gemini Generate Content et Interactions. L’adaptation des protocoles permet d’utiliser Claude Code avec d’autres modèles via CCR. CCR est distribué sous licence MIT, avec un copyright musistudio de 2025, et fourni « EN L’ÉTAT ». L’autorisation d’utiliser le logiciel ne rend pas l’inférence auprès des fournisseurs en amont gratuite. Les frais et quotas des fournisseurs restent distincts ; les tarifs historiques des fournisseurs et les montants en dollars inclus dans OpenCode Go n’ont pas été vérifiés à la date de cette publication. ### La version 3.1 de Claude Code Router concernée La version 3.1.1 est sortie le 16 septembre 2026. Elle ajoute une prise en charge native de l’importation locale d’OpenCode Go, expose chaque tentative échouée de la passerelle et corrige la tarification de l’utilisation des modèles acheminés. Cette version accepte également --daemon sur start et serve, corrige le worker chargé du corps des journaux dans l’interface Docker et fournit des versions macOS pour Apple Silicon et Intel, un programme d’installation Windows et une AppImage Linux. La configuration ci-dessous utilise la distribution npm et la documentation figée sur la version v3.1.1. ## Installer CCR et connecter Claude Code La distribution npm nécessite Node.js 22 ou une version ultérieure. Le [guide CLI figé sur cette version](https://raw.githubusercontent.com/musistudio/claude-code-router/v3.1.1/docs/src/content/docs/en/guides/cli.md) documente les commandes suivantes : ``` npm install -g @musistudio/claude-code-router ccr --help ccr ui ``` Pour démarrer sans ouvrir de navigateur : ``` ccr ui --no-open ``` L’interface de gestion et la passerelle de modèles ont des adresses par défaut distinctes : | Composant | Adresse par défaut | Rôle | Interface de gestion | http://127.0.0.1:3458 | Configurer les fournisseurs, les profils et le routage | Passerelle de modèles | http://127.0.0.1:3456 | Recevoir les requêtes de modèles provenant des clients Bien distinguer ces rôles aide à déterminer où une connexion a échoué. Le bon fonctionnement de la page de gestion ne suffit pas à établir que la passerelle de modèles a accepté sa configuration. ### Ajouter un fournisseur et une clé client Ouvrez Fournisseurs → Ajouter un fournisseur, choisissez un préréglage ou Autre / point de terminaison API personnalisé, puis saisissez le point de terminaison et la clé API. CCR détecte les protocoles et les modèles ; Paramètres avancés vous permet de sélectionner un protocole manuellement. Utilisez Vérifier la connexion pour tester le fournisseur. Cette action envoie une requête réelle et peut donc consommer des tokens ou une partie du quota de requêtes du fournisseur. Créez une clé client CCR sur Clés API pour les requêtes de modèles. Cette clé est distincte du jeton de l’interface de gestion/RPC : traitez l’accès client et l’accès de gestion comme des éléments de configuration distincts. ### Créer un profil Claude Code Dans Configuration des agents, créez un profil activé pour Claude Code, sélectionnez un modèle tel que Provider/model, puis enregistrez-le. Pour un profil nommé « Claude Code - Work », lancez-le avec : ``` ccr "Claude Code - Work" ``` Les commandes de lancement générées par l’application de bureau utilisent ccr-app. Le [guide des profils Claude Code](https://raw.githubusercontent.com/musistudio/claude-code-router/v3.1.1/docs/src/content/docs/en/configuration/agents/claude-code.md) distingue deux portées : - Uniquement lors d’un lancement depuis CCR applique la configuration aux lancements depuis CCR. - Par défaut pour le système affecte également les lancements directs de Claude Code. Les profils prennent en charge les substitutions pour Fable, Opus, Sonnet et Haiku. Vérifiez la sélection active avec /model, puis consultez les Journaux de requêtes de CCR pour voir les requêtes qui transitent par la passerelle. Gardez le [guide des modèles de Claude Code](/fr/claude-code/models/) à portée de main lorsque vous planifiez ces sélections. ## Configurer le routage, les nouvelles tentatives et les solutions de repli Les règles de routage de CCR peuvent examiner request.header et request.body, et peuvent réécrire request.body.model. Vous pouvez ainsi contrôler la sélection du modèle en fonction de la requête entrante, au-delà du modèle choisi dans un profil d’agent. La configuration des solutions de repli utilise mode, models, ainsi que retryCount. Les trois modes sont off, retry, ainsi que model-chain. | Comportement | Réponses concernées | Effet opérationnel | Nouvelle tentative | 408, 409, 429 et 5xx | Relance les requêtes après des échecs admissibles | Cibles de repli | Toute réponse 4xx ou 5xx | Peut transférer une requête vers un autre modèle configuré | Gestion du délai | Positif Retry-After, lorsqu’il est présent | Utilise le délai fourni avant une nouvelle tentative | Temporisation par défaut | Lorsqu’aucune valeur positive de Retry-After ne s’applique | Commence à une seconde, avec un plafond de 30 secondes par tentative La distinction entre l’admissibilité à une nouvelle tentative et l’admissibilité à un repli est importante. Une réponse qui ne permet pas de nouvelle tentative peut tout de même permettre le recours à une cible de repli. ### Vérifier quel modèle a réellement traité la requête Une chaîne de modèles peut modifier le modèle qui traite finalement une requête. Les journaux de CCR indiquent le fournisseur et le modèle finaux ; utilisez-les donc pour analyser un comportement ou une utilisation inattendus. Commencez par un profil dont vous pouvez identifier le fournisseur et le modèle. Ajoutez des règles de routage et des cibles de repli de manière réfléchie, puis vérifiez la destination finale après les avoir testées. Il sera ainsi plus facile de relier un changement de réponse ou de coûts à la configuration du routage. La version 3.1.1 expose également chaque tentative échouée de la passerelle. Ces enregistrements aident à distinguer une réponse finale réussie des tentatives qui l’ont précédée. ## Utiliser l’importation OpenCode Go dans la version v3.1.1 La version v3.1.1 de Claude Code Router de musistudio ajoute une prise en charge native de l’importation locale d’OpenCode Go. L’intégration distingue Zen, identifié par opencode, de Go, identifié par opencode-go, y compris leurs identifiants d’accès et les identifiants de modèles qu’ils ont en commun. L’outil d’importation lit la configuration OpenCode, auth.json, ainsi que les métadonnées des modèles mises en cache. OPENCODE_API_KEY s’applique aux deux services ; OPENCODE_GO_API_KEY fournit une valeur de remplacement propre à Go. La découverte filtre les modèles par protocole et rapproche les métadonnées en cache des résultats en direct de /models . ### Pourquoi l’en-tête de session est important Le [La PR d’intégration d’OpenCode Go](https://github.com/musistudio/claude-code-router/pull/1786) indique que les requêtes adressées à https://opencode.ai/zen/go/v1 nécessitent x-opencode-session. Sans cet en-tête, le point de terminaison renvoie 400 MissingSessionID. CCR sélectionne la valeur de session dans cet ordre : configuration explicite, en-tête client explicite, en-têtes de session Claude, metadata.user_id, puis, en dernier recours, une valeur stable propre au processus. L’injection de l’en-tête est limitée au point de terminaison officiel de Go. Cela explique pourquoi saisir uniquement un point de terminaison et un identifiant d’authentification peut ne pas suffire pour Go. L’exigence de session fait partie de l’intégration du fournisseur. ### Actualiser la découverte et consulter les limites d’utilisation Si l’importation Go n’est pas disponible, connectez OpenCode Go dans OpenCode, actualisez son cache local de modèles et relancez l’analyse dans CCR. CCR récupère les données d’utilisation depuis GET https://opencode.ai/zen/go/v1/usage et affiche les pourcentages restants pour les périodes de cinq heures, hebdomadaires et mensuelles. La documentation épinglée ne précise pas les quotas en dollars. Interprétez ces valeurs comme les pourcentages restants pour les périodes indiquées ; elles ne permettent pas de déterminer un solde monétaire. ## Diagnostiquer la connexion par étapes La documentation de dépannage de CCR couvre le contournement du routage, les échecs d’authentification, les modèles manquants, la sélection inattendue de modèles, les hausses soudaines de coûts, les délais d’attente dépassés et les traces d’agents manquantes. Une démarche de diagnostic utile consiste à suivre la requête depuis la configuration de lancement jusqu’au fournisseur final. ### Claude Code contourne CCR Vérifiez que le profil Agent Config souhaité est activé et que vous avez effectué le lancement via ce profil. Un profil défini sur Uniquement lors d’un lancement depuis CCR limite sa configuration aux lancements via CCR ; les lancements directs sont concernés lorsque Par défaut pour le système est sélectionné. Utilisez /model et les journaux Request de CCR ensemble pour vérifier la configuration. Le [référence de la CLI de Claude Code](/fr/claude-code/cli/) fournit une référence plus complète pour travailler avec le client. ### Erreurs d’authentification ou modèles manquants Pour les erreurs 401/403, vérifiez les identifiants d’authentification à chaque niveau concerné : la clé API du fournisseur, la clé client CCR pour les requêtes de modèles et le jeton de gestion distinct. Ces identifiants remplissent des rôles différents. Pour model not found, vérifiez les modèles détectés, le protocole sélectionné et le fournisseur/modèle choisi dans le profil. Avec OpenCode Go, actualisez le cache local et relancez l’analyse si l’importation n’est pas disponible. ### Échecs de démarrage et dépassements du délai d’attente La version 3.1.1 fait passer le délai d’acceptation de la configuration de la passerelle de cinq secondes à 30 secondes. Cela résout les cas où l’interface de gestion démarre, mais où la passerelle échoue lorsque la machine hôte est sous charge, notamment sous Windows. CCR_GATEWAY_CONFIG_TIMEOUT_MS remplace le délai d’attente. Les valeurs invalides ou inférieures à 1,000 millisecondes entraînent l’utilisation de la valeur par défaut. La configuration se trouve dans ~/.claude-code-router sous macOS/Linux et dans %APPDATA%\claude-code-router sous Windows. Les fichiers pertinents comprennent config.sqlite, le fichier généré gateway.config.json, ainsi que service.json. Les commandes de service comprennent ccr start, ccr stop, ainsi que l’exécution au premier plan avec ccr serve. ## Quand une passerelle hébergée est plus simple CCR convient aux workflows qui nécessitent une gestion locale des fournisseurs, un routage fondé sur les requêtes, des pools d’identifiants d’authentification ou des chaînes de repli explicites. Une passerelle hébergée peut réduire les étapes de configuration locale lorsque votre objectif immédiat est de connecter Claude Code à un service en amont. L’annonce d’OpenRouter du [4 août 2026](https://openrouter.ai/blog/announcements/ori-harness/) documente ces paramètres de connexion : ``` ANTHROPIC_BASE_URL=https://openrouter.ai/api ANTHROPIC_AUTH_TOKEN= ANTHROPIC_API_KEY= ``` L’annonce précise également des paramètres supplémentaires pour les modèles et les fonctionnalités. Ces trois variables sont les paramètres de connexion, et non une configuration complète pour chaque modèle. OpenRouter avertit que la plupart des modèles ouverts ne prennent pas en charge la recherche d’outils ; les paramètres varient donc selon le modèle. Son CLI Ori automatise la configuration via : ``` ori login ori claude ``` Ces mêmes workflows peuvent également passer par une passerelle API telle qu’AI Prime Tech, un service indépendant sans affiliation avec Anthropic ou OpenAI ; consultez le guide consacré à [utiliser Claude Code avec une clé API](/fr/learn/claude-code-api-key-setup/). Choisissez en fonction des contrôles dont vous avez besoin. CCR fournit un point de gestion local pour administrer les routes, examiner les tentatives et configurer les replis ; l’approche hébergée documentée évite d’avoir à exploiter CCR localement. ## Points clés - Claude Code Router connecte Claude Code et d’autres clients aux fournisseurs via un point de terminaison local stable, avec adaptation des protocoles. - La distribution npm nécessite Node.js 22 ou une version ultérieure, et l’interface de gestion et la passerelle de modèles utilisent des ports par défaut distincts. - La portée d’Agent Config détermine si un profil s’applique uniquement aux lancements via CCR ou également aux lancements directs. - Les replis peuvent changer le modèle qui traite la requête ; consultez les journaux Request pour connaître le fournisseur et le modèle finaux. - La version v3.1.1 ajoute l’importation d’OpenCode Go avec des identifiants d’authentification distincts et la gestion de l’en-tête de session requis. - Une passerelle hébergée peut réduire la configuration locale lorsque vous n’avez pas besoin des contrôles de routage locaux de CCR. ## FAQ ### Claude Code Router est-il gratuit ? Claude Code Router est distribué sous licence MIT, qui autorise l’utilisation du logiciel. Cela ne garantit pas la gratuité de l’inférence en amont, et les anciens tarifs des fournisseurs ou les quotas en dollars d’OpenCode Go ne sont pas vérifiés ici. ### Puis-je utiliser Claude Code avec d’autres modèles via CCR ? Oui. CCR assure l’adaptation des protocoles et la sélection du fournisseur/modèle, et ses profils Claude Code vous permettent de sélectionner un modèle tel que Provider/model. Les formats en amont pris en charge comprennent OpenAI Chat/Responses, Anthropic Messages et Gemini Generate Content/Interactions. ### Qu’est-ce qui a changé dans Claude Code Router 3.1.1 ? Publiée le 16 septembre 2026, la version v3.1.1 ajoute une prise en charge native de l’importation locale d’OpenCode Go, la visibilité sur chaque tentative échouée et une tarification d’utilisation corrigée pour les modèles routés. Elle porte également le délai d’acceptation de la configuration de la passerelle à 30 secondes et accepte --daemon sur start et serve. ### Pourquoi OpenCode Go renvoie-t-il MissingSessionID ? Le point de terminaison officiel d’OpenCode Go exige l’en-tête x-opencode-session et renvoie 400 MissingSessionID lorsqu’il est absent. L’intégration Go de CCR sélectionne une valeur de session selon un ordre de priorité défini et injecte l’en-tête uniquement pour le point de terminaison officiel de Go. [Claude](/fr/blog/tag/claude/)[Développement](/fr/blog/tag/coding/)[Open source](/fr/blog/tag/open-source/) 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.