OpenCode est un agent de programmation ouvert qui réside directement dans le terminal. Il peut lire des fichiers de projet, éditer du code, exécuter des commandes et des tests, rechercher dans le référentiel et travailler avec git – à peu près la même chose que Claude Code et d’autres agents de console. La principale différence est qu’OpenCode n’est pas lié à un seul fournisseur de modèle : des dizaines de fournisseurs peuvent être connectés via lui, y compris DeepSeek. Dans cet article, je décrirai l’installation de l’agent et la connexion de DeepSeek à celui-ci.
Ce dont vous avez besoin
Vous n’avez besoin que de deux choses pour fonctionner :
- Terminal moderne. WezTerm, Alacritty, Ghostty, Kitty ou tout autre feront l’affaire.
- Clé API du fournisseur. Dans notre cas, DeepSeek.
Node.js n’est pas requis si vous installez l’agent avec un script d’installation standard : le binaire arrive prêt à l’emploi.
Installation
Le moyen le plus simple est le script d’installation officiel :
curl -fsSL https://opencode.ai/install | bash
Il détectera la plateforme elle-même et placera le fichier exécutable dans PATH. Après l’installation, vous devez vérifier que tout est en place :
opencode --version
Si la commande affiche la version, l’installation a réussi.
Installation à l’aide d’autres méthodes
Si vous préférez les gestionnaires de packages, il existe plusieurs options. Via Node.js :
npm install -g opencode-ai
Bun, pnpm et Yarn peuvent faire la même chose :
bun install -g opencode-ai
pnpm install -g opencode-ai
yarn global add opencode-ai
macOS et Linux ont Homebrew. Attention : c’est le tap des développeurs qui est recommandé, et non la formule officielle – il est mis à jour moins fréquemment :
brew install anomalyco/tap/opencode
Sous Arch Linux :
sudo pacman -S opencode
paru -S opencode-bin
La première commande installe la version stable du référentiel, la seconde – la dernière de l’AUR.
Installation sous Windows
Sous Windows, il est recommandé de travailler via WSL : de cette façon, les performances sont plus élevées et la compatibilité avec les capacités de l’agent est complète. Mais il existe aussi des méthodes natives. Via Chocolatey, Scoop ou npm :
choco install opencode
scoop install opencode
npm install -g opencode-ai
Il existe également une option via Mise, ainsi qu’un conteneur Docker :
mise use -g github:anomalyco/opencode
docker run -it --rm ghcr.io/anomalyco/opencode
Enfin, le binaire terminé peut toujours être extrait de la page des versions sur GitHub.
Clé DeepSeek
La clé est créée dans votre compte personnel DeepSeek. Accédez à platform.deepseek.com, ouvrez la section avec les clés API et cliquez sur créer une nouvelle clé. Il est préférable de sauvegarder immédiatement la chaîne résultante : elle ne sera affichée qu’une seule fois.
Connexion DeepSeek
Ensuite, tout se fait à l’intérieur de l’agent lui-même. Lancez OpenCode dans le terminal :
opencode
Dans l’interface, nous exécutons la commande de connexion :
/connect
Dans la liste des fournisseurs qui s’ouvre, recherchez DeepSeek, sélectionnez-le et insérez la clé API. Les clés ajoutées de cette manière sont enregistrées dans un fichier :
~/.local/share/opencode/auth.json
Après connexion, il ne reste plus qu’à sélectionner le modèle avec la commande :
/models
Les modèles DeepSeek seront disponibles dans la liste, notamment deepseek-v4-pro, deepseek-flash et deepseek-v4-flash. Pour le travail de routine dans le référentiel, l’option flash est suffisante ; Pour les tâches complexes, il est judicieux de passer au pro.
Configuration via config
Si vous ne souhaitez pas stocker la clé via un maître ou si vous devez définir votre propre adresse API, le fournisseur est décrit directement dans le fichier de configuration opencode.json :
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"deepseek": {
"options": {
"baseURL": "https://api.deepseek.com"
}
}
}
}
Le champ baseURL est utile si vous passez par un proxy ou votre propre passerelle. Dans ce cas, il est pratique de transférer la clé elle-même vers une variable d’environnement :
export DEEPSEEK_API_KEY=ваш_ключ_deepseek
opencode
Cette option convient aux lancements CI et ponctuels : la clé ne finit pas dans le stockage, mais vit uniquement dans l’environnement du processus.
Premier lancement dans le projet
Accédez au répertoire du projet et lancez l’agent :
cd ваш_проект
opencode
La première étape consiste à l’initialiser :
/init
OpenCode analysera la structure du projet et créera un fichier AGENTS.md – un analogue des instructions pour l’agent. Ce fichier vaut la peine d’être engagé dans git : il aide l’agent à comprendre les conventions et les modèles adoptés dans le projet.
Comment l’utiliser
Le travail est structuré à peu près de la même manière que celui des autres agents. Quelques astuces que vous devriez connaître tout de suite :
- Mode planification. La touche Tabulation fait basculer l’agent entre les modes planification et assemblage. Dans le premier, il suggère uniquement comment résoudre le problème et ne change rien – il est pratique de vérifier l’idée avant d’apporter des modifications.
- Liens vers des fichiers. La touche @ ouvre une recherche floue dans les fichiers du projet pour transférer un fichier spécifique à l’agent dans le contexte.
- Annuler les modifications. La commande /undo annule les dernières modifications et renvoie la demande d’origine, /redo les renvoie. Vous pouvez revenir en arrière de plusieurs étapes d’affilée.
- Partager une conversation. La commande /share crée un lien vers la conversation en cours et la copie dans le presse-papiers. Par défaut, les conversations ne sont publiées nulle part.
Pour des modifications simples, vous n’êtes pas obligé de passer en mode planification, mais décrivez immédiatement ce qui doit être fait et spécifiez les fichiers via @.
À quoi faire attention
Quelques points pratiques. OpenCode ne nécessite pas d’abonnement : vous payez directement le fournisseur lorsque vous dépensez des jetons, donc les longues sessions avec DeepSeek sont, comme on pouvait s’y attendre, moins chères que les meilleurs modèles. La clé est stockée localement dans auth.json – cela vaut la peine d’être pris en compte sur une machine partagée, mais pour les environnements d’autres personnes, une variable d’environnement est plus fiable.
Et encore une chose : la qualité des réponses à des problèmes architecturaux complexes diffère selon les modèles de différentes classes, donc pour la conception, il est logique de prendre un modèle plus solide et de céder la routine à un modèle rapide et bon marché.
Liens
https://opencode.ai/
https://opencode.ai/docs/
https://opencode.ai/docs/providers/
https://github.com/anomalyco/opencode
https://platform.deepseek.com/api_keys
https://api-docs.deepseek.com
Sources
https://opencode.ai/docs/
https://opencode.ai/docs/providers/#deepseek
https://github.com/anomalyco/opencode/releases
https://models.dev/
Leave a Reply