OpenCode

Un agent dans le terminal, pas un chatbot

OpenCode ouvre un agent dans un dossier de votre machine. Il lit les fichiers qui s'y trouvent, en crée, en modifie, et lance des commandes — comme un développeur à qui vous parlez. Le dossier ouvert est son monde : ce qu'il ne peut pas lire, il ne le connaît pas.

Vous restez le pilote : c'est vous qui décidez, qui lisez, qui validez. OpenCode est le poste de commande ; le modèle (DeepSeek) est le moteur ; le dossier est le terrain.

Installer

Un terminal récent suffit (WezTerm, Alacritty, Ghostty, Kitty… celui de votre système fait aussi l'affaire pour commencer). Ensuite, une seule commande :

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

Autres méthodes, si vous les préférez :

# Avec Node.js (déjà présent si vous avez fait l'installation du kit)
npm install -g opencode-ai

# Avec Homebrew (macOS / Linux)
brew install anomalyco/tap/opencode

Vérifiez que la commande répond, puis lancez l'installation depuis le dossier de votre projet :

opencode --version
cd mon-projet
opencode

Brancher la clé DeepSeek

1. Créer la clé sur platform.deepseek.com(rubrique API keys). Elle commence par sk- et ne s'affiche qu'une seule fois : copiez-la tout de suite.
2. Dans OpenCode, taper /connect, choisir deepseek dans la liste des fournisseurs.
3. Coller la clé quand l'interface la demande.
4. Choisir le modèle : DeepSeek V4.1 Flash (identifiant deepseek-flash). /models liste ce qui est disponible.

La première session

Ouvrez le terminal dans le dossier du projet, lancez opencode, puis /init. L'agent explore le dossier et rédige AGENTS.md : la carte du projet, ses conventions, ce qu'il faut savoir avant d'y toucher. Relisez-le et committez-le : c'est le document que lit l'agent à chaque session.

# Dans OpenCode, une fois le projet ouvert :
/init      → analyse le dossier et écrit AGENTS.md
/help      → la liste des commandes de votre version
/models    → vérifier le modèle utilisé

Anatomie de l'écran

Schéma simplifié de l'interface, avec les cinq éléments à repérer :

1. Le modèle utilisé : vérifiez qu'il correspond à ce que vous voulez.
2. Votre demande : une intention par message, pas trois.
3. Les outils exécutés : fichiers lus, fichiers modifiés, commandes lancées. /details affiche l'intégralité.
4. Le mode courant : plan (lecture seule) ou build(modifications). Tab bascule.
5. Le coût et les tokens de la session : à surveiller, surtout quand le projet grossit.

Les commandes utiles

Tapez / pour ouvrir la liste. Voici celles qui comptent pour un projet d'élève — l'interface évolue, donc /help fait foi.

Les raccourcis à connaître

Mode plan ou mode build ?

Le mode plan interdit les modifications : l'agent lit, raisonne et propose, mais ne touche à rien. Le mode build exécute. Ce n'est pas un détail de confort : c'est votre principal garde-fou. Tab bascule de l'un à l'autre ; l'indicateur est en bas de l'écran.

Suivre le coût

OpenCode tient les comptes : coût cumulé de la session, tokens d'entrée, de sortie et mis en cache. Ces informations s'affichent dans l'interface et dans l'écran de statistiques. Prenez l'habitude de jeter un œil après une grosse demande : c'est ainsi qu'on repère une session qui s'emballe.

• Une session qui coûte cher n'est pas une session utile : le coût vient surtout du contexte relu à chaque tour.
• Compacter avant de continuer : /compact résume la conversation et fait baisser la facture.
• Comprendre les tarifs : la section L'IA et les modèles contient un calculateur et la règle des heures creuses (moitié prix le week-end et l'après-midi).

Où sont mes fichiers ?

Là où ils étaient : dans le dossier du projet. L'agent ne travaille pas « dans le cloud » — il écrit sur votre disque. Repérez simplement :

• Le dossier ouvert : celui du terminal, avant de lancer opencode. C'est le point à vérifier en premier.
• Les chemins annoncés : à chaque action, l'interface indique le fichier lu ou modifié (src/pages/index.astro). Lisez ces lignes : elles racontent ce qui est réellement en train de se passer.
• La question magique : « montre-moi la liste des fichiers du projet et explique à quoi sert chacun ». Utile au début, rassurant ensuite.
• Le point de retour : Git (voir la section Git et GitHub) garde l'historique. /undo s'appuie dessus — sans dépôt, pas d'annulation.

La première heure sans stress

1. Ouvrir un terminal dans le dossier du projet. L'agent travaille dans le dossier courant : c'est ce dossier qui est « son monde ».
2. Lancer OpenCode et brancher le modèle. /connect, choisir DeepSeek, coller la clé d'API, puis /models pour vérifier le modèle utilisé.
3. Initialiser le projet. /init : l'agent découvre le dossier et rédige AGENTS.md. Relisez-le, il décrit votre projet.
4. Poser une première question sans risque. « Résume-moi ce projet et liste les fichiers » : vous vérifiez que l'agent lit le bon dossier.
5. Créer un dépôt Git avant de modifier quoi que ce soit. Sans dépôt, /undo ne peut rien annuler. C'est le filet de sécurité, à poser au début.
6. Passer en mode plan pour la première vraie demande. Tab, puis décrire ce que vous voulez. Lire le plan, le corriger, puis basculer en build.
7. Regarder le coût et le détail. Le coût de la session et les tokens consommés sont affichés ; /details montre chaque outil utilisé.

Cinq pièges à connaître

Pour aller plus loin