OpenCode CLI et web local¶

OpenCode CLI est la version en ligne de commande d'OpenCode. Utilisez-la si vous êtes déjà à l'aise avec un terminal. Sinon, prenez OpenCode Desktop.

Avant de modifier un projet

OpenCode peut modifier les fichiers du dossier courant. Des changements catastrophiques peuvent arriver : fichiers supprimés, dossier réécrit, modifications difficiles à comprendre. Avant de demander une action importante, faites un commit Git. OpenCode fonctionne très bien avec Git : vous pouvez lui demander de créer le dépôt, de faire des commits réguliers et d'afficher les différences avant de garder les modifications. Sans Git ni sauvegarde, il peut être impossible de revenir en arrière.

1. Installer OpenCode CLI¶

Les commandes d'installation peuvent évoluer. Les commandes à jour sont indiquées sur le site OpenCode.

Méthode commune avec npm¶

OpenCode CLI peut s'installer avec npm. Il faut d'abord installer Node.js, qui fournit npm.

Windows, dans PowerShell :

winget install "Node.js (LTS)"

Fermez puis rouvrez PowerShell.

macOS, avec Homebrew :

brew install node

Linux Debian, Ubuntu ou Devuan :

sudo apt install nodejs npm

Installez ensuite OpenCode CLI :

npm i -g opencode-ai

Autres méthodes¶

Sur macOS, Homebrew peut aussi installer OpenCode directement :

brew install anomalyco/tap/opencode

Sur Linux, le script d'installation OpenCode reste possible :

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

Pour une application graphique, utilisez OpenCode Desktop.

2. Télécharger la configuration Aristote¶

Télécharger le fichier opencode.json

Pour mettre à jour une configuration existante, gardez une copie de votre ancien fichier, puis utilisez le nouveau fichier et renseignez à nouveau votre clé. Si vous avez des réglages personnalisés à conserver, remplacez seulement la section provider.aristote.models par celle du fichier téléchargé.

Configuration par projet¶

Placez opencode.json dans le dossier depuis lequel vous lancerez OpenCode :

mon-projet/
  opencode.json

Configuration globale¶

OpenCode lit aussi le fichier ~/.config/opencode/opencode.json.

macOS et Linux :

mkdir -p ~/.config/opencode
cp opencode.json ~/.config/opencode/opencode.json

Pour ouvrir le fichier sous macOS :

open -a TextEdit ~/.config/opencode/opencode.json

Pour ouvrir le fichier sous Linux :

nano ~/.config/opencode/opencode.json

Windows, dans PowerShell :

New-Item -ItemType Directory -Force "$env:USERPROFILE\.config\opencode"
Copy-Item -Force .\opencode.json "$env:USERPROFILE\.config\opencode\opencode.json"
notepad "$env:USERPROFILE\.config\opencode\opencode.json"

$env:USERPROFILE désigne votre dossier utilisateur Windows, par exemple C:\Users\prenom.nom.

3. Ajouter votre clé¶

Dans opencode.json, remplacez :

"apiKey": "sk... à compléter"

par votre vraie clé Aristote.

4. Lancer la CLI¶

Depuis le dossier qui contient opencode.json :

opencode

Dans OpenCode :

/models

Choisissez aristote/qwen-3.6-35b-instruct. Si ce modèle n'est pas disponible ou ne convient pas, choisissez aristote/gemma-4-31b.

Vous pouvez aussi choisir Qwen Reasoning High, GPT OSS, Llama ou Mistral. Modèles et limites.

Interface web locale¶

L'interface web locale dépend de la CLI. Ce n'est pas OpenCode Desktop.

Depuis le dossier qui contient opencode.json :

opencode web

OpenCode ouvre une page locale dans votre navigateur.

Utiliser OpenCode dans VS Code¶

L'extension VS Code nécessite OpenCode CLI.

Dans VS Code, ouvrez le panneau Extensions, cherchez OpenCode, puis cliquez sur Install.

Après installation, lisez la documentation affichée par le plugin. L'extension existe aussi pour Cursor, Windsurf et VSCodium.

Vérification¶

La commande opencode fonctionne dans le terminal.
Vous lancez opencode ou opencode web depuis le dossier contenant opencode.json.
La ligne apiKey contient votre vraie clé.
Le modèle choisi existe dans opencode.json et dans la liste affichée par OpenCode.

Clé personnelle

Une fois la clé ajoutée, opencode.json devient personnel. Ne le mettez pas dans Git et ne le joignez pas à un message de support.