OpenCode 是一款开源的 AI 编程代理工具，提供终端界面、桌面应用和 IDE 扩展等多种使用方式。方舟 Coding Plan 支持在 OpenCode 中使用，可参考本文进行配置及使用。 :::tip 需要先访问[方舟 Coding Plan活动](https://www.volcengine.com/activity/codingplan)，按需订阅套餐后再配置使用编程工具。 ::: # 核心配置接入工具的核心参数如下： ## **模型配置** 支持以下两种方式配置模型： \`\`\`mixin-react return ( ); \`\`\` ## **Base URL** 不同的工具配置的 Base URL 根据兼容的协议会有不同： * 兼容 Anthropic 接口协议工具：\`https://ark.cn-beijing.volces.com/api/coding\` * 兼容 OpenAI 接口协议工具：\`https://ark.cn-beijing.volces.com/api/coding/v3\`（目前还不支持 Responses API，建议使用 Chat API。） :::warning 请勿使用 \`https://ark.cn-beijing.volces.com/api/v3\` ：该 Base URL 不会消耗您的 Coding Plan 额度，而是会产生额外费用。 ::: ## **API Key** [获取 API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) # 安装步骤前提条件：安装 [Node.js 18 或更新版本](https://nodejs.org/en/download/)。在命令行界面，执行以下命令安装 OpenCode。 ```Bash npm install -g opencode-ai ``` 安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。 ```Bash opencode --version ``` # 配置工具 ## 方式一：自动化助手（推荐） Ark Helper 是一个编码工具助手，支持快速配置选择的工具接入 Coding Plan。安装并运行该助手，根据界面提示操作可自动完成工具配置，降低手动配置的时间成本和出错风险。 :::warning * Ark Helper 仅支持 MacOS、Linux 系统，暂不支持 Windows 系统。 * 以下配置步骤及截图为 Ark Helper 首次使用指引；非首次使用请按界面提示完成套餐配置和工具配置。 ::: 1. 执行以下命令安装 Ark Helper。 ```Bash curl -fsSL https://lf3-static.bytednsdoc.com/obj/eden-cn/ylwslo-yrh/ljhwZthlaukjlkulzlp/install.sh | sh ``` 安装完成后，执行以下命令查看安装的版本号。 ```Bash ark-helper --version ``` 2. 在命令行界面输入`ark-helper`命令，启动 Ark Helper。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/802e66e79f864ceeaba2d05250f1c743~tplv-goo7wpa0wc-image.image =399x) 3. 根据界面提示完成套餐配置。 1. 选择要配置的套餐：`[Volcano] Volcano Engine（国内）`。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6a68961ee782408ca485dff07b2fcfb5~tplv-goo7wpa0wc-image.image =235x) 2. 配置 API Key： [获取 API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey)。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0f327801346548e49580aff3fbfe9c0f~tplv-goo7wpa0wc-image.image =379x) ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0d49b2af47294daba8a5e2c86f2c706c~tplv-goo7wpa0wc-image.image =363x) 3. 选择默认模型。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a9a13add5808465bb8c27d6518623916~tplv-goo7wpa0wc-image.image =245x) 4. 根据界面提示完成 OpenCode 工具配置。 1. 选择要配置的编码工具：`OpenCode`。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/8ade34d1600a47e0b79611ba26a9eb51~tplv-goo7wpa0wc-image.image =230x) 2. 选择`设置 Volcano 配置到 OpenCode`，配置完成后，选择`退出`。如果需要重新配置工具，可先选择`卸载 OpenCode 配置`，再重新执行配置流程。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3ef01dcda4684c97a748f69acb95e988~tplv-goo7wpa0wc-image.image =283x) ## 方式二：手动配置编辑 OpenCode 的配置文件，路径如下： * macOS / Linux：`~/.config/opencode/opencode.json` * Windows：`C:\Users\您的用户名\.config\opencode\opencode.json` 需要修改的配置信息如下： * ``：替换为您自己的 [API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey)。 * `model`：更新为需要使用的模型信息。支持的模型信息参见[模型配置](/docs/82379/2188958#3a775131)。以配置`ark-code-latest`为例，具体信息如下。 :::warning * `provider.volcengine-plan.models`节点下有**两处**（对象键、`name`字段）需**替换为同一 Model Name**，切勿遗漏。 * 若需开启模型图片理解能力，需在模型配置节点下新增如下配置项： `"modalities": {"input": ["text", "image"], "output": ["text"]}` ::: ```JSON { "$schema": "https://opencode.ai/config.json", "model": "volcengine-plan/ark-code-latest", "provider": { "volcengine-plan": { "npm": "@ai-sdk/openai-compatible", "name": "Volcano Engine", "options": { "baseURL": "https://ark.cn-beijing.volces.com/api/coding/v3", "apiKey": "" }, "models": { "ark-code-latest": { "name": "ark-code-latest", "limit": { "context": 256000, "output": 4096 }, "modalities": { "input": [ "text", "image" ], "output": [ "text" ] } }, "doubao-seed-code": { "name": "doubao-seed-code", "limit": { "context": 256000, "output": 4096 }, "modalities": { "input": [ "text", "image" ], "output": [ "text" ] } }, "glm-4.7": { "name": "glm-4.7", "limit": { "context": 200000, "output": 4096 }, "modalities": { "input": [ "text" ], "output": [ "text" ] } }, "deepseek-v3.2": { "name": "deepseek-v3.2", "limit": { "context": 128000, "output": 4096 } }, "doubao-seed-2.0-code": { "name": "doubao-seed-2.0-code", "limit": { "context": 256000, "output": 4096 }, "modalities": { "input": [ "text", "image" ], "output": [ "text" ] } }, "doubao-seed-2.0-pro": { "name": "doubao-seed-2.0-pro", "limit": { "context": 256000, "output": 4096 }, "modalities": { "input": [ "text", "image" ], "output": [ "text" ] } }, "doubao-seed-2.0-lite": { "name": "doubao-seed-2.0-lite", "limit": { "context": 256000, "output": 4096 }, "modalities": { "input": [ "text", "image" ], "output": [ "text" ] } }, "minimax-m2.5": { "name": "minimax-m2.5", "limit": { "context": 200000, "output": 4096 }, "modalities": { "input": [ "text" ], "output": [ "text" ] } }, "kimi-k2.5": { "name": "kimi-k2.5", "limit": { "context": 256000, "output": 4096 }, "modalities": { "input": [ "text", "image" ], "output": [ "text" ] } } } } } } ``` # 开始使用 1. 启动OpenCode： ```Shell opencode ``` 2. 输入`/models`，选择配置的模型并在 OpenCode 中使用。 # 常见问题 * [OpenCode 如何开启深度思考模式？](/docs/82379/2165245#1cfacd2b) * [如何升级 Ark Helper？](/docs/82379/2165245#7bdd6584) * [如何卸载 Ark Helper？](/docs/82379/2165245#e2f455fc) # 错误码在编程工具中使用 Coding Plan 套餐时可能会遇到报错，您可以根据错误信息查看对应的报错场景并定位问题，具体可参考[错误码](/docs/82379/1299023)。

火山方舟