Claude Code 模型路由详解：为什么 Base URL 不等于换模型

很多人在配置 Claude Code 中转站时会有一个误解：把 ANTHROPIC_BASE_URL 改成中转站地址，就等于把模型也换掉了。实际上不是。

Base URL 只决定请求发到哪里，模型路由决定请求最终用哪个模型。两者有关联，但不是一回事。

Claude Code 选择模型的几种方式

官方模型配置文档说明，Claude Code 可以在会话中用 /model 切换模型，也可以启动时用 claude --model 指定，还可以通过 ANTHROPIC_MODEL 环境变量或 settings 文件里的 model 字段配置。

claude --model sonnet
# 或者
export ANTHROPIC_MODEL=sonnet
claude

Base URL 做什么

ANTHROPIC_BASE_URL 只把 Claude Code 的请求路由到 proxy 或 gateway。网关收到请求后，还需要识别请求里的模型名，再把它映射到某个上游模型。

中转站为什么要做模型映射

Claude Code 可能请求 sonnet、opus、完整 Claude 模型 ID，或者某些部署环境里的别名。中转站如果只认识自己的内部模型名，就需要建立映射表。

modelOverrides 是什么

官方模型配置文档还提到，企业或第三方部署场景可以用 modelOverrides 把 Claude Code 的模型别名映射到部署方需要的目标模型 ID。需要注意，直接通过 ANTHROPIC_MODEL、--model 或默认模型环境变量提供的值，会按原样传给 provider，不会被 modelOverrides 转换。

常见误区

• 误区一：改 Base URL 就等于换模型；
• 误区二：模型选择器里能看到就一定能调用；
• 误区三：普通聊天模型能用，Claude Code 全部功能就一定能用；
• 误区四：model not found 是本地安装问题。

正确排查方式

如果模型相关报错出现，先确认 Claude Code 发出的模型名，再看中转站后台有没有这个模型名或映射规则。站长最好在日志里保留原始 model 字段，用户也要避免同时设置多个模型变量。

如果你不想自己维护网关、证书、模型映射、上游兼容和各种错误排查，可以了解 YYLX.IO 鱼鱼连线。它更适合想直接稳定使用 Claude Code、Codex、Gemini CLI、Cline 等 AI 编程工具的用户。

总结

Base URL 是入口，模型路由是分发规则。Claude Code 要稳定接入中转站，必须同时处理 endpoint、鉴权、模型名和映射。

参考资料：Claude Code model configuration、Claude Code environment variables。