OmniRoute · Lesson 1 / 6

OmniRoute 基础

统一 AI 网关

你学过了 Claude Code（AI 编码工具）和 Stitch（AI 设计工具）。OmniRoute 是连接它们的基础设施—— 一个统一网关，让你用一个端点对接 250+ AI 提供商，自动做故障转移、成本优化、Token 压缩。

什么是 OmniRoute？

OmniRoute 是一个开源的 AI 网关（MIT 许可），运行在你自己的机器上。它在你的编程工具和 AI 提供商之间插入一层，提供统一的 /v1 端点（兼容 OpenAI 格式），自动处理路由、故障转移、配额管理、成本优化。

💡 一句话理解

OmniRoute = 你的 AI "交换机"。所有工具（Claude Code、Cursor、Cline…）接到一个口，由它帮你智能分配到最合适的 AI 模型。

架构与请求流

你的工具（Claude Code / Cursor / Cline …）
        ↓
http://localhost:20128/v1
        ↓
OmniRoute 智能路由器
        ↓
4 层故障转移：订阅 → API Key → 低价模型 → 免费模型
        ↓
250+ AI 提供商（OpenAI / Anthropic / Google / 免费提供商…）

核心能力

能力	说明
250+ 提供商	所有主流 AI 厂商 + 社区网关，90+ 有免费层
18 种路由策略	priority、cost-optimized、round-robin、fusion（多模型融合）等
Token 压缩 15-95%	10 引擎堆叠压缩，代码和结构化数据无损保留
4 层故障转移	订阅 → API Key → 低价 → 免费，毫秒级切换
MCP 服务器	94 个工具，3 种传输方式
断路器	自动检测上游故障并恢复
配额共享	团队共享一个订阅，公平分配
零遥测	所有请求只发给你选择的提供商

安装

npm install -g omniroute
omniroute

启动后：

仪表板：http://localhost:20128
API 端点：http://localhost:20128/v1

兼容工具（24+）

所有工具只需配置 Base URL 指向 http://localhost:20128/v1：

类别	工具
编码 CLI	Claude Code、Codex CLI、OpenCode、Kilo Code
IDE	Cursor、Copilot、Continue
云端 Agent	Codex Cloud、Cursor Cloud、Devin、Jules
其他	Cline、Antigravity、Windsurf、Roo Code 等

免费提供商

提供商	免费模型	额度
Kiro	Claude Sonnet/Haiku/Opus	~50 credits/月
Qoder	Kimi-K2、DeepSeek-R1	无限免费
Qwen	Qwen3 系列	无限免费
Pollinations	GPT-5、Claude、Gemini	无需密钥
LongCat	LongCat-2.0	1000 万 Token
Cloudflare AI	50+ 模型	1 万 neurons/天
NVIDIA NIM	129 模型	~40 RPM

动手练习

🎯 练习：安装并启动 OmniRoute

安装
```
npm install -g omniroute
```
启动
```
omniroute
```
打开仪表板
浏览器打开 http://localhost:20128，看看仪表板。
查看提供商列表
在仪表板中查看可用的提供商和模型。
注意那些标注"免费"的提供商。

关键要点

课后推荐阅读

GitHub 仓库 — 源码、Issues、文档
OmniRoute 官网 — 官方文档和社区
npm 包 — 安装和版本信息

下一课讲路由策略——18 种策略怎么选。