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

# OpenCode

> 通过兼容 OpenAI 的自定义提供商将 OpenCode 与 Venice AI 配合使用

[OpenCode](https://opencode.ai/) 是一款用于终端的 AI 编码 agent。Venice 通过 OpenCode 的自定义提供商配置工作，使用 OpenAI 兼容的适配器和自定义的 base URL。

<CardGroup cols={3}>
  <Card title="自定义提供商" icon="sliders">
    在 `opencode.json` 中将 Venice 添加为提供商
  </Card>

  <Card title="OpenAI 兼容" icon="plug">
    使用 Venice 的 `/chat/completions` 端点
  </Card>

  <Card title="环境变量密钥" icon="key">
    从 `VENICE_API_KEY` 读取您的 API 密钥
  </Card>
</CardGroup>

***

## 前置条件

* 来自 [venice.ai/settings/api](https://venice.ai/settings/api) 的 Venice API 密钥
* 已在您的机器上安装并可正常使用的 OpenCode

***

## 设置

<Steps>
  <Step title="设置您的 Venice API 密钥">
    在运行 OpenCode 的 shell 中导出您的 Venice API 密钥：

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

  <Step title="创建 OpenCode 配置文件">
    对于项目专属设置，在项目根目录创建 `opencode.json`。

    对于全局设置，改用 `~/.config/opencode/opencode.json`。
  </Step>

  <Step title="添加 Venice 提供商">
    将以下配置粘贴到 `opencode.json`：

    ```json theme={"dark"}
    {
      "$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">
    从同一项目目录启动 OpenCode：

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

    OpenCode 将加载 `opencode.json`，使用 `VENICE_API_KEY`，并通过 `https://api.venice.ai/api/v1` 路由所选的 Venice 模型。
  </Step>
</Steps>

***

## 验证设置

在 OpenCode 中运行：

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

您应该会看到配置中的 Venice 模型。选择一个，然后发送一个小的测试 prompt。

如果您像上面那样设置 `"model": "venice/zai-org-glm-5-1"`，OpenCode 应默认使用该 Venice 模型。您可以将 `zai-org-glm-5-1` 替换为[文本模型目录](/models/text)中任意模型 ID，并将其添加到 `models` 映射中，以更改默认模型。

***

## 配置说明

* 将 `baseURL` 保持为 `https://api.venice.ai/api/v1`。OpenCode 的 OpenAI 兼容适配器将此 base URL 用于 chat completions。
* 将 `npm` 保持为 `@ai-sdk/openai-compatible`，用于 Venice 的 OpenAI 兼容聊天端点。
* 提供商 ID 是 `venice`，因此模型引用使用 `venice/<model-id>` 格式。
* 如果您更倾向于使用 OpenCode 的 `/connect` 流程，选择 **Other**，使用 `venice` 作为提供商 ID，粘贴您的 Venice API 密钥，并从配置中删除 `options.apiKey`。

<Info>
  OpenCode 已通过 `@ai-sdk/openai-compatible` 支持自定义提供商 `baseURL` 值和 OpenAI 兼容提供商。Venice 无需对 OpenCode 核心提供商进行任何更改。
</Info>

***

## 资源

<CardGroup cols={2}>
  <Card title="Venice 文本模型" icon="list" href="/models/text">
    可用的 Venice 模型 ID
  </Card>

  <Card title="OpenCode 提供商文档" icon="book" href="https://opencode.ai/docs/providers/">
    自定义提供商和 base URL 参考
  </Card>
</CardGroup>