Utiliser Claude Code avec OpenRouter

Si vous appréciez le flux de travail fluide de **Claude Code** (l'outil CLI d'Anthropic), alors vous savez probablement que par défaut, il s'attend au format d'API Anthropic. Mais que faire si vous souhaitez utiliser un modèle différent, ou explorer de nouveaux modèles qui ne sont pas disponibles via l'API directe d'Anthropic ? C'est là qu'intervient **OpenRouter** ! Il fournit un accès API unifié et compatible OpenAI à des **centaines de modèles** provenant de nombreux fournisseurs différents.

En reliant les deux systèmes, vous pouvez obtenir le meilleur des deux mondes : l'interface conviviale pour les développeurs de Claude Code et le vaste catalogue de modèles d'OpenRouter. Cette intégration est ce que nous appelons **"Claude Code avec Openrouter"**.

L'astuce consiste à utiliser un "routeur / proxy" qui traduit entre les deux formats d'API. Une fois configuré, vous pouvez exécuter Claude Code comme d'habitude, mais avec OpenRouter en arrière-plan.

Principaux avantages de l'utilisation de Claude Code avec Openrouter

La combinaison de Claude Code et d'Openrouter offre une série d'avantages puissants :

• **Accès à plus de 400 modèles** — y compris des variantes de Claude, des modèles de style GPT, des LLM open source, et plus encore.
• **Pas besoin d'abonnement Anthropic** — vous ne payez que ce que vous utilisez via la tarification à l'usage d'Openrouter.
• **Changement de modèle flexible** — changez de modèle en cours de session dans Claude Code avec ` /model`, ou routez en fonction du type de tâche (léger vs raisonnement, coût vs performance).
• **Optimisation des coûts** — modèles à faible coût ou gratuits pour les tâches de routine, modèles puissants uniquement lorsque nécessaire : idéal pour les développeurs soucieux de leur budget.
• **Routage local ou basé sur le cloud** — exécutez tout localement pour la confidentialité, ou hébergez votre routeur pour une utilisation partagée par l'équipe, le CI/CD ou l'automatisation cloud.
• **Outils & flexibilité** — certains routeurs prennent en charge des fonctionnalités avancées comme le streaming, le basculement de modèle, le multiplexage de plusieurs fournisseurs et l'intégration avec des flux de travail de développement plus larges.

Prérequis

Avant de commencer, assurez-vous d'avoir :

1. Claude Code installé globalement (par exemple via `npm install -g @anthropic-ai/claude-code`).

2. Un **compte Openrouter** avec une clé API valide (`sk-or-...`) (Créez un compte sur OpenRouter).

3. Un outil de routeur/proxy (Docker est le plus simple, mais les routeurs basés sur Node.js fonctionnent également) pour gérer la conversion de format

4. Une familiarité de base avec l'utilisation des variables d'environnement et de la ligne de commande

Avec cette configuration, vous pourrez diriger Claude Code vers le routeur — qui transmettra ensuite les requêtes à Openrouter et redirigera les réponses.

Méthode 1 : y-router (la plus simple et recommandée)

L'un des routeurs les plus utilisés pour cette configuration est **y-router**. Il agit comme un traducteur entre le format d'API attendu par Anthropic et l'API de style OpenAI d'Openrouter (voir le dépôt sur : GitHub). Voici comment procéder étape par étape avec y-router :

1.**Déployer y-router localement** (Docker recommandé) :

git clone https://github.com/luohy15/y-router.git
cd y-router
docker compose up -d

Ceci lance un service de routeur local écoutant (par défaut) sur `http://localhost:8787`.

2. **Configurez vos variables d'environnement** afin que Claude Code envoie ses requêtes à y-router, et non directement à Anthropic :

export ANTHROPIC_BASE_URL="http://localhost:8787"
export ANTHROPIC_AUTH_TOKEN="sk-or-<votre-clé-openrouter>"
export ANTHROPIC_MODEL="z-ai/glm-4.5-air"   # pour un modèle rapide et léger
# ou export ANTHROPIC_MODEL="z-ai/glm-4.5"   # pour un modèle plus puissant

3. **Exécutez Claude Code** :

claude

L'interface démarrera comme d'habitude. Si vous tapez `/model`, vous verrez le modèle alimenté par Openrouter sélectionné. Félicitations — vous utilisez maintenant Claude Code avec Openrouter. (ishan.rs)

Cette méthode maintient le routage local, simple et sous votre contrôle — idéal pour les développeurs qui aiment la confidentialité et un minimum de frais généraux.

Méthode 2 : Claude Code Router (basé sur npm, riche en fonctionnalités)

Si vous préférez ne pas utiliser Docker, il existe une autre option robuste : **Claude Code Router** — un outil de routage basé sur Node.js conçu pour donner à Claude Code l'accès à des fournisseurs externes (voir le dépôt sur GitHub). Voici comment le configurer :

1. **Installer globalement :**

npm install -g @musistudio/claude-code-router

Créez ensuite un fichier de configuration (par exemple `~/.claude-code-router/config.json`) avec vos paramètres et modèles préférés. De nombreux utilisateurs incluent Openrouter comme fournisseur, spécifiant leur clé API et listant les modèles pris en charge (plus de détails sur cette méthode sur lgallardo.com).

2. **Démarrer le routeur :**

ccr start

Une fois en cours d'exécution, définissez `ANTHROPIC_BASE_URL` sur l'URL du routeur et utilisez `claude` comme d'habitude. Le routeur traduira les requêtes et permettra une commutation dynamique entre les modèles — y compris le comportement de repli, les règles de routage, et plus encore.

Cette méthode est puissante si vous souhaitez plus de contrôle sur le routage des modèles, les politiques de repli ou l'intégration dans des chaînes d'outils plus grandes (comme le CI/CD, les scripts automatisés ou les expériences multi-modèles).

Méthode 3 : Proxy Openrouter direct (configuration minimale pour des tests rapides)

Si vous voulez juste une vérification rapide ou un test — sans exécuter un routeur complet — vous pouvez essayer de pointer Claude Code directement vers un proxy compatible Openrouter ou un adaptateur minimal. Certaines solutions communautaires existent pour faciliter cela (voir leur dépôt sur GitHub).

Par exemple, vous pouvez définir :

export ANTHROPIC_BASE_URL="https://proxy-votre-choix.com"
export ANTHROPIC_AUTH_TOKEN="sk-or-<votre-clé>"
export ANTHROPIC_MODEL="openrouter/nom-du-modèle"

Puis exécutez Claude Code. Cette approche est utile pour les tests éphémères ou les expériences rapides. Cependant, elle peut manquer de robustesse (par exemple pour le streaming, l'appel d'outils ou les sessions à long terme), selon l'implémentation du proxy.

Bonnes pratiques & Astuces pour une expérience fluide

1. **Vérifiez la compatibilité des modèles** — tous les modèles ne prennent pas en charge des fonctionnalités avancées comme les appels d'outils ou les fenêtres de contexte longues. Utilisez des modèles plus légers pour des tâches simples, des modèles plus performants pour des tâches lourdes comme le raisonnement ou le codage.
2. **Sécurisez votre clé API** — traitez votre clé API Openrouter comme un secret ; stockez-la en toute sécurité et ne l'exposez jamais côté client.
3. **Gérez les coûts** — surveillez l'utilisation des jetons lorsque vous utilisez de grands modèles ; envisagez la mise en cache des invites, les modèles de repli ou le routage basé sur les tâches pour optimiser l'équilibre coût/performance.
4. **Testez la configuration du routage** — après la configuration, testez toujours avec des commandes simples (par exemple `claude --model <modèle>`) pour vous assurer que tout est acheminé correctement.
5. **Utilisez le routage de repli pour la fiabilité** — dans les configurations multi-modèles, configurez des options de repli afin que si un modèle est indisponible, le routeur puisse basculer automatiquement vers un autre.

Questions fréquemment posées

Q1. Dois-je payer Anthropic pour utiliser Claude Code avec Openrouter ?
Non. Lorsqu'il est configuré avec Openrouter (via un routeur ou un proxy), Claude Code utilise votre clé API Openrouter pour les requêtes — vous n'avez pas besoin d'un abonnement Anthropic payant.

Q2. Puis-je changer de modèle à la volée dans la même session Claude Code ?
Oui. De nombreux routeurs (et Claude Code lui-même) vous permettent de changer de modèle en utilisant `/model <nom_du_modèle>`. Cela fonctionne en cours de conversation dans la plupart des cas.

Q3. Tous les modèles d'Openrouter sont-ils compatibles avec les fonctionnalités de Claude Code (comme l'exécution d'outils, le streaming) ?
Pas toujours. Certains modèles "texte uniquement" ou plus légers pourraient ne pas prendre en charge l'appel d'outils, le contexte long ou le streaming. Pour des flux de travail complexes, utilisez des modèles connus pour prendre en charge ces fonctionnalités.

Q4. Un routeur Docker local est-il plus sécurisé qu'un routeur hébergé ?
Généralement oui. L'exécution d'un routeur local vous donne un contrôle total et évite d'exposer votre clé API à des services externes. Les routeurs hébergés sont pratiques mais peuvent présenter des compromis en termes de sécurité ou de fiabilité.

Q5. Puis-je intégrer cette configuration dans le CI/CD ou les flux de travail automatisés ?
Absolument. Des outils comme Claude Code Router prennent en charge les fichiers de configuration et les variables d'environnement, ce qui les rend faciles à intégrer dans les pipelines d'automatisation (GitHub Actions, scripts, etc.).

Conclusion

L'utilisation de **Claude Code avec Openrouter** est un moyen élégant et puissant de vous libérer des verrous d'un fournisseur unique tout en conservant une interface de développement familière et rationalisée. Que vous choisissiez d'exécuter un routeur local via Docker, d'utiliser un routeur basé sur Node.js ou de tester via un proxy minimal — vous ouvrez la porte à un catalogue massif de modèles, des options de coût flexibles et des flux de travail adaptés.

Pour les développeurs, les projets personnels ou les équipes cherchant à optimiser le codage assisté par l'IA sans frais généraux élevés, cette configuration offre un équilibre convaincant entre contrôle, flexibilité et évolutivité. Avec seulement quelques étapes de configuration, vous pouvez étendre considérablement ce que votre assistant IA peut faire — puis basculer ou adapter selon l'évolution de vos besoins.

Essayez-le : votre prochaine session de code pourrait bientôt être alimentée par un modèle que vous n'auriez jamais cru possible — le tout sous l'interface familière de Claude Code.