在OpenCode中对接火山引擎

本文档介绍如何在 OpenCode 中配置和对接火山引擎（Volcengine）的 API 服务及 CodingPlan。

# 1. 对接 API 使用#

火山引擎 API 提供免费额度供开发者使用。由于 OpenCode 官方暂未直接对接火山引擎方舟服务，我们需要手动修改配置文件。

## 修改配置文件#

编辑你的 OpenCode 配置文件：

bash
vim ~/.config/opencode.jsonc

添加以下配置：

json
1{
2  "$schema": "https://opencode.ai/config.json",
3  "provider": {
4    "volcengine-ark-api": {
5      "npm": "@ai-sdk/openai-compatible",
6      "name": "volcengine-api",
7      "options": {
8        "baseURL": "https://ark.cn-beijing.volces.com/api/v3",
9        "apiKey": "${your_api_key}"
10      },
11      "models": {
12        "deepseek-v3-2-251201": {
13          "name": "deepseek32-va-api" 
14        },
15        "glm-4-7-251222": {
16          "name": "glm-4.7"
17        },
18        "doubao-seed-1-8-251228": {
19          "name": "doubao-seed-1.8"
20        }
21      }
22    }
23  }
24}

注意：

deepseek-v3-2-251201 等 key 是模型 ID，不能修改。

name 字段可以修改，仅用于显示。

上述配置列出了常用的 3 种模型，每种都有 50w token 的体验额度，不算多，仅够体验。如果需要其他模型，请访问模型广场↗，鼠标指向模型，复制 ModelId 作为 key 即可使用。

# 2. 开通 CodingPlan 使用#

豆包 CodingPlan 首月优惠（最低 8.9 元），可以使用 doubaoseed、deepseek、glm4.7 等多种模型。次月恢复原价 40 元，可以看首月使用情况决定是否续费（GLM 那边也有首月优惠 20 元）。

开通地址：火山引擎 CodingPlan↗ (邀请码：RWYPVFMZ)
官方文档：接入 OpenCode 指南↗

## 注意事项#

配置 CodingPlan 时，请注意与标准 API 的区别：

baseURL 不同：需要使用 CodingPlan 专用的 URL。
模型指定：模型 key 必须使用 ark-code-latest。这是一个"外壳"，实际使用的模型需要在网页端配置。

重要提示：开通 CodingPlan 后，请务必前往网页端控制台↗选择你要使用的模型。默认可能是 Auto，推荐手动选择 Doubao-Seed-2.0-Code、Kimi K2.5 或者 Deepseek v3.2。

## 配置示例#

json
1{
2  "$schema": "https://opencode.ai/config.json",
3  "provider": {
4    "myprovider": {
5      "npm": "@ai-sdk/openai-compatible",
6      "name": "volcengine",
7      "options": {
8        "baseURL": "https://ark.cn-beijing.volces.com/api/coding/v3",
9        "apiKey": "${your_api_key}"
10      },
11      "models": {
12        // 模型就只用这个，不要改
13        "ark-code-latest": {
14          "name": "ark-code-latest"
15        }
16      }
17    }
18  }
19}