OmniRoute 快速上手从安装到接入免费 Provider 与 IDE/CLI 的完整指南【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 352 providers (150 free), 1200 models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline Copilot. Quota-aware auto-fallback, RTKCaveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 550 contributors项目地址: https://gitcode.com/GitHub_Trending/om/OmniRoute本篇基于 OmniRoute 官方快速上手文档覆盖其“安装 → 启动 → 接入免费 Provider → 验证 → 接入 IDE/CLI”五步全流程并结合仓库源码与配置文件补充了运行环境要求、端口与 CLI 入口等实操细节。读完本篇你可以零成本跑起一个本地 AI 网关并让 Claude Code、Codex 等工具通过单一 OpenAI 兼容端点自动路由到多个上游模型。核心理念安装、连接免费 Provider、指向 IDE三步完成官方文档给出的最短路径是安装 → 连接一个免费 Provider → 把你的 IDE 指向 OmniRoute原文 TL;DR。OmniRoute 启动后监听http://localhost:20128对外暴露 OpenAI 兼容接口如/v1/models、/v1/chat/completions对上游则自动完成 Provider 选择与故障切换。文档同时强调你可以不付费使用它——通过接入免费 ProviderKiro、OpenCode Free、Pollinations 等即可获得模型能力。第一步安装 OmniRoute三种方式方式 Anpm官方推荐npm install -g omniroute方式 BDockerdocker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest文档特别提示镜像标签语义:latest指向当前已发布的最高稳定 SemVer不跟踪 gitmain分支如果你需要 GitOps 式的可复现部署应固定为diegosouzapw/omniroute:X.Y.Z具体版本号。详见 Docker 指南 中的 Release Channels 章节。方式 C从源码安装git clone https://github.com/diegosouzapw/OmniRoute.git cd OmniRoute npm install npm run dev运行环境要求来自仓库源码查阅 package.json 可以确认几点与实操直接相关的约束包名为omniroute当前仓库版本为3.8.51engines声明 Node 版本要求为22.22.2 23 || 24.0.0 27即需要 Node 22≥22.22.2或 Node 2426安装全局包前建议先node -v确认bin字段注册了两个可执行入口omniroute对应 bin/omniroute.mjs与omniroute-reset-password因此 npm 全局安装后即可获得文档后续步骤使用的omniroute命令npm run dev实际执行的是node --max-old-space-size8192 scripts/dev/run-next.mjs dev即通过自定义脚本拉起 Next.js 开发服务器npm start走同一个入口的start模式。第二步启动 OmniRouteomniroute启动后服务运行在http://localhost:20128仪表盘会自动打开。端口 20128 的源码依据在仓库源码中20128是贯穿前后端的默认端口约定——例如 package.json 中electron:dev脚本会用wait-on http://localhost:20128等待服务就绪后再启动 Electron 窗口前端仪表盘代码如 EndpointPageClient.tsx/dashboard/endpoint/EndpointPageClient.tsx) 与 buildCurl.ts/dashboard/providers/utils/buildCurl.ts)中也大量引用该端口生成请求示例。从源码结构看所有 curl 示例、Base URL 默认值都围绕这个本地端口展开因此把 IDE 指向http://localhost:20128/v1是最自然的组合。第三步连接一个免费 Provider以下三个 Provider 均无需 API Key操作路径一致打开http://localhost:20128仪表盘 →Providers→Add Provider→ 选择 Provider → 点击Connect。Provider特点Kiro AI免费使用 Claude 系模型无需信用卡OpenCode Free免认证提供多个模型Pollinations无需 Key可访问 GPT-5、Claude、Gemini 等更多模型完成任意一项后你就拥有了一条免费的模型访问通路。更多付费/免费 Provider 的接入方式见 Providers Guide 与 Free Tiers Guide。第四步创建 API Key 并验证网关打开仪表盘的API Keys页面路径为/dashboard/api-manager创建一个新 Key。务必立即保存该 Key——它只会显示一次。注意文档的语义区分这把 Key 是你的工具用来访问 OmniRoute 自身的凭证而不是访问上游 Provider 的凭证。用 curl 验证模型列表curl http://localhost:20128/v1/models -H Authorization: Bearer YOUR_KEY如果能看到已连接 Provider 提供的模型列表说明网关链路正常。第五步把 IDE 或 CLI 指向 OmniRoute在你的 IDE 或 CLI 工具中统一设置三项Base URL: http://localhost:20128/v1 API Key: [从 Dashboard → Endpoints 复制] Model: autoauto的含义让 OmniRoute 对每个请求自动挑选最合适的 Provider权衡速度、成本、质量与可用性详见 Auto-Combo Guide。IDE 示例VSCode Continue.dev在 VSCode 中安装 Continue.dev 扩展通过 VSCode 扩展市场安装。修改~/.continue/config.yaml加入- name: OmniRoute - Auto provider: openai model: auto apiBase: http://localhost:20128/v1 apiKey: YOUR_KEY在 Continue.dev 聊天面板选择OmniRoute - Auto请求即经 OmniRoute 转发。文档还留了一个“读者练习”让 AI 帮你把其它预置配置也写进config.yaml。CLI 示例Codex CLI持久化设置环境变量。macOS/Linux 写入~/.bashrc或~/.zshrcexport OMNIROUTE_API_KEYYOUR_KEYWindows 命令提示符setx OMNIROUTE_API_KEY YOUR_KEY用 OmniRoute 自带的一键启动器拉起 Codexomniroute launch-codex --model auto你也可以手动运行codex并通过命令行参数指定端点与 API Key但launch-codex会自动替你完成全部配置。同理通用启动器omniroute run target还支持claude、codex、aider、goose、opencode、qwen、gemini等目标详见 CLI Integrations。启动后 CLI 的流量即指向 OmniRoute。确认工具确实在走 OmniRoute点击仪表盘左侧栏的Monitoring/Logs路径/dashboard/logs查看请求详情。文档特别指出一个附带价值这里可以看到你的 Agent/CLI 实际上游发送了哪些信息对学习其内部行为和排查问题都很有帮助。常见问题FAQ“我需要 API Key 吗”不需要。Kiro、OpenCode Free、Pollinations 等免费 Provider 无需任何 API Key在仪表盘连接即可。“auto是什么”自动路由模式由 OmniRoute 根据速度、成本、质量与可用性为每个请求挑选 Provider见 Auto-Combo Guide。“要花多少钱”OmniRoute 本身免费且开源MIT 协议你只为所使用的上游 Provider 付费大量 Provider 提供免费额度见 Free Tiers Guide。“能用于 Claude Code / Cursor / Copilot 吗”可以。任何支持 OpenAI 格式的工具都能接入只需把 Base URL 设为http://localhost:20128/v1具体配置见 CLI Tools Guide。“某个 Provider 挂了怎么办”OmniRoute 会自动跳过失败 Provider 并尝试下一个无需人工干预机制细节见 Auto-Combo Guide。下一步与排障Auto-Combo Guide —— 让 OmniRoute 替你挑选最佳模型Providers Guide —— 接入更多免费/付费 ProviderFree Tiers Guide —— 免信用卡的免费 AI 额度Troubleshooting —— 常见问题修复手册以上即 OmniRoute 官方快速上手文档的完整五步流程。核心要点回顾npm 安装后一条omniroute命令即可在 20128 端口起服务接入 Kiro/OpenCode Free/Pollinations 任一免费 Provider 即可零成本运行工具端统一使用http://localhost:20128/v1 API Key auto模型名用/dashboard/logs验证流量确实经过网关。注意本文基于当前仓库 v3.8.51 的实际内容Node 版本等环境约束以 package.json 中的声明为准。【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 352 providers (150 free), 1200 models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline Copilot. Quota-aware auto-fallback, RTKCaveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 550 contributors项目地址: https://gitcode.com/GitHub_Trending/om/OmniRoute创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OmniRoute 快速上手：从安装到接入免费 Provider 与 IDE/CLI 的完整指南
OmniRoute 快速上手从安装到接入免费 Provider 与 IDE/CLI 的完整指南【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 352 providers (150 free), 1200 models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline Copilot. Quota-aware auto-fallback, RTKCaveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 550 contributors项目地址: https://gitcode.com/GitHub_Trending/om/OmniRoute本篇基于 OmniRoute 官方快速上手文档覆盖其“安装 → 启动 → 接入免费 Provider → 验证 → 接入 IDE/CLI”五步全流程并结合仓库源码与配置文件补充了运行环境要求、端口与 CLI 入口等实操细节。读完本篇你可以零成本跑起一个本地 AI 网关并让 Claude Code、Codex 等工具通过单一 OpenAI 兼容端点自动路由到多个上游模型。核心理念安装、连接免费 Provider、指向 IDE三步完成官方文档给出的最短路径是安装 → 连接一个免费 Provider → 把你的 IDE 指向 OmniRoute原文 TL;DR。OmniRoute 启动后监听http://localhost:20128对外暴露 OpenAI 兼容接口如/v1/models、/v1/chat/completions对上游则自动完成 Provider 选择与故障切换。文档同时强调你可以不付费使用它——通过接入免费 ProviderKiro、OpenCode Free、Pollinations 等即可获得模型能力。第一步安装 OmniRoute三种方式方式 Anpm官方推荐npm install -g omniroute方式 BDockerdocker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest文档特别提示镜像标签语义:latest指向当前已发布的最高稳定 SemVer不跟踪 gitmain分支如果你需要 GitOps 式的可复现部署应固定为diegosouzapw/omniroute:X.Y.Z具体版本号。详见 Docker 指南 中的 Release Channels 章节。方式 C从源码安装git clone https://github.com/diegosouzapw/OmniRoute.git cd OmniRoute npm install npm run dev运行环境要求来自仓库源码查阅 package.json 可以确认几点与实操直接相关的约束包名为omniroute当前仓库版本为3.8.51engines声明 Node 版本要求为22.22.2 23 || 24.0.0 27即需要 Node 22≥22.22.2或 Node 2426安装全局包前建议先node -v确认bin字段注册了两个可执行入口omniroute对应 bin/omniroute.mjs与omniroute-reset-password因此 npm 全局安装后即可获得文档后续步骤使用的omniroute命令npm run dev实际执行的是node --max-old-space-size8192 scripts/dev/run-next.mjs dev即通过自定义脚本拉起 Next.js 开发服务器npm start走同一个入口的start模式。第二步启动 OmniRouteomniroute启动后服务运行在http://localhost:20128仪表盘会自动打开。端口 20128 的源码依据在仓库源码中20128是贯穿前后端的默认端口约定——例如 package.json 中electron:dev脚本会用wait-on http://localhost:20128等待服务就绪后再启动 Electron 窗口前端仪表盘代码如 EndpointPageClient.tsx/dashboard/endpoint/EndpointPageClient.tsx) 与 buildCurl.ts/dashboard/providers/utils/buildCurl.ts)中也大量引用该端口生成请求示例。从源码结构看所有 curl 示例、Base URL 默认值都围绕这个本地端口展开因此把 IDE 指向http://localhost:20128/v1是最自然的组合。第三步连接一个免费 Provider以下三个 Provider 均无需 API Key操作路径一致打开http://localhost:20128仪表盘 →Providers→Add Provider→ 选择 Provider → 点击Connect。Provider特点Kiro AI免费使用 Claude 系模型无需信用卡OpenCode Free免认证提供多个模型Pollinations无需 Key可访问 GPT-5、Claude、Gemini 等更多模型完成任意一项后你就拥有了一条免费的模型访问通路。更多付费/免费 Provider 的接入方式见 Providers Guide 与 Free Tiers Guide。第四步创建 API Key 并验证网关打开仪表盘的API Keys页面路径为/dashboard/api-manager创建一个新 Key。务必立即保存该 Key——它只会显示一次。注意文档的语义区分这把 Key 是你的工具用来访问 OmniRoute 自身的凭证而不是访问上游 Provider 的凭证。用 curl 验证模型列表curl http://localhost:20128/v1/models -H Authorization: Bearer YOUR_KEY如果能看到已连接 Provider 提供的模型列表说明网关链路正常。第五步把 IDE 或 CLI 指向 OmniRoute在你的 IDE 或 CLI 工具中统一设置三项Base URL: http://localhost:20128/v1 API Key: [从 Dashboard → Endpoints 复制] Model: autoauto的含义让 OmniRoute 对每个请求自动挑选最合适的 Provider权衡速度、成本、质量与可用性详见 Auto-Combo Guide。IDE 示例VSCode Continue.dev在 VSCode 中安装 Continue.dev 扩展通过 VSCode 扩展市场安装。修改~/.continue/config.yaml加入- name: OmniRoute - Auto provider: openai model: auto apiBase: http://localhost:20128/v1 apiKey: YOUR_KEY在 Continue.dev 聊天面板选择OmniRoute - Auto请求即经 OmniRoute 转发。文档还留了一个“读者练习”让 AI 帮你把其它预置配置也写进config.yaml。CLI 示例Codex CLI持久化设置环境变量。macOS/Linux 写入~/.bashrc或~/.zshrcexport OMNIROUTE_API_KEYYOUR_KEYWindows 命令提示符setx OMNIROUTE_API_KEY YOUR_KEY用 OmniRoute 自带的一键启动器拉起 Codexomniroute launch-codex --model auto你也可以手动运行codex并通过命令行参数指定端点与 API Key但launch-codex会自动替你完成全部配置。同理通用启动器omniroute run target还支持claude、codex、aider、goose、opencode、qwen、gemini等目标详见 CLI Integrations。启动后 CLI 的流量即指向 OmniRoute。确认工具确实在走 OmniRoute点击仪表盘左侧栏的Monitoring/Logs路径/dashboard/logs查看请求详情。文档特别指出一个附带价值这里可以看到你的 Agent/CLI 实际上游发送了哪些信息对学习其内部行为和排查问题都很有帮助。常见问题FAQ“我需要 API Key 吗”不需要。Kiro、OpenCode Free、Pollinations 等免费 Provider 无需任何 API Key在仪表盘连接即可。“auto是什么”自动路由模式由 OmniRoute 根据速度、成本、质量与可用性为每个请求挑选 Provider见 Auto-Combo Guide。“要花多少钱”OmniRoute 本身免费且开源MIT 协议你只为所使用的上游 Provider 付费大量 Provider 提供免费额度见 Free Tiers Guide。“能用于 Claude Code / Cursor / Copilot 吗”可以。任何支持 OpenAI 格式的工具都能接入只需把 Base URL 设为http://localhost:20128/v1具体配置见 CLI Tools Guide。“某个 Provider 挂了怎么办”OmniRoute 会自动跳过失败 Provider 并尝试下一个无需人工干预机制细节见 Auto-Combo Guide。下一步与排障Auto-Combo Guide —— 让 OmniRoute 替你挑选最佳模型Providers Guide —— 接入更多免费/付费 ProviderFree Tiers Guide —— 免信用卡的免费 AI 额度Troubleshooting —— 常见问题修复手册以上即 OmniRoute 官方快速上手文档的完整五步流程。核心要点回顾npm 安装后一条omniroute命令即可在 20128 端口起服务接入 Kiro/OpenCode Free/Pollinations 任一免费 Provider 即可零成本运行工具端统一使用http://localhost:20128/v1 API Key auto模型名用/dashboard/logs验证流量确实经过网关。注意本文基于当前仓库 v3.8.51 的实际内容Node 版本等环境约束以 package.json 中的声明为准。【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 352 providers (150 free), 1200 models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline Copilot. Quota-aware auto-fallback, RTKCaveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 550 contributors项目地址: https://gitcode.com/GitHub_Trending/om/OmniRoute创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考