Skip to content
De développeur à ingénieur

01 — Découverte

01 — Découverte d’Opencode

Objectif : installer Opencode, le connecter à un fournisseur de LLM, et faire vos premiers prompts en comprenant les bases de l’interface.

1. Qu’est-ce qu’Opencode ?

Opencode est un agent de codage IA open source qui vit dans votre terminal. C’est un « ingénieur junior infatigable » : vous lui décrivez ce que vous voulez, il explore le code, propose des plans, écrit les modifications, exécute des tests et explique ce qu’il a fait.

Il se décline en trois interfaces :

  • TUI (terminal) — la référence de ce tutoriel
  • Application de bureau (desktop)
  • Extension IDE (VS Code, JetBrains, etc.)

Dans ce tutoriel, nous utilisons le terminal.

2. Installation

Choisissez la méthode qui vous convient.

Script d’installation officiel

Terminal window
curl -fsSL https://opencode.ai/install | bash

Via npm (Node.js)

Terminal window
npm install -g opencode-ai

Via Homebrew (macOS / Linux)

Terminal window
brew install anomalyco/tap/opencode

Vérifiez l’installation :

Terminal window
opencode --version

3. Connexion à un fournisseur de LLM

Opencode fonctionne avec de nombreux fournisseurs. Deux options simples :

  1. OpenCode Zen (recommandé pour débuter) — des modèles testés et vérifiés par l’équipe Opencode. Dans le TUI, tapez /connect, choisissez opencode, puis allez sur opencode.ai/auth pour obtenir votre clé API.
  2. Un fournisseur direct (Anthropic, OpenAI, OpenRouter…) — configurez votre clé via /connect ou le fichier de configuration.

4. Premier lancement

Terminal window
cd /chemin/vers/votre/projet
opencode

Puis initialisez Opencode pour le projet :

/init

Opencode analyse votre projet et crée un fichier AGENTS.md à la racine. Ce fichier contient les règles, la structure et les conventions de votre projet — c’est la « mémoire longue » que l’agent relit à chaque session. Commitez ce fichier dans Git.

Un bon AGENTS.md transforme un agent générique en collaborateur qui connaît votre projet. Nous y reviendrons au chapitre 02.

5. Premier prompt

Tapez simplement votre demande, en langage naturel :

Explique-moi comment fonctionne l'authentification dans ce projet.

Utilisez la touche @ pour référencer des fichiers précis du projet :

Comment gère-t-on les erreurs dans @src/services/api.ts

Le conseil d’ingénieur : parlez à Opencode comme à un développeur junior compétent. Donnez-lui du contexte, des exemples, et dites-lui ce que vous attendez — pas seulement ce que vous voulez faire.

6. Les bases de l’interface

Action Raccourci Utilité
Basculer Plan ↔ Build Tab Réfléchir avant de coder
Référencer un fichier @ Pointer un fichier précis
Annuler les dernières modifications /undo Revenir en arrière
Rétablir les modifications annulées /redo Ré-appliquer
Partager la conversation /share Créer un lien vers la session
Nouvelle session /new Recommencer proprement

7. Plan mode et Build mode

C’est la compétence la plus importante de ce chapitre.

  • Plan mode (Tab) : Opencode ne peut rien modifier. Il analyse et propose un plan. Parfait pour comprendre avant d’agir.
  • Build mode (Tab) : Opencode peut lire, écrire, exécuter. C’est là qu’il implémente.
sequenceDiagram
    participant U as Vous (ingénieur)
    participant O as Opencode
    U->>O: Plan mode (Tab) : décrire le besoin
    O->>O: Analyse du code existant
    O-->>U: Propose un plan découpé
    U->>O: Retours : "utilise le pattern de @fichier"
    O-->>U: Plan ajusté
    U->>O: Build mode (Tab) : "implémente le plan"
    O->>O: Écrit le code + exécute les tests
    O-->>U: Résultat + résumé des changements
    U->>O: Vérification : tests, /undo si besoin

Cycle de travail idéal

1. Mettez-vous en Plan mode (Tab)
2. Décrivez le besoin : "Quand un utilisateur supprime une note, marque-la
   comme supprimée en base. Ajoute un écran listant les notes récemment
   supprimées avec possibilité de restaurer ou supprimer définitivement."
3. Itérez sur le plan : "Cette fois, utilisons le pattern utilisé dans
   @src/notes.ts" — glissez une image de maquette si besoin.
4. Basculez en Build mode (Tab)
5. "Parfait, implémente le plan."

Cet aller-retour plan → build est le cœur de la méthode d’ingénieur. Il évite 80 % des « il a fait n’importe quoi ».

8. Testez vos acquis

  • Opencode est installé et une clé API est configurée
  • Vous avez lancé /init et committé AGENTS.md
  • Vous avez fait un premier prompt avec @fichier
  • Vous avez testé Plan mode (Tab) et /undo

Passez au chapitre 02 — Méthode d’ingénieur.