想省事可以用 CC Switch 一键导入,或者用配置生成器。这一篇讲手动配置。
安装#
按 Claude Code 官方说明安装,例如:
npm install -g @anthropic-ai/claude-code
claude --version
使用 claude-opus-5-5 或 claude-sonnet-5-5 需要 Claude Code 2.1.280 或更新。版本太旧会收到 client_version_unsupported,执行 claude update 后重开会话即可。
方法 A:只在当前终端生效#
适合先试一下。
printf 'MoeRouter API Key: '; read -rs MOEROUTER_API_KEY; printf '\n'
export ANTHROPIC_BASE_URL="https://moerouter.com"
export ANTHROPIC_AUTH_TOKEN="$MOEROUTER_API_KEY"
unset ANTHROPIC_API_KEY
claude --model claude-opus-5-5 -p "只回复 OK"
$secure = Read-Host "MoeRouter API Key" -AsSecureString
$env:ANTHROPIC_AUTH_TOKEN = [System.Net.NetworkCredential]::new("", $secure).Password
$env:ANTHROPIC_BASE_URL = "https://moerouter.com"
Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue
claude --model claude-opus-5-5 -p "只回复 OK"

ANTHROPIC_API_KEY 是为了避免另一种认证变量抢先生效。地址写 https://moerouter.com,不带 /v1:Claude Code 自己会拼上 /v1/messages。
方法 B:写进用户配置#
长期使用时,编辑 ~/.claude/settings.json(Windows 是 %USERPROFILE%\.claude\settings.json),把下面的 env 字段合并进去。已有的 permissions、hooks、MCP 配置不要删。
{
"env": {
"ANTHROPIC_BASE_URL": "https://moerouter.com",
"ANTHROPIC_AUTH_TOKEN": "sk-YOUR-MOEROUTER-KEY",
"ANTHROPIC_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
}
}
文件里有明文 Key,在 macOS 和 Linux 上执行 chmod 600 ~/.claude/settings.json。然后开一个新终端运行 claude。
| 变量 | 作用 |
|---|---|
ANTHROPIC_MODEL |
启动时默认用的模型 |
ANTHROPIC_DEFAULT_OPUS_MODEL、…_SONNET_MODEL、…_HAIKU_MODEL |
/model 里三档各自对应的模型。Claude Code 内部的小任务会用 Haiku 那一档 |
如果配置里同时有 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN,确保它们是同一个 MoeRouter Key,或者只留一个,免得旧凭据盖掉新配置。
验证#
第一次运行交互式 claude 会依次出现主题选择、安全提示、是否信任当前文件夹。用了自定义地址后不会要求登录 Anthropic 账号,这是正常的。


进入后输入 /status,确认 Anthropic base URL 是 https://moerouter.com,Model 是你配置的模型:

/status 里能看到认证来源、地址和模型。下面两行提示“custom ANTHROPIC_BASE_URL 时不拉取远程托管设置”,属于正常现象。
再到控制台的使用日志里核对这次请求。
选哪个模型#
Claude Code 走 Anthropic Messages 接口,所以要选模型广场里端点带 anthropic 的模型。
| 模型 | 说明 |
|---|---|
claude-opus-5-5 |
旗舰,适合长文写作和硬核工程 |
claude-sonnet-5-5 |
日常编码的主力 |
claude-haiku-4-5 |
快而便宜,适合填在 Haiku 那一档 |
gpt-6.1-terra、deepseek-v4-pro、gemini-3.8-flash 等 |
不是 Claude 模型,但支持 Messages 接口,也可以填进 ANTHROPIC_MODEL |
关于价格#
default 分组里,同一个模型可能有不止一条线路,价格各不相同。模型广场显示的是参考价;每次请求按实际走到的那条线路结算,可能高于参考价,扣了多少以使用日志为准。原因和算法见计费与额度。
想让 Claude 模型的价格固定下来,可以给 Key 选 stable 分组:每个模型只有一条线路,按固定倍率计费。见分组与倍率。
恢复#
- 临时变量:
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN,或者直接关掉终端。 - 写进文件的:删掉这次加的字段。
- 回到官方订阅:运行
claude后按提示重新登录。
常见问题#
| 现象 | 原因 | 处理 |
|---|---|---|
| 提示版本不支持 | Claude Code 版本低于 2.1.280 | claude update,然后重开会话。第三方应用要更新它内置的 SDK |
| 401 | Key 不完整,或者被 ANTHROPIC_API_KEY 里的旧值盖掉了 |
检查两个认证变量 |
| 404,提示模型不能通过这个接口调用 | 选的模型不支持 Messages 接口 | 换一个端点带 anthropic 的模型 |
| 改了配置没生效 | 已经在运行的会话不会重读配置 | 开新终端 |
input_schema 无效 |
某个 MCP 服务或自定义工具的参数定义有问题 | 更新或暂时禁用它,再新建会话 |
更多报错见报错对照表。