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

# OpenCode

> OpenCode mit Venice AI über einen OpenAI-kompatiblen Custom Provider verwenden

[OpenCode](https://opencode.ai/) ist ein KI-Coding-Agent fürs Terminal. Venice funktioniert über die Custom-Provider-Konfiguration von OpenCode mit dem OpenAI-kompatiblen Adapter und einer eigenen Base URL.

<CardGroup cols={3}>
  <Card title="Custom Provider" icon="sliders">
    Venice als Provider in `opencode.json` hinzufügen
  </Card>

  <Card title="OpenAI-kompatibel" icon="plug">
    Verwendet Venices `/chat/completions`-Endpoint
  </Card>

  <Card title="Umgebungs-Key" icon="key">
    Liest deinen API-Schlüssel aus `VENICE_API_KEY`
  </Card>
</CardGroup>

***

## Voraussetzungen

* Ein Venice API-Schlüssel von [venice.ai/settings/api](https://venice.ai/settings/api)
* OpenCode installiert und einsatzbereit auf deinem Rechner

***

## Einrichtung

<Steps>
  <Step title="Venice API-Schlüssel setzen">
    Exportiere deinen Venice API-Schlüssel in der Shell, in der du OpenCode ausführst:

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

  <Step title="OpenCode-Konfigurationsdatei erstellen">
    Für ein projekt-spezifisches Setup erstelle `opencode.json` im Projekt-Root.

    Für ein globales Setup verwende stattdessen `~/.config/opencode/opencode.json`.
  </Step>

  <Step title="Venice-Provider hinzufügen">
    Füge folgende Konfiguration in `opencode.json` ein:

    ```json theme={"system"}
    {
      "$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="OpenCode starten">
    Starte OpenCode aus demselben Projektverzeichnis:

    ```bash theme={"system"}
    opencode
    ```

    OpenCode lädt `opencode.json`, verwendet `VENICE_API_KEY` und routet das ausgewählte Venice-Modell über `https://api.venice.ai/api/v1`.
  </Step>
</Steps>

***

## Setup überprüfen

Führe in OpenCode aus:

```txt theme={"system"}
/models
```

Du solltest die in deiner Konfiguration definierten Venice-Modelle sehen. Wähle eines aus und sende einen kleinen Test-Prompt.

Wenn du wie oben `"model": "venice/zai-org-glm-5-1"` gesetzt hast, sollte OpenCode dieses Venice-Modell standardmäßig verwenden. Du kannst den Default ändern, indem du `zai-org-glm-5-1` durch eine andere Modell-ID aus dem [Textmodell-Katalog](/models/text) ersetzt und sie in die `models`-Map aufnimmst.

***

## Konfigurations-Hinweise

* Belasse `baseURL` auf `https://api.venice.ai/api/v1`. OpenCodes OpenAI-kompatibler Adapter verwendet diese Base URL für Chat-Completions.
* Belasse `npm` auf `@ai-sdk/openai-compatible` für Venices OpenAI-kompatiblen Chat-Endpoint.
* Die Provider-ID ist `venice`, deshalb verwenden Modell-Referenzen das Format `venice/<model-id>`.
* Bevorzugst du OpenCodes `/connect`-Flow, wähle **Other**, verwende `venice` als Provider-ID, füge deinen Venice API-Schlüssel ein und entferne `options.apiKey` aus der Konfiguration.

<Info>
  OpenCode unterstützt bereits Custom-Provider-`baseURL`-Werte und OpenAI-kompatible Provider über `@ai-sdk/openai-compatible`. Es sind keine Änderungen am OpenCode-Core-Provider für Venice nötig.
</Info>

***

## Ressourcen

<CardGroup cols={2}>
  <Card title="Venice Textmodelle" icon="list" href="/models/text">
    Verfügbare Venice-Modell-IDs
  </Card>

  <Card title="OpenCode-Provider-Doku" icon="book" href="https://opencode.ai/docs/providers/">
    Custom-Provider- und Base-URL-Referenz
  </Card>
</CardGroup>