教程 · Claude Code × 火山方舟

Claude Code
接入方舟 Coding Plan

方舟 Coding Plan 一份额度覆盖 8+ 款模型(Doubao-Seed-2.1-turbo、GLM-5.2、Kimi-K3、Kimi-K2.7-Code、MiniMax-M3、Deepseek-V4 等),Claude Code 通过 Anthropic 兼容端点接入后可随时换模型,或交给 Auto 模式自动调度。

¥9.9首购起价
8+可用模型
Auto智能调度

前置准备

  • 已安装 Node.js 18+ 与 Claude Code CLI
  • 已开通火山引擎账号并订阅方舟 Coding Plan(新用户首购 ¥9.9 起)
  • 在方舟控制台的 API Key 管理页创建 Key(ep 开头的接入点 ID 按需创建)
  • 购买即开通模型调用权限,无需单独创建推理接入点

配置步骤

1

设置环境变量指向方舟端点

方舟提供 Anthropic 兼容网关,Claude Code 直接识别。

export ANTHROPIC_BASE_URL="https://ark.cn-beijing.volces.com/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="你的方舟 API Key"
source ~/.zshrc
2

选择模型

通过 /model 或环境变量指定模型 ID:写代码推荐 Doubao-Seed-2.1-turbo(速度)或 GLM-5.2(质量,限时加量 4 倍);也可以直接选 Auto 模式由平台按任务自动路由。

cd your-project
claude
/model   # 选择 Doubao / GLM / Kimi / MiniMax / DeepSeek 或 Auto
3

确认额度规则

所有支持工具共享同一套餐额度(5h/周/月三重窗口),Lite 与 Pro 唯一区别是用量倍数(Pro 为 Lite 的 5 倍)。额度耗尽后等待周期恢复,不会扣账户余额。

Auto 模式适合谁

不想选模型的人

Auto 按任务类型自动分发到合适模型,日常问答走轻量档、复杂改动走旗舰档。

模型横向评测

一份额度轮询 8+ 款模型,对比 Doubao/GLM/Kimi/MiniMax/DeepSeek 的出码风格。

成本敏感用户

首购 ¥9.9 体验两个月,Auto 避免旗舰模型浪费在简单任务上。

常见报错排查

模型未开通

Coding Plan 购买即开通模型;若报权限错误,确认订阅仍在有效期且未限购下架。

鉴权失败

使用方舟控制台的 API Key;若用接入点 ID 方式,确认接入点与模型匹配。

限额 429

5h/周/月任一窗口耗尽都会触发;Lite 用户高峰期可考虑升级 Pro(5 倍用量)。

多套餐切换

配合 ccswitch 等工具在方舟与智谱/Kimi 配置间切换,注意 BASE_URL 与 Key 成对替换。

常见问题

方舟端点地址以哪里为准?

以火山引擎方舟官方文档的「Anthropic 兼容」章节为准,本教程写的是 ark.cn-beijing.volces.com/api/anthropic。

¥9.9 能用多久?

首购促销价 ¥9.9/月起通常覆盖前两个月(2.5 折),第三个月起恢复刊例价 ¥40/月;以活动页规则为准。

Claude Code 里能随时换模型吗?

可以,/model 即可切换;额度跨模型共享,切换不产生额外费用。

GLM-5.2 限时限量是怎么回事?

活动期间 GLM-5.2 等热门模型加量 4 倍(加量不加价),活动结束后恢复原额度,关注官方公告时间。