> ## 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

> Usa OpenCode con Venice AI tramite un provider personalizzato compatibile con OpenAI

[OpenCode](https://opencode.ai/) è un agente AI di coding per il terminale. Venice funziona tramite la configurazione del provider personalizzato di OpenCode usando l'adapter compatibile con OpenAI e un base URL personalizzato.

<CardGroup cols={3}>
  <Card title="Provider personalizzato" icon="sliders">
    Aggiungi Venice come provider in `opencode.json`
  </Card>

  <Card title="Compatibile con OpenAI" icon="plug">
    Usa l'endpoint `/chat/completions` di Venice
  </Card>

  <Card title="Chiave da ambiente" icon="key">
    Legge la tua API key da `VENICE_API_KEY`
  </Card>
</CardGroup>

***

## Prerequisiti

* Una API key Venice da [venice.ai/settings/api](https://venice.ai/settings/api)
* OpenCode installato e funzionante sulla tua macchina

***

## Configurazione

<Steps>
  <Step title="Imposta la tua API key Venice">
    Esporta la tua API key Venice nella shell in cui esegui OpenCode:

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

  <Step title="Crea un file di configurazione di OpenCode">
    Per una configurazione specifica del progetto, crea `opencode.json` nella root del tuo progetto.

    Per una configurazione globale, usa invece `~/.config/opencode/opencode.json`.
  </Step>

  <Step title="Aggiungi il provider Venice">
    Incolla questa configurazione in `opencode.json`:

    ```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="Esegui OpenCode">
    Avvia OpenCode dalla stessa directory del progetto:

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

    OpenCode caricherà `opencode.json`, userà `VENICE_API_KEY` e instraderà il modello Venice selezionato tramite `https://api.venice.ai/api/v1`.
  </Step>
</Steps>

***

## Verifica la configurazione

All'interno di OpenCode, esegui:

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

Dovresti vedere i modelli Venice dalla tua configurazione. Selezionane uno, quindi invia un piccolo prompt di prova.

Se hai impostato `"model": "venice/zai-org-glm-5-1"` come mostrato sopra, OpenCode dovrebbe usare quel modello Venice per impostazione predefinita. Puoi cambiare il default sostituendo `zai-org-glm-5-1` con qualsiasi ID di modello del [catalogo dei modelli di testo](/models/text) e aggiungendolo alla mappa `models`.

***

## Note di configurazione

* Mantieni `baseURL` impostato su `https://api.venice.ai/api/v1`. L'adapter OpenAI-compatible di OpenCode usa questo base URL per le chat completion.
* Mantieni `npm` impostato su `@ai-sdk/openai-compatible` per l'endpoint chat compatibile con OpenAI di Venice.
* L'ID del provider è `venice`, quindi i riferimenti ai modelli usano il formato `venice/<model-id>`.
* Se preferisci il flusso `/connect` di OpenCode, scegli **Other**, usa `venice` come ID del provider, incolla la tua API key Venice e rimuovi `options.apiKey` dalla configurazione.

<Info>
  OpenCode supporta già valori `baseURL` personalizzati e provider compatibili con OpenAI tramite `@ai-sdk/openai-compatible`. Non sono richieste modifiche al core dei provider di OpenCode per Venice.
</Info>

***

## Risorse

<CardGroup cols={2}>
  <Card title="Modelli di testo Venice" icon="list" href="/models/text">
    ID dei modelli Venice disponibili
  </Card>

  <Card title="Documentazione provider OpenCode" icon="book" href="https://opencode.ai/docs/providers/">
    Riferimento per provider personalizzati e base URL
  </Card>
</CardGroup>