OpenCode : installation, modèles et premier lancement

OpenCode est un agent de programmation IA open source pour le terminal : l’outil lui-même est gratuit (licence MIT), et vous pouvez y connecter n’importe quel modèle, de Claude et GPT à un modèle local via Ollama. Le dépôt du projet a déjà dépassé les deux cent mille étoiles sur GitHub. La formule « Claude Code gratuit avec n’importe quel modèle » est séduisante, mais mérite une précision : l’outil est gratuit ; les conditions d’utilisation dépendent du modèle choisi.

Voici tout ce qu’indique la documentation officielle : ce qu’est l’outil, comment l’installer sur macOS, Linux ou Windows, comment connecter un modèle et quoi faire au premier lancement. Une section distincte porte sur les coûts, car « gratuit » ne concerne ici que l’outil : les modèles sont payants, et c’est ce qui prête le plus souvent à confusion.

Vous trouverez dans la documentation des informations pratiques sur l’utilisation d’Ailoot.

Qu’est-ce qu’OpenCode, en termes simples ?#

En bref, OpenCode fait la même chose que Claude Code : il reçoit une tâche formulée en langage courant et l’exécute dans votre projet. Ils diffèrent sur deux points. Le code est entièrement ouvert, vous pouvez donc le lire et l’inspecter. Et l’outil n’est pas lié à un seul fournisseur de modèles : il fonctionne avec plus de 75 fournisseurs, d’Anthropic et OpenAI jusqu’à un modèle local exécuté sur votre matériel.

Le projet est développé par l’équipe Anomaly. Le dépôt a été créé le 30 avril 2025 et, au 4 octobre 2026, il compte plus de 211 000 étoiles et 28 000 forks (vérifié par une requête à l’API GitHub). Le langage utilisé est TypeScript. La documentation est continuellement mise à jour ; les instructions ci-dessous se fondent donc sur la version actuelle.

Ne confondez pas les noms : le paquet npm de la branche actuelle s’appelle opencode-ai, le dépôt est anomalyco/opencode et la commande du terminal est simplement opencode. Les articles plus anciens peuvent indiquer l’adresse sst/opencode : l’organisation a changé de nom et l’ancien lien redirige désormais vers le nouveau.

Mis à jour le 4 octobre 2026 : l’équipe a publié OpenCode 2.0, la nouvelle génération majeure de l’outil. Les instructions d’installation et de connexion d’un modèle ci-dessous concernent toujours la branche actuelle 1.x (installée avec la commande curl -fsSL https://opencode.ai/install | bash ; la version actuelle au 30 septembre 2026 est la 1.18.34) : elle est activement prise en charge et c’est la version installée par la documentation officielle sur opencode.ai/docs. Les changements apportés par la deuxième version et le moment opportun pour y passer sont traités dans une section distincte ci-dessous.

En quoi OpenCode diffère-t-il de Claude Code et de Codex ?#

Si vous avez déjà un abonnement Claude, il est logique de conserver Claude Code comme outil principal ; nous avons un guide d’installation détaillé à son sujet. OpenCode est pertinent dans trois cas : si vous voulez travailler avec un abonnement ChatGPT Plus ou GitHub Copilot, exécuter un modèle local sans frais d’API, ou disposer d’une interface unique pour plusieurs modèles. Nous avons également un avis et un guide d’installation de Codex.

Si vous hésitez encore sur l’outil à choisir, commencez par cet aperçu : avec quoi les gens programment en 2026. Et si OpenCode est déjà installé et que vous devez le connecter à d’autres agents dans Devin Desktop via ACP, consultez notre guide de configuration.

Qu’est-ce qui a changé dans OpenCode 2.0 ?#

La deuxième version s’installe avec la commande curl -fsSL https://opencode.ai/v2/install | bash. Selon le guide officiel de migration (opencode.ai/v2/docs/migrate-v1), les deux versions utilisent la même commande opencode et ne s’installent plus côte à côte par défaut : l’installateur de la v2 remplace le binaire de la v1, et avant d’installer la v2 au moyen d’un gestionnaire de paquets, la documentation demande explicitement de supprimer d’abord la version v1. Toutefois, la configuration est lue à partir des mêmes fichiers, ~/.config/opencode/ et <project>/.opencode/, de sorte que les paramètres, les agents et les serveurs MCP sont transférés sans réécriture. Trois éléments doivent être réécrits : les plugins (leur API est nouvelle), les intégrations avec l’API du serveur (le protocole a changé) et les paramètres du terminal (un seul fichier cli.json partagé remplace désormais plusieurs fichiers tui.json).

Les deux nouveautés les plus notables de la v2 sont les suivantes. D’abord, Console a été lancé : un service payant pour les équipes, avec suivi de l’utilisation, budgets et règles communes à tous les membres. Ensuite, l’équipe a enfin annoncé le prix de l’abonnement Go : $10 par mois pour Go et $40 par mois pour Go Plus, avec des limites plus élevées (page opencode.ai/go, vérifiée le 4 octobre 2026). Auparavant, la documentation parlait simplement d’un « abonnement peu coûteux », sans indiquer de montant.

Si vous découvrez l’outil et voulez simplement installer l’agent, suivez les instructions ci-dessous ; elles couvrent la première version actuelle, celle que la documentation recommande elle-même. Envisagez la v2 si vous avez besoin des nouvelles fonctionnalités des plugins ou de Console pour les équipes, mais prévoyez de réécrire certains anciens plugins pour la nouvelle API. Si vous préférez une application de bureau open source qui ne nécessite pas de terminal, nous avons un avis sur ZCode, un autre agent similaire doté de sa propre interface.

De quoi avez-vous besoin avant l’installation ?#

Quelques mots de plus sur le terminal, car c’est le seul endroit où l’installation risque de ne pas se dérouler comme prévu. OpenCode affiche une interface complète avec des panneaux et de la coloration dans le terminal, c’est pourquoi la documentation recommande un émulateur moderne. Si l’interface s’affiche mal après le lancement, commencez par installer l’une des quatre options citées : WezTerm (compatible avec tous les systèmes), Alacritty, Ghostty ou Kitty. Sous Windows, la méthode principale passe par WSL ; une section lui est consacrée ci-dessous.

Il vous faut ensuite un modèle. OpenCode fonctionne avec le modèle que vous connectez : seul, il ne traite pas les requêtes. Vous avez quatre options : un abonnement (ChatGPT Plus, GitHub Copilot, GitLab Duo), une clé API de n’importe quel fournisseur, OpenCode Zen, l’agrégateur de l’équipe elle-même, ou un modèle local via Ollama. Les quatre options sont présentées dans la section sur la connexion d’un modèle.

Sans description du projet, l’agent doit deviner les commandes de compilation, la structure des fichiers et les conventions en vigueur, d’où les « hallucinations ». OpenCode utilise un fichier AGENTS.md à cet effet. La même approche s’applique à Claude Code et à tout autre agent ; seul le nom du fichier d’instructions change.

Comment installer OpenCode sur macOS et Linux ?#

La méthode recommandée consiste à utiliser l’installateur officiel :

1. Exécuter l’installateur

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

   Le script détecte votre système et télécharge OpenCode. Si la commande est introuvable après l’installation, fermez puis rouvrez le terminal ; le chemin sera pris en compte lors de la nouvelle session.

2. Vérifier que l’installation a réussi

   opencode --version
   

   La commande renvoie un numéro de version, ce qui signifie que l’installation a réussi. Le message « command not found » vous ramène à la première étape : démarrez une nouvelle session du terminal ou modifiez PATH manuellement.

Si vous préférez gérer vous-même les paquets, voici les options disponibles :

brew install anomalyco/tap/opencode

npm install -g opencode-ai

La commande Homebrew commence volontairement par anomalyco/tap/ : la documentation recommande leur propre dépôt, car l’équipe Homebrew met moins souvent à jour la formule de brew install opencode. Le même nom de paquet, opencode-ai, fonctionne aussi avec bun, pnpm et yarn (bun install -g opencode-ai, yarn global add opencode-ai). Sous Arch Linux, utilisez sudo pacman -S opencode depuis le dépôt stable ou paru -S opencode-bin pour obtenir la dernière version depuis l’AUR.

Mettez OpenCode à jour avec opencode upgrade ; au démarrage, il télécharge aussi les mises à jour de lui-même si la mise à jour automatique est activée. Après la mise à jour, vérifiez la version avec la commande habituelle opencode --version. La désinstallation est également intégrée :

opencode uninstall

La commande indique exactement ce qui sera supprimé et demande confirmation. Vous pouvez conserver la configuration et les données de session si vous le souhaitez : utilisez les options --keep-config et --keep-data.

Comment installer OpenCode sur Windows ?#

La première option recommandée par les développeurs eux-mêmes est WSL. Installez-le avec une seule commande dans PowerShell exécuté en tant qu’administrateur :

wsl --install

Après le redémarrage, ouvrez Ubuntu depuis le menu Démarrer et exécutez-y la commande habituelle :

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

Vos fichiers sur les lecteurs Windows sont accessibles dans WSL via /mnt/ : le lecteur C: se trouve sous /mnt/c/, et le lecteur D: sous /mnt/d/. Vous pouvez donc ouvrir un projet situé dans C:\Users\Name\project ainsi :

cd /mnt/c/Users/Name/project
opencode

La deuxième option consiste à se passer de WSL et à utiliser les gestionnaires de paquets Windows. Dans PowerShell :

choco install opencode

scoop install opencode

La troisième option est l’application de bureau ou la version Web. L’application s’installe comme un programme classique et affiche l’interface dans une fenêtre, sans terminal. La version Web se lance avec la commande opencode web : elle ouvre OpenCode dans un navigateur, et la documentation recommande aussi de la lancer depuis WSL afin d’éviter les problèmes d’accès aux fichiers. La documentation mentionne également des options moins courantes : mise, Docker et un binaire prêt à l’emploi sur la page des versions GitHub. L’installation avec bun sous Windows est encore en cours de développement ; si bun est votre gestionnaire de paquets principal, utilisez l’option npm.

Comment connecter un modèle à OpenCode ?#

OpenCode prend en charge plus de 75 fournisseurs via l’AI SDK et Models.dev, ainsi que des modèles locaux. La plupart se connectent avec la commande /connect dans l’interface ; pour les modèles locaux, vous indiquez également l’adresse du serveur dans la configuration. Les options diffèrent par leur mode de paiement et les exigences matérielles :

La documentation recommande aux débutants de commencer avec OpenCode Zen. L’équipe a choisi des modèles qui fonctionnent bien spécifiquement comme agents et a testé leurs combinaisons avec des fournisseurs sur ses propres tâches.

Voici comment procéder : saisissez /connect, choisissez OpenCode Zen, connectez-vous et ajoutez un moyen de paiement sur opencode.ai/auth, récupérez une clé et collez-la. Ensuite, /models affichera la liste des modèles recommandés. Au 4 octobre 2026, cette liste comprend notamment GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3 et Kimi K2.5. La documentation précise honnêtement que la liste n’est pas exhaustive et devient rapidement obsolète, car de nouveaux modèles sortent chaque semaine.

Les abonnements se connectent avec la même commande /connect : choisissez ChatGPT Plus ou GitHub Copilot dans la liste et connectez-vous à votre compte ; aucune configuration supplémentaire n’est nécessaire.

Si vous choisissez Anthropic, /connect propose deux options : saisir une clé API manuellement ou choisir Claude Pro/Max et vous authentifier dans un navigateur. Anthropic interdit toutefois les plugins tiers permettant d’utiliser un abonnement Claude Pro/Max, et les plugins intégrés de ce type ont été supprimés d’OpenCode à partir de la version 1.3.0. Si vous trouvez un ancien article sur « OpenCode via un abonnement Claude », il fait référence à ces plugins supprimés et non à une autorisation officielle. Les abonnements ChatGPT Plus, GitHub Copilot, GitLab Duo (indiqué comme expérimental) et Atomic Chat fonctionnent sans configuration supplémentaire.

OpenCode enregistre les clés saisies via /connect dans le fichier ~/.local/share/opencode/auth.json. Si vous ne voulez pas choisir un modèle à chaque fois, définissez le modèle par défaut dans le fichier de configuration opencode.json, à la racine du projet :

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5"
}

Le format est provider/model ; les deux identifiants apparaissent dans la sortie de /models.

Agent IA gratuit : connecter un modèle local à OpenCode#

Cette option signifie qu’il n’y a aucun frais d’API : le modèle s’exécute sur votre ordinateur. Si vous comparez les modèles gratuits en général, nous avons un avis distinct sur ceux qui fonctionnent raisonnablement bien comme agents et ceux qui ne le font qu’en théorie. Pour OpenCode, installez Ollama depuis le site officiel et téléchargez un modèle :

ollama pull qwen3-coder

Un détail utile de la documentation : Ollama peut se configurer automatiquement pour OpenCode ; un guide d’intégration lui est consacré. Si vous voulez tout configurer manuellement, ajoutez dans opencode.json un fournisseur indiquant l’adresse de votre serveur Ollama local :

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3-coder": {
          "name": "Qwen3 Coder"
        }
      }
    }
  }
}

Le modèle local apparaîtra ensuite dans la liste de l’interface sous /models. Sélectionnez-le et commencez à travailler. Voici un conseil pratique de la documentation : si l’agent cesse d’appeler les outils (pour modifier des fichiers ou exécuter des commandes), augmentez num_ctx dans les paramètres d’Ollama ; commencez par des valeurs de 16k–32k. Les modèles locaux sont moins performants que les modèles cloud spécifiquement pour les tâches d’agent, et un contexte réduit aggrave le problème. Si la version locale ne suffit pas, vous pouvez connecter Qwen dans le cloud avec une clé ; le guide Comment obtenir une clé API pour Qwen Code indique où en trouver une.

Combien coûtent OpenCode et son utilisation ?#

Tous les coûts concernent ici le modèle, et il existe quatre scénarios. Avec une clé API ou Zen, vous payez selon l’utilisation réelle, et le montant dépend du travail effectué par l’agent. Go est un abonnement de l’équipe OpenCode pour les modèles ouverts : $10 par mois pour Go et $40 par mois pour Go Plus avec des limites plus élevées (vérifié sur la page opencode.ai/go le 4 octobre 2026). La limite dépend du modèle : par exemple, Go autorise environ 110 requêtes toutes les 5 heures (440 par mois) pour Kimi K3 et environ 26 000 requêtes toutes les 5 heures pour le modèle plus léger DeepSeek V4.1 Flash. Pour accéder à un modèle précis au-delà de la limite, la documentation indique un tarif distinct ($15 par mois pour Kimi K3, $60 pour Go Plus). Consultez la page des abonnements au moment de la connexion pour connaître la liste complète des modèles et des limites. Avec ChatGPT Plus ou Copilot, les requêtes sont couvertes par l’abonnement que vous payez déjà ; n’oubliez pas que les abonnements ont leurs propres limites d’intensité d’utilisation. Enfin, les requêtes envoyées à un modèle local via Ollama ne coûtent rien, mais il faut un ordinateur assez puissant pour l’exécuter rapidement.

Que faire au premier lancement ?#

Premier lancement, depuis le dossier de votre projet :

cd path/to/project
opencode

L’interface s’ouvre avec un champ de saisie. Commencez par utiliser la commande /init : l’agent analyse les fichiers importants du dépôt, pose quelques questions si nécessaire et crée un fichier AGENTS.md, un guide décrivant la structure du projet, les commandes à exécuter pour les compilations et les tests, ainsi que les conventions utilisées. La documentation recommande d’ajouter ce fichier à git ; OpenCode l’utilisera ensuite comme instruction permanente pour le projet. AGENTS.md est, dans son principe, l’équivalent direct de CLAUDE.md dans l’écosystème OpenCode.

Ensuite, utilisez le mode Plan. La touche Tab permet de passer d’un agent principal à l’autre : Build dispose d’un accès complet aux fichiers et aux commandes, tandis que Plan sert à l’analyse et à la planification ; par défaut, les modifications de fichiers et les commandes bash en mode Plan nécessitent votre approbation. Pour les nouvelles tâches, la documentation recommande de commencer par un plan : lisez ce que l’agent prévoit, ajustez la formulation, puis repassez en mode Build avec Tab.

La documentation conseille ceci :

Plus la tâche est précise et plus vous fournissez de contexte, moins vous aurez de retouches à faire. Ajoutez des fichiers à une requête avec @ : commencez à saisir un nom et l’interface les trouvera grâce à une recherche approximative. Vous pouvez faire glisser des images directement dans le terminal, et un message commençant par ! est exécuté comme une commande shell ; sa sortie est ajoutée au contexte de l’agent. Si vous vous êtes trompé dans la tâche ou si l’agent a fait autre chose que prévu, /undo annule les modifications ; vous pouvez exécuter la commande plusieurs fois de suite. Vous avez encore changé d’avis ? /redo rétablit ce qui a été annulé. Enfin, /share crée un lien vers une conversation à partager avec votre équipe ; sans cette commande, la conversation n’est publiée nulle part.

Que peut faire OpenCode d’autre ?#

Commandes personnalisées. Toute demande récurrente peut devenir une commande : placez un fichier Markdown dans .opencode/commands/, définissez description, agent et model dans son frontmatter, puis écrivez un modèle de prompt en dessous. Appelez ensuite la commande avec /. Vérifications du projet avant publication, examen des erreurs récentes, génération d’une migration : tout ce que vous demandez régulièrement.

Sous-agents. En plus de Build et Plan, il en existe trois autres : General pour les tâches en plusieurs étapes (accès à tous les outils sauf à la liste des tâches), Explore pour lire rapidement le code sans autorisation de le modifier, et Scout pour rechercher des bibliothèques externes. Appelez-les en les mentionnant avec @ dans un message.

Serveurs MCP. Connectez des outils externes via la section mcp de la configuration opencode.json ; les serveurs locaux et distants sont pris en charge. Chaque serveur MCP ajoute ses outils au contexte, et un serveur gourmand comme GitHub peut épuiser le contexte très rapidement : connectez uniquement les outils dont vous avez besoin. Nous avons un guide avec des configurations prêtes à l’emploi sur le concept MCP ; il porte sur Claude Code, mais le protocole est commun.

Version Web et serveur. opencode web ouvre l’interface dans un navigateur. Pour y accéder depuis une autre machine, utilisez opencode serve --hostname 0.0.0.0 --port 4096 ; dès qu’un accès réseau est possible, définissez un mot de passe à l’aide de la variable OPENCODE_SERVER_PASSWORD. Sans mot de passe, le serveur n’est pas protégé.

Que faire si l’installation échoue ?#

« opencode: command not found » après l’installation. Le terminal ne connaît pas encore le nouveau chemin. Commencez simplement par le fermer et le rouvrir. Si cela ne suffit pas, recherchez l’emplacement où l’installateur a placé le binaire et ajoutez ce dossier au PATH du terminal.

Le modèle ne répond pas ou signale une erreur d’autorisation. Vérifiez que le fournisseur est connecté : saisissez /connect et authentifiez-vous à nouveau. Les clés sont enregistrées dans ~/.local/share/opencode/auth.json ; si vous avez déplacé l’installation depuis un autre ordinateur ou supprimé des dossiers, le fichier peut manquer. La documentation traite séparément les erreurs ProviderInitError et AI_APICallError : pour la première, réautorisez le fournisseur ; pour la seconde, videz le dossier ~/.cache/opencode et redémarrez.

L’interface est défectueuse : les panneaux sont dispersés ou des caractères illisibles apparaissent à la place des symboles. Commencez par vérifier votre terminal. Installez l’une des options recommandées — WezTerm fonctionne sur les trois systèmes — et lancez-y OpenCode.

Si rien ne fonctionne, consultez les journaux : sur macOS et Linux, ils se trouvent dans ~/.local/share/opencode/log/ ; sous Windows, appuyez sur Win+R et saisissez %USERPROFILE%\.local\share\opencode\log. Les dix fichiers les plus récents sont conservés ; activez la journalisation détaillée avec l’option opencode --log-level DEBUG. À l’aide de ces journaux, vous pouvez signaler un bogue dans le dépôt GitHub du projet.

Quelles autres questions les gens posent-ils sur OpenCode ?#

Ouvrir Ailoot.