Configuration d'OpenCode
OpenCode est un assistant de code IA open source en ligne de commande. Il est idéal pour poser des questions sur le code, modifier des fichiers et changer de modèle au sein d'un répertoire de projet. Il est conseillé aux débutants d'utiliser d'abord son assistant de connexion intégré et d'éviter d'écrire manuellement l'intégralité du JSON dès le départ.
Informations officielles Les téléchargements et la documentation dépendent du site officiel.
À quoi sert cet outil et quelle est son utilité
Emplacement du fichier de configuration
| Système | Emplacement du fichier de configuration | Description |
|---|---|---|
| Windows | C: \Users\YourUsername\. config\opencode\opencode.json | Si le fichier n'existe pas, créez-en un nouveau |
| macOS / Linux | ~/. config/opencode/opencode.json | Si le fichier n'existe pas, créez-en un nouveau |
Commencer avec l'assistant de connexion
Assistant de connexion OpenCode
cd YOUR_TEST_PROJECT opencode /connectVérifier le modèle OpenCode
cd YOUR_TEST_PROJECT opencode /modelsPoints d'attention pour la configuration manuelle
Ne modifiez le fichier de configuration que si la documentation de votre provider indique clairement le champ Provider d'OpenCode, ainsi que l'emplacement de la Base URL et de la clé (Key). Les champs peuvent varier selon les versions, ne copiez pas directement d'exemples JSON d'autres outils dans OpenCode.
| Éléments à vérifier | Description |
|---|---|
| Type de Provider | Ne confondez pas les protocoles OpenAI, Claude, Gemini ou autres |
| Base URL | Utilisez l'adresse complète fournie par le provider pour OpenCode ou pour le protocole correspondant |
| Key | Utilisez la clé correspondant au Provider actuel |
| Nom du modèle | Copiez la liste des modèles depuis le panneau de gestion de votre provider |
Comment tester après l'enregistrement
- Après être entré dans le répertoire d'un projet de test, exécutez
opencode. - Utilisez d'abord
/modelspour vérifier que le modèle que vous venez de configurer est bien visible. - Après avoir sélectionné le modèle, envoyez : « Réponds uniquement : Configuration OpenCode réussie ».
- La première fois, ne lui demandez pas de modifier des fichiers ; demandez-lui simplement d'expliquer le répertoire courant ou le fichier en cours.
- En cas d'échec, revenez d'abord à
/connectou vérifiez le provider, la Base URL, la clé et le nom du modèle par rapport à la documentation de votre provider.
| Symptôme | Vérification prioritaire | Résolution |
|---|---|---|
Aucun modèle dans /models | Vérifier si le provider a bien été enregistré et si la liste des modèles peut être récupérée | Ajoutez manuellement l'ID / le nom du modèle depuis le panneau de gestion du provider |
| Échec de connexion | Vérifier si la Base URL correspond bien au protocole du Provider actuel | Ne mélangez pas les adresses de Claude, Gemini et OpenAI |
| Fichier de configuration invalide | Format JSON, virgules, guillemets | Privilégiez la génération de la configuration avec l'assistant de connexion, puis apportez des ajustements manuels mineurs. |
Site officiel d'OpenCode Consultez les instructions d'installation, d'authentification et de commande.
Référence de configuration pour provider d'IA OpenCode Consultez l'approche de configuration pour opencode.json.