火山方舟 Coding Plan - 开源工具配置文档

面向开发者的订阅式 AI 编码服务，支持 Claude Code、OpenClaw、OpenCode 等主流编程 Agent 工具。

核心配置信息

Base URL（重要）

接口协议	Base URL	适用工具
Anthropic 兼容	`https://ark.cn-beijing.volces.com/api/coding`	Claude Code
OpenAI 兼容	`https://ark.cn-beijing.volces.com/api/coding/v3`	OpenClaw、OpenCode、TRAE、Roo Code、Cline、Kilo Code、Cursor、Codex CLI、Hermes Agent 等

⚠️ 注意：请勿使用 https://ark.cn-beijing.volces.com/api/v3，该地址不会消耗 Coding Plan 额度，会产生额外后付费费用。

模型配置（两种方式）

方式一：配置 `ark-code-latest`（控制台管理）

在工具中统一配置模型名为 ark-code-latest
在火山方舟「开通管理页面」选择/切换目标模型，3-5 分钟生效
支持 Auto 模式：通过「效果 + 速度」智能算法自动选模型

方式二：配置具体 Model Name（实时切换）

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

分类	模型名称	上下文
极速	`doubao-seed-2.0-lite`	256k
极速	`deepseek-v4-flash`	1024k
代码	`doubao-seed-2.0-code`	256k
进阶	`doubao-seed-2.0-pro`	256k
进阶	`minimax-m2.7`	200k
进阶	`minimax-m3`	512k
进阶	`glm-5.2` (glm-latest)	1024k
进阶	`kimi-k2.6`	256k
进阶	`kimi-k2.7-code`	256k
进阶	`deepseek-v4-pro`	1024k

支持全小写格式，也可直接复制控制台中的模型名称。

API Key 获取

火山方舟控制台 → API Key 管理 → Coding Plan 专属 Key

自动化配置工具 ArkCLI Helper

推荐使用官方自动化工具一键配置所有支持的编程工具。

安装

bash

npm install -g @volcengine/ark-cli@latest
arkcli --version

一键配置

bash

arkcli helper

选择 Plan profile：coding-plan_cn-beijing_personal
选择默认 model
选择要配置的 AI Agent（Claude Code / OpenCode / OpenClaw / Hermes Agent）

Claude Code

前置条件

Node.js 18+
Windows 需安装 Git for Windows

安装

bash

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

手动配置

1. 创建配置文件

macOS / Linux：

bash

mkdir -p ~/.claude
nano ~/.claude/settings.json

Windows：

cmd

if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"
notepad "%USERPROFILE%\.claude\settings.json"

2. 编辑 settings.json

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<ARK_API_KEY>",
    "ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding",
    "ANTHROPIC_MODEL": "ark-code-latest",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "doubao-seed-2.0-lite",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "ark-code-latest",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "ark-code-latest",
    "CLAUDE_CODE_SUBAGENT_MODEL": "ark-code-latest"
  }
}

建议：
Haiku（轻量）配置小尺寸模型如 doubao-seed-2.0-lite
Sonnet（日常）、Opus（复杂）按需配置
SUBAGENT_MODEL 建议与主模型一致

3. 初始化配置

macOS / Linux： ~/.claude.jsonWindows： C:\Users\<用户名>\.claude.json

json

{
  "hasCompletedOnboarding": true
}

使用

bash

cd my-project
claude

验证状态：输入 /status

切换模型

配置方式	切换方法
`ark-code-latest`	控制台开通管理页面切换，3-5分钟生效
具体 Model Name	启动时：`claude --model <Model_Name>` 对话中：`/model <Model_Name>`

OpenClaw

前置条件

Node.js 22+

安装

macOS / Linux：

bash

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell：

powershell

iwr -useb https://openclaw.ai/install.ps1 | iex

初始向导选项

提示	选择
I understand this is personal-by-default...	Yes
Setup mode	QuickStart
Model/auth provider	Skip for now
Default model	Keep current
Select channel	Skip for now
Search provider	Skip for now
Configure skills now?	No
Enable hooks?	Skip for now（空格选中，回车下一步）
How do you want to hatch your bot?	Hatch in Terminal

手动配置

配置文件：~/.openclaw/openclaw.json

json

{
  "models": {
    "providers": {
      "volcengine": {
        "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
        "apiKey": "<ARK_API_KEY>",
        "api": "openai-completions",
        "models": [
          {
            "id": "ark-code-latest",
            "name": "ark-code-latest"
          },
          {
            "id": "doubao-seed-2.0-code",
            "name": "doubao-seed-2.0-code"
          },
          {
            "id": "glm-5.2",
            "name": "glm-5.2",
            "contextWindow": 1024000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "volcengine/ark-code-latest"
      },
      "models": {
        "volcengine/ark-code-latest": {}
      }
    }
  },
  "gateway": {
    "mode": "local"
  }
}

1M 上下文：glm-5.2、deepseek-v4-flash、deepseek-v4-pro 支持 1M 上下文，通过 contextWindow 字段指定。

重启生效：

bash

openclaw gateway restart

使用

bash

# 终端 TUI
openclaw tui

# Web UI
openclaw dashboard

OpenCode

安装

bash

npm install -g opencode-ai
opencode --version

配置

配置文件路径：

macOS / Linux：~/.config/opencode/opencode.json
Windows：C:\Users\用户名\.config\opencode\opencode.json

json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "volcengine": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "volcengine",
      "options": {
        "baseURL": "https://ark.cn-beijing.volces.com/api/coding/v3",
        "apiKey": "<ARK_API_KEY>"
      },
      "models": {
        "ark-code-latest": {
          "name": "ark-code-latest"
        },
        "glm-5.2": {
          "name": "glm-5.2",
          "contextWindow": 1024000
        }
      }
    }
  }
}

使用

bash

opencode

输入 /models 选择豆包模型。

TRAE

安装

TRAE 官网下载安装 TRAE CN 版本。

配置

选择「个人用户」登录，点击右上角设置
左侧导航 → 模型 → 添加模型
配置信息：

配置项	值
服务商	火山引擎 Plan
模型	列表选择或手动输入模型 ID
API 密钥	Coding Plan API Key

切换模型

对话输入框右下角点击当前模型名称即可切换。

Roo Code

安装

VSCode 扩展市场搜索 Roo Code 安装。

配置

配置项	值
API Provider	OpenAI Compatible
Base URL	`https://ark.cn-beijing.volces.com/api/coding/v3`
API Key	Coding Plan API Key
Model	`ark-code-latest` 或具体模型名

Cline

安装

VSCode 扩展市场搜索 Cline 安装。

配置

配置项	值
API Provider	OpenAI Compatible
Base URL	`https://ark.cn-beijing.volces.com/api/coding/v3`
API Key	Coding Plan API Key
Model ID	`ark-code-latest` 或具体模型名

Kilo Code

安装

VSCode 扩展市场搜索 kilo code 安装。

配置

选择 Use your own API key：

配置项	值
API Provider	OpenAI Compatible
Base URL	`https://ark.cn-beijing.volces.com/api/coding/v3`
API Key	Coding Plan API Key
Model	`ark-code-latest` 或具体模型名

Cursor

安装

Cursor 官网下载安装（需 Pro 及以上套餐）。

配置

Models 模块配置：

配置项	值
OpenAI API Key	Coding Plan API Key
Override OpenAI Base URL	`https://ark.cn-beijing.volces.com/api/coding/v3`
Add Custom Model	`ark-code-latest` 或具体模型名

Codex CLI

前置条件

Node.js 18+

安装

bash

npm i -g @openai/codex
codex --version

配置

macOS / Linux： ~/.codex/config.tomlWindows： %USERPROFILE%\.codex\config.toml

toml

model = "ark-code-latest"
model_provider = "volcengine"

[model_providers.volcengine]
name = "volcengine"
base_url = "https://ark.cn-beijing.volces.com/api/coding/v3"
env_key = "ARK_API_KEY"
wire_api = "responses"

环境变量

bash

# macOS / Linux
echo 'export ARK_API_KEY="YOUR_API_KEY"' >> ~/.zshrc
source ~/.zshrc

使用

bash

codex

Hermes Agent

配置

选择 Quick setup → More providers... → Custom endpoint
填写配置：

配置项	值
Endpoint URL	`https://ark.cn-beijing.volces.com/api/coding/v3`
API Key	Coding Plan API Key
Model ID	`ark-code-latest` 或具体模型名

常用模型推荐

场景	推荐模型	说明
轻量快速	`doubao-seed-2.0-lite` / `deepseek-v4-flash`	简单补全、解释代码
日常编码	`doubao-seed-2.0-code` / `glm-5.2`	主力开发，平衡质量与速度
复杂任务	`doubao-seed-2.0-pro` / `deepseek-v4-pro`	架构设计、复杂重构
大型代码库	`glm-5.2` / `deepseek-v4-pro`	1M 上下文，整库理解

也可直接使用 ark-code-latest + 控制台 Auto 模式，自动匹配最优模型。

注意事项

Base URL 务必正确：使用 /api/coding/v3 或 /api/coding 才能抵扣套餐额度，误用 /api/v3 会额外计费
额度共享：同一套餐在所有工具中共享 AFP 额度
模型切换：ark-code-latest 方式切换模型需等待 3-5 分钟生效
1M 上下文：仅 glm-5.2、deepseek-v4-flash、deepseek-v4-pro 支持，需显式配置 contextWindow
超额后付费：开启后额度用尽自动切换后付费模式，无需修改配置

官方文档：火山方舟 Coding Plan 快速开始更新时间：2026.07.06

火山方舟 Coding Plan - 开源工具配置文档 ​

核心配置信息 ​

Base URL（重要） ​

模型配置（两种方式） ​

方式一：配置 ark-code-latest（控制台管理） ​

方式二：配置具体 Model Name（实时切换） ​

API Key 获取 ​

自动化配置工具 ArkCLI Helper ​

安装 ​

登录 ​

一键配置 ​

Claude Code ​

前置条件 ​

安装 ​

手动配置 ​

1. 创建配置文件 ​

2. 编辑 settings.json ​

3. 初始化配置 ​

使用 ​

切换模型 ​

OpenClaw ​

前置条件 ​

安装 ​

初始向导选项 ​

手动配置 ​

使用 ​

OpenCode ​

安装 ​

配置 ​

使用 ​

TRAE ​

安装 ​

配置 ​

切换模型 ​

Roo Code ​

安装 ​

配置 ​

Cline ​

安装 ​

配置 ​

Kilo Code ​

安装 ​

配置 ​

Cursor ​

安装 ​

配置 ​

Codex CLI ​

前置条件 ​

安装 ​

配置 ​

环境变量 ​

使用 ​

Hermes Agent ​

配置 ​

常用模型推荐 ​

注意事项 ​

关于本站

火山方舟 Coding Plan - 开源工具配置文档

核心配置信息

Base URL（重要）

模型配置（两种方式）

方式一：配置 `ark-code-latest`（控制台管理）

方式二：配置具体 Model Name（实时切换）

API Key 获取

自动化配置工具 ArkCLI Helper

安装

登录

一键配置

Claude Code

前置条件

安装

手动配置

1. 创建配置文件

2. 编辑 settings.json

3. 初始化配置

使用

切换模型

OpenClaw

前置条件

安装

初始向导选项

手动配置

使用

OpenCode

安装

配置

使用

TRAE

安装

配置

切换模型

Roo Code

安装

配置

Cline

安装

配置

Kilo Code

安装

配置

Cursor

安装

配置

Codex CLI

前置条件

安装

配置

环境变量

使用

Hermes Agent

配置

常用模型推荐

注意事项