> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-d2fddb8a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenCode

> Connectez OpenCode à Venice via un fournisseur personnalisé compatible OpenAI pour que votre agent de codage s'exécute sur des modèles Venice privés avec un seul fichier de configuration.

[OpenCode](https://opencode.ai/) est un agent de codage IA pour le terminal. Venice fonctionne via la configuration de fournisseur personnalisé d'OpenCode en utilisant l'adaptateur compatible OpenAI et une URL de base personnalisée.

<CardGroup cols={3}>
  <Card title="Fournisseur personnalisé" icon="sliders">
    Ajoutez Venice comme fournisseur dans `opencode.json`
  </Card>

  <Card title="Compatible OpenAI" icon="plug">
    Utilise l'endpoint `/chat/completions` de Venice
  </Card>

  <Card title="Clé d'environnement" icon="key">
    Lit votre clé API depuis `VENICE_API_KEY`
  </Card>
</CardGroup>

***

## Prérequis

* Une clé API Venice depuis [venice.ai/settings/api](https://venice.ai/settings/api)
* OpenCode installé et fonctionnel sur votre machine

***

## Configuration

<Steps>
  <Step title="Définissez votre clé API Venice">
    Exportez votre clé API Venice dans le shell où vous exécutez OpenCode :

    ```bash theme={null}
    export VENICE_API_KEY="your-api-key"
    ```
  </Step>

  <Step title="Créez un fichier de configuration OpenCode">
    Pour une configuration spécifique au projet, créez `opencode.json` à la racine de votre projet.

    Pour une configuration globale, utilisez plutôt `~/.config/opencode/opencode.json`.
  </Step>

  <Step title="Ajoutez le fournisseur Venice">
    Collez cette configuration dans `opencode.json` :

    ```json theme={null}
    {
      "$schema": "https://opencode.ai/config.json",
      "model": "venice/zai-org-glm-5-1",
      "small_model": "venice/zai-org-glm-5-1",
      "provider": {
        "venice": {
          "npm": "@ai-sdk/openai-compatible",
          "name": "Venice AI",
          "options": {
            "baseURL": "https://api.venice.ai/api/v1",
            "apiKey": "{env:VENICE_API_KEY}"
          },
          "models": {
            "zai-org-glm-5-1": {
              "name": "GLM 5.1"
            },
            "kimi-k2-5": {
              "name": "Kimi K2.5"
            },
            "minimax-m25": {
              "name": "MiniMax M2.5"
            }
          }
        }
      }
    }
    ```
  </Step>

  <Step title="Exécutez OpenCode">
    Démarrez OpenCode depuis le même répertoire de projet :

    ```bash theme={null}
    opencode
    ```

    OpenCode chargera `opencode.json`, utilisera `VENICE_API_KEY` et routera le modèle Venice sélectionné via `https://api.venice.ai/api/v1`.
  </Step>
</Steps>

***

## Vérifier la configuration

Dans OpenCode, exécutez :

```txt theme={null}
/models
```

Vous devriez voir les modèles Venice de votre configuration. Sélectionnez-en un, puis envoyez un petit prompt de test.

Si vous définissez `"model": "venice/zai-org-glm-5-1"` comme montré ci-dessus, OpenCode devrait utiliser ce modèle Venice par défaut. Vous pouvez changer le modèle par défaut en remplaçant `zai-org-glm-5-1` par n'importe quel ID de modèle du [catalogue de modèles de texte](/models/text) et en l'ajoutant à la map `models`.

***

## Notes de configuration

* Conservez `baseURL` à `https://api.venice.ai/api/v1`. L'adaptateur compatible OpenAI d'OpenCode utilise cette URL de base pour les chat completions.
* Conservez `npm` à `@ai-sdk/openai-compatible` pour l'endpoint de chat compatible OpenAI de Venice.
* L'ID du fournisseur est `venice`, donc les références de modèle utilisent le format `venice/<model-id>`.
* Si vous préférez le flux `/connect` d'OpenCode, choisissez **Other**, utilisez `venice` comme ID de fournisseur, collez votre clé API Venice et supprimez `options.apiKey` de la configuration.

<Info>
  OpenCode prend déjà en charge les valeurs `baseURL` personnalisées pour les fournisseurs et les fournisseurs compatibles OpenAI via `@ai-sdk/openai-compatible`. Aucune modification du cœur du fournisseur OpenCode n'est requise pour Venice.
</Info>

***

## Ressources

<CardGroup cols={2}>
  <Card title="Modèles de texte Venice" icon="list" href="/models/text">
    ID de modèles Venice disponibles
  </Card>

  <Card title="Docs des fournisseurs OpenCode" icon="book" href="https://opencode.ai/docs/providers/">
    Référence des fournisseurs personnalisés et de l'URL de base
  </Card>
</CardGroup>