Installation d'OpenCode et configuration d'OmniProxy

OpenCode est un assistant de codage open-source qui vous permet d’écrire du code depuis un terminal, un IDE ou un bureau. Il ne stocke pas votre code ou votre contexte, ce qui le rend adapté aux projets sensibles en termes de confidentialité. build est utilisé pour modifier un projet, tandis que plan est en lecture seule par défaut et est utile pour comprendre du code inconnu et planifier des changements avant de les effectuer. Vous pouvez choisir un service de modèle en fonction de vos besoins.

Avant de commencer

Le script d’installation est l’option la plus simple. Vous avez besoin d’un terminal moderne — une application de terminal capable d’exécuter des commandes et de travailler avec des fichiers de projet — comme WezTerm, Alacritty, Ghostty ou Kitty. Sur Windows, WSL est préférable. Il fournit un environnement Linux au sein de Windows avec des performances et des fonctionnalités plus complètes.

Le plus simple

Script d'installation

curl opencode.ai/install
Utiliser directement sur macOS Linux
WSL est recommandé sur Windows

macOS Linux

Homebrew tap

anomalyco/tap/opencode
Mis à jour plus fréquemment que la formule
Un paquet est également disponible pour Arch

Windows natif

Gestionnaire de paquets

choco ou scoop
Ou installer globalement avec npm
Vous pouvez également le télécharger depuis les Releases

Commencez par le script d'installation. Si vous êtes déjà à l'aise avec les gestionnaires de paquets, utilisez l'une des autres commandes listées.

Préparez également l’ID du modèle à partir de la liste actuelle des modèles. Un ID de modèle est le nom que le service utilise pour identifier précisément un modèle spécifique.

Installation et premier lancement

La commande d’installation la plus simple est :

curl -fsSL https://opencode.ai/install | bash

Vous pouvez également utiliser l’une de ces méthodes d’installation :

Node.js : npm install -g opencode-ai. Bun, pnpm et Yarn ont également des commandes d’installation globale correspondantes ; consultez la page d’introduction à la fin de ce guide.
Homebrew sur macOS et Linux : brew install anomalyco/tap/opencode. Utilisez ce tap car il est mis à jour plus fréquemment que brew install opencode, qui est maintenu par l’équipe Homebrew.
Arch Linux : utilisez sudo pacman -S opencode pour la version stable, ou le paquet AUR opencode-bin pour une version plus récente.
Windows : utilisez choco install opencode ou scoop install opencode. Vous pouvez également utiliser npm install -g opencode-ai. Les fichiers binaires peuvent également être téléchargés depuis les Releases. La prise en charge de l’installation avec Bun sur Windows est toujours en cours.

Entrez dans votre répertoire de projet, puis lancez OpenCode :

cd /path/to/project
opencode

Lors de la première utilisation, vous pouvez exécuter /init. Il analyse le projet et crée AGENTS.md à la racine du projet. Ce fichier peut être validé dans Git afin que le projet conserve ces instructions.

Obtenir les valeurs de connexion depuis OmniProxy

baseURL: https://your-omniproxy-origin.example/v1
API Key: <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy from the current OmniProxy model list

baseURL est l’adresse du service, API Key est le justificatif d’accès, et Model ID est le nom complet du modèle.

Lors de l’utilisation de /v1/chat/completions, définissez le paquet npm sur @ai-sdk/openai-compatible. Chat Completions est un type d’interface de requête de chat. Passez à @ai-sdk/openai uniquement lorsque le modèle utilise /v1/responses. Lorsqu’OmniProxy est utilisé via le point de terminaison chat completions, conservez le paquet de compatibilité.

Copiez l’ID complet du modèle depuis la liste actuelle d’OmniProxy, y compris les barres obliques. Au 09/10/2026, deux ID de référence étaient claude-sonnet-5-5 et gpt-6-luna. gpt-6-luna prend en charge Chat Completions ; l’appel de fonction via Chat Completions n’est pris en charge que lorsque reasoning_effort est none. Ne copiez pas un ID qui ne figure pas dans la liste.

Saisir la configuration de l’outil

Un fournisseur (Provider) peut être compris comme un ensemble de valeurs de configuration qu’OpenCode utilise pour se connecter à un service de modèle. La documentation du fournisseur traite un service compatible OpenAI qui n’est pas listé sous /connect comme un fournisseur personnalisé. Un service compatible OpenAI utilise le même format de requête et peut être appelé par le même type de client.

Exécutez /connect dans OpenCode et faites défiler jusqu’à Other.
Entrez un ID de fournisseur. L’exemple ci-dessous utilise omniproxy. Choisissez un ID facile à retenir car vous devez utiliser le même dans le fichier de configuration.
Entrez la clé API OmniProxy. Cette étape n’enregistre que la clé API ; l’adresse et les modèles doivent toujours être ajoutés à opencode.json. Le justificatif est stocké dans ~/.local/share/opencode/auth.json.
Créez ou modifiez opencode.json dans le répertoire du projet :

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniproxy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniProxy",
      "options": {
        "baseURL": "https://your-omniproxy-origin.example/v1"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "gpt-6-luna": { "name": "GPT-6 Luna" }
      }
    }
  }
}

Exécutez /models. Le fournisseur personnalisé et ses modèles apparaîtront dans la liste.

L’ID saisi sous /connect doit correspondre à la clé dans opencode.json. Ne mettez pas de vraie clé secrète dans ce fichier. Si vous n’utilisez pas /connect, vous pouvez utiliser la syntaxe de variable d’environnement dans options.apiKey, telle que {env:VARIABLE_NAME}. Lors des tests effectués le 09/10/2026 avec OpenCode 1.18.34, mettre la clé directement dans le options.apiKey du projet sans utiliser /connect a également permis une connexion réussie. Si la passerelle ne valide pas la clé, cette valeur peut être une chaîne de caractères générique utilisée uniquement sur la machine locale. Les clés sous models doivent utiliser les ID complets de la liste.

Clé

/connect

Sélectionnez Other en bas
Choisissez votre propre ID de fournisseur
Stocké dans auth.json

Projet

opencode.json

La clé du fournisseur doit utiliser le même nom
Utilisez un paquet npm compatible
baseURL se termine par /v1

Sélectionner

/models

Le modèle apparaît dans la liste
Sélectionnez-en un avant de poser une question
Utilisez l'ID de la liste de la passerelle

La clé et l'adresse sont stockées dans deux endroits différents. L'ID du fournisseur doit être le même dans les deux.

Vérifier avec une tâche réelle

Exécutez d’abord une tâche réelle depuis le répertoire du projet. Le format de référence du modèle est Provider ID/model ID; conservez toutes les barres obliques dans l’ID du modèle :

opencode run --model omniproxy/claude-sonnet-5-5 --auto "Explain what a file you specify does. Do not modify the file."

--auto permet à cette exécution d’utiliser des outils tels que des outils de lecture de fichiers. Lors des tests effectués le 09/10/2026 avec OpenCode 1.18.34, il a lu avec succès le contenu du fichier spécifié. La première exécution a pris environ deux minutes.

Pour une utilisation interactive, exécutez opencode, puis sélectionnez un modèle avec /models. Vous pouvez utiliser @ pour rechercher des fichiers. Utilisez opencode auth list pour confirmer le justificatif enregistré via /connect, puis vérifiez les enregistrements de requêtes d’OmniProxy pour vérifier la source et l’ID du modèle.

Lancement

opencode se lance

D'abord cd vers le projet
auth list affiche l'ID
Le fichier de configuration est dans le projet

Tâche

Il a lu le code

Posez une question sur un fichier spécifique
Examinez son explication
Utilisez /undo s'il a tort

Journaux

Visible dans la passerelle

La source est OpenCode
L'ID du modèle correspond
Ne validez pas la clé

Après avoir enregistré le fichier de configuration, effectuez une requête réelle depuis le projet.

Erreurs courantes

OmniProxy n’apparaît pas sous /models: Vérifiez que l’ID saisi sous /connect correspond à la clé dans opencode.json, que npm est défini sur @ai-sdk/openai-compatible, et que baseURL se termine par /v1.
Le justificatif est manquant : Exécutez opencode auth list. Les fournisseurs tels que Bedrock qui reposent sur des variables d’environnement n’apparaissent pas ici ; un fournisseur personnalisé configuré via /connect devrait être visible.
La fonctionnalité Windows est incomplète : Utilisez le script d’installation à l’intérieur de WSL à la place.
L’ID du modèle est invalide : Copiez-le à nouveau depuis la liste actuelle d’OmniProxy et mettez à jour la clé correspondante sous models.
Les requêtes vont vers le mauvais point de terminaison : Gardez @ai-sdk/openai-compatible pour les chat completions. Ne changez pas le paquet pour l’interface Responses à moins que ce modèle sur OmniProxy n’utilise réellement /v1/responses.

Références officielles

Pour l’installation, voir l’introduction à OpenCode. Pour les fournisseurs personnalisés, voir Providers. Pour les ID de modèle utilisés dans les exemples, voir le Claude model overview et GPT-6 Luna.

Remplacez chaque espace réservé par des valeurs de votre propre configuration OmniProxy. Ne publiez jamais une vraie clé.

Un résultat sauvegardé ou un HTTP 200 seul ne prouve pas une compatibilité complète de l'Agent. Vérifiez la source et le modèle dans l'enregistrement d'appel d'OmniProxy.

Sources officielles · OpenCode ↗