Configuration de la clé API OpenCode

Configuration de la clé API OpenCode : URL de base, fournisseur et modèles

OpenCode avec une API tierce nécessite trois choses : une clé API, une base_url et une configuration de fournisseur.

Paiement à l'usage pour Claude, Kimi, GLM et plus : obtenez une clé API, définissez base_url et provider dans opencode.json, puis confirmez avec un message de test.

OpenCode est installé : configurez-le Pas encore installé : commencez par l'installation

Exemple opencode.jsonJSON

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "aicodewith-anthropic/claude-opus-5-5",
  "provider": {
    "aicodewith-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI Code With Anthropic",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "your-aicodewith-api-key"
      },
      "models": {
        "claude-opus-5-5": {
          "name": "Claude Opus 5.5"
        }
      }
    }
  }
}

OpenCode not installed?

This page configures the OpenCode terminal CLI. If opencode --version already prints a version, skip ahead to the quick setup.

Open the official OpenCode download page Already installed: continue

Commande d’installation de base

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

Or install globally with npm (this exact command is commonly searched)

npm install -g opencode-ai@latest

Installation succeeds when opencode --version prints a version number.

Continue with AI Code With Read the official installation docs

Configuration rapide sécurisée

Choisissez un modèle, copiez la configuration, enregistrez le fichier et vérifiez la connexion en environ 3 minutes.

1. Choisir un modèle

Le catalogue actuel contient 47 modèles.

2. Copier la configuration

Fournisseur: aicodewith-anthropic
Adaptateur npm: @ai-sdk/anthropic
URL de base: https://api.aicodewith.ai/v1
ID du modèle: claude-opus-5-5

{
  "$schema": "https://opencode.ai/config.json",
  "model": "aicodewith-anthropic/claude-opus-5-5",
  "provider": {
    "aicodewith-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI Code With Anthropic",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "your-aicodewith-api-key"
      },
      "models": {
        "claude-opus-5-5": {
          "name": "Claude Opus 5.5"
        }
      }
    }
  }
}

Suivant : enregistrer la configuration

3. Enregistrer opencode.json et définir la clé API

Sauvegardez un opencode.json existant, puis fusionnez le modèle et le fournisseur à partir du contenu généré. Conservez les autres fournisseurs et stockez la vraie clé uniquement dans une variable d'environnement locale.

Ouvrir la page de clé API

Enregistrer le fichier de configuration

1. Ouvrez le terminal de votre système
2. Exécutez la commande ci-dessous pour ouvrir le fichier de configuration (créé automatiquement s'il est absent) :
```
notepad "$env:USERPROFILE\.config\opencode\opencode.json"
```
3. Collez la configuration copiée à l'étape 2 et enregistrez-la
Appuyez sur Ctrl+S sous Windows/Linux, Cmd+S sous macOS.

Définissez la clé API (remplacez your-key par votre vraie clé)

Ouvrez un nouveau terminal ou rechargez la configuration de votre shell, puis redémarrez OpenCode.

4. Redémarrer et vérifier

À exécuter dans le terminal de votre systèmeopencode
À saisir dans OpenCode/models confirmez que le fournisseur et l'ID de modèle correspondent à la sélection de la page
À envoyer dans le chatReply with exactly: connection successful
confirmez qu'OpenCode affiche une réponse et faites correspondre son heure et son modèle dans les enregistrements d'utilisation AI Code With

Les enregistrements d'utilisation confirment qu'une requête a atteint AI Code With. Déterminez le succès à partir du statut, du contenu de la réponse et de la réponse réellement affichée dans OpenCode.

La configuration n'a pas été chargée : résoudre le problème

Comment OpenCode se connecte-t-il à une API tierce ?

OpenCode utilise un Provider personnalisé pour envoyer des requêtes au service API de votre choix : le Provider est l'espace de noms qui indique à OpenCode quel service appeler, la clé API gère l'authentification, la Base URL est le point de terminaison de l'API tierce, et le Model ID sélectionne le modèle réel.

Une fois enregistrées, les requêtes circulent selon OpenCode → Provider → Base URL → API du modèle. Après une vérification /models et un court message de test, vous pouvez faire correspondre la requête à vos relevés d'utilisation par heure et par modèle.

En cas d'échec de configuration, vérifiez d'abord ces 4 points

Chaque élément renvoie à un article de dépannage dédié avec des étapes détaillées.

401 Non autorisé
Voir le dépannage détaillé →
En général, la clé API est invalide, mal saisie ou mal lue. Vérifiez que AICODEWITH_API_KEY est définie sans espaces supplémentaires et qu'OpenCode démarre depuis le même terminal.
Modèle introuvable
Voir le dépannage détaillé →
Le Model ID ne correspond pas à la configuration du Provider, ou le canal ne prend pas en charge le modèle. Comparez la paire Model ID et Provider générée caractère par caractère.
Base URL / 404
Voir le dépannage détaillé →
En général, la Base URL est incorrecte. Copiez la valeur générée sur cette page et n'ajoutez pas /v1, /v1beta, et n'inventez pas de chemin d'endpoint.
Configuration non appliquée / Provider manquant
Voir le dépannage détaillé →
Vérifiez le chemin du fichier de configuration, que le JSON est valide, et qu'OpenCode a rechargé le fichier. Rouvrez OpenCode après l'enregistrement, puis exécutez /models.

Questions fréquentes

Quelle doit être la Base URL ?

Copiez la Base URL générée par la configuration rapide ci-dessus. N'ajoutez pas /v1 ou /v1beta manuellement.

Où se trouve le fichier de configuration d'OpenCode ?

Cette page génère ~/.config/opencode/opencode.json. Les chemins peuvent varier selon la méthode d'installation et la version, comparez donc avec la documentation actuelle d'OpenCode.

Comment confirmer que la configuration fonctionne ?

Exécutez /models pour sélectionner le modèle, envoyez un court message, puis faites correspondre la requête par heure et par modèle dans les relevés d'utilisation d'AI Code With.

Quels modèles sont pris en charge ?

Claude, GPT, Gemini, DeepSeek, GLM, Kimi et Grok, entre autres. Cliquez sur « Voir tous les modèles » pour parcourir le catalogue complet.

Besoin de la documentation complète d'installation ou de dépannage ?

Consultez la documentation de configuration d'OpenCode pour les guides d'installation complets, chaque paramètre de configuration, la liste complète des modèles et le dépannage.

Ouvrir la documentation de configuration d'OpenCode