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, OpenCode ou Codex : lequel ?

Ce 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 guide en suit trois à parité, avec un onglet pour chacun quand une étape diffère, et la différence entre eux tient en une ligne :

• Claude Code : l’agent d’Anthropic. Vous vous branchez sur les modèles Claude (en tête du classement Code de Quelle IA à l’édition du 28 septembre 2026). Setup ultra-simple, fiabilité au top sur les tâches longues. Compris dans les abonnements Claude Pro et Max, ou payé à l’usage par l’API.
• Codex : l’agent d’OpenAI, adossé aux modèles GPT (GPT-6 Astra mène le classement Agents à la même édition). Compris dans les abonnements ChatGPT, de Plus à Pro, ou payé à l’usage avec une clé d’API. Il sait aussi tourner sur un modèle local (codex --oss).
• OpenCode : l’agent open-source. Même esprit, mais vous choisissez votre moteur : Claude, GPT, Grok, ou un modèle local via Ollama. Il accepte des clés d’API et plusieurs abonnements (ChatGPT, SuperGrok, GitHub Copilot). Parfait si vous voulez du 100 % local ou jongler entre fournisseurs.

Les deux autres éditeurs frontières ont aussi leur agent en terminal, inclus dans leurs abonnements. Si vous payez déjà l’un d’eux, ce sont des options de premier rang :

• Grok Build (xAI, commande grok) : coché dans toutes les formules de xAI, de la gratuite à SuperGrok Heavy, avec des limites qui montent avec l’abonnement. Installation : curl -fsSL https://x.ai/cli/install.sh | bash, puis grok login --device-auth sur une machine sans navigateur.
• Antigravity CLI (Google, commande agy) : il remplace Gemini CLI, qui ne sert plus depuis le 18 juin 2026 ni les comptes gratuits ni Google AI Pro et Ultra (Gemini CLI reste accessible par clé d’API payante et par licence Gemini Code Assist). Écrit en Go, il orchestre plusieurs sous-agents en arrière-plan. Installation : curl -fsSL https://antigravity.google/cli/install.sh | bash.

Prix, limites de chaque palier et règles d’usage des quatre abonnements : Les modèles frontières en abonnement.

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

• 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 : un agent qui vit dans VS Code plutôt qu’au terminal, si vous préférez rester dans votre éditeur. (Son cousin Roo Code a fermé en mai 2026.)
• Cursor, Devin Desktop (ex-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 en parallèle (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 (85 références au 1er octobre 2026, 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 idée, mais au forfait : 10 $/mois (40 $ pour Go Plus) pour des modèles de code ouverts à bas coût. Le forfait a des plafonds, comptés en dollars d’usage : chaque modèle a une enveloppe mensuelle (de 15 à 60 $ en Go), dont 20 % au plus sur une tranche de 5 heures et 50 % sur une semaine (relevé le 1er octobre 2026 sur la page d’OpenCode Go). Le bon plan si vous codez tous les jours et préférez un montant fixe à une facture variable.

Node.js : plus obligatoire, toujours utile

Bonne nouvelle : ni Claude Code, ni Codex, ni OpenCode n’ont besoin de Node.js. Les trois s’installent par un script qui pose un programme autonome. Vous pouvez sauter cette section et passer directement à l’installation.

Node reste pourtant un outil que beaucoup de projets réclament : un site en JavaScript, un paquet npm, Pi installé par npm. Le jour venu, installez-le avec nvm (gestionnaire de versions) plutôt qu’avec le paquet système, pour éviter les soucis de permissions et passer d’une version à l’autre sans douleur.

# Installe nvm (gestionnaire de versions Node)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/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   # v24.x au 1er octobre 2026 (Node 26 doit passer LTS le 28 octobre)

Installer et lancer

# Télécharge et installe Claude Code dans ~/.local/bin
curl -fsSL https://claude.ai/install.sh | bash
# Ouvrez un nouveau terminal, puis vérifiez
claude --version

claude

curl -fsSL https://opencode.ai/install | bash
# alternative, si Node est installé : npm install -g opencode-ai

opencode

# Installe Codex (relancer la même commande le met à jour)
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# alternative, si Node est installé : npm install -g @openai/codex

codex

# affiche une adresse et un code à saisir depuis votre ordinateur (bêta)
codex login --device-auth

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 (Codex, 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 26.04, usage : atelier de dev perso.
- Toujours montrer les commandes sudo avant de les lancer.
- Pas de secret en clair dans le code.
EOF