用 OmniRoute 拼一套零成本模型组合：免费供应商怎么接、回退链怎么排

2026-07-27

数据截至 2026-07，价格与限额以各官网为准。

OmniRoute 能帮你把”零成本用上 AI 编程工具”这件事从碰运气变成有结构：它不是替你变出免费额度，而是把多个各自有免费档的供应商串成一条带自动回退的链路，当前一个额度用完时自动落到下一个。真正决定这条路能不能走通的，不是网关本身好不好装，而是你选的那几个上游供应商在你的网络环境下能不能连上、免费档还在不在。

先说一个常见误解。很多人看到”290+ 供应商、500+ 模型、一个端点全接住”这种描述，第一反应是”那我配好之后就再也不用花钱了”。这个理解偏了。OmniRoute 是个路由层，它自己不产生额度，所有免费额度都来自上游供应商各自的免费政策，而这类政策的调整频率相当高——今天写着”无限免费”的条目，过一阵子可能变成限速、限量甚至下线。所以正确的心态是：把它当成一个降低切换成本的工具，而不是一张长期饭票。

OmniRoute 到底是什么

按仓库自述，OmniRoute 是一个 MIT 协议的免费 AI 网关，用一个端点接住 290+ 家供应商（其中 90+ 家有免费档）、500+ 个模型，覆盖 Kimi、Claude、GPT、OpenAI、Gemini、GLM、DeepSeek、MiniMax 这些常见的名字。它可以对接 Claude Code、Codex、Cursor、OpenCode、Cline、Copilot 等工具。

核心卖点其实就一句话：在你的工具里把接口地址填成 http://localhost:20128/v1，剩下的选哪家、走哪个模型、额度用完怎么办，都交给网关处理。

它的来路也值得说一句：OmniRoute 由 9router fork 而来，是 Go 项目 CLIProxyAPI 的 TypeScript 移植。换句话说这不是一个凭空冒出来的新项目，而是在一条已有的技术路线上继续走。至于星标数和供应商数量，不同来源口径不一（有说 268+ 也有说 290+），第三方资料称 23k+ GitHub stars、500+ 贡献者——这些数字都属于仓库自述或第三方统计，看个量级就行，别当成硬指标。

装起来：两条路，选一条

最快的方式是 npx，不用先想清楚要不要长期留着：

npx omniroute@latest

如果你更习惯容器化部署，或者想让它在服务器上常驻：

docker run -p 20128:20128 diegosouzapw/omniroute

跑起来之后打开 http://localhost:20128 就是管理面板。

仓库称提供了 80+ 条命令，日常真正会用到的其实是这几个：

omniroute —— 启动网关和面板，端口 20128
omniroute setup —— 首次运行向导，第一次装完先走一遍
omniroute chat —— 交互式 TUI 聊天，用来快速验证链路通不通
omniroute doctor —— 自检，配置出问题时先跑它
omniroute models --search <关键词> —— 查某个模型当前有没有可用供应商，也可以走 GET /api/models/catalog

我的建议是装完先 setup 再 doctor，最后用 chat 发一句话确认真的能出字。这三步走完再去接你的 IDE，比出了问题之后回头猜是哪一层断了要省事得多。

加第一个免费供应商

在面板里走这条路径：左侧 Providers → + Add Provider → 搜索并点选你要的那家 → 免费供应商无需凭证，直接 Connect → 点 Test Connection 验证。也可以直接访问 /dashboard/providers。

这里有个容易被忽略的点：供应商的认证类型分四种，接入难度差别不小。

OAuth：由 OmniRoute 代管登录流程，不需要你自己去申请 API key，对新手最友好。
web cookie：靠浏览器 cookie 认证。
API key：通常是付费供应商，部分带免费额度，要你自己先去对应平台申请。
Local：本地模型，比如 Ollama、LM Studio、vLLM 这类。

想走零成本路线，优先挑前面两种和 Local，因为它们不需要你先在别处充钱。

文档给的起步建议是从 Kiro AI 开始：免费、无需 API key、可以用 Claude 系模型。这是个合理的第一站，因为它把”要不要绑卡”这个最劝退的环节直接跳过了。除了 Kiro，目录里标为免费的选项还包括 OpenCode Free 和 Pollinations。仓库称目录中 90+ 家有免费档，其中 40+ 家永久免费——注意这是仓库文档当前版本的说法，实际以你打开面板当时看到的为准。

回退链怎么排：一条可抄的思路

只接一家免费供应商，额度用完就断，体验会很难受。OmniRoute 的做法是：接多个免费供应商，就能启用自动回退（fallback），而且它是配额感知的——前一个额度耗尽时会自动切到下一个。

仓库给出的零成本组合示例长这样：

gemini-cli/gemini-3-flash-preview   （每月 180K 免费）
    ↓ 额度用完
if/kimi-k2                          （无限免费）
    ↓
qw/qwen3-coder-plus                 （无限免费）

这个排法的逻辑其实很清楚：把有明确额度上限但质量更好的放在最前面先用，把标称无限但可能限速的放在后面兜底。 你自己排链路时可以照这个思路来——先排你最想用的，最后一位一定放一个”再差也能出字”的。

另外，模型这一栏填 "auto" 时由 OmniRoute 自动挑选，适合你不在乎具体走哪个模型、只要有结果的场景。如果你要指定，模型 ID 用供应商原生格式，仓库给的示例是 claude-opus-4-8、gpt-5.5、glm-5.1、kimi-k2.5。有些 ID 带点号版本号看着别扭，那是因为上游 API 本身就是这么要求的，不是网关的写法怪。

接到你的编程工具上

配置逻辑对所有 OpenAI 兼容的工具都一样：把接口地址指到 http://localhost:20128/v1。除了前面提到的几个，仓库还列了 Kiro、Command Code、Antigravity、Windsurf、AMP，以及任意 OpenAI 兼容工具。33 个工具的逐一配置写在 docs/reference/CLI-TOOLS.md 里，接你自己那个工具之前先去翻一下对应条目，比自己猜参数快。

OpenCode 的接法稍微特殊一点，走的是插件：@omniroute/opencode-provider。

除了路由，它还带了几样附加能力：RTK+Caveman 压缩，仓库称能省 15%-95% 的 token；支持 MCP / A2A；另有 Desktop 版和 PWA。压缩这个区间跨度极大，说明效果高度依赖你的具体内容形态，别按上限去做预期。想理解 MCP 这层是干什么的，可以看 MCP 协议是什么？一篇讲清它解决的问题。

诚实说局限：这条路不适合谁

这一节比前面所有配置步骤都重要，因为它决定你要不要投入时间。

第一，免费额度是流沙，不是地基。 项目仓库的文档自己也反复强调：免费额度类信息变动极快，“无限免费”不是承诺，一切以仓库文档当前版本为准。如果你要做的是有交付压力的生产项目，把关键路径押在一条随时可能变的免费链上，是拿项目进度赌运气。生产环境该付费还是得付费，可以参考 AI 编程工具成本怎么算这类算账思路。

第二，网络访问是硬前提。 OmniRoute 装在你本地，但请求最终还是要发到各家上游。OpenAI、Google Gemini、Anthropic 这些厂商的官方服务并不支持中国大陆直连，网关不会改变这个事实——它只是帮你换个入口，连不上的还是连不上。所以在大陆环境里，实际能稳定用起来的往往是国内可访问的那部分供应商和本地模型（Local 那一类）。市面上确实存在第三方中转服务，但那属于另一个话题，风险和合规性需要你自己判断，这里不做推荐也不背书。

第三，凭证要过你的本地代理。 这是一个第三方聚合网关，你把各家账号的凭证（OAuth 授权、cookie、API key）都交给了本地运行的这个进程。开源可审计是加分项，但不等于你可以不看就用。至少做到两点：一是从官方仓库 github.com/diegosouzapw/OmniRoute 拿代码，别从来路不明的镜像装；二是别把你的主力付费账号凭证一股脑塞进去测试，先用无关紧要的免费账号跑通。企业环境里还要额外考虑，把公司账号凭证交给第三方工具是否符合内部合规要求——这一步别自己拍板。

第四，多一层就多一处故障点。 直连供应商时报错原因通常很直接；套上网关之后，“没出字”可能是网关配置错、可能是上游额度耗尽、也可能是回退链上某一环挂了。所以前面才建议先用 omniroute chat 单独验证链路，把网关这一层排除掉再去查工具那一层。

什么情况下它确实划算

说完不适合，也说说真正合适的场景：

学习和练手阶段：不想为了试个工具先绑卡，用免费档跑通流程完全够用。
频繁横向对比模型：一个端点切模型，比每家单独配一遍省事很多。
有明确的降级需求：主力模型额度用完时不希望工作直接中断，宁可用差一点的模型继续。
本地模型混用：Local 类型能把 Ollama 之类的本地部署和云端供应商放在同一条链路里，本地兜底、云端提质。

小结

OmniRoute 的价值在于把”多供应商切换”这件原本很琐碎的事变成一次配置：装好之后所有工具都指向 http://localhost:20128/v1，选哪家、怎么回退交给网关。零成本组合的排法有个简单原则——有额度上限但质量好的排前面，标称无限的放后面兜底。但免费额度随时会变，仓库自述的数字只能当参考不能当承诺，真正有交付压力的项目别把关键路径押在上面。在大陆网络环境下，还要先确认你选的上游本身是否可达，网关不解决访问权限问题。最后，凭证交给第三方工具这件事值得慎重，个人练手可以放开手脚，企业账号请先过合规这一关。