OpenCode : configurer un agent de programmation pour son dépôt
OpenCode est un agent de programmation open source accessible dans un terminal, une application de bureau ou une interface web. Son intérêt dépend du modèle connecté et du contexte du dépôt fourni. Ce guide suit la documentation v2 vérifiée le 15 novembre 2026 ; les anciens tutoriels peuvent utiliser d’autres champs. Le guide d’installation présente les paquets disponibles et la commande /connect.
Connecter le dépôt et le fournisseur
Installez une version adaptée à votre système, ouvrez le répertoire du projet et lancez opencode. Configurez avec /connect un fournisseur accessible à votre compte. Un client opérationnel ne signifie pas une utilisation gratuite du modèle : la facturation et les conditions de traitement des données du fournisseur s’appliquent.
Créez opencode.jsonc dans le dépôt avec le schéma ci-dessous. La référence de configuration explique les paramètres du projet, globaux et administrés. Vérifiez ces couches si une option semble sans effet ; les paramètres administrés peuvent prévaloir. Gardez les identifiants hors des fichiers versionnés.
Définir les limites des commandes
Cet exemple v2 demande confirmation pour les commandes shell, interdit les push et demande l’accord avant tout accès hors du projet :
{
"$schema": "https://opencode.ai/config.json",
"permissions": [
{ "action": "shell", "resource": "*", "effect": "ask" },
{ "action": "shell", "resource": "git push *", "effect": "deny" },
{ "action": "external_directory", "resource": "*", "effect": "ask" }
]
}
La dernière règle correspondante l’emporte ; examinez aussi les exceptions propres à l’agent. Ces permissions d’outils ne constituent pas un bac à sable du système. La référence des permissions précise les actions et les correspondances.
Étudier un défaut précis
Pour un formulaire envoyé deux fois, commencez avec Plan : « Suis le gestionnaire d’envoi et la requête réseau. Explique pourquoi un clic produit deux requêtes et propose la correction minimale. » Plan évite de modifier les fichiers ordinaires du projet, mais ses commandes shell restent soumises aux permissions. Build réalise l’implémentation, selon la référence des agents.
Donnez à Build les fichiers concernés et les critères : une requête par clic, validation inchangée et contrôle de non-régression des envois répétés. Demandez de réutiliser le cadre de tests et de fournir les sorties réelles. Une explication plausible ne prouve pas la correction du code.
Vérifier avant d’adopter
Examinez git diff, lancez le test pertinent et les vérifications imposées par le dépôt, puis contrôlez les changements inattendus de dépendances ou de fichiers générés. Conservez un point de départ Git propre : l’annulation de fichiers ne rétablit ni opérations distantes ni bases de données. Comparez les fournisseurs sur ce même défaut en consignant temps de revue, erreurs restantes et frais réels. Vous obtenez une base de choix utile sans scores inventés ni hypothèse de comportement identique entre modèles.