Guide pratique 2026

Guide de déploiement OpenCodeInstaller, configureret vérifier le modèle

Ce guide s'adresse aux développeurs qui veulent faire fonctionner OpenCode rapidement. Il couvre l'environnement, l'installation de la CLI, la connexion du fournisseur, la configuration du projet, les tests de validation et les erreurs fréquentes.

Commencer Vérifier le fournisseur

Point d'entrée: CLI d'abord
Configuration clé: Fournisseur + modèle
Public: Développeurs IA

Réponse courte

Installez Node.js LTS, installez la CLI OpenCode, connectez un fournisseur, confirmez que la liste des modèles se charge, puis testez la lecture, la modification et l'exécution d'une commande dans un petit dépôt.

npm install -g opencode-ai
opencode
/models

Quick Start

Processus de déploiement en 7 étapes

Utilisez cette séquence pour une première installation ou pour déplacer la configuration vers une nouvelle machine.

Vérifier l'environnement

Préparez Node.js LTS, Git, un dossier de projet propre et un terminal capable d'atteindre votre fournisseur de modèles.

Installer la CLI

Utilisez la méthode officielle, puis vérifiez que la commande opencode est disponible dans le terminal.

Connecter un fournisseur

Ajoutez d'abord un seul fournisseur. Gardez les clés API hors du dépôt.

Choisir un modèle

Commencez par un modèle stable et abordable, avec l'identifiant exact fourni par le tableau de bord ou la documentation.

Créer la configuration

Utilisez opencode.json pour les préférences non secrètes: permissions, chemins ignorés et modèle par défaut.

Valider avec une petite tâche

Demandez à OpenCode d'expliquer un fichier, de modifier un fichier peu risqué et d'exécuter un test.

Conserver une note de dépannage

Notez la version de Node, le fournisseur, le proxy, le modèle par défaut et les erreurs courantes.

OpenCode deployment workflow: runtime, provider, project configuration, and validation.

Provider

Fournisseur: faire fonctionner un chemin avant d'optimiser

La plupart des échecs viennent des clés API, URL de base, noms de modèles, proxies ou permissions trop larges.

Vérification	Action recommandée	Erreur fréquente
Clé API	Stockez-la hors du dépôt.	Publier des secrets dans Git.
URL de base	Utilisez le point d'accès officiel ou compatible.	Oublier le protocole ou utiliser un mauvais chemin.
Nom du modèle	Copiez le vrai model ID.	Utiliser un nom marketing.
Permissions	Commencez prudemment, puis élargissez après validation.	Autoriser toutes les commandes trop tôt.

Project config example

Use this as a non-secret configuration shape. Confirm exact fields with your OpenCode version.

{
  "model": "provider/model-id",
  "permission": { "edit": "ask", "bash": "ask" },
  "ignore": ["node_modules", ".env", "dist"]
}

Platform Notes

Notes par plateforme

Windows

PowerShell suffit pour les projets simples; WSL est préférable si le dépôt dépend d'outils Linux.

macOS

Vérifiez quelle installation de Node est utilisée par le terminal.

Linux

Utilisez un compte normal, protégez les clés API et évitez les tâches de développement sous root.

Troubleshooting

Ordre de dépannage

Si la commande manque, vérifiez le chemin npm global et rouvrez le terminal.
Si la liste des modèles est vide, vérifiez le fournisseur, la clé API, l'URL et le réseau.
Si les requêtes expirent, séparez réseau local, proxy, limites et panne du service.
Si les permissions échouent, vérifiez le dossier de travail et la politique OpenCode.
Si la qualité varie, validez d'abord le déploiement avec un modèle stable.

FAQ

FAQ du déploiement OpenCode

Que faut-il installer avant OpenCode?

Node.js LTS, Git, un terminal utilisable et au moins une clé API de fournisseur.

Où placer opencode.json?

Généralement à la racine du dépôt, sans aucun secret.

Comment vérifier le déploiement?

Lisez un fichier, modifiez un fichier peu risqué et lancez un test ou un formatage.