OpenCode

OpenCode prend en charge les providers personnalisés et permet de connecter le service Codex Proxy via un fichier de configuration.

PrérequisCopier le lien d’ancre

Le site d'OpenCode propose un script d'installation officiel, ainsi que des installations via npm, bun, brew, etc.

• Si vous utilisez directement le script d'installation officiel, configurer npm au préalable est en principe inutile
• Si vous passez par npm, installez d'abord Node.js et npm
• Si vous passez par bun, installez d'abord bun

Installation de Node.js (méthode npm)Copier le lien d’ancre

La page officielle de téléchargement de Node.js : https://nodejs.org/en/download

• macOS / Windows : téléchargez et installez la version LTS
• Linux : installez selon la méthode propre à votre distribution, indiquée sur cette page

Sous macOS avec Homebrew déjà installé, vous pouvez aussi exécuter directement :

brew install node

Cela installe Node.js et npm en même temps.

Vérifiez que les commandes correspondant à votre méthode d'installation sont disponibles. Pour la méthode npm, contrôlez par exemple :

node -v
npm -v

Remarque : si vous utilisez un environnement en ligne de commande sous Windows, l'éditeur recommande pour l'instant de passer par WSL.

InstallationCopier le lien d’ancre

Utilisez de préférence la commande d'installation fournie sur le site d'OpenCode :

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

Le site d'OpenCode propose également des installations via npm, bun, brew, etc.

Définition de la clé APICopier le lien d’ancre

Passez par le mécanisme de connexion ou d'authentification propre à OpenCode :

opencode auth login

Ou exécutez /connect dans l'interface interactive pour enregistrer ce service comme provider personnalisé.

Si vous préférez les variables d'environnement, faites lire à opencode.json le nom de variable officiel standard, par exemple :

export OPENAI_API_KEY="your_api_key_here"

Configuration de opencode.jsonCopier le lien d’ancre

Créez un fichier opencode.json à la racine du projet ou dans le répertoire de configuration global :

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aicentos": {
      "npm": "@ai-sdk/openai",
      "name": "aicentos",
      "options": {
        "baseURL": "https://aicentos.com/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-4o": {
          "name": "gpt-4o"
        }
      }
    }
  },
  "model": "aicentos/gpt-4o"
}

TestCopier le lien d’ancre

Après le démarrage d'OpenCode, exécutez :

/models

Les modèles sous aicentos doivent apparaître.

RemarquesCopier le lien d’ancre

• Ordre recommandé : d'abord le fichier de configuration à la main (opencode.json), puis les variables d'environnement, et seulement en dernier l'outil cc-switch (https://github.com/farion1231/cc-switch/releases)
• Si vous utilisez /v1/responses, la documentation officielle d'OpenCode recommande @ai-sdk/openai
• Ne passez à @ai-sdk/openai-compatible que si votre connexion ne prend en charge que /v1/chat/completions
• Inutile de définir des variables propres au projet comme CODEX_PROXY_API_KEY

Liens utilesCopier le lien d’ancre

• Site officiel : https://opencode.ai/