claude code 如何使用火山或国内的模型
2026-08-24 11:57:43

Claude‑Code CLI 使用火山方舟模型完整配置

关键点:Claude‑Code 原生走 Anthropic 协议,不要填 OpenAI 的 /api/coding/v3,要用专门的 Anthropic 兼容端点火山引擎。
- Coding‑Plan(老账号续费)地址:`https://ark.cn-beijing.volces.com/api/coding`
- Agent‑Plan(新账号)地址:`https://ark.cn-beijing.volces.com/api/plan`

两个配置文件:

  1. ~/.claude/settings.json:放环境变量(key、baseUrl、模型)
  2. ~/.claude.json:hasCompletedOnboarding":true,跳过 Claude 官方登录,否则会联网访问anthropic.com报错。

Windows 路径

  • settings.json:C:\Users\你的用户名\.claude\settings.json
  • .claude.json:C:\Users\你的用户名\.claude.json
如果没有 .claude 文件夹,手动新建。

① Coding‑Plan(老账号,按请求次数扣费)

settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "填你的Coding‑Plan专属API Key",
    "ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding",
    "ANTHROPIC_MODEL": "ark-code-latest",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "ark-code-latest",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "ark-code-latest",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "ark-code-latest",
    "CLAUDE_CODE_SUBAGENT_MODEL": "ark-code-latest"
  }
}

.claude.json(跳过登录)

{
  "hasCompletedOnboarding": true
}

② Agent‑Plan(新账号,AFP 燃料点)

只改ANTHROPIC_BASE_URL为 /api/plan,key 换成 Agent‑Plan 的专属 key:

{
  "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": "ark-code-latest",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "ark-code-latest",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "ark-code-latest",
    "CLAUDE_CODE_SUBAGENT_MODEL": "ark-code-latest"
  }
}
ark‑code‑latest:在火山方舟网页控制台切换实际底层模型,工具这边不用改配置。

生效步骤

  1. 保存两个文件;完全关闭旧 PowerShell,新开终端窗口(配置才加载)
  2. 进入你的代码项目文件夹,直接输入命令:
claude

直接进入对话,不需要访问 claude 官方服务器,全程走火山国内接口,不需要科学上网。

配置其他的服务商也是一样的 修改参数就好了

使用web 网页打开

# 全局安装
npm install -g claude-code-webui

# 启动本地网页服务
claude-code-webui

启动完成浏览器自动打开:http://127.0.0.1:8080