OmniRoute 是一个开源 AI 网关项目，通过一个端点连接 237 个 AI 提供商（其中 90+ 个免费），并提供自动故障转移、智能路由和 Token 压缩功能。它的核心口号是"Never stop coding"——让你的 AI 编码工具永不因配额问题而中断。

什么是 OmniRoute？

OmniRoute 由开发者 diegosouzapw 发起，核心理念很简单：把所有 AI 提供商统一到一个 OpenAI 兼容的端点下，让任何 AI 工具都能无缝对接。

你只需配置一个本地网关，然后把 Claude Code、Cursor、Cline、Copilot 等工具都指向这个网关。网关会智能选择最优的 AI 提供商——可以是最快的、最便宜的、质量最好的，也可以是配额最充足的。

当某个提供商出问题或配额用完时，系统会自动切换到备用方案，整个过程对开发者完全透明。

核心功能亮点

免费 Tokens 池

OmniRoute 聚合了 40+ 个提供商池、500+ 个模型的免费额度。它会去重计数——多个服务商共享同一免费池时只算一次，确保数据真实可信。

4 层自动故障转移

OmniRoute 设计了 4 层故障转移机制，确保 AI 服务永不中断：

• 订阅层：优先使用付费订阅的服务商（如 Claude Code、Codex、Copilot）
• API Key 层：订阅配额用完时，自动切换到已配置的 API Key 提供商
• 便宜层：使用成本极低的模型（如 GLM，约 $0.5/1M tokens）
• 免费层：最后兜底，使用永久免费的提供商

整个切换过程在毫秒级完成，几乎感觉不到任何中断。

15-95% Token 压缩

AI 编码工具输出（如 git diff、日志、grep 结果）往往占据大量 tokens。OmniRoute 集成了 RTK + Caveman 压缩技术，智能过滤和压缩这些内容，平均可节省 15-95% 的 tokens 消耗。

17 种路由策略

OmniRoute 提供 17 种路由策略，可按场景灵活组合：

• priority：按优先级顺序使用，用尽一个再切换下一个
• cost-optimized：自动选择成本最低的模型
• headroom：优先选择配额最充足的提供商
• lkgp：优先使用最近成功的提供商（Last-Known-Good Path）
• fusion：并行请求多个模型，由"裁判"模型综合最优答案

内置 MCP 服务器

OmniRoute 内置了 MCP（Model Context Protocol）服务器，支持 95 个工具和 30 个权限范围，方便扩展。

快速上手指南

安装方式

OmniRoute 支持多种安装方式：

npm 安装（最简单）：

npm install -g omniroute

Docker 运行：

docker run -p 20128:20128 diegosouzapw/omniroute

也提供 Electron 桌面应用，支持 Windows、macOS、Linux。

启动服务

omniroute start

服务默认运行在 http://localhost:20128/v1。

配置工具

将你的 AI 编码工具指向 OmniRoute 端点：

• Claude Code：在设置中配置 API Base URL 为 http://localhost:20128/v1
• Cursor：在设置中配置自定义 API 端点
• 其他工具：类似配置 OpenAI API 的方式，将 base URL 指向本地网关

使用 Auto 模式

最简单的方式是使用 auto 模式，OmniRoute 会自动构建虚拟组合并实时评分：

• auto/coding — 代码生成优化
• auto/fast — 最低延迟优先
• auto/cheap — 最低成本优先
• auto/offline — 配额最充足优先
• auto/smart — 质量优先 + 10% 探索

自定义 Combo

你可以在仪表盘中创建自定义 combo，指定路由策略和提供商顺序：

Combo: "always-on"
Strategy: priority
1. cc/claude-code       # 订阅层：Claude Code
2. cx/copilot           # 备用订阅：GitHub Copilot
3. ds/deepseek-chat     # 便宜层：DeepSeek
4. kg/kilo-code         # 免费层：Kilo Code

总结

OmniRoute 解决了一个实际痛点：如何让 AI 编码工具永不因配额问题中断。它通过聚合免费额度、智能路由和自动故障转移，大幅降低了 AI 使用成本和管理复杂度。

项目完全开源免费，零成本启动，GitHub 已获得 21K+ Star。

• 项目地址：https://github.com/diegosouzapw/OmniRoute
• 官网：https://omniroute.online