Appearance
火山方舟 Agent Plan - 开源工具配置文档
面向个人开发者的全模态订阅式 Agent 服务,支持文本、图片、视频、向量化等能力,兼容主流 Agent 工具生态。
核心配置信息
Base URL(重要)
| 接口协议 | Base URL | 适用工具 |
|---|---|---|
| Anthropic 兼容 | https://ark.cn-beijing.volces.com/api/plan | Claude Code |
| OpenAI 兼容 | https://ark.cn-beijing.volces.com/api/plan/v3 | OpenCode、OpenClaw、TRAE、Hermes Agent、Codex CLI、Cline、Cursor、Kilo Code、Roo Code 等 |
⚠️ 注意:Agent Plan 有专属 Base URL,请勿混用普通 API 的
/api/v3,否则不会抵扣套餐额度。
API Key 获取
Agent Plan 专属 API Key 与普通方舟 API Key 不同,请勿混用。
获取路径:火山方舟控制台 → 开通管理 → Agent Plan → 使用配置 → 配置专属 API Key → 复制
模型配置(两种方式)
方式一:ark-code-latest(控制台管理)
- 工具中统一配置模型名为
ark-code-latest - 控制台「开通管理」页面选择/切换目标模型,3-5 分钟生效
- 支持 Auto 模式:智能算法自动选模型
方式二:具体 Model Name(实时切换)
在工具配置中指定模型名,可实时切换。
| 分类 | 模型名称 | 上下文 | 多模态 |
|---|---|---|---|
| 极速 | doubao-seed-2.0-mini | 256k | 图文 |
| 极速 | 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 | 文本 |
专属 Harness 能力
- 豆包搜索:联网搜索能力(Medium+ 套餐每月500次免费)
- 专业数据集:专业领域知识增强
- Agent 记忆(OpenViking):跨会话长期记忆
- AI Native 应用开发底座:Supabase 集成
向量化模型
doubao-embedding-vision:多模态向量化,支持文本/图片/视频转向量
自动化配置工具 ArkCLI Helper
推荐使用官方 CLI 工具一键配置所有支持的 Agent 工具及 Harness。
安装
bash
npm install -g @volcengine/ark-cli@latest
arkcli --version登录
bash
arkcli auth login选择 SSO 浏览器登录,首次登录配置:
- 选择项目:默认「账号全部资源」
- 选择消费模式:
agent-plan
一键配置
bash
arkcli helper- 选择 Plan profile:
agent-plan_cn-beijing_personal - 选择默认 model
- 选择要配置的 AI Agent:
- OpenCode(模型 + Harness 工具集)
- OpenClaw(模型 + Harness 工具集)
- Hermes Agent(仅模型)
- Trae(仅 Harness 工具集)
- 按需选择 Harness 配置:豆包搜索、专业数据集、Agent 记忆、火山引擎 Supabase
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.jsonWindows:
cmd
if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"
notepad "%USERPROFILE%\.claude\settings.json"2. 编辑 settings.json
json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "<AGENT_PLAN_API_KEY>",
"ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/plan",
"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"
}
}3. 初始化配置
macOS / Linux: ~/.claude.jsonWindows: C:\Users\<用户名>\.claude.json
json
{
"hasCompletedOnboarding": true
}使用
bash
cd my-project
claude验证:输入 /status
OpenCode
前置条件
Node.js 18+
安装
bash
npm install -g opencode-ai
opencode --version手动配置
配置文件路径:
- macOS / Linux:
~/.config/opencode/opencode.json - Windows:
%USERPROFILE%\.config\opencode\opencode.json
Responses API(推荐,推理效果更好)
json
{
"$schema": "https://opencode.ai/config.json",
"model": "volcengine-agent-plan/ark-code-latest",
"provider": {
"volcengine-agent-plan": {
"npm": "@ai-sdk/openai",
"name": "Volcano Engine(Responses API)",
"options": {
"baseURL": "https://ark.cn-beijing.volces.com/api/plan/v3",
"apiKey": "<AGENT_PLAN_API_KEY>"
},
"models": {
"ark-code-latest": {
"name": "ark-code-latest",
"limit": {
"context": 256000,
"output": 4096
},
"modalities": {
"input": ["text", "image"],
"output": ["text"]
}
},
"doubao-seed-2.0-pro": {
"name": "doubao-seed-2.0-pro",
"limit": {
"context": 256000,
"output": 4096
},
"modalities": {
"input": ["text", "image"],
"output": ["text"]
}
},
"glm-5.2": {
"name": "glm-5.2",
"limit": {
"context": 1024000,
"output": 4096
},
"modalities": {
"input": ["text"],
"output": ["text"]
}
}
}
}
}
}1M 上下文:
glm-5.2、deepseek-v4-flash、deepseek-v4-pro支持,通过limit.context指定。 图片理解:支持多模态的模型配置modalities.input包含"image"。
使用
bash
opencode输入 /models 切换模型。
OpenClaw
前置条件
Node.js 22+
安装
macOS / Linux:
bash
curl -fsSL https://openclaw.ai/install.sh | bashWindows 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
Responses API 配置(推荐)
json
{
"models": {
"providers": {
"volcengine-agent-plan": {
"baseUrl": "https://ark.cn-beijing.volces.com/api/plan/v3",
"apiKey": "<AGENT_PLAN_API_KEY>",
"api": "openai-responses",
"models": [
{
"id": "ark-code-latest",
"name": "ark-code-latest",
"contextWindow": 256000,
"maxTokens": 32000,
"input": ["text", "image"]
},
{
"id": "doubao-seed-2.0-pro",
"name": "doubao-seed-2.0-pro",
"contextWindow": 256000,
"maxTokens": 65536,
"input": ["text", "image"]
},
{
"id": "glm-5.2",
"name": "glm-5.2",
"contextWindow": 1024000,
"maxTokens": 65536,
"input": ["text"]
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "volcengine-agent-plan/ark-code-latest"
},
"models": {
"volcengine-agent-plan/ark-code-latest": {},
"volcengine-agent-plan/doubao-seed-2.0-pro": {},
"volcengine-agent-plan/glm-5.2": {}
}
}
},
"gateway": {
"mode": "local"
}
}重启生效:
bash
openclaw gateway restart配置向量化记忆(可选)
在 agents.defaults 节点下添加:
json
{
"agents": {
"defaults": {
"memorySearch": {
"provider": "openai",
"model": "doubao-embedding-vision",
"remote": {
"baseUrl": "https://ark.cn-beijing.volces.com/api/plan/v3",
"apiKey": "<AGENT_PLAN_API_KEY>"
}
}
}
}
}使用
bash
# Web UI
openclaw dashboard
# 终端 TUI
openclaw tuiTRAE
安装
TRAE 官网 下载安装 TRAE CN 版本。
配置
- 个人用户登录 → 设置 → 模型 → 添加模型
- 配置信息:
| 配置项 | 值 |
|---|---|
| 服务商 | 火山引擎 Plan |
| 模型 | 列表选择或手动输入 ark-code-latest |
| API 密钥 | Agent Plan 专属 API Key |
Hermes Agent
配置
- 执行
hermes model - Select Provider:选择 Custom endpoint (36)
- 配置信息:
| 配置项 | 值 |
|---|---|
| API base URL | https://ark.cn-beijing.volces.com/api/plan/v3 |
| API Key | Agent Plan 专属 API Key |
| Model name | doubao-seed-2.0-pro 或 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/plan/v3"
env_key = "ARK_API_KEY"
wire_api = "responses"环境变量
bash
# macOS / Linux
echo 'export ARK_API_KEY="YOUR_AGENT_PLAN_KEY"' >> ~/.zshrc
source ~/.zshrc使用
bash
codexCline
安装
VSCode 扩展市场搜索 Cline 安装。
配置
| 配置项 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://ark.cn-beijing.volces.com/api/plan/v3 |
| API Key | Agent Plan 专属 API Key |
| Model ID | ark-code-latest 或具体模型名 |
Cursor
安装
Cursor 官网 下载安装(需 Pro+ 套餐)。
配置
| 配置项 | 值 |
|---|---|
| OpenAI API Key | Agent Plan 专属 API Key |
| Override OpenAI Base URL | https://ark.cn-beijing.volces.com/api/plan/v3 |
| Add Custom Model | ark-code-latest 或具体模型名 |
注意:
minimax-m2.7、glm-5.2、kimi-k2.6若遇名称冲突,改用minimax-m2-7、glm-5-2、kimi-k2-6。
Roo Code
安装
VSCode 扩展市场搜索 Roo Code 安装(建议 3.43.0+)。
配置
| 配置项 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://ark.cn-beijing.volces.com/api/plan/v3 |
| API Key | Agent Plan 专属 API Key |
| Model | ark-code-latest 或具体模型名 |
Kilo Code
安装
VSCode 扩展市场搜索 kilo code 安装。
配置
Settings → Providers → Custom provider:
| 配置项 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://ark.cn-beijing.volces.com/api/plan/v3 |
| API Key | Agent Plan 专属 API Key |
| Model | ark-code-latest 或具体模型名 |
套餐对比速查
| 套餐 | Small | Medium | Large | Max |
|---|---|---|---|---|
| 月价格 | 40元 | 200元 | 500元 | 1000元 |
| 月 AFP 额度 | 20,000 | 100,000 | 250,000 | 500,000 |
| 图片生成 | √ | √ | √ | √ |
| 视频生成 | × | √ | √ | √ |
| 豆包搜索 | × | 500次/月 | 500次/月 | 500次/月 |
| Agent 记忆 | × | √ | √ | √ |
| 推荐场景 | 轻量体验 | 日常开发 | 重度开发 | 团队/全模态 |
注意事项
- API Key 独立:Agent Plan 有专属 API Key,与普通方舟 API Key 不通用
- Base URL 独立:必须使用
/api/plan/v3或/api/plan才能抵扣套餐额度 - 模型切换:
ark-code-latest方式控制台切换需 3-5 分钟生效 - 1M 上下文:仅
glm-5.2、deepseek-v4-flash/pro支持,需显式配置 - 多模态:豆包系列、MiniMax M3、Kimi 系列支持图片输入
- 视觉模型:生图/生视频模型不支持 Auto 模式,需通过 Skill 单独接入
- 额度共享:同一套餐在所有工具中共享 AFP 额度
官方文档:火山方舟 Agent Plan 接入 AI 工具更新时间:2026.07.07