文档中心

火山方舟

Coding Plan 个人版

快速开始

本文介绍如何在编程工具中快速使用 Coding Plan 套餐所支持的模型进行代码开发。

核心配置

接入工具的核心参数如下：

模型配置

支持以下两种方式配置模型：

配置 Model Name (配置文件指定)

配置 ark-code-latest (控制台管理)

在工具配置文件中指定 Model Name，可实时切换模型。支持配置的 Model Name：

注意

配置 Model Name 时，支持使用全小写格式，同时也支持直接复制中的模型名称。

doubao-seed-evolving

doubao-seed-2.1-pro

doubao-seed-2.1-lite

doubao-seed-2.0-mini

minimax-m3

glm-5.3 (glm-latest)

glm-5.3-flash

deepseek-v4.1-flash

deepseek-v4-flash

deepseek-v4-pro

kimi-k2.7-code

kimi-k2.8-preview

kimi-k3

说明

Model Name 不支持配置为 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

获取 API Key

步骤一：订阅方舟 Coding Plan

访问方舟 Coding Plan 活动，按需订阅套餐。套餐介绍请参见套餐概览。

步骤二：配置编程工具

Coding Plan 支持主流的编程工具，可按需选择。

Claude Code

AI 终端编程助手，自然语言编程

TraeCode

智能 IDE，构建新一代编程工作流

Roo Code

轻量级编程助手

Codex CLI

OpenAI 推出的命令行编程工具

OpenCode

开源 AI 编程代理工具

Cline

VSCode 扩展，代码补全和调试

Kilo Code

轻量高性能编程工具

OpenClaw

开源、自托管个人 AI 助手

Cursor

AI 原生代码编辑器

Hermes Agent

开源自主 AI 智能体

下面以 Claude Code 为例介绍如何使用 Coding Plan。

安装 Claude Code

前提条件：

安装 Node.js 18 或更新版本环境。

Windows 用户需安装 Git for Windows。

在命令行界面，执行以下命令安装 Claude Code。

npm install -g @anthropic-ai/claude-code

安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。

claude --version

配置工具

方式一：自动化助手（推荐）

ArkCLI Helper 是一个编码工具助手，支持快速配置选择的工具接入 Coding Plan。安装并运行该助手，根据界面提示操作可自动完成工具配置，降低手动配置的时间成本和出错风险。

注意

ArkCLI Helper 是基于 Ark Helper 升级演进的工具配置服务，相关能力将持续在 ArkCLI Helper 上迭代更新。建议优先使用 ArkCLI Helper 完成工具配置。

ArkCLI Helper 支持 macOS、Linux、Windows 系统。

安装 Ark CLI。

# 1. 通过 NPM 安装
npm install -g @volcengine/ark-cli@latest

# 2. 验证安装
arkcli --version

arkcli auth login

根据界面提示选择登录方式。若之前已登录过 arkcli，会沿用上次选择的配置；如需重新选择，请先执行 arkcli config reset 后再运行 arkcli auth login。首次登录时，按提示完成以下配置：

选择项目（Project）：可按需选择，或默认选择账号全部资源。

选择消费模式（Type）：选择 coding-plan。

运行 ArkCLI Helper，根据界面提示完成 Claude Code 的配置。

在命令行界面输入 arkcli helper 命令，启动 ArkCLI Helper。

选择要配置的 Plan profile：选择 coding-plan_cn-beijing_personal (Coding Plan)。

选择默认 model：按需选择。

选择要配置的 AI Agent：Claude Code。

完成上述操作后，将自动完成 Claude Code 的基础配置，无需手动安装。

方式二：手动配置

完成Claude Code安装后，配置以下信息。

ANTHROPIC_BASE_URL：https://ark.cn-beijing.volces.com/api/coding

ANTHROPIC_AUTH_TOKEN：获取 API Key

ANTHROPIC_MODEL: 支持配置 Model Name （实时切换模型）、配置ark-code-latest（控制台切换模型）两种方式，具体见模型配置。

配置步骤如下：

创建并打开 settings.json 配置文件。文件路径因系统而异，具体操作如下：

macOS/Linux
Windows
macOS/Linux 系统 Claude Code 配置文件路径：~/.claude/settings.json。
如果在主目录下没有.claude目录，执行以下命令创建目录。

mkdir -p ~/.claude

创建并打开配置文件。

nano ~/.claude/settings.json
Windows 系统 Claude Code 配置文件路径：C:\Users\<用户名>\.claude\settings.json。以 CMD 命令行方式为例，操作如下。
如果当前用户目录下没有.claude目录，执行以下命令创建目录。

if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"

创建并打开配置文件。

notepad "%USERPROFILE%\.claude\settings.json"

编辑配置文件，需要修改的配置信息如下：

<ARK_API_KEY>：替换为您自己的 API Key。

<Model_Name>：更新为需要使用的模型信息，如ark-code-latest。支持的模型信息参见模型配置。

{
"env": {
"ANTHROPIC_AUTH_TOKEN": "<ARK_API_KEY>",
"ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding",
"ANTHROPIC_MODEL": "<MODEL_NAME>",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "<MODEL_NAME>",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "<MODEL_NAME>",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "<MODEL_NAME>",
"CLAUDE_CODE_SUBAGENT_MODEL": "<MODEL_NAME>",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}

说明

要开启 1M 上下文窗口，配置参见扩展上下文。

推荐使用完整模型配置，并按任务复杂度选择模型：Haiku（轻量）、Sonnet（日常）、Opus（复杂）。

CLAUDE_CODE_SUBAGENT_MODEL 建议与主模型保持一致。

ANTHROPIC_DEFAULT_HAIKU_MODEL 建议设置为小尺寸模型，通常不会影响整体使用效果。

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 用于关闭 Claude Code 后台匿名遥测请求。遥测请求默认会走 ANTHROPIC_BASE_URL 并占用 Coding Plan 配额，设为 "1" 可避免额度被静默消耗（方式 1 的 ArkCLI Helper 会自动配置此项）。

编辑或新增 .claude.json 文件，修改或新增 hasCompletedOnboarding 字段值为 true。

不同系统.claude.json配置文件路径如下：

macOS/Linux：~/.claude.json

Windows：C:\Users\<用户名>\.claude.json

修改或新增的字段信息如下：

{
"hasCompletedOnboarding": true
}

保存配置文件后，在新的终端窗口执行后续命令。

使用 Claude Code

启动 Claude Code：进入项目目录，执行claude命令，即可开始使用 Claude Code。

cd my-project
claude

启动后，选择信任此文件夹，允许 Claude Code 访问该文件夹中的文件。

模型状态验证：输入/status确认模型状态。

在 Claude Code 中对话。

注意

Claude Code 如何开启深度思考模式？

切换模型

请根据模型配置方式，选择对应的模型切换方案。

配置方式	配置ark-code-latest	配置 Model Name
切换模型操作	在开通管理页面选择要使用的模型，切换后3-5分钟即可生效。在命令行窗口，启动 Claude Code 后，输入/status确认模型状态。	启动时：执行claude --model <Model_Name>，可指定对应的模型。对话期间：执行/model <Model_Name>切换模型。

常见问题

错误码

如遇报错，可根据错误信息查看错误码说明，定位&解决问题。详细信息请参见错误码。

最近更新时间：2026.09.23 17:06:44

这个页面对您有帮助吗？

有用

无用