火山方舟
火山方舟
订阅 [Agent/Coding Plan]
请输入
- 文档首页
火山方舟Coding Plan 个人版接入 AI 工具OpenCode
复制全文
下载 pdfOpenCode
文档反馈
问问助手OpenCode 是一款开源的 AI 编程代理工具，提供终端界面、桌面应用和 IDE 扩展等多种使用方式。
方舟 Coding Plan 支持在 OpenCode 中使用，可参考本文进行配置及使用。
说明
核心配置
模型配置
支持以下两种方式配置模型：
在工具配置文件中指定 Model Name，可实时切换模型。支持配置的 Model Name：
注意
- doubao-seed-evolving
- doubao-seed-2.1-pro
- doubao-seed-2.1-lite
- doubao-seed-2.0-mini
- glm-5.3 (glm-latest)
- glm-5.3-flash
- deepseek-v4.1-flash
- deepseek-v4.1-flash-economy
- deepseek-v4-flash
- deepseek-v4-pro
- kimi-k2.8-preview
- kimi-k3
- kimi-k3.1-pro
说明
Model Name 不支持配置为 Auto，如需使用，请通过控制台切换该模式。
- 在配置文件中指定模型为ark-code-latest。
- 通过开通管理页面选择或切换目标模型，切换模型后 3-5 分钟即可生效。
- 支持 Auto 模式，通过「效果 + 速度」双维度智能算法自动选择模型。
Base URL
不同的工具配置的 Base URL 根据兼容的协议会有不同：
- 兼容 Anthropic 接口协议工具：https://ark.cn-beijing.volces.com/api/coding
- 兼容 OpenAI 接口协议工具：https://ark.cn-beijing.volces.com/api/coding/v3
注意
请勿使用 https://ark.cn-beijing.volces.com/api/v3 ：该 Base URL 不会消耗您的 Coding Plan 额度，而是会产生额外费用。
API Key
一、安装 OpenCode
在命令行界面，执行以下命令安装 OpenCode。
安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。
二、配置 OpenCode
方式 1：自动化助手（推荐）
ArkCLI Helper 是一个编码工具助手，支持快速配置选择的工具接入 Coding Plan。安装并运行该助手，根据界面提示操作可自动完成工具配置，降低手动配置的时间成本和出错风险。
注意
- ArkCLI Helper 是基于 Ark Helper 升级演进的工具配置服务，相关能力将持续在 ArkCLI Helper 上迭代更新。建议优先使用 ArkCLI Helper 完成工具配置。
- ArkCLI Helper 支持 macOS、Linux、Windows 系统。
- 安装 Ark CLI。
-
- 登录 Ark CLI。
-
-
- 根据界面提示选择登录方式。若之前已登录过 arkcli，会沿用上次选择的配置；如需重新选择，请先执行 arkcli config reset 后再运行 arkcli auth login。首次登录时，按提示完成以下配置：
- 选择项目（Project）：可按需选择，或默认选择账号全部资源。
- 选择消费模式（Type）：选择 coding-plan。
-
- 运行 ArkCLI Helper，根据界面提示完成 OpenCode 的配置。
- 在命令行界面输入 arkcli helper 命令，启动 ArkCLI Helper。
- 选择要配置的 Plan profile：选择 coding-plan_cn-beijing_personal (Coding Plan)。
-
- 选择默认 model：按需选择。
- 选择要配置的 AI Agent：OpenCode。
-
完成上述操作后，将自动完成 OpenCode 的基础配置，无需手动安装。
方式 2：手动配置
- 创建并打开 OpenCode 的配置文件。文件路径因系统而异，具体操作如下：
- macOS/Linux 系统 OpenCode 配置文件路径：~/.config/opencode/opencode.json。
- 如果在主目录下没有.config/opencode目录，执行以下命令创建目录。
-
- 创建并打开配置文件。
-
Windows 系统 OpenCode 配置文件路径：%USERPROFILE%\.config\opencode\opencode.json。以 CMD 命令行方式为例，操作如下。- 如果当前用户目录下没有.config\opencode目录，执行以下命令创建目录。
-
- 创建并打开配置文件。
-
- 编辑 opencode.json，需关注的配置信息如下：
- <ARK_API_KEY>：替换为您自己的 API Key。
- model：更新为需要使用的模型信息。支持的模型信息参见 模型配置。
- Coding Plan 兼容 OpenAI 接口协议，支持 Responses API、Chat API。推荐使用 Responses API 的配置，推理效果更好。
- 支持的两类 API 仅在 npm 配置上不同：
- Responses API 配置："npm": "@ai-sdk/openai"
- Chat API 配置："npm": "@ai-sdk/openai-compatible"
- 以配置ark-code-latest为例，具体信息如下。
注意
- glm-5.3、deepseek-v4-flash、deepseek-v4-pro、kimi-k3.1-pro、kimi-k3、kimi-k2.8-preview 支持 1M 上下文窗口用于包含大型代码库的长会话，可以通过 limit.context 字段显式指定窗口大小。
- provider.volcengine-plan.models节点下有两处（对象键、name字段）需替换为同一 Model Name，切勿遗漏。
- 若需开启模型图片理解能力，需在模型配置节点下新增如下配置项：
"modalities": {"input": ["text", "image"], "output": ["text"]}
说明
npm 必须使用 @ai-sdk/openai，模型才会使用 Responses API，在 baseURL 的基础上自动拼接 /responses。
说明
npm 必须使用 @ai-sdk/openai-compatible，模型才会使用 Chat API，在 baseURL 的基础上自动拼接 /chat/completions。
三、使用 OpenCode
- 启动OpenCode：
-
- 输入/models，选择配置的模型并在 OpenCode 中使用。
常见问题
错误码
最近更新时间：2026.10.28 20:32:46
这个页面对您有帮助吗？
有用
有用
无用
无用