本文介绍如何在编程工具中快速使用火山引擎的方舟 Coding Plan 套餐所支持的模型进行代码开发。
接入工具的核心参数如下:(不同的工具配置的Base URL会有不同)
- 配置模型:
ark-code-latest
目前仍支持设置为doubao-seed-code-preview-latest,如果想使用其他 Code 模型,建议设置为ark-code-latest。 - Coding Plan 专用的 Base URL
- 兼容 Anthropic 接口协议 Base URL:
https://ark.cn-beijing.volces.com/api/coding - 兼容 OpenAI 接口协议 Base URL:
https://ark.cn-beijing.volces.com/api/coding/v3
- 兼容 Anthropic 接口协议 Base URL:
步骤一:订阅方舟 Coding Plan
- 访问【方舟 Coding Plan 活动】,按需订阅套餐。套餐介绍请参见【套餐概览】。
- 在【开通管理页面】选择或切换目标模型,无需在工具中额外变更模型配置。支持最新的 Doubao-Seed-Code、DeepSeek-V3.2、GLM-4.7、Kimi-k2-thinking、Kimi-K2.5 模型,也可开启 Auto 模式,方舟将根据场景选择最优模型。切换成自己想用的模型就行,推荐:
Kimi-K2.5、GLM 4.7。
步骤二:配置编程工具
Coding Plan 支持 Claude Code、Cursor、Cline、Codex CLI 等编程工具。下面以Claude Code为例介绍如何使用 Coding Plan。
接入其他编程工具或vscode内部的插件,请参见【接入AI编程工具】。
2.1 安装Claude Code
前提条件:
- 安装 【Node.js 18 或更新版本环境】。
- Windows 用户需安装 【Git for Windows】。
在命令行界面,执行以下命令安装 Claude Code。
npm install -g @anthropic-ai/claude-code安装结束后,执行以下命令查看安装结果,若显示版本号则安装成功。
claude --version2.2 配置工具
完成Claude Code安装后,配置以下信息。
- ANTHROPIC_BASE_URL:
https://ark.cn-beijing.volces.com/api/coding - ANTHROPIC_AUTH_TOKEN:【获取API Key】
- ANTHROPIC_MODEL:
ark-code-latest
自 Claude Code v2.0.7x 起,环境变量的加载与读取逻辑发生变化,首次登录、执行
logout后重新登录时,~/.claude/settings.json中的env配置可能不会生效,推荐将环境变量写入 Shell 的启动配置文件中。
2.2.1 MacOS & Linux
在终端执行以下命令查看当前使用的 Shell 类型。
echo $SHELL根据 Shell 类型配置环境变量。
# SHELL 类型为 zsh,执行以下命令。 nano ~/.zshrc # SHELL 类型为 bash,执行以下命令。 nano ~/.bashrc在文件末尾追加以下内容,请将
<ARK_API_KEY>替换为方舟 API Key,保存并退出编辑。export ANTHROPIC_BASE_URL="https://ark.cn-beijing.volces.com/api/coding" export ANTHROPIC_AUTH_TOKEN="<ARK_API_KEY>" export ANTHROPIC_MODEL="ark-code-latest" export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1" # Avoid conflicts with local Anthropic configuration export ANTHROPIC_API_KEY=""在终端执行以下命令,使配置生效。
# SHELL 类型为 zsh,执行以下命令。 source ~/.zshrc # SHELL 类型为 bash,执行以下命令。 source ~/.bashrc在终端执行以下命令验证环境变量是否生效。
echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_MODEL
2.2.2 Windows
CMD
在CMD中执行以下命令,设置环境变量。
setx ANTHROPIC_AUTH_TOKEN ARK_API_KEY setx ANTHROPIC_BASE_URL https://ark.cn-beijing.volces.com/api/coding setx ANTHROPIC_MODEL ark-code-latest在新的CMD窗口执行以下命令,检查环境变量是否生效。
echo %ANTHROPIC_AUTH_TOKEN% echo %ANTHROPIC_BASE_URL% echo %CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC% echo %ANTHROPIC_MODEL%
PowerShell
在PowerShell中执行以下命令,设置环境变量。
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'ARK_API_KEY', 'User') [System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://ark.cn-beijing.volces.com/api/coding', 'User') [System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'ark-code-latest', 'User')在新的PowerShell窗口执行以下命令,检查环境变量是否生效。
echo $env:ANTHROPIC_AUTH_TOKEN echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_MODEL
2.3 切换模型
- 在【开通管理页面】选择要使用的模型,切换后3-5分钟即可生效。也就是第一步中那个页面,你切换成自己想用的模型就行:
Kimi-K2.5、GLM 4.7、Deepseek v3.2、Kimi-k2-thinking。 - 在命令行窗口,启动 Claude Code 后,输入
/status确认模型状态。
2.4 使用Claude Code
启动Claude Code:进入项目目录,执行
claude命令,即可开始使用Claude Code。cd my-project claude模型状态验证:输入
/status确认模型状态。
如果提示信息如下,可能是由于之前已登录过Claude Code,可输入/logout退出登录,然后再启动Claude Code。{ "error": { "code": "AuthenticationError", "message": "The API key format is incorrect. Request id:0217xxxxxxx", "param": "", "type": "Unauthorized" } }
错误码
如遇报错,可根据错误信息查看错误码说明,定位&解决问题。详细信息请参见【错误码】。