Configuration d'OpenCode

OpenCode est un agent de codage en terminal open source. Il dialogue avec n'importe quel point de terminaison compatible OpenAI, donc une clé API CodeByAI lui suffit : vous déclarez ce site comme fournisseur personnalisé et choisissez l'un de ses modèles.

1. Installer OpenCode

macOS ou Linux :

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

Si vous préférez npm :

Copy
1
npm install -g opencode-ai

Sous Windows, WSL est recommandé ; une installation native fonctionne aussi avec npm install -g opencode-ai.

2. Créer le fichier de configuration

OpenCode lit opencode.json dans ~/.config/opencode/ (global) ou à la racine de votre projet. La configuration globale s'applique partout, commencez donc par là :

• macOS / Linux : ~/.config/opencode/opencode.json
• Windows : C:\Users\YourUserName\.config\opencode\opencode.json

Créez le fichier avec le contenu suivant :

Copy
1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "model": "codebyai/gpt-5.6-terra",
4
  "small_model": "codebyai/gpt-5.6-terra",
5
  "provider": {
6
    "codebyai": {
7
      "npm": "@ai-sdk/openai-compatible",
8
      "name": "CodeByAI",
9
      "options": {
10
        "baseURL": "https://www.codebyai.net/api/agent",
11
        "apiKey": "{env:CODEBYAI_API_KEY}"
12
      },
13
      "models": {
14
        "gpt-5.6-terra": {
15
          "name": "GPT-5.6 Terra",
16
          "limit": { "context": 200000, "output": 65536 }
17
        }
18
      }
19
    }
20
  }
21
}

Quelques détails utiles à connaître :

• npm sélectionne le protocole de communication. @ai-sdk/openai-compatible signifie qu'OpenCode appelle /chat/completions.
• baseURL s'arrête à /api/agent. N'ajoutez pas /v1 : la passerelle transmet au fournisseur en amont tout ce qui suit ce chemin, et /api/agent/v1/chat/completions renvoie 404 page not found.
• Les clés sous models sont les identifiants de modèle qu'OpenCode enverra. Cette route sert la famille GPT — les identifiants listés sous Codex sur le Model Plaza, par exemple gpt-6-astra. Les modèles Claude passent par la route compatible Anthropic décrite sur la page Claude Code.
• small_model est défini explicitement à dessein. Sinon, OpenCode cherche un modèle moins cher chez le même fournisseur et utilise votre modèle principal lorsqu'il n'en trouve pas ; le nommer évite les erreurs de génération de titre.

3. Fournir la clé API

Exportez la variable utilisée dans apiKey ci-dessus (créez d'abord une clé sur la page API Keys) :

Copy
1
export CODEBYAI_API_KEY="sk-proj-xxxx"

Ajoutez cette ligne à ~/.zshrc ou ~/.bashrc pour que chaque nouveau terminal en hérite. Si vous préférez ne pas utiliser de variable d'environnement, exécutez opencode auth login une fois et collez-y la clé — l'identifiant enregistré est alors utilisé lorsque apiKey est omis.

4. Démarrer OpenCode

Copy
1
cd your-project
2
opencode --model codebyai/gpt-5.6-terra

Pour une question ponctuelle sans l'interface interactive :

Copy
1
opencode run -m codebyai/gpt-5.6-terra "summarise the structure of this repository"

Dans l'interface, /models permet de basculer entre les modèles que vous avez déclarés dans la configuration.

5. Dépannage

• 404 page not found dans la réponse : baseURL se termine par /v1. Supprimez-le.
• Error: Hello! How can I help you with your software engineering tasks today? (HTTP 403) : la passerelle n'a reçu aucune clé, donc CODEBYAI_API_KEY est vide dans le terminal qui a lancé OpenCode. Vérifiez opencode auth list ; opencode auth login stocke la clé en dehors du fichier de configuration. Error: Invalid key! Your api-key is invalid or expired signifie que la clé a été supprimée, mal saisie ou a expiré.
• Solde insuffisant : rechargez sur la page Portefeuille.
• Les modèles Claude sont servis sur le point de terminaison compatible Anthropic que configure la page Claude Code de ce guide ; cette page documente la route compatible OpenAI.