说明: CodeRouter 是我们的产品,一个专门给编程 agent 用的路由。下文关于 OpenRouter 的内容都来自 OpenRouter 自己的公告和文档(2026 年 11 月 9 日核对,文中附链接),引号里是原文的意思翻译;涉及 CodeRouter 的地方会明确说明。
2026 年 11 月 6 日,OpenRouter 发布了重做的 Auto Router,以及一个"专门针对编程工作"的新路由:Auto Code,模型 ID 是 openrouter/auto-code。简单说,在 Claude Code、Codex、Cursor 或自己写的 agent 里把模型名填成它,OpenRouter 就会替你决定每一轮用哪个模型、用多大的推理强度。
这篇讲清楚三件事:Auto Code 怎么工作、花多少钱、编程 agent 的路由到底该怎么选。
一、Auto Code 和 Auto Router 是什么关系
OpenRouter 的 Auto Router 家族有三个成员(文档):
| 模型 ID | 用途 |
|---|---|
openrouter/auto |
通用路由,为每个请求选模型和推理强度,适合混合流量和通用 agent |
openrouter/auto-code |
专门给编程 agent 和编程工具用 |
openrouter/auto-beta |
实验通道,新改动先在这里上线 |
按 Auto Code 文档的说法,Auto Code 和 Auto Router 用同一个路由引擎,只是策略针对编程调过,区别有三点:
- 起步就在更高的成本档,档里有更强的编程模型;
- 更看重速度;
- 对失败罚得更重:测试没过、同一个错误反复出现时,会更快纠正方向。
二、它怎么为每一轮选模型
文档把过程分成五步:
- 缩小模型池:护栏策略、零数据保留(ZDR)、模型能力、服务商限制、BYOK 密钥,以及你设置的允许/排除列表,决定哪些模型参与选择。
- 给这一轮打分:一个快速的判断模型评估这一轮,比如是哪类编程任务、任务是不是刚换了、有多难、换更大的模型或多想一会儿有没有帮助。公告里说,新路由会综合每个请求的十一个因素。
- 选模型和推理强度:路由策略综合各模型、各推理强度下实测的通过率、速度和每个解决任务的成本,再加上实时价格和缓存状态。
- 交给服务商:和直接调用这个模型走同一套服务商路由。
- 把信号带到下一轮:Auto Code 更倾向于调整推理强度而不是换模型,以保住提示缓存;只有失败信号表明是模型本身的问题时才换。
对编程 agent 来说,缓存是关键。Agent 每一轮都会把整段上下文重新发一遍,换模型就意味着新模型要从头建缓存。OpenRouter 文档直说"换模型要多花钱",所以路由会克制换模型;公告提到,测试期间 Auto Router 在接近十分之九的 agent 轮次里都留在同一个模型上。
会话识别:OpenRouter 根据请求里的 session_id 识别同一个会话;不传的话,就根据消息内容的指纹识别。给 agent 用时,文档建议传 session_id 或 x-session-id 请求头。
三、收不收费
- 路由本身不收费:"你按实际处理每个请求的那个模型的标准价格付费,Auto Code 不额外收费。"
- 模型价格原样转付:OpenRouter 的 FAQ 说,按底层服务商的价格计费,不加价。
- 买额度时收平台费:按 OpenRouter 定价页,平台费在购买额度(credits)时收取,Standard 方案 5.5%,Business 方案 8%,Enterprise 有费率折扣。
所以一个 Auto Code 会话的花费 = 每一轮被选中的模型各自的费用之和,再加上买额度时的平台费。因为每一轮的模型可能不同,单轮价格事先不固定;每个响应的 model 字段会告诉你是哪个模型回答的。加上请求头 X-OpenRouter-Metadata: enabled,还能拿到这次选择的候选模型、推理强度、预估成本和理由。
OpenRouter 自己公布的效果:Auto Code 在 Deep SWE、SWE-Atlas QA、Terminal Bench 4.0、τ³-bench Banking、MMMU Pro Vision 五个基准上"得分与 Claude Opus 5.5 相当,每个任务的成本低 74%"。这是 OpenRouter 的测量,我们没有复现。
更完整的费用说明(BYOK 额度、免费模型限制、最低充值)见英文文章 OpenRouter pricing in 2026。
四、在 Claude Code 里怎么用
按 OpenRouter 的 Claude Code 指南:
export OPENROUTER_API_KEY="<你的 OpenRouter key>"
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY="" # 必须显式设为空
以前用 Anthropic 账号登录过 Claude Code 的,先在 Claude Code 里执行一次 /logout,退出后重新启动;用 /status 确认 Auth token 是 ANTHROPIC_AUTH_TOKEN、base URL 是 https://openrouter.ai/api。
想让 Auto Code 选模型:Auto Code 文档说在工具填模型名的地方填 openrouter/auto-code,Claude Code 填模型名的地方就是 ANTHROPIC_DEFAULT_SONNET_MODEL 等变量。注意两点:OpenRouter 的指南说 Claude Code 走 OpenRouter 时"只保证 Anthropic 官方服务商可用",而 Auto Code 可能选到非 Anthropic 的模型;如果只想在 Claude 模型之间选,可以在 OpenRouter 工作区的 Routing 页面设置允许列表(如 anthropic/*),Auto Code 会遵守。
逐步说明和排错表见英文文章 How to use a model router with Claude Code。
五、编程 agent 的路由怎么选
现实中有四种做法:
| OpenRouter Auto Code | CodeRouter | 直连服务商,固定模型 | 自建 LiteLLM | |
|---|---|---|---|---|
| 谁选模型 | 判断模型给每一轮打分,策略选模型和推理强度 | 小判断模型读最新消息和工具输出,代码在四个固定档位里选 | 你自己 | 你自己配置 |
| 模型范围 | OpenRouter 全目录(600+),按允许/排除列表缩小 | Claude Haiku 5.5、Kimi K2.6、Claude Sonnet 5.5、Claude Opus 5.5 | 一家服务商的模型 | 用自己的 key 接 140+ 服务商 |
| Agent 会话中换模型 | 倾向调推理强度;失败信号指向模型时才换 | 会话开始时定档;代码改动没通过测试或 agent 停滞不前时才升档,不降档 | 不换 | 看配置 |
| 标价之外的费用 | 路由免费;买额度时 5.5% 或 8% 平台费 | 用量标价 +8%;Team 另加每位开发者每月 $19 | 无 | 开源版免费,自己运维服务器 |
OpenRouter 一栏引自其文档和定价页(2026 年 11 月 9 日核对);LiteLLM 一栏来自我们的 CodeRouter vs LiteLLM 页面。
适合 OpenRouter Auto Code:已经在用 OpenRouter 额度;想要最大的模型池(包括开源模型)、同时让路由决定推理强度;需要 Business/Enterprise 方案的功能,比如欧盟/美国区域内路由、SSO。
适合 CodeRouter:开销主要来自编程 agent,希望按 agent 正在做的事(规划、实现、调试)在一小组固定模型里选;希望 agent 会话停在一个模型上、只在改动失败或停滞时升档,而且规则公开(见 llms.txt);团队需要每人一个 key、按人和项目设预算、到 100% 自动降档或暂停;偶尔也想自己指定模型(同一个按量付费账户里切换 Direct 模式)。
两个都不用的情况:
- 你已经知道用哪个模型。 团队几乎所有事都用同一个模型、账单也能接受,就直接调用服务商:没有额外费用,也不会因为中途换模型丢缓存。
- 数据必须留在自己的基础设施里,或者已经和服务商签了合同。 自建 LiteLLM:MIT 开源、免费,直接付钱给服务商,但要自己运维代理、Postgres 和 Redis。
- 流量主要不是编程。 CodeRouter 不是为这个设计的,用通用路由或固定模型更合适。
无论选哪个,都别只看路由自己报的"省了多少"。不同模型完成同一个任务的步数不同,单个请求的价格推算不出整个会话的花费。最可靠的办法是用自己一周的真实会话,按会话比较成本和缓存命中率。检查清单见 What to measure before you pick a coding router。
关于 CodeRouter 的价格
按量付费:从预付余额按模型标价 +8% 扣费,没有月费,同一个账户可以用智能路由(模型名 auto)或 Direct 模式(自己指定模型)。Team:每位开发者每月 $19,用量按标价 +8%。新账户有 7 天试用,含 $5 用量,可用除 Claude Opus 以外的所有模型。详情见定价;不注册也可以在 Playground 粘贴一个任务,看智能路由会从哪个模型开始、为什么。
常见问题
OpenRouter Auto Code 是什么?
OpenRouter 上的模型路由,模型 ID openrouter/auto-code,专门给编程 agent 和编程工具用,为每一轮选择模型和推理强度。
Auto Code 收费吗? 路由本身不收费。你按每一轮实际使用的模型付标准价格,另外在购买 OpenRouter 额度时付平台费(Standard 5.5%,Business 8%)。
openrouter/auto 和 openrouter/auto-code 有什么区别?
同一个引擎。Auto Code 的策略针对编程:起步档位更高、更看重速度、对失败罚得更重。
Auto Code 会不会破坏提示缓存? OpenRouter 说它优先调整推理强度而不是换模型,只有失败信号指向模型时才换;测试期间 Auto Router 接近十分之九的 agent 轮次留在同一个模型上。
Claude Code 能用 Auto Code 吗?
可以把 Claude Code 的模型变量设成 openrouter/auto-code。但 OpenRouter 只保证 Claude Code 在 Anthropic 官方服务商上可用,Auto Code 可能选到其他模型,可以用 Routing 页面的允许列表限制。
CodeRouter 和 OpenRouter 有什么不同? OpenRouter 是一个接入大量模型的平台,Auto Code 是其中的编程路由;CodeRouter 只做编程场景的路由,在四个固定档位之间选,agent 会话的规则公开。英文对比页:CodeRouter vs OpenRouter。
来源(2026 年 11 月 9 日核对):OpenRouter 公告、Auto Code 文档、Auto Router 文档、OpenRouter 定价、OpenRouter FAQ、OpenRouter Claude Code 指南。OpenRouter 的条款可能变化,以其官网为准。