MoeRouter 文档 获取 API Key

Claude Code 接入 MoeRouter

用两个环境变量或 settings.json 把 Claude Code 指向 MoeRouter,选好 Opus、Sonnet、Haiku 三档模型,并用 /status 验证。

更新于 2026-11-15 阅读约 3 分钟 实测:Claude Code 2.1.323 · macOS

本页目录
  1. 安装
  2. 方法 A:只在当前终端生效
  3. 方法 B:写进用户配置
  4. 验证
  5. 选哪个模型
  6. 关于价格
  7. 恢复
  8. 常见问题

想省事可以用 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"
手动设置环境变量后运行 claude -p,返回 OK
输入 Key 时不回显,Key 也不会进入 shell 历史。清掉 ANTHROPIC_API_KEY 是为了避免另一种认证变量抢先生效。

地址写 https://moerouter.com,不带 /v1:Claude Code 自己会拼上 /v1/messages。

方法 B:写进用户配置#

长期使用时,编辑 ~/.claude/settings.json(Windows 是 %USERPROFILE%\.claude\settings.json),把下面的 env 字段合并进去。已有的 permissions、hooks、MCP 配置不要删。

~/.claude/settings.json
{
  "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 账号,这是正常的。

首次启动的安全提示
按 Enter 继续。
询问是否信任当前文件夹
选“Yes, I trust this folder”。只在你自己的项目目录里这样做。

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

Claude Code 的 /status 输出
/status 里能看到认证来源、地址和模型。下面两行提示“custom ANTHROPIC_BASE_URL 时不拉取远程托管设置”,属于正常现象。
Claude Code 正常对话
启动画面显示“API Usage Billing”,表示走的是按量计费的 API。

再到控制台的使用日志里核对这次请求。

选哪个模型#

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 服务或自定义工具的参数定义有问题 更新或暂时禁用它,再新建会话

更多报错见报错对照表。

↑↓ 选择Enter 打开可以直接粘贴报错原文