Configurer Claude Code gratuitement avec OpenRouter

Q: 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é :** Vous voulez changer de modèle ? Changez juste la ligne `ANTHROPIC_MODEL` dans votre fichier JSON. --- Voilà, vous avez maintenant un assistant de code surpuissant et gratuit. C'est ça, la magie du web ouvert ! n'hésite pas à faire un tour sur mon blog pour d'autres astuces.

Hello ! Aujourd'hui, on va s'attaquer à un sujet qui touche directement le portefeuille : le coût des IA pour coder. On adore tous Claude Code (la CLI d'Anthropic) pour booster nos projets, mais l'idée d'un abonnement mensuel ou de raquer à chaque requête API peut vite refroidir l'enthousiasme.

J'ai la solution pour vous. Dans ce guide, on va voir comment configurer Claude Code pour qu'il tourne de manière totalement gratuite en utilisant OpenRouter. Pas d'alias compliqués à taper à chaque fois : on va passer par une configuration globale propre et efficace.

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.).

L'avantage ? OpenRouter propose une tonne de modèles "Free" (gratuits). En configurant correctement votre fichier de paramètres global, Claude Code croira parler à Anthropic, mais utilisera en réalité la puissance gratuite d'OpenRouter. C'est légal, c'est efficace, et ça permet de garder une "vibe code" au top sans dépenser un centime.

Étape 1 : Installer Claude Code

Si vous ne l'avez pas encore fait, installez l'outil globalement via NPM. Ouvrez votre terminal préféré et lancez :

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

Étape 2 : Trouver votre modèle gratuit sur OpenRouter

Avant de configurer, il nous faut une cible.

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

Étape 3 : Générer votre clé API OpenRouter

Il vous faut un badge d'accès pour passer la porte :

Connectez-vous à votre compte OpenRouter.
Allez dans API Keys et créez une nouvelle clé (nommez-la "Claude Free" pour vous y retrouver).
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 bidouiller des variables d'environnement à chaque lancement, on va modifier directement le fichier de configuration de Claude Code. C'est plus propre et ça devient votre réglage par défaut.

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

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

{
  "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, dès que vous tapez claude dans votre terminal, l'outil utilisera automatiquement OpenRouter et le modèle gratuit que vous avez 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é, vous aurez une réponse rapide sans que votre compte Anthropic ne soit débité.

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é : Vous voulez changer de modèle ? Changez juste la ligne ANTHROPIC_MODEL dans votre fichier JSON.

Voilà, vous avez maintenant un assistant de code surpuissant et gratuit. C'est ça, la magie du web ouvert ! n'hésite pas à faire un tour sur mon blog pour d'autres astuces.