Tester Claude Code avec OpenRouter : configuration et limites

Le prix d'un assistant de code compte vite quand tu l'utilises tous les jours. Claude Code, la CLI d'Anthropic, est agréable à utiliser, mais un abonnement ou une facturation à chaque requête ne convient pas à tous les projets.

Dans ce guide, je configure Claude Code avec OpenRouter pour tester plusieurs modèles. Certains peuvent être gratuits ou peu coûteux selon la période, les quotas et les conditions du fournisseur : ce n'est pas une promesse de gratuité permanente. Vérifie aussi le traitement des données avant d'envoyer un dépôt privé. La configuration reste globale, sans alias à recopier à chaque commande.

Le concept : OpenRouter comme passerelle

Par défaut, Claude Code cherche à discuter avec les serveurs d'Anthropic. L'astuce consiste à détourner cet appel vers OpenRouter, une plateforme qui centralise des dizaines de modèles (Mistral, Llama, Gemini, etc.).

OpenRouter propose plusieurs modèles marqués "Free". En configurant correctement ton fichier de paramètres global, Claude Code enverra les requêtes à OpenRouter. Les quotas et les conditions changent : vérifie-les avant de considérer cette solution comme gratuite.

Étape 1 : Installer Claude Code

Si tu ne l'as pas encore fait, installe l'outil globalement via NPM, puis ouvre ton terminal :

Copier
npm install -g @anthropic-ai/claude-code

Étape 2 : trouver ton modèle gratuit sur OpenRouter

Avant de configurer, il nous faut une cible.

1. Direction la page des modèles : openrouter.ai/models.
2. Dans la barre de recherche, tapez simplement "free".
3. Tu verras apparaître une liste de modèles gratuits (comme google/gemini-2.0-flash-exp:free ou stepfun/step-3.5-flash:free).
4. Notez bien l'identifiant du modèle (ex: stepfun/step-3.5-flash:free).

Étape 3 : générer ta clé API OpenRouter

Il te faut une clé d'accès :

1. Connecte-toi à ton compte OpenRouter.
2. Ouvre API Keys et crée une clé (nomme-la "Claude Free" pour la retrouver).
3. Copiez-la immédiatement, car elle ne s'affichera qu'une seule fois.

Étape 4 : La configuration globale (Le "Secret Sauce")

Plutôt que de modifier des variables à chaque lancement, on va écrire le réglage dans le fichier de configuration de Claude Code. Il deviendra ton réglage par défaut.

Le fichier se trouve généralement ici : ~/.claude/settings.json (sous Linux/macOS) ou dans ton répertoire utilisateur sous Windows.

Ouvrez ce fichier (ou créez-le s'il n'existe pas) et collez-y la structure suivante :

Copier
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "votre_cle_openrouter_ici",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_MODEL": "stepfun/step-3.5-flash:free"
  }
}

Note importante : Laissez une valeur vide dans ANTHROPIC_API_KEY. Claude Code vérifie parfois la présence d'une clé au format Anthropic avant de lancer la requête, même si OpenRouter utilise le jeton dans ANTHROPIC_AUTH_TOKEN.

Étape 5 : Testez et validez

Désormais, quand tu tapes claude, l'outil utilisera OpenRouter et le modèle que tu as choisi.

• Allez dans un dossier de projet.
• Lancez la commande : claude
• Posez une question : "Peux-tu m'expliquer ce fichier ?"

Si tout est bien configuré, tu recevras une réponse sans que ton compte Anthropic soit utilisé.

Pourquoi utiliser cette méthode ?

• Zéro coût : Idéal pour l'apprentissage ou les petits projets.
• Transparence : Claude Code conserve toutes ses fonctionnalités (lecture de fichiers, exécution de commandes) et ça marche plutôt bien j'ai été impressionné.
• Flexibilité : tu veux changer de modèle ? Modifie la ligne ANTHROPIC_MODEL dans ton fichier JSON.

Tu as maintenant une configuration utilisable sans abonnement Claude Code. Surveille les quotas OpenRouter et évite d'envoyer des secrets ou un dépôt privé à un modèle que tu ne connais pas.

Article co-écrit avec l'IA · Images générées avec l'IA.