🤖Installer l'agent (très tôt)

Voici le secret le moins intuitif de tout ce parcours : on installe l’agent de code avant tout le reste.

La plupart des tutos vous font configurer la machine pendant trois heures, réseau, pare-feu, services, puis installer l’IA à la fin, comme une récompense. On fait l’inverse. Vous posez l’agent maintenant, tant que le système est encore nu, et c’est lui qui va vous aider à brancher Tailscale, Cloudflare, Ollama et tout le toutim. Vous passez de « je tape des commandes que je ne comprends pas » à « je décris ce que je veux, je relis, je valide ».

Claude Code ou OpenCode : lequel ?

Les deux sont d’excellents agents de code en ligne de commande. Ils lisent votre projet, écrivent des fichiers, lancent des commandes, et bouclent jusqu’à ce que ça marche. Ce sont les deux que ce guide suit à parité : mais ce ne sont pas les seuls. La différence entre eux tient en une phrase :

• Claude Code : l’agent d’Anthropic. Vous vous branchez sur les modèles Claude (les meilleurs du marché pour le code en 2026). Setup ultra-simple, fiabilité au top sur les tâches longues. Payant (abonnement ou API).
• OpenCode : l’agent open-source. Même esprit, mais vous choisissez votre moteur : Claude, GPT, ou un modèle local via Ollama. Parfait si vous voulez du 100 % local ou jongler entre fournisseurs.

Et si vous voulez explorer plus large, le paysage est riche en 2026, tous fonctionnent sur le même principe (lire, écrire, lancer, boucler) :

• Antigravity CLI (commande agy) : le nouvel agent en ligne de commande de Google, branché sur les modèles Gemini. Il remplace Gemini CLI, dont Google a coupé le service grand public le 18 juin 2026 (comptes gratuit, Pro et Ultra basculés d’office ; seules les licences Gemini Code Assist entreprise restent sur l’ancien outil). Écrit en Go, il orchestre plusieurs sous-agents en arrière-plan. S’installe via un script, plus par npm : curl -fsSL https://antigravity.google/cli/install.sh | bash.
• Codex CLI : l’agent d’OpenAI, adossé aux modèles GPT.
• Aider : un agent open-source très apprécié, pensé autour de git (chaque changement = un commit propre), compatible avec à peu près tous les modèles, locaux compris.
• Pi : l’alternative minimaliste à OpenCode. Même monde open-source, philosophie inverse : un cœur réduit à l’os qu’on étend soi-même. Voir l’encadré juste en dessous.
• Cline / Roo Code : des agents qui vivent dans VS Code plutôt qu’au terminal, si vous préférez rester dans votre éditeur.
• Cursor, Windsurf : des éditeurs de code entiers, bâtis autour de l’IA, pour qui veut une expérience tout-en-un.
• Orca : pas un agent de plus, mais un environnement pour les faire tourner (un « ADE », Agent Development Environment). Voir l’encadré juste en dessous.

Une clé, tous les modèles : les API unifiées

Quand un agent ouvert comme OpenCode vous demande « quel fournisseur ? », vous pourriez créer un compte chez chaque éditeur (Anthropic, OpenAI, Google…), jongler avec cinq clés, cinq factures, cinq quotas. Ou brancher une API unifiée : un seul service posé devant des dizaines de modèles, qui n’expose qu’une clé, une facture, un format. Vous changez de modèle sans changer de compte, et vous payez tout au même endroit.

• OpenRouter : le plus connu. Une seule clé donne accès à des centaines de modèles (Claude, GPT, Gemini, Grok, Llama, Qwen, DeepSeek…), avec un routage automatique vers le fournisseur le moins cher ou le plus rapide, un repli si l’un tombe, et un tableau de bord qui suit la dépense au token près. Paiement à l’usage, petite marge au-dessus du prix de gros. Idéal pour comparer dix modèles sur la même tâche sans dix inscriptions.
• OpenCode Zen : la passerelle maison de l’équipe OpenCode : un jeu de modèles triés et benchmarkés pour le code agentique (40+ références, du frontier au petit modèle rapide, dont quelques gratuits). Moins de choix qu’OpenRouter, mais chacun est vérifié pour bien se tenir dans un agent (et pas seulement dans un chat). Paiement à l’usage (prix de gros + frais de traitement), recharge auto et plafond mensuel paramétrables. Branchement : /connect dans OpenCode → « OpenCode Zen » → coller la clé.
• OpenCode Go : la même chose, mais au forfait : environ 5 $ le premier mois puis 10 $/mois, pour un accès à des modèles de code à bas coût sans compter les tokens. Le bon plan si vous codez tous les jours et préférez un montant fixe à une facture variable.

Le prérequis commun : Node et un terminal propre

Les deux agents tournent sur Node.js. On l’installe proprement avec nvm (gestionnaire de versions) plutôt qu’avec le paquet système, pour éviter les soucis de permissions.

# Installe nvm (gestionnaire de versions Node)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# Recharge ton shell (ou ferme/rouvre le terminal)
source ~/.bashrc
# Installe la dernière LTS de Node
nvm install --lts
node -v   # doit afficher v22.x ou plus récent

Installer et lancer

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

claude

curl -fsSL https://opencode.ai/install | bash
# alternative : npm install -g opencode-ai

opencode

Votre premier vrai geste : lui faire configurer la machine

C’est ici que la magie opère. Plutôt que d’enchaîner les commandes système vous-même, vous demandez. Voici une première mission concrète, à copier presque tel quel une fois dans l’agent :

Posez les fondations de la mémoire tout de suite

Avant de quitter, créez le fichier que l’agent lira à chaque session : un CLAUDE.md (Claude Code) ou AGENTS.md (OpenCode) à la racine de votre projet. Deux lignes suffisent pour commencer, on creuse le sujet dans Les fichiers mémoire.

cd ~/mon-projet
cat > CLAUDE.md <<'EOF'
# Contexte machine
- Mini-PC Ubuntu 24.04, usage : atelier de dev perso.
- Toujours montrer les commandes sudo avant de les lancer.
- Pas de secret en clair dans le code.
EOF