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

> Conecte o OpenCode à Venice por meio de um provedor personalizado compatível com OpenAI para que seu agente de codificação rode em modelos privados da Venice com um único arquivo de configuração.

O [OpenCode](https://opencode.ai/) é um agente de codificação de IA para o terminal. A Venice funciona através da configuração de provedor personalizado do OpenCode, usando o adaptador compatível com OpenAI e uma base URL customizada.

<CardGroup cols={3}>
  <Card title="Provedor personalizado" icon="sliders">
    Adicione a Venice como provedor em `opencode.json`
  </Card>

  <Card title="Compatível com OpenAI" icon="plug">
    Usa o endpoint `/chat/completions` da Venice
  </Card>

  <Card title="Chave via variável de ambiente" icon="key">
    Lê sua chave de API a partir de `VENICE_API_KEY`
  </Card>
</CardGroup>

***

## Pré-requisitos

* Uma chave de API Venice em [venice.ai/settings/api](https://venice.ai/settings/api)
* OpenCode instalado e funcionando na sua máquina

***

## Configuração

<Steps>
  <Step title="Defina sua chave de API Venice">
    Exporte sua chave de API Venice no shell em que você roda o OpenCode:

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

  <Step title="Crie um arquivo de configuração do OpenCode">
    Para uma configuração específica de projeto, crie `opencode.json` na raiz do seu projeto.

    Para uma configuração global, use `~/.config/opencode/opencode.json` em vez disso.
  </Step>

  <Step title="Adicione o provedor Venice">
    Cole esta configuração em `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="Execute o OpenCode">
    Inicie o OpenCode a partir do mesmo diretório do projeto:

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

    O OpenCode carregará `opencode.json`, usará `VENICE_API_KEY` e roteará o modelo Venice selecionado através de `https://api.venice.ai/api/v1`.
  </Step>
</Steps>

***

## Verifique a configuração

Dentro do OpenCode, execute:

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

Você deve ver os modelos Venice da sua configuração. Selecione um e envie um pequeno prompt de teste.

Se definiu `"model": "venice/zai-org-glm-5-1"` como mostrado acima, o OpenCode deve usar esse modelo Venice por padrão. Você pode mudar o padrão substituindo `zai-org-glm-5-1` por qualquer ID de modelo do [catálogo de modelos de texto](/models/text) e adicionando-o ao mapa `models`.

***

## Notas de configuração

* Mantenha `baseURL` definido como `https://api.venice.ai/api/v1`. O adaptador compatível com OpenAI do OpenCode usa essa base URL para chat completions.
* Mantenha `npm` definido como `@ai-sdk/openai-compatible` para o endpoint de chat compatível com OpenAI da Venice.
* O ID do provedor é `venice`, então as referências de modelo usam o formato `venice/<model-id>`.
* Se preferir o fluxo `/connect` do OpenCode, escolha **Other**, use `venice` como o ID do provedor, cole sua chave de API Venice e remova `options.apiKey` da configuração.

<Info>
  O OpenCode já suporta valores `baseURL` customizados de provedor e provedores compatíveis com OpenAI via `@ai-sdk/openai-compatible`. Nenhuma alteração no provedor core do OpenCode é necessária para a Venice.
</Info>

***

## Recursos

<CardGroup cols={2}>
  <Card title="Modelos de texto Venice" icon="list" href="/models/text">
    IDs de modelos Venice disponíveis
  </Card>

  <Card title="Documentação de provedores do OpenCode" icon="book" href="https://opencode.ai/docs/providers/">
    Referência de provedores personalizados e base URL
  </Card>
</CardGroup>