Aller au contenu principal

Installation avec OpenRouter

Partie théorique​

Prérequis​

Avant d'installer Claude Code, vérifiez que vous disposez des éléments suivants :

remarque

Prérequis obligatoires :

  • Node.js >= 18 — vérifier avec node --version
  • npm — inclus avec Node.js, vérifier avec npm --version
  • Un terminal — bash (Linux) ou zsh (macOS)
  • Un compte OpenRouter — gratuit sur openrouter.ai

Installer Claude Code​

Claude Code s'installe comme un paquet npm global :

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

Pour vérifier que l'installation a réussi :

claude --version
info

Claude Code est installé de façon globale (option -g) et devient disponible comme commande claude depuis n'importe quel répertoire de votre système.

Configurer OpenRouter​

Pour utiliser OpenRouter comme fournisseur d'API, deux variables d'environnement sont nécessaires :

export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_API_KEY="sk-or-v1-VOTRE_CLE_ICI"
attention

Ne commitez jamais votre clé API dans git. Utilisez des variables d'environnement ou un fichier .env ajouté au .gitignore.

Pour rendre ces variables permanentes, ajoutez-les à votre fichier de configuration shell :

  • macOS / zsh : ~/.zshrc
  • Linux / bash : ~/.bashrc

Choisir un modèle gratuit​

Utilisez le flag --model pour spécifier le modèle à utiliser :

claude --model "qwen/qwen3-coder:free"

Vous pouvez aussi le définir de façon permanente dans ~/.claude/settings.json.

astuce

Commencez avec qwen/qwen3-coder:free pour les tâches de code — c'est un modèle 480B de pointe, disponible gratuitement avec une fenêtre de contexte de 262 000 tokens.

Modèles gratuits recommandés (avril 2026) :

  • qwen/qwen3-coder:free — meilleur pour le code (contexte 262K)
  • deepseek/deepseek-r1:free — excellent pour le raisonnement
  • mistralai/devstral-small:free — léger et rapide

Exemple pratique​

Voici la séquence complète d'installation et de test en une session terminal :

# 1. Verifier Node.js
$ node --version
v20.11.0

# 2. Installer Claude Code globalement
$ npm install -g @anthropic-ai/claude-code
added 142 packages in 12s

# 3. Verifier l'installation
$ claude --version
1.0.0

# 4. Configurer les variables d'environnement
$ export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
$ export ANTHROPIC_API_KEY="sk-or-v1-abc123..."

# 5. Rendre permanent (macOS/zsh)
$ echo 'export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"' >> ~/.zshrc
$ echo 'export ANTHROPIC_API_KEY="sk-or-v1-abc123..."' >> ~/.zshrc
$ source ~/.zshrc

# 6. Tester avec un modele gratuit
$ claude --model "qwen/qwen3-coder:free" "Dis bonjour en PHP"

> echo "<?php echo 'Bonjour !';" > bonjour.php
  Fichier cree : bonjour.php

  Contenu :
  <?php echo 'Bonjour !';

  Pour l'executer : php bonjour.php
remarque

La commande source ~/.zshrc recharge le fichier de configuration sans fermer le terminal. Les variables seront disponibles dans tous les futurs terminaux automatiquement.

Test de mémorisation/compréhension​


Quelle version minimum de Node.js est requise pour Claude Code ?


Quelle commande installe Claude Code globalement ?


Quelle variable d'environnement pointe vers l'API OpenRouter ?


Quel fichier faut-il modifier pour rendre les variables permanentes sous macOS/zsh ?


Quel modèle gratuit est recommandé pour les tâches de code ?


TP pour réfléchir et résoudre des problèmes​

Installer Claude Code avec OpenRouter​

Dans ce TP, vous allez réaliser l'installation complète de Claude Code et le configurer pour utiliser OpenRouter avec un modèle gratuit.

1. Vérifiez que Node.js >= 18 est installé​

astuce

Si la version affichée est inférieure à 18, téléchargez Node.js LTS sur https://nodejs.org.

2. Installez Claude Code globalement​

3. Vérifiez l'installation​

4. Créez un compte OpenRouter et générez une clé API​

Rendez-vous sur https://openrouter.ai :

  1. Cliquez "Sign Up" et créez votre compte (gratuit)
  2. Allez dans "Keys" > "Create Key"
  3. Donnez un nom à votre clé (ex: claude-code-cours)
  4. Copiez la clé générée (elle commence par sk-or-v1-)
attention

Conservez votre clé en lieu sûr. OpenRouter ne vous la montrera qu'une seule fois.

5. Exportez les variables d'environnement​

6. Rendez la configuration permanente dans ~/.zshrc​

7. Testez Claude Code avec un modèle gratuit​

Lancez une première commande pour valider toute la configuration :

claude --model "qwen/qwen3-coder:free" "Dis bonjour en PHP"

Si tout fonctionne, Claude Code devrait créer ou afficher du code PHP.

astuce

Si vous obtenez une erreur d'authentification, vérifiez que vos variables d'environnement sont bien définies avec echo $ANTHROPIC_API_KEY.

Une solution