方舟 API 兼容 OpenAI 和 Anthropic 接口协议，支持在三方工具中使用，可参考本文进行配置及使用。 :::warning 对于个人开发场景，推荐订阅 [Coding Plan 套餐](https://www.volcengine.com/activity/codingplan)，接入教程参见 [快速开始](/docs/82379/1928261)。 ::: # **关于方舟 Coding Plan** ## **方舟 Coding Plan 优势** 方舟 Coding Plan 是为开发者量身打造的 AI Coding 场景订阅服务，不仅支持主流大语言模型，还支持 Embedding 向量化模型，大幅提升开发者代码编写的效率与质量。 ## **方舟 Coding Plan VS 方舟 API 调用** * 计费方式 |接入方式 |方舟 Coding Plan |方舟 API 调用 | |---|---|---| |计费方式 |订阅 Coding Plan 套餐，详见[套餐详情](/docs/82379/1925114#6e51df70)。|按 Token 用量后付费 |\\ | |:::tip| |\\ | |套餐优惠定价，token 单价更低，性价比高。| |\\ | || |\\ | |:::| | * 核心配置两种方式在支持模型、Base URL 上存在差异，配置时需注意区分。 |接入方式 ||方舟 Coding Plan |方舟 API 调用 | |---|---|---|---| |支持模型 ||配置为：ark\\-code\\-latest。|* 兼容 Anthropic 接口协议（如 Claude Code）：支持 Doubao\\-Seed\\-Code、Doubao\\-Seed\\-1.8、GLM\\-4.7、DeepSeek\\-V3.2。|\\ | | |在[开通管理页面](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=subscribe)支持选择或切换模型。支持模型参见[支持的模型](/docs/82379/1925114#51b87c17)。 |* 兼容 OpenAI 接口协议（如 OpenCode、Cline 等）：支持所有语言模型，可按需选择。 | |Base URL |兼容 Anthropic 接口协议 |\`https://ark.cn-beijing.volces.com/api/coding\` |\`https://ark.cn-beijing.volces.com/api/compatible\` | |^^|兼容 OpenAI 接口协议 |\`https://ark.cn-beijing.volces.com/api/coding/v3\` |\`https://ark.cn-beijing.volces.com/api/v3\` | # 生态兼容为了满足开发者对 OpenAI API 和 Anthropic API 生态的使用需求，方舟 API 新增了对两类接口格式的适配支持，全面兼容主流大模型接口规范及相关工具生态。开发者无需修改核心代码，仅需切换 Base URL 与 API Key，即可实现跨平台模型调用与工具集成。在配置三方工具时，需要配置的 Base URL 信息见下表。 |接口协议 |Base URL |适用工具 | |---|---|---| |兼容 Anthropic 接口协议 |`https://ark.cn-beijing.volces.com/api/compatible` |Claude Code | |兼容 OpenAI 接口协议 |`https://ark.cn-beijing.volces.com/api/v3` |Chatbox、Cherry Studio、OpenClaw（原 Clawdbot）、TRAE、Cline、Cursor、Kilo Code、Roo Code、OpenCode 等。 | :::tip 在配置工具前，需要[开通所需的模型服务](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false)。 ::: # 接入 Chatbox ## 安装步骤通过 [Chatbox 官网](https://chatboxai.app/zh)下载并安装合适的版本，或直接**启动网页版**。 ## 配置工具打开 Chatbox 进入 Settings 页面。 1. 在 Model Provider 中单击添加提供商，其中 **API Mode** 选择 `OpenAI API Compatible`。 2. 提供商添加成功后，配置以下信息。 * **API Key**：[获取API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) * **API Host**：`https://ark.cn-beijing.volces.com/api/v3` * **API Path**：`/chat/completions` * **Model**：[选择模型并获取 Model ID](https://www.volcengine.com/docs/82379/1330310#b318deb2) 配置完成后，就可以在输入框中输入需求，与模型进行交互。 # 接入 Cherry Studio ## 安装步骤通过 [Cherry Studio 官网](https://www.cherry-ai.com/)下载并安装 Cherry Studio 客户端。 ## 配置工具打开 Cherry Studio 客户端，进入设置页面。 1. 在模型服务中点击添加提供商，其中**提供商类型**选择 `OpenAI`。 2. 提供商添加成功后，配置以下信息。 * **API 密钥**：[获取API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) * **API 地址**：`https://ark.cn-beijing.volces.com/api/v3` * **模型**：点击添加模型，填写要使用的[模型 ID](https://www.volcengine.com/docs/82379/1330310#b318deb2) 配置完成后，就可以在输入框中输入需求，与模型进行交互。 # 接入 Claude Code :::warning 对于个人开发场景，推荐订阅 [Coding Plan 套餐](https://www.volcengine.com/activity/codingplan)，接入教程参见 [Claude Code](/docs/82379/1928262)。 ::: ## 安装步骤前提条件： * 安装 [Node.js 18 或更新版本环境](https://nodejs.org/en/download/)。 * Windows 用户需安装 [Git for Windows](https://git-scm.com/download/win)。在命令行界面，执行以下命令安装 Claude Code。 ```Bash npm install -g @anthropic-ai/claude-code ``` 安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。 ```Bash claude --version ``` ## 配置工具完成Claude Code安装后，配置以下信息。 * **ANTHROPIC_BASE_URL**：`https://ark.cn-beijing.volces.com/api/compatible` * **ANTHROPIC_AUTH_TOKEN**：[获取API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) * **ANTHROPIC_MODEL**: 支持的模型 doubao\-seed\-1\-8\-251228、glm\-4\-7\-251222、doubao\-seed\-code\-preview\-251028、deepseek\-v3\-2\-251201。配置步骤如下： 1. 编辑或新增 `settings.json` 文件，需要替换配置信息中的以下信息： * ``：替换为 [API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey)。 * ``：替换为上述支持的模型名称，如 glm\-4\-7\-251222。 :::tip 不同系统配置文件路径不同，具体如下： * MacOS & Linux：`~/.claude/settings.json` * Windows：`C:\Users\<用户名>\.claude\settings.json` ::: ```JSON { "env": { "ANTHROPIC_AUTH_TOKEN": "", "ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/compatible", "ANTHROPIC_MODEL": "" } } ``` 2. 编辑或新增 `.claude.json` 文件，修改或新增 `hasCompletedOnboarding` 字段值为 true。 :::tip 不同系统配置文件路径不同，具体如下： * MacOS & Linux：`~/.claude.json` * Windows：`C:\Users\<用户名>\.claude.json` ::: ```JSON { "hasCompletedOnboarding": true } ``` 保存配置文件后，在新的终端窗口执行后续命令。 ## 使用 Claude Code * 启动Claude Code：进入项目目录，执行`claude`命令，即可开始使用Claude Code。 ```Bash cd my-project claude ``` * 模型状态验证：输入`/status`确认模型状态。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/88d72ac928024768928848a622755b6b~tplv-goo7wpa0wc-image.image =867x) ## 使用 Claude Code IDE 插件 1. 安装 Claude Code 并配置好环境变量，具体参考[接入Claude Code](/docs/82379/695a0060a7383b0543d7f081#a4bd3115)。 Claude Code IDE 插件依赖 Claude Code CLI 工具，需先完成 Claude Code的安装及配置。 2. 安装并使用 IDE 插件。 > 因 IDE 插件会迭代演进，以下内容仅供参考，具体的安装及使用可参考 [Visual Studio Code](https://code.claude.com/docs/en/vs-code)、[JetBrains IDEs](https://code.claude.com/docs/en/jetbrains)。 ```mixin-react return ( ### 安装插件打开 VSCode，在扩展市场搜索\`claude code\`进行安装。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6c39c8cb4ec84f03bb0ca2444804eac7~tplv-goo7wpa0wc-image.image =1202x) ### 配置环境变量 1. 安装完成后，点击 VSCode 右上角的 Claude Code 图标，进入 Claude Code 页面。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/388665c0f9ed47379faa5291e180a6b2~tplv-goo7wpa0wc-image.image =1738x) 2. 在对话框中输入 \`/config\`回车进入 settings 配置页面。 3. 在 **Claude Code: Environment Variables** 区域单击 **Edit in settings.json**，修改\`claudeCode.environmentVariables\`、\`claudeCode.selectedModel\`。 :::tip 需要替换配置信息中的以下信息： * \`\`：替换为 [API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey)。 * \`\`：替换为上述支持的模型名称，如 glm\\-4\\-7\\-251222。 ::: \`\`\`JSON ... "claudeCode.environmentVariables": [ \{ "name": "ANTHROPIC_BASE_URL", "value": "https://ark.cn-beijing.volces.com/api/compatible" \}, \{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "" \}, \{ "name": "ANTHROPIC_MODEL", "value": "" \} ], "claudeCode.selectedModel": "", ... \`\`\` 保存配置信息后，即可开始使用 Claude Code。 `}> ### 安装插件打开 Jetbrains IDE，在插件市场搜索\`claude code\`进行安装。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5859916985a34036bb41f5097ba58f6c~tplv-goo7wpa0wc-image.image =2334x) ### 开始使用安装完成后，重启IDE后，单击Claude Code 图标，进入 Claude Code 页面开始使用。 `}>); ``` # 接入 OpenCode :::warning 对于个人开发场景，推荐订阅 [Coding Plan 套餐](https://www.volcengine.com/activity/codingplan)，接入教程参见 [OpenCode](/docs/82379/2188958)。 ::: ## 安装步骤在命令行界面，执行以下命令安装 OpenCode。 ```Bash npm install -g opencode-ai ``` 安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。 ```Bash opencode --version ``` ## 配置工具 1. 编辑OpenCode的配置文件`~/.config/opencode/opencode.json`。以配置模型`doubao-seed-code-preview-251028`为例，配置信息如下。 :::tip * 替换配置信息中的[](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey)。 * 按需选择模型并获取 [Model ID](https://www.volcengine.com/docs/82379/1330310#b318deb2)。 ::: ```JSON { "$schema": "https://opencode.ai/config.json", "provider": { "myprovider": { "npm": "@ai-sdk/openai-compatible", "name": "volcengine", "options": { "baseURL": "https://ark.cn-beijing.volces.com/api/v3", "apiKey": "" }, "models": { "doubao-seed-code-preview-251028": { "name": "doubao-seed-code-preview-251028" } } } } } ``` ## 开始使用 1. 启动OpenCode： ```Shell opencode ``` 2. 输入`/models`，选择配置的`doubao-seed-code-preview-251028`模型并在 OpenCode 中使用。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7dbba85371b14b998a8ab8324e8d8bd2~tplv-goo7wpa0wc-image.image =502x) # 接入 OpenClaw（原 Clawdbot） :::warning 对于个人开发场景，推荐订阅 [Coding Plan 套餐](https://www.volcengine.com/activity/codingplan)，接入教程参见 [OpenClaw (原 Clawdbot)](/docs/82379/2183190)。 ::: ## 安装步骤 1. 执行以下命令安装 OpenClaw。 ```mixin-react return ( ); ``` 2. 根据提示信息完成 Moltbot 配置，参考配置如下。 |提示信息 |配置 | |---|---| |I understand this is powerful and inherently risky. Continue? |选择 "Yes" | |Onboarding mode |选择 “QuickStart” | |Model/auth provider |选择 "Skip for now"，后续可以配置。 | |Filter models by provider |选择 "All providers" | |Default model |使用默认配置 | |Select channel (QuickStart) |选择 “Skip for now”，后续可以配置。 | |Configure skills now? (recommended) |选择 “No”，后续可以配置。 | |Enable hooks? |按空格键选中选项，按回车键进入下一步。|\ | |![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ead19a3a5d0f49538b6289594fcccf90~tplv-goo7wpa0wc-image.image =603x) | |How do you want to hatch your bot? |选择 "Hatch in TUI"。|\ | |![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/69295ee8ade64371abcfa6729414d4a4~tplv-goo7wpa0wc-image.image =351x) | ## 配置工具 ### 查看配置信息 ```mixin-react return ( ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/8d500ec5582c407dae56ddb5f6034738~tplv-goo7wpa0wc-image.image =2940x) `}> ); ``` ### 修改配置信息可以参考以下配置内容，其中需要修改的核心配置信息如下： * baseUrl：`https://ark.cn-beijing.volces.com/api/v3` * apiKey：[获取API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) * models：[选择模型并获取 Model ID](https://www.volcengine.com/docs/82379/1330310#b318deb2) ```JSON { "meta": { "lastTouchedVersion": "2026.1.24-3", "lastTouchedAt": "2026-01-27T08:01:28.453Z" }, "wizard": { "lastRunAt": "2026-01-27T07:34:55.069Z", "lastRunVersion": "2026.1.24-3", "lastRunCommand": "onboard", "lastRunMode": "local" }, "auth": { "profiles": { // Authentication configuration information "volcengine:default": { "provider": "volcengine", "mode": "api_key" } } }, "models": { "providers": { "volcengine": { "baseUrl": "https://ark.cn-beijing.volces.com/api/v3", // Base URL for Coding Plan "apiKey": "", // Replace with the actual API KEY "api": "openai-completions", "models": [ // Model supported by Coding Plan { "id": "doubao-seed-1-8-251228", "name": "doubao-seed-1-8-251228" } ] } } }, "agents": { "defaults": { // Model information "model": { "primary": "volcengine/doubao-seed-1-8-251228" }, "models": { "volcengine/doubao-seed-1-8-251228": { "alias": "volcengine" } }, "workspace": "/Users/*****/clawd", // Pay attention to path permissions for MacOS and Windows "compaction": { "mode": "safeguard" }, "maxConcurrent": 4, "subagents": { "maxConcurrent": 8 } } }, "messages": { "ackReactionScope": "group-mentions" }, "commands": { "native": "auto", "nativeSkills": "auto" }, "hooks": { "internal": { "enabled": true, "entries": { "command-logger": { "enabled": true }, "session-memory": { "enabled": true } } } }, "gateway": { "port": 18789, "mode": "local", "bind": "loopback", "auth": { "mode": "token", "token": "" // Replace with the corresponding TOKEN, which can be obtained in Overview - Gateway Token }, "tailscale": { "mode": "off", "resetOnExit": false } }, "plugins": { // Plugin configuration information "entries": {} } } ``` ### 保存配置信息并重启 ```mixin-react return ( ); ``` 配置生效后，即可使用 OpenClaw。 ## 开始使用 * 打开 TUI，并查看 Gateway 状态。 ```JSON openclaw tui /status ``` * 打开 Web UI，在 Chat 页面进行交互。 ```JSON openclaw dashboard ``` # 接入 TRAE ## 安装 TRAE CN 访问 [TRAE 官网](https://www.trae.cn/)下载并安装对应操作系统的版本。 ## 配置工具 1. 选择**个人用户**入口登录后，点击界面右上角的 **设置** 图标，进入设置中心。 2. 在左侧导航栏中，选择 **模型**，在模型管理页面进行配置。 3. 点击 **+ 添加模型** 按钮，界面上显示 **添加模型** 窗口，在窗口中配置以下信息。 * **服务商**：**火山引擎** * **模型**： * 直接从列表中选择 TRAE 预置的模型（均为默认版本）。 * 若希望使用其他模型，单击**使用其他模型**，然后在输入框中填写 **模型 ID** 配置信息。 * **API 密钥**：[获取API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) ## 切换模型在 AI 对话输入框的右下角，单击当前模型名称，在模型列表中，选择配置的模型。选定模型后，即可使用 TRAE 进行开发任务了。 # 接入 Cline :::warning 对于个人开发场景，推荐订阅 [Coding Plan 套餐](https://www.volcengine.com/activity/codingplan)，接入教程参见 [其他工具](/docs/82379/2188959)。 ::: ## 安装步骤打开 VSCode，在扩展市场搜索`Cline`安装。 ## 配置工具 Cline插件安装完成后，您需要配置以下信息。 * **API Provider**：`OpenAI Compatible`（Coding Plan 接口兼容 OpenAI 标准） * **Base URL**：`https://ark.cn-beijing.volces.com/api/v3` * **API Key**：[获取API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) * **Model ID**：按需选择模型并获取 [Model ID](https://www.volcengine.com/docs/82379/1330310#b318deb2) 配置完成后，就可以在输入框中输入需求，与模型进行交互。 # 接入 Cursor :::warning 对于个人开发场景，推荐订阅 [Coding Plan 套餐](https://www.volcengine.com/activity/codingplan)，接入教程参见 [其他工具](/docs/82379/2188959)。 ::: ## 安装步骤官网下载安装包：通过[Cursor官网](https://cursor.com/features)下载并安装Cursor。 ## 配置工具 :::tip 由于 Cursor 的限制，只有订阅了 Cursor Pro 及以上套餐的用户才支持自定义配置模型。 ::: Cursor安装完成后，Models 模块的具体配置如下： * OpenAI API Key：[获取API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) * Override OpenAI Base URL：`https://ark.cn-beijing.volces.com/api/v3` * Add Custom Model：按需选择模型并获取 [Model ID](https://www.volcengine.com/docs/82379/1330310#b318deb2) 配置完成后，即可在聊天面板中选择配置的模型进行交互。 # 接入 Roo Code :::warning 对于个人开发场景，推荐订阅 [Coding Plan 套餐](https://www.volcengine.com/activity/codingplan)，接入教程参见 [其他工具](/docs/82379/2188959)。 ::: ## 安装步骤打开 VSCode，在扩展市场搜索`Roo Code`进行安装，安装完成后选择信任发布者。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/dd47c5150044469cb4e95b8de067d817~tplv-goo7wpa0wc-image.image =601x) ## 配置工具安装完成后，配置以下信息。 * **API Provider**：`OpenAI Compatible`（Coding Plan 接口兼容 OpenAI 标准） * **Base URL**：`https://ark.cn-beijing.volces.com/api/v3` * **API Key**：[获取API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) * **Model**：按需选择模型并获取 [Model ID](https://www.volcengine.com/docs/82379/1330310#b318deb2) 配置完成后，就可以在输入框中输入需求，与模型进行交互。 # 接入 Kilo Code :::warning 对于个人开发场景，推荐订阅 [Coding Plan 套餐](https://www.volcengine.com/activity/codingplan)，接入教程参见 [其他工具](/docs/82379/2188959)。 ::: ## 安装步骤打开 VSCode，在扩展市场搜索`kilo code`进行安装，安装完成后选择信任发布者。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3e991c168c0c49bc9449f6f6efc29bd7~tplv-goo7wpa0wc-image.image =572x) ## 配置工具选择Use your own API key，然后配置以下信息。 * **API Provider**：`OpenAI Compatible`（Coding Plan 接口兼容 OpenAI 标准） * **Base URL**：`https://ark.cn-beijing.volces.com/api/v3` * **API Key**：[获取API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) * **Model**：按需选择模型并获取 [Model ID](https://www.volcengine.com/docs/82379/1330310#b318deb2) 配置完成后，就可以在输入框中输入需求，与模型进行交互。 :::warning 对于个人开发场景，推荐订阅 [Coding Plan 套餐](https://www.volcengine.com/activity/codingplan)，接入教程参见 [其他工具](/docs/82379/2188959)。 :::

火山方舟