1 - TP Configuration et Premier Pas

Mise en route de l’environnement

⏱ 45 min

Outil principal : Codex CLI. Les variantes OpenCode et Claude Code sont notées où elles diffèrent.

Prérequis

  • Docker & docker-compose
  • Git configuré
  • Un éditeur de code (VSCode recommandé)
  • La clé OpenRouter fournie par le formateur

Étape 1 : Configurer votre clé OpenRouter

Vous avez reçu une clé OpenRouter (sk-or-v1-...). Exportez-la :

export OPENROUTER_API_KEY="sk-or-v1-..."
# Ajouter à ~/.bashrc ou ~/.zshrc pour la rendre persistante

Pourquoi OpenRouter ?

  • Accès à 200+ modèles via une seule clé
  • Frugal (Gemini Flash ~$0.10/1M) comme premium (Claude Sonnet ~$3/1M)
  • Pas de vendor lock-in

Étape 2 : Installation

  • Codex CLI :
npm install -g @openai/codex
codex --version

Étape 3 : Configuration

Codex CLI se configure via variables d’environnement :

export OPENAI_API_KEY="${OPENROUTER_API_KEY}"
export OPENAI_BASE_URL="https://openrouter.ai/api/v1"
export OPENAI_MODEL=""

OpenCode : fichier ~/.config/opencode/config.yaml

providers:
  openrouter:
    api_key: ${OPENROUTER_API_KEY}
    base_url: https://openrouter.ai/api/v1
default_provider: openrouter
default_model: google/gemini-2.0-flash

Claude Code : via ~/.claude/settings.json ou ANTHROPIC_API_KEY pour usage direct Anthropic.

Choisir son app de travail

Comparia est l’app démo de cette formation, mais vous pouvez appliquer les mêmes exercices à votre propre projet.

Étape 4 : Cloner et faire marcher Comparia

Comparia est un outil de comparaison de modèles d’IA développé par beta.gouv.fr.

git clone https://github.com/betagouv/comparia
cd comparia

Configurer le token OpenRouter (fourni par le formateur) :

export OPENROUTER_TOKEN="hf_..."

Lancer l’app avec l’aide de l’agent :

codex

> Arrive à lancer ce projet en local

Vérification : l’interface est accessible dans le navigateur.

Ressources