Claude Code 环境变量配置
设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，四步将 Claude Code 全部流量路由到 TheRouter.ai
https://api.therouter.ai 根域名，不是https://api.therouter.ai/v1。这和 Cursor 等 OpenAI 兼容工具的接法不一样。第一步 — 安装 Claude Code
如果还没装过：
npm install -g @anthropic-ai/claude-code第二步 — 配置环境变量
Claude Code 有三个模型层级：默认模型（Sonnet）、快速模型（Haiku）、高级推理模型（Opus）。 把三个都配上，确保所有场景都走 TheRouter。
ANTHROPIC_MODEL 是否是已知的 Anthropic 模型名。 请使用 Anthropic 原生格式（如 claude-sonnet-4-6）， 不要用 TheRouter 的 brand/model-name 格式。 TheRouter 在收到请求时会自动解析这些名称。export THEROUTER_API_KEY="sk-..."
# 指向 TheRouter
export ANTHROPIC_BASE_URL="https://api.therouter.ai"
export ANTHROPIC_AUTH_TOKEN="$THEROUTER_API_KEY"
export ANTHROPIC_API_KEY=""
# 三个模型层级（使用 Anthropic 原生格式）
export ANTHROPIC_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"各变量说明
ANTHROPIC_BASE_URL— 把所有 Anthropic SDK 请求重定向到 TheRouterANTHROPIC_AUTH_TOKEN— 你的 TheRouter API KeyANTHROPIC_API_KEY— 必须设为空字符串，防止回落到直连 AnthropicANTHROPIC_MODEL— 日常任务的默认模型（Sonnet 层级）ANTHROPIC_DEFAULT_HAIKU_MODEL— 轻量快速任务模型（Haiku 层级）ANTHROPIC_DEFAULT_OPUS_MODEL— 复杂推理任务模型（Opus 层级）
第三步 — 验证是否生效
打开一个新的终端窗口（让环境变量生效），启动 Claude Code，然后输入 /status 查看当前配置：
claude
# 在 Claude Code 内输入：
/status正确的 /status 输出
应该看到 TheRouter 的 base URL 和你配置的模型别名：
Model: claude-sonnet-4-6
Small/fast model: claude-haiku-4-5
Opus model: claude-opus-4-6
API base: https://api.therouter.ai
claude-sonnet-4-5-20250514 之类带日期后缀的名称， 说明你的环境变量没有生效。确认是否在新终端中启动了 Claude Code， 或者检查 settings.json 的路径是否正确（~/.claude/settings.json）。第四步 — 安装 TheRouter Skill（可选）
安装后 Claude Code 会更懂 TheRouter 的模型目录、路由策略、BYOK、错误处理等。 这是一个本地参考文件，不会向外发送任何数据。
curl -fsSL https://www.therouter.ai/ai/skill/install.sh | bash安装后可以这样问 Claude Code：
> 帮我接入 TheRouter API
> 哪个模型做摘要最便宜？
> 帮我调试 TheRouter 429 错误
> 给我的聊天机器人设置模型 fallback常见问题排查
/status 仍显示 Anthropic 原始模型名
环境变量在启动时读取。设置后必须打开新终端再运行 claude。如果用 settings.json，确认文件在 ~/.claude/settings.json（不是项目目录内）。
请求能用，但没有经过 TheRouter
如果没有把 ANTHROPIC_API_KEY 显式设为空字符串，Claude Code 可能静默回落到你系统上已有的 Anthropic 密钥。务必显式设为 ""。
报错 "There's an issue with the selected model"
Claude Code 会验证 ANTHROPIC_MODEL 是否是已知的 Anthropic 模型名。如果使用 TheRouter 的 brand/model-name 格式（如 anthropic/claude-sonnet-4.6），会被拒绝。 请使用 Anthropic 原生格式：claude-sonnet-4-6。 TheRouter 会自动解析这些名称。
报错 "model not found" 或 404
用 curl 确认模型在 TheRouter 上可用。避免使用带日期后缀的 上游原始名称（如 claude-sonnet-4-6-20250514）， 使用不带日期的基础名称（如 claude-sonnet-4-6）。
Base URL 和其他工具搞混了
Claude Code（Anthropic SDK）用 https://api.therouter.ai，Cursor/Windsurf/Cline 等 OpenAI 兼容工具用 https://api.therouter.ai/v1。搞混会导致连接失败。