---
title: OpenCode
description: 为 OpenCode 添加 VC 自定义服务商，配置 API Key、接口地址和文本模型。
---

OpenCode 可以通过自定义 Provider 接入 VC。选择支持 Chat Completions 和工具调用的文本模型分组。

## 安装与准备

从 [OpenCode 官方下载页](https://opencode.ai/download)安装当前版本，运行 `opencode --version` 确认命令可用。

在启动 OpenCode 的终端设置密钥：

<CodeGroup>
```bash macOS / Linux
export VC_API_KEY="YOUR_VC_API_KEY"
```
```powershell Windows PowerShell
$env:VC_API_KEY="YOUR_VC_API_KEY"
```
</CodeGroup>

## 添加项目配置

在项目根目录创建 `opencode.json`。已有文件时合并服务商配置，保留其他设置。将两处 `YOUR_MODEL_ID` 替换成同一个可用模型 ID。

```json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "vc/YOUR_MODEL_ID",
  "providers": {
    "vc": {
      "name": "VC",
      "env": ["VC_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://sub.vcnovb.cn/v1"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "VC 编程模型"
        }
      }
    }
  }
}
```

`vc/` 是 OpenCode 的服务商前缀，后半部分才是 VC 接口使用的模型 ID。配置不会将密钥写入项目文件。

## 选择模型

在项目目录运行 `opencode`，输入 `/models`，选择 VC 下的模型，发送一个简单问题。然后尝试让它读取 README。

## 已有配置如何处理

VC 密钥使用说明也提供 OpenCode 配置。已有 `provider` / `options` 格式的配置时，可以继续按其对应版本使用；上面的配置使用当前官方 `providers` / `settings` 格式。不要将两种结构混写在同一个服务商条目中。

## 常见问题

- **无法识别 providers 字段**：更新 OpenCode，或使用密钥页面提供的对应版本配置。
- **模型列表没有 VC**：检查项目文件名、JSON 格式、模型 ID 和 `VC_API_KEY`，重启 OpenCode。
- **模型能聊天但无法执行工具**：选择支持工具调用的文本模型。

更多配置见 [OpenCode 官方服务商说明](https://opencode.ai/docs/providers/)。