> ## 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 mediante un proveedor personalizado compatible con OpenAI

[OpenCode](https://opencode.ai/) es un agente de programación con IA para el terminal. Venice funciona a través de la configuración de proveedor personalizado de OpenCode utilizando el adaptador compatible con OpenAI y una URL base personalizada.

<CardGroup cols={3}>
  <Card title="Proveedor personalizado" icon="sliders">
    Añade Venice como proveedor en `opencode.json`
  </Card>

  <Card title="Compatible con OpenAI" icon="plug">
    Utiliza el endpoint `/chat/completions` de Venice
  </Card>

  <Card title="Clave por entorno" icon="key">
    Lee tu API key desde `VENICE_API_KEY`
  </Card>
</CardGroup>

***

## Requisitos previos

* Una API key de Venice desde [venice.ai/settings/api](https://venice.ai/settings/api)
* OpenCode instalado y funcionando en tu máquina

***

## Configuración

<Steps>
  <Step title="Configura tu API key de Venice">
    Exporta tu API key de Venice en el shell donde ejecutas OpenCode:

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

  <Step title="Crea un archivo de configuración de OpenCode">
    Para una configuración específica del proyecto, crea `opencode.json` en la raíz de tu proyecto.

    Para una configuración global, usa `~/.config/opencode/opencode.json` en su lugar.
  </Step>

  <Step title="Añade el proveedor de Venice">
    Pega esta configuración en `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="Ejecuta OpenCode">
    Inicia OpenCode desde el mismo directorio del proyecto:

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

    OpenCode cargará `opencode.json`, usará `VENICE_API_KEY` y enrutará el modelo de Venice seleccionado a través de `https://api.venice.ai/api/v1`.
  </Step>
</Steps>

***

## Verifica la configuración

Dentro de OpenCode, ejecuta:

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

Deberías ver los modelos de Venice de tu configuración. Selecciona uno y envía un pequeño prompt de prueba.

Si estableces `"model": "venice/zai-org-glm-5-1"` como se muestra arriba, OpenCode debería usar ese modelo de Venice por defecto. Puedes cambiar el predeterminado sustituyendo `zai-org-glm-5-1` por cualquier ID de modelo del [catálogo de modelos de texto](/models/text) y añadiéndolo al mapa `models`.

***

## Notas de configuración

* Mantén `baseURL` en `https://api.venice.ai/api/v1`. El adaptador compatible con OpenAI de OpenCode utiliza esta URL base para chat completions.
* Mantén `npm` en `@ai-sdk/openai-compatible` para el endpoint de chat compatible con OpenAI de Venice.
* El ID del proveedor es `venice`, por lo que las referencias a modelos usan el formato `venice/<model-id>`.
* Si prefieres el flujo `/connect` de OpenCode, elige **Other**, usa `venice` como ID del proveedor, pega tu API key de Venice y elimina `options.apiKey` de la configuración.

<Info>
  OpenCode ya admite valores personalizados de `baseURL` para proveedores y proveedores compatibles con OpenAI a través de `@ai-sdk/openai-compatible`. No se requieren cambios en el proveedor núcleo de OpenCode para Venice.
</Info>

***

## Recursos

<CardGroup cols={2}>
  <Card title="Modelos de texto de Venice" icon="list" href="/models/text">
    IDs de modelo disponibles de Venice
  </Card>

  <Card title="Docs de proveedor de OpenCode" icon="book" href="https://opencode.ai/docs/providers/">
    Referencia de proveedor personalizado y URL base
  </Card>
</CardGroup>