配合 Claude Code 使用

Claude Code 走 Anthropic Messages 协议。万川提供 /v1/messages 端点，因此只需要改两个环境变量，不用改工作流。

注意这里的 Base URL 是 https://chuanapi.com，不带 /v1。Claude Code 会自己拼上 /v1/messages，多写一层会得到 404。这和 OpenAI SDK 需要带 /v1 正好相反。

前置条件

已在控制台创建 API Key，账户余额充足。创建方式见快速接入。
本机已安装 Claude Code 并能正常启动。

配置步骤

把密钥写入环境变量 WANCHUAN_API_KEY，不要硬编码进 shell 配置文件。
从模型目录复制一个真实 model id，替换下面的 MODEL_ID。
设置三个环境变量后启动 Claude Code。

# macOS / Linux
export ANTHROPIC_BASE_URL="https://chuanapi.com"
export ANTHROPIC_AUTH_TOKEN="$WANCHUAN_API_KEY"
export ANTHROPIC_MODEL="MODEL_ID"

claude

Windows：

# Windows PowerShell
$env:ANTHROPIC_BASE_URL = "https://chuanapi.com"
$env:ANTHROPIC_AUTH_TOKEN = "$env:WANCHUAN_API_KEY"
$env:ANTHROPIC_MODEL = "MODEL_ID"

claude

想固定下来就把前三行写进 ~/.zshrc、~/.bashrc 或 PowerShell 配置文件；只想临时试一次，直接在当前终端里执行即可。

验证连通

启动 Claude Code 之前先单独打一次接口。这样能把「网关配置问题」和「客户端配置问题」分开：

curl https://chuanapi.com/v1/messages \
  -H "Authorization: Bearer $WANCHUAN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "你好"}]
  }'

返回 200 且带有模型回答，说明 Base URL、密钥与 model id 三者都对，剩下的问题就只可能出在 Claude Code 自身的配置上。

常见问题

404：多半是 ANTHROPIC_BASE_URL 后面多写了 /v1，变成了 /v1/v1/messages；也可能是 model id 不在目录里。
401：密钥没生效。检查环境变量是否在当前 shell 里真的展开了，以及是否误把 Bearer 前缀写进了密钥值。
403：密钥有效，但账号分组不包含该模型。换一个目录中可用的 model id 再试。
429：触发限流。降低并发后重试，重试策略见错误码。
官方账号登录态干扰：如果之前登录过 Claude 官方账号，客户端可能优先用已保存的凭据。退出登录后再用环境变量方式启动。

前置条件

配置步骤

验证连通

常见问题

相关文档