Installer OpenCode

Guide complet pour installer et utiliser OpenCode, l'agent IA open-source pour coder. Toutes les commandes sont prêtes à être copiées.

1. Qu'est-ce qu'OpenCode ?

OpenCode est un agent IA open-source qui vous aide à coder directement dans votre terminal. Il peut comprendre votre code, répondre à vos questions, ajouter des fonctionnalités, corriger des bugs, et bien plus.

C'est l'un des projets les plus populaires sur GitHub avec plus de 120 000 étoiles et utilisé par plus de 5 millions de développeurs chaque mois.

Fonctionnalités principales :

  • Multi-provider : fonctionne avec OpenAI, Anthropic Claude, GitHub Copilot, Ollama (local), et 70+ autres providers
  • Comprend votre code : analyse automatiquement la structure de votre projet
  • Mode Plan/Build : propose d'abord un plan, puis l'exécute
  • Partage de sessions : envoyez un lien à vos collègues pour voir une conversation
Gratuit ou payant ? OpenCode lui-même est gratuit et open-source. Vous payez uniquement les providers d'IA que vous choisissez d'utiliser (OpenAI, Anthropic, etc.). Vous pouvez aussi utiliser vos abonnements existants (GitHub Copilot, ChatGPT Plus/Pro) sans frais supplémentaires.

2. Prérequis

Avant d'installer OpenCode, assurez-vous d'avoir :

  • Un terminal moderne : WezTerm, Alacritty, Kitty, Ghostty (macOS/Linux), ou le terminal Windows standard
  • Optionnel : Node.js si vous voulez installer via npm

Vérifier votre terminal :

echo $TERM

Si cette commande affiche quelque chose (ex: xterm-256color), vous avez un terminal compatible.

3. Installation

Choisissez votre système d'exploitation :

Linux / macOS (recommandé)

La méthode la plus simple est d'utiliser le script d'installation officiel :

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

Avec npm (Node.js)

Si vous avez Node.js installé, vous pouvez utiliser npm :

npm install -g opencode-ai

Avec Homebrew (macOS/Linux)

brew install anomalyco/tap/opencode

Windows (Chocolatey)

choco install opencode

Windows (Scoop)

scoop install opencode

Arch Linux (AUR)

paru -S opencode-bin
Important pour Windows : Pour une meilleure expérience sur Windows, nous recommandons vivement d'utiliser WSL (Windows Subsystem for Linux). Voir la section suivante.

4. Windows : utiliser WSL (recommandé)

WSL (Windows Subsystem for Linux) vous permet de faire tourner un environnement Linux directement sur Windows. C'est la méthode recommandée pour utiliser OpenCode sur Windows.

Pourquoi utiliser WSL ?

  • Meilleure performance : OpenCode est optimisé pour Linux/macOS
  • Compatibilité totale : toutes les fonctionnalités sont disponibles
  • Accès aux outils Linux : git, ssh, et autres outils en ligne de commande

Installer WSL 2

Ouvrez PowerShell en administrateur et exécutez :

wsl --install

Cette commande installe WSL 2 avec Ubuntu par défaut. Redémarrez votre ordinateur après l'installation.

Installer une distribution spécifique

Si vous préférez une autre distribution :

wsl --install -d Ubuntu

Une fois WSL installé

Après le redémarrage :

  1. Ouvrez le Terminal Windows ou PowerShell
  2. Tapez wsl pour entrer dans l'environnement Linux
  3. Suivez les instructions d'installation pour Linux/macOS (section précédente)
Astuce : Vous pouvez accéder à vos fichiers Windows depuis WSL via /mnt/c/. Par exemple, cd /mnt/c/Users/votre-nom/.

5. Se connecter à un provider

Une fois OpenCode installé, vous devez le connecter à un provider d'IA. OpenCode supporte plus de 70 providers, mais voici les plus populaires.

Lancer OpenCode

opencode

Cela ouvre l'interface d'OpenCode dans votre terminal.

Utiliser la commande /connect

Dans l'interface d'OpenCode, tapez :

/connect

Un menu s'affiche avec la liste des providers disponibles. Utilisez les flèches pour sélectionner et Entrée pour confirmer.

6. Providers populaires

Voici les options les plus courantes pour commencer avec OpenCode :

OpenCode Zen (recommandé pour débuter)

OpenCode Zen est un service géré par l'équipe OpenCode. Il propose des modèles testés et optimisés pour le code.

  1. Lancez /connect
  2. Sélectionnez OpenCode Zen
  3. Allez sur opencode.ai/auth
  4. Créez un compte et copiez votre clé API
  5. Collez la clé dans le terminal

Puis sélectionnez un modèle :

/models

ChatGPT Plus / Pro

Si vous avez un abonnement ChatGPT Plus ou ChatGPT Pro, vous pouvez l'utiliser directement, sans configuration supplémentaire.

  1. Lancez /connect
  2. Sélectionnez OpenAI
  3. Choisissez ChatGPT Plus/Pro
  4. Authentifiez-vous via le navigateur

Claude (Anthropic)

Vous pouvez utiliser Claude via votre abonnement Claude Pro ou via l'API Anthropic.

Méthode API :

  1. Allez sur console.anthropic.com
  2. Créez une clé API
  3. Lancez /connect → Anthropic
  4. Collez votre clé API

GitHub Copilot

Si vous avez un abonnement GitHub Copilot (individuel ou entreprise), vous pouvez l'utiliser avec OpenCode.

  1. Lancez /connect
  2. Sélectionnez GitHub Copilot
  3. Un code s'affiche, allez sur github.com/login/device
  4. Entrez le code affiché dans votre terminal
  5. Authentifiez-vous avec GitHub
Zero setup : Avec GitHub Copilot ou ChatGPT Plus/Pro, vous n'avez pas de configuration supplémentaire. Votre abonnement existant suffit.

Ollama (gratuit, local)

Ollama vous permet d'utiliser des modèles localement, gratuitement. Idéal si vous voulez tester sans coût.

1. Installer Ollama :

Sur macOS/Linux :

curl -fsSL https://ollama.com/install.sh | sh

Ou téléchargez depuis ollama.com/download pour Windows.

2. Télécharger un modèle :

ollama pull llama3

3. Configurer OpenCode pour Ollama :

Créez un fichier opencode.json dans votre projet :

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

7. Initialiser un projet

Maintenant que vous avez installé OpenCode et configuré un provider, vous pouvez l'utiliser sur vos projets.

Naviguer vers votre projet

cd /chemin/vers/mon-projet

Lancer OpenCode

opencode

Initialiser le projet

La première fois, OpenCode a besoin d'analyser votre projet pour mieux le comprendre :

/init

Cette commande crée un fichier AGENTS.md à la racine de votre projet. Ce fichier contient une description de la structure de votre projet.

Conseil : Ajoutez le fichier AGENTS.md à Git (git add AGENTS.md). Cela permet à OpenCode de mieux comprendre votre projet à chaque nouvelle session.

8. Utiliser OpenCode

Poser des questions

Dans l'interface d'OpenCode, tapez simplement votre question :

Comment fonctionne l'authentification dans ce projet ?

Utilisez @ pour faire référence à un fichier spécifique :

Explique la fonction getUser dans @src/auth/user.js

Mode Plan / Build

OpenCode propose deux modes :

  • Mode Plan : OpenCode propose un plan sans modifier vos fichiers
  • Mode Build : OpenCode modifie directement vos fichiers

Passez d'un mode à l'autre avec la touche Tab. Vous verrez l'indicateur dans le coin inférieur droit.

Workflow recommandé : Utilisez d'abord le mode Plan pour voir ce que OpenCode propose. Une fois satisfait, passez en mode Build pour appliquer les modifications.

Annuler des modifications

Si OpenCode a fait des modifications que vous voulez annuler :

/undo

Vous pouvez utiliser /undo plusieurs fois pour annuler plusieurs modifications.

Refaire des modifications annulées

/redo

Partager une conversation

Vous pouvez partager une conversation avec vos collègues :

/share

Un lien est automatiquement copié dans votre presse-papiers.

9. Dépannage courant

"command not found: opencode"

Si vous obtenez cette erreur, OpenCode n'est pas dans votre PATH.

Solution : Ajoutez le répertoire d'installation à votre PATH ou utilisez le chemin complet. Sur macOS/Linux, ajoutez à votre ~/.bashrc ou ~/.zshrc :

export PATH="$HOME/.local/bin:$PATH"

Puis rechargez votre terminal :

source ~/.bashrc  # ou source ~/.zshrc

Lenteur sur WSL

Si OpenCode est lent sur WSL, essayez ces solutions :

  • Placez votre projet dans le système de fichiers Linux (~/mon-projet) plutôt que dans /mnt/c/
  • Augmentez la mémoire allouée à WSL dans %USERPROFILE%\.wslconfig

Problèmes d'authentification

Si vous avez des problèmes avec /connect :

  • Vérifiez que votre clé API est correcte
  • Assurez-vous d'avoir des crédits sur votre compte provider
  • Essayez de vous reconnecter avec /connect

Supprimer les données locales

Si vous voulez repartir de zéro :

rm -rf ~/.local/share/opencode

10. Pour aller plus loin

Voici quelques ressources pour approfondir votre utilisation d'OpenCode :

Félicitations ! Vous avez installé et configuré OpenCode. Vous pouvez maintenant l'utiliser sur tous vos projets. N'oubliez pas d'exécuter /init dans chaque nouveau projet pour que OpenCode le comprenne mieux.
Retour aux tutoriels