Back to Blog

OpenRouter Auto Code 是什么?编程 Agent 路由怎么选(2026)

2026-11-09·3 min read·CodeRouter Team

说明: 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 用同一个路由引擎,只是策略针对编程调过,区别有三点:

二、它怎么为每一轮选模型

文档把过程分成五步:

  1. 缩小模型池:护栏策略、零数据保留(ZDR)、模型能力、服务商限制、BYOK 密钥,以及你设置的允许/排除列表,决定哪些模型参与选择。
  2. 给这一轮打分:一个快速的判断模型评估这一轮,比如是哪类编程任务、任务是不是刚换了、有多难、换更大的模型或多想一会儿有没有帮助。公告里说,新路由会综合每个请求的十一个因素。
  3. 选模型和推理强度:路由策略综合各模型、各推理强度下实测的通过率、速度和每个解决任务的成本,再加上实时价格和缓存状态。
  4. 交给服务商:和直接调用这个模型走同一套服务商路由。
  5. 把信号带到下一轮:Auto Code 更倾向于调整推理强度而不是换模型,以保住提示缓存;只有失败信号表明是模型本身的问题时才换。

对编程 agent 来说,缓存是关键。Agent 每一轮都会把整段上下文重新发一遍,换模型就意味着新模型要从头建缓存。OpenRouter 文档直说"换模型要多花钱",所以路由会克制换模型;公告提到,测试期间 Auto Router 在接近十分之九的 agent 轮次里都留在同一个模型上。

会话识别:OpenRouter 根据请求里的 session_id 识别同一个会话;不传的话,就根据消息内容的指纹识别。给 agent 用时,文档建议传 session_id 或 x-session-id 请求头。

三、收不收费

所以一个 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 模式)。

两个都不用的情况:

无论选哪个,都别只看路由自己报的"省了多少"。不同模型完成同一个任务的步数不同,单个请求的价格推算不出整个会话的花费。最可靠的办法是用自己一周的真实会话,按会话比较成本和缓存命中率。检查清单见 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 的条款可能变化,以其官网为准。

延伸阅读(英文)

Try phase-aware routing on your own workload

One base URL for Claude Code, Cursor or Aider. Free trial, no credit card.

Start free trial

Get weekly AI cost optimization tips

Join developers cutting their agent bills