Aller au contenu
minimachine.
← Le parcours
Étape 07 · Les fondations Facile · 12 min

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

Claude Code ou OpenCode, en cinq minutes. L'astuce : l'installer maintenant, pour qu'il configure tout le reste de la machine à votre place.

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

  • Gemini CLI : l’agent en ligne de commande de Google, branché sur les modèles Gemini. Généreux en usage gratuit.
  • 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.
  • 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.

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

Le CLI s’installe avec npm, en global :

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

Lancez-le depuis n’importe quel dossier :

claude

Au premier démarrage, il ouvre votre navigateur pour vous connecter (compte Anthropic, abonnement Pro/Max ou clé API). Une fois authentifié, vous êtes dans l’agent. Tapez une demande en français et regardez-le travailler.

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 :

Décrivez l'objectif, pas les commandes

Dans l’agent, écrivez quelque chose comme :

« On est sur un Ubuntu 24.04 tout neuf. Je veux que tu m’aides à finir la config de base : mises à jour de sécurité automatiques, pare-feu ufw qui ne laisse passer que le SSH, et zram pour le swap. Explique-moi chaque étape avant de l’exécuter, et ne lance rien en sudo sans me montrer la commande d’abord. »

Relisez le plan avant de valider

L’agent va vous proposer un plan et des commandes. Lisez-les. C’est le cœur du métier : vous ne tapez plus, vous relisez. Si une commande vous semble louche, demandez « pourquoi celle-là ? » avant d’accepter.

Laissez-le exécuter, gardez la main

Vous approuvez étape par étape. En cas d’erreur, l’agent lit le message, comprend, et corrige. Vous venez de configurer votre machine en discutant.

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