OpenCode : le guide complet 2026 — l'agent de code open source qui a conquis le terminal

Guide Publié le 2026-07-29

OpenCode : le guide complet 2026 — l'agent de code open source qui a conquis le terminal

Date : 29 juillet 2026

Auteur : La Revue Editoriale

Lecture : 12-15 min

1. Introduction — qu'est-ce qu'OpenCode ?

OpenCode est un agent de codage IA open source qui vit dans votre terminal. Il lit votre codebase, planifie des changements, écrit et modifie du code, exécute des commandes et des tests, et itère jusqu'à ce que la tâche soit terminée — avec votre approbation à chaque étape.

Les chiffres qui parlent :

180 000+ étoiles GitHub (juin 2026) — l'agent de codage open source le plus adopté de l'histoire
~7,5 millions de développeurs actifs mensuels
Licence MIT — gratuit, code source ouvert
Développé par sst.dev (TypeScript + Go, tourne sur Bun)

Pourquoi il a gagné

Alternative	Modèle économique	Ouverture
Claude Code	Abonnement / API Anthropic	❌ Propriétaire
Codex CLI	Abonnement OpenAI	❌ Propriétaire
OpenCode	Gratuit (MIT) — vos clés API	✅ Open source
Aider	Gratuit	✅ Open source
Goose	Gratuit	✅ Open source

Le point clé : OpenCode est agnostique au modèle. Vous connectez n'importe quel fournisseur — Claude, GPT, Gemini, GLM-5.2 (Zhipu), ou vos modèles locaux via Ollama / LM Studio / vLLM / llama.cpp. Zéro enfermement.

2. Installation — 3 façons

Option A — npm (recommandé)

npm install -g opencode-ai
# ou avec bun
bun install -g opencode-ai

Option B — script d'installation natif

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

Option C — Desktop app (beta)

Disponible pour macOS, Windows et Linux — la même puissance avec une interface graphique.

Vérification

opencode --version
opencode          # lance le TUI (interface terminal)

💡 Premier lancement : OpenCode détecte vos clés API existantes (ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.) ou vous invite à en ajouter. Le catalogue de modèles vient de models.dev.

3. Le cœur : les deux agents intégrés (Build / Plan)

C'est LA fonctionnalité signature d'OpenCode. Deux agents intégrés, permutables avec la touche Tab :

Agent	Mode	Accès	Usage
Build (défaut)	Exécution	Système de fichiers complet, commandes, modifications de code	Faire le travail
Plan	Lecture seule	Analyse, exploration, planification — aucune modification	Réfléchir avant d'agir

Le workflow gagnant

Tab → Plan : « Analyse cette fonction, propose une refactorisation »
L'agent Plan explore le code, lit les fichiers, propose un plan
Tab → Build : « Exécute ton plan »
L'agent Build modifie le code, exécute les tests, itère

💡 Astuce : vous pouvez aussi appeler un agent spécifique avec la mention @ : @plan analyse ce fichier ou @build implémente la TODO.

4. L'utilisation en local — 100% hors ligne, zéro clé API

C'est là qu'OpenCode devient intéressant pour un usage souverain : vous pouvez brancher vos propres modèles locaux.

4.1 Avec Ollama (le plus simple)

# 1. Ollama installé et lancé
ollama pull qwen3-coder:30b   # ou votre modèle de codage préféré
ollama serve                  # écoute sur localhost:11434

# 2. Configurer OpenCode
opencode

Configuration dans opencode.jsonc (à la racine du projet ou global) :

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@openai/opencode-ollama",
      "models": {
        "qwen3-coder:30b": { "name": "Qwen3 Coder 30B" }
      }
    }
  },
  "model": "ollama/qwen3-coder:30b"
}

4.2 Avec LM Studio

# 1. LM Studio installé, modèle téléchargé
# 2. Activer le serveur local (onglet Developer → Start Server)
#    http://localhost:1234/v1 (compatible OpenAI)

{
  "provider": {
    "lmstudio": {
      "npm": "opencode-lmstudio",
      "options": { "baseURL": "http://localhost:1234/v1" }
    }
  },
  "model": "lmstudio/qwen3-coder-14b"
}

4.3 Avec vLLM / llama.cpp (avancé)

Tout serveur compatible OpenAI fonctionne : il suffit de pointer baseURL vers votre endpoint local.

4.4 Le plugin opencode-local-setup (astuce)

Le plugin opencode-local-setup synchronise automatiquement les modèles disponibles : au démarrage, il interroge vos serveurs locaux et met à jour opencode.json avec les modèles réellement présents.

Les meilleurs modèles locaux pour coder (2026)

Modèle	Taille	VRAM requise	Niveau
Qwen3-Coder	30B	20-24 Go	⭐⭐⭐⭐
GLM-4.5-Coder	32B	20-24 Go	⭐⭐⭐⭐
Qwen3-Coder	14B	10-12 Go	⭐⭐⭐
DeepSeek-Coder-V3	16B (quantisé)	10-12 Go	⭐⭐⭐
Granite-Coder (IBM)	8B	6-8 Go	⭐⭐

⚠️ Vérité 2026 : les LLM locaux restent en dessous des modèles cloud pour les tâches complexes (refactoring multi-fichiers, debug subtil). Utilisation locale recommandée pour : autocomplétion, génération de tests, petits scripts, exploration — et confidentialité totale.

5. Les fonctionnalités qui font la différence

5.1 Sessions

Reprise de session : opencode --continue ou opencode --session <id>
Sessions parallèles : travaillez sur plusieurs tâches sans perdre le contexte
Chaque session a son historique complet (messages, fichiers modifiés, commandes)

5.2 AGENTS.md — la mémoire du projet

Le fichier AGENTS.md (comme README mais pour l'agent) :

# Règles du projet
- Utiliser TypeScript strict
- Pas de `any` implicite
- Tests obligatoires pour chaque nouvelle fonction
- Style : 2 espaces, pas de point-virgule

Global : ~/.config/opencode/AGENTS.md — vos règles personnelles
Projet : AGENTS.md à la racine — les règles du dépôt
Auto-génération : commande /init — OpenCode analyse le projet et génère le fichier

5.3 Le moteur de permissions

Contrôle granulaire de ce que l'agent peut faire :

{
  "permission": {
    "edit": "allow",              // modification de fichiers
    "bash": "ask",                // demander avant chaque commande
    "webbrowser": "deny"          // jamais de navigateur
  }
}

Les 3 niveaux : allow (automatique), ask (demander), deny (interdire).

5.4 Commandes personnalisées

Dans opencode.jsonc :

{
  "command": {
    "test": {
      "description": "Lancer les tests",
      "prompt": "Exécutez les tests du projet et corrigez les échecs"
    },
    "review": {
      "description": "Revue de code",
      "prompt": "Faites une revue de code des derniers changements, listez les problèmes"
    }
  }
}

Puis : /test ou /review directement dans le TUI.

5.5 MCP — les serveurs externes

OpenCode gère nativement les serveurs MCP (voir notre guide MCP) :

{
  "mcp": {
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp"]
    },
    "playwright": {
      "type": "local",
      "command": ["npx", "@playwright/mcp"]
    }
  }
}

Commandes TUI : /mcp pour lister/connecter/déconnecter.

5.6 LSP — compréhension réelle du code

OpenCode intègre les serveurs LSP (Language Server Protocol) : il comprend la structure du code (symboles, références, diagnostics) plutôt que de simplement lire du texte. Go to definition, trouver les références, erreurs de compilation — l'agent a le même niveau de compréhension que votre IDE.

5.7 Agents personnalisés

Créez vos propres agents dans .opencode/agent/ :

---
description: Expert frontend
model: claude-sonnet-4
mode: build
tools: { edit: true, bash: true }
---
Vous êtes un expert frontend React/Next.js. Répondez en français.

5.8 Partage de sessions

opencode share — publie une session (lisible par les non-utilisateurs). Idéal pour demander de l'aide ou montrer un problème à un collègue.

6. Les 10 astuces qui changent tout

Tab pour basculer Build/Plan — le réflexe n°1 : planifier d'abord, exécuter ensuite
/model pour changer de modèle en vol — modèle rapide pour explorer, modèle fort pour exécuter
/init pour générer AGENTS.md — donnez vos conventions une fois, l'agent les respecte partout
opencode --continue — reprendre une session de la veille sans perdre le contexte
Sessions par tâche — une session = une feature. Évite la confusion de contexte
@plan / @build en mention — forcer un agent précis sans changer le mode global
Permissions ask sur bash — gardez le contrôle des commandes critiques (rm, git push)
Commandes personnalisées — /review systématique avant chaque commit
Hooks — déclenchez des actions après les événements (ex: lancer le linter après chaque édition)
AGENTS.md global — vos préférences perso (langue française, style, tests) appliquées à tous les projets

7. Exemples concrets d'utilisation

Exemple 1 — Corriger un bug (workflow complet)

> La fonction de connexion renvoie une erreur 500 quand le mot de passe contient un @

L'agent (Build) explore les fichiers d'authentification
Il reproduit le problème en exécutant les tests
Il identifie : l'échappement de caractères spéciaux manque dans la requête SQL
Il corrige, relance les tests, confirme le fix
Vous validez les modifications

Exemple 2 — Refactoring sécurisé avec Plan

> @plan Je veux extraire la logique de paiement dans un module séparé

L'agent Plan lit le code, identifie les dépendances
Il propose un plan en 5 étapes avec les fichiers concernés
Vous passez en Build : « Exécute ton plan »
Chaque étape est approuvée, les tests tournent entre chaque

Exemple 3 — Génération de tests

> /test — génère des tests unitaires pour le module utils/date.js

L'agent analyse les fonctions, les cas limites, les dépendances
Il génère des tests couvrant les cas nominaux ET les cas d'erreur
Il exécute la suite pour vérifier

Exemple 4 — Veille documentaire (usage local pur)

> @plan Analyse ce dossier de briefs et classe les sujets par thème

Avec un modèle local + Filesystem MCP, OpenCode devient un outil d'organisation documentaire — zéro donnée sortie de la machine.

Exemple 5 — Revue de code avant commit

> /review

L'agent relit les derniers changements
Liste : bugs potentiels, dette technique, améliorations de style
Suggère des corrections que vous appliquez ou non

8. OpenCode Zen — l'option « clé en main »

Pour ceux qui ne veulent pas gérer leurs clés API :

OpenCode Zen : catalogue de modèles curaté et benchmarké (Claude, GPT, Gemini)
Pay-as-you-go : vous payez ce que vous consommez, pas d'abonnement
Un seul compte : opencode auth login et c'est tout

Le calcul économique :

Approche	Coût
Claude Code (abonnement)	~20 $/mois + quota
API directe (Claude/GPT)	Pay-as-you-go (facturation à l'usage)
OpenCode + vos clés API	Pay-as-you-go, zéro abonnement
OpenCode + Ollama local	0 € — électrique

9. Les pièges à éviter

Les petits modèles locaux hallucinent : pour du refactoring critique, utilisez un gros modèle cloud — le local pour les tâches simples
Permissions trop ouvertes : bash: allow global = un agent qui fait rm -rf sans demander
Pas de AGENTS.md : sans conventions, l'agent écrit du code incohérent avec votre style
Contexte noyé : trop de fichiers dans une session = l'agent oublie le début. Fractionnez
Confiance aveugle : OpenCode est un outil — il faut lire et valider ses changements, comme une PR d'un collègue
Spec 2026-07-28 MCP : les serveurs MCP anciens peuvent casser après la migration stateless — vérifiez vos configs

10. Verdict

OpenCode est devenu l'agent de codage open source de référence — pas parce qu'il est gratuit, mais parce qu'il est libre : libre de choisir vos modèles, libre de tout héberger en local, libre de lire le code source.

Critère	Note
Puissance	⭐⭐⭐⭐⭐ (avec modèles cloud)
Souveraineté (local)	⭐⭐⭐⭐ (limité par les modèles locaux)
Prix	⭐⭐⭐⭐⭐ (MIT, BYO API keys)
Ergonomie	⭐⭐⭐⭐ (TUI riche, desktop beta)
Écosystème	⭐⭐⭐⭐⭐ (MCP, LSP, plugins, 180K ⭐)

En une phrase : OpenCode est à Claude Code ce que Linux est à Windows — le même pouvoir, sans le propriétaire. Pour un usage 100% local, c'est le meilleur choix du marché : Ollama ou LM Studio en backend, et votre code ne quitte jamais votre machine.

Annexes

Commandes CLI essentielles

opencode                    # lancer le TUI
opencode --continue         # reprendre la dernière session
opencode --session <id>     # reprendre une session précise
opencode --model <model>    # lancer avec un modèle précis
opencode run "tâche"        # mode non-interactif (scripts, CI)
opencode share              # partager une session
opencode auth login         # connexion (Zen ou providers)
opencode mcp                # gestion des serveurs MCP
opencode doctor             # diagnostic de configuration

Raccourcis TUI essentiels

Touche	Action
Tab	Basculer Build ↔ Plan
Ctrl+K	Menu des commandes
Ctrl+R	Sessions récentes
Ctrl+D	Nouvelle session
Esc	Annuler / interrompre

Sources

opencode.ai/docs — documentation officielle
github.com/sst/opencode — 180K+ ⭐
docs.ollama.com/integrations/opencode — Ollama officiel
models.dev — catalogue de modèles
fundesk.io — OpenCode complete guide 2026
explainx.ai — guide OpenCode 2026
kanaries.net — utiliser OpenCode en français