Guide opencode.jsonc : 7 vérifications avant le commit

La bonne question n'est pas seulement où placer le fichier. Utilisez opencode.jsonc pour des réglages OpenCode non secrets et relisibles, gardez les identifiants hors du dépôt, comprenez la fusion entre configuration globale et projet, puis validez fournisseur, modèles, permissions et retour arrière.

La documentation officielle indique la prise en charge de JSON et JSONC. Les commentaires doivent donc expliquer la raison d'un réglage, son propriétaire et la commande qui prouve qu'il fonctionne.

Ne stockez pas de secrets. Les modèles, le shell, les outils, permissions et chemins de projet peuvent être configurés; clés API, tokens, URL privées et mots de passe proxy restent hors dépôt.

OpenCode fusionne les fichiers de configuration au lieu de les remplacer entièrement. Une préférence globale peut donc se combiner avec une règle de projet sauf en cas de clé conflictuelle.

La configuration globale sert aux habitudes personnelles. La configuration de projet sert aux règles que l'équipe doit relire: modèle, chemins ignorés, commandes, MCP et permissions.

Copiez les IDs de modèle depuis les docs ou le tableau de bord du fournisseur. Un fichier JSON valide peut échouer si le modèle n'existe pas ou si le nom marketing n'est pas l'ID réel.

Séparez modèle principal et petit modèle seulement avec une raison claire: coût, latence, contexte, disponibilité locale ou conformité. Si la raison change, relisez le fichier.

Les permissions sont la partie la plus sensible. Gardez éditions et commandes en ask tant que les actions répétées, réversibles et peu risquées ne sont pas prouvées.

Installations, suppressions, migrations, déploiements, push, secrets et dossiers externes doivent rester en deny ou en validation explicite. Les exceptions d'agent ou MCP restent proches du rôle.

Ajoutez l'URL du schéma officiel pour la validation et l'autocomplétion. Cela ne remplace pas une revue humaine, mais bloque les clés mal écrites et les formes obsolètes.

Relisez ensuite chaque clé: est-elle non secrète, utile au dépôt, documentée et encore exacte pour la version actuelle?

Avant le commit, testez dans un dépôt peu risqué. Lancez OpenCode, listez les modèles, lisez un fichier, faites une petite édition, exécutez une commande attendue et vérifiez qu'une action interdite s'arrête.

Conservez les preuves: OS, shell, fournisseur, modèle, commande et méthode de rollback. Le fichier devient alors une base reproductible.

1. Créer un fichier minimalCommencez par schéma, modèle et posture de permission relue.
2. Valider la syntaxeUtilisez le schéma de l'éditeur ou un outil JSONC.
3. Résoudre les couchesVérifiez si global, projet, chemin personnalisé ou géré gagne.
4. Lancer une petite tâcheLire un fichier, faire une modification légère et exécuter une commande connue.
5. Tester denyEssayez une action bloquée et confirmez qu'elle ne s'exécute pas.
6. Noter le rollbackExpliquez comment retirer la règle ou démarrer sans ce fichier.

En cas de panne, isolez les couches: syntaxe JSONC, dossier courant, racine Git, overrides globaux, overrides projet, variables d'environnement, fournisseur puis permissions.

Sous Windows, séparez emplacement du fichier et shell. Une configuration correcte peut échouer si le terminal intégré ne voit pas les variables ou si le shell n'existe pas.