Tutoriel Claude Code Router : connecter Claude Code à DeepSeek, Gemini ou n'importe quel modèle
Le routeur open source conserve l'expérience Claude Code que vous aimez, mais envoie chaque requête vers des modèles moins chers — DeepSeek, Kimi, Gemini ou un modèle Ollama local. Installation en une commande npm, configuration des fournisseurs dans la console ccr ui, routage par scénario, puis une vraie tâche pour vérifier. 15 étapes avec captures d'écran.
En bref : ce que fait Claude Code Router
- Claude Code Router (CCR) est un proxy libre et open source : Claude Code garde son interface, son prompt système et ses outils, mais les appels aux modèles vont vers votre configuration — DeepSeek, Kimi K2, Gemini, OpenRouter ou un modèle Ollama local.
- L'installation tient en une commande npm (npm install -g @musistudio/claude-code-router) et la console web ccr ui modifie ~/.claude-code-router/config.json pour vous — sans éditer le JSON à la main.
- Le routage se fait par scénario : default, background, think (raisonnement du Plan Mode), longContext (s'active automatiquement au-delà d'un seuil de 60 000 jetons) et webSearch reçoivent chacun leur propre modèle.
- ccr code démarre une session routée avec l'URL de base pointant vers http://127.0.0.1:3456 ; la commande claude fonctionne toujours telle quelle. Particularité connue : /cost reste à 0 $ — suivez vos dépenses dans le tableau de bord du fournisseur.
Claude Code Router: Use Gemini 2.5 Pro FREE API in Claude Code
Vidéo source:AI With Nathan10:52
claude-code-router — official README
Faits produit:musistudio on GitHubDocs
Les étapes et captures suivent la vidéo ; les noms de champs de config.json, les rôles du routeur et le comportement des transformers ont été recoupés avec le README officiel.
Les images sont des captures du vidéo source dûment créditées, chacune liée à son horodatage. Le texte de ce guide est original — ce n'est pas une transcription.
Configurer Claude Code Router, étape par étape
1 · Orienter Claude Code vers des modèles moins chers
- 1
Comprendre pourquoi Claude Code a besoin d'un routeur
Claude Code est lié aux modèles Claude, et ils sont chers : Opus 4.1 est officiellement à 15 $ par million de jetons d'entrée et 75 $ par million de sortie. Le projet open source Claude Code Router (CCR) préserve l'expérience Claude Code mais aiguille chaque requête vers le modèle de votre choix — DeepSeek, Kimi, Gemini ou un modèle Ollama local.
Les tarifs officiels d'Anthropic avant le changement — voilà la facture que CCR évite.Voir à 0:30 - 2
Installer Claude Code, puis le routeur
CCR suppose que Claude Code est déjà installé : npm install -g @anthropic-ai/claude-code. Installez ensuite le routeur : npm install -g @musistudio/claude-code-router. Votre configuration des fournisseurs vivra dans ~/.claude-code-router/config.json.
Les deux installations npm du README officiel — le routeur ne remplace jamais Claude Code.Voir à 3:36 - 3
Laisser npm terminer l'installation globale
npm récupère les dépendances du routeur (un avertissement de dépréciation node-domexception est normal). Une fois terminé, la commande ccr est disponible partout.
npm téléchargeant les paquets pendant l'installation globale de @musistudio/claude-code-router.Voir à 3:49
2 · Ajouter des fournisseurs dans la console ccr ui
- 4
Ouvrir la console de configuration avec ccr ui
Plutôt que d'éditer le JSON à la main, lancez ccr ui. Un onglet du navigateur s'ouvre sur 127.0.0.1:3456 : les fournisseurs se gèrent à gauche, la section Router à droite attribue des modèles aux scénarios, et les Custom Transformers se trouvent en dessous.
Premier lancement de la console ccr ui — fournisseurs vides, emplacements du routeur en attente.Voir à 4:08 - 5
Ajouter un fournisseur depuis un modèle préétabli
Cliquez sur Add Provider et choisissez un template — la vidéo utilise OpenRouter ; des préréglages existent aussi pour deepseek, gemini, dashscope, modelscope, siliconflow et volcengine. Le template pré-remplit l'URL d'API et une liste de modèles par défaut, et vous pouvez laisser le transformer vide.
Templates de fournisseurs dans ccr ui — choisissez-en un, l'URL et les modèles se remplissent automatiquement.Voir à 4:30 - 6
Coller la clé API et choisir vos modèles
Trois champs comptent vraiment : l'URL d'API (déjà pré-remplie), la clé secrète et la liste des modèles. La vidéo ajoute DeepSeek R1 et Kimi K2 sous OpenRouter, puis enregistre — le fournisseur apparaît dans le panneau de gauche, prêt à être attribué.
Le formulaire Edit Provider : URL, clé, modèles — tout le reste peut rester par défaut.Voir à 4:53 - 7
Laisser les transformers gérer les différences d'API
Les transformers réécrivent les requêtes et réponses pour que les API tierces restent compatibles avec Claude Code. CCR fournit des valeurs par défaut judicieuses — par exemple un transformer deepseek pour api.deepseek.com et un transformer tooluse pour deepseek-chat — vous écrivrez rarement le vôtre.
Exemples de transformers globaux et spécifiques au modèle tirés du README, dont le préréglage DeepSeek.Voir à 3:54 - 8
Ajouter une clé Gemini gratuite pour le raisonnement
Ajoutez un second fournisseur via le template Gemini et créez une clé API gratuite dans Google AI Studio (Get API key → Create API key). Collez-la, enregistrez — vous attribuerez bientôt ce fournisseur aux emplacements de raisonnement, de contexte long et de recherche web.
Création de la clé API Gemini gratuite dans Google AI Studio pour le fournisseur CCR.Voir à 5:45
3 · Définir les règles de routage
- 9
Comprendre les cinq rôles du routeur
default gère les tâches générales (et tout ce que vous n'attribuez pas). background exécute les tâches de fond — un petit modèle ou local économise ici. think prend en charge le raisonnement lourd comme le Plan Mode. longContext s'active automatiquement au-delà de longContextThreshold (60 000 jetons par défaut), et webSearch exige un modèle qui prend en charge la fonction — sur OpenRouter, ajoutez :online au nom du modèle. /model change de modèle en pleine session.
L'objet Router du README : chaque rôle, le seuil de 60K et le suffixe :online.Voir à 1:06 - 10
Attribuer un modèle à chaque scénario
Dans la section Router, choisissez parmi les modèles de vos fournisseurs enregistrés : la vidéo met DeepSeek R1 en default, Kimi K2 pour l'usage général, Gemini 2.5 Pro (fenêtre de 1M de jetons) pour longContext et le rapide Gemini Flash pour webSearch. Cliquez sur Save and Restart en haut à droite.
Remplissage de l'emplacement Default avec deepseek/deepseek-r1-0528 du fournisseur enregistré.Voir à 5:15 - 11
Démarrer la session routée avec ccr code
De retour dans le terminal, lancez ccr code. L'écran d'accueil de Claude Code liste Overrides (via env) — API Base URL http://127.0.0.1:3456 — preuve que les requêtes passent désormais par le routeur. La simple commande claude démarre toujours une session non routée, sans rien désinstaller.
Le bloc Overrides sur l'écran d'accueil : votre trafic passe par le proxy local de CCR.Voir à 6:45
4 · Lancer une vraie tâche et vérifier
- 12
Lui donner une vraie tâche de code
Invite comme d'habitude — la vidéo demande un jeu de casse-briques néon avec des animations modernes. Claude Code planifie une liste de tâches et l'exécute pas à pas via les modèles routés. Attendez-vous à des quirks cosmétiques : le compteur de jetons d'entrée peut rester à zéro.
Claude Code parcourant sa liste de tâches pendant que CCR aiguille les appels aux modèles.Voir à 7:06 - 13
Examiner le résultat final
L'agent conclut avec un résumé des fonctionnalités — effets visuels, design responsive, contrôles, mécaniques de jeu — et les fichiers atterrissent dans votre projet (index.html, style.css, script.js). Ouvrez le HTML dans un navigateur pour tester vous-même.
Résumé final de Claude Code pour le jeu de casse-briques néon.Voir à 7:30 - 14
Vérifier l'usage réel dans le tableau de bord du fournisseur
La page Your Activity d'OpenRouter est la source de vérité : elle montre les appels routés — requêtes répétées de Kimi K2 et l'appel DeepSeek — avec les compteurs de jetons et les dépenses. C'est ainsi que vous confirmez que CCR utilise vraiment vos modèles moins chers.
Utilisation d'OpenRouter après la session : les modèles routés apparaissent avec de vrais compteurs de requêtes.Voir à 7:45 - 15
Connaître les limites avant de vous y fier
Lancez /cost dans une session routée : il affiche 0,0000 $ et l'usage par modèle montre claude-sonnet à zéro — la comptabilité des coûts n'est pas encore branchée sur les fournisseurs externes. Le routage fonctionne bien ; suivez simplement vos dépenses dans le tableau de bord du fournisseur pour l'instant.
Le défaut connu de /cost dans les sessions routées — les tableaux de bord des fournisseurs sont votre vrai compteur.Voir à 9:25