OmniRoute 是本地运行的 AI gateway，把多个 provider 暴露为一个 OpenAI-compatible base URL，供 Claude Code、Codex、Cursor、Cline 等客户端接入。
来源：官方 Releases 查看 GitHub 仓库 → 📘 使用教程 →官方 v3.8.50 README 还列出 359 provider、150+ 免费条目和 1,200+ 模型，但这些目录和额度会变化。
来源：官方 Releases官方 README 同时给出 npm 全局安装和 Docker 镜像路径，默认服务端口为 20128。
来源：github.com/diegosouzapw/OmniRoute启动后 dashboard 位于 localhost:20128，客户端使用 OpenAI-compatible 的 /v1 base URL。
来源：github.com/diegosouzapw/OmniRoutesetup 负责首次配置，doctor 检查 provider/端口/原生依赖，路由层负责切换 provider 和模型。
来源：github.com/diegosouzapw/OmniRoute客户端请求先到本地 OmniRoute gateway，再由 gateway 按配置转发到上游 provider；dashboard、凭据存储和路由策略属于本地 gateway 的运维边界。
来源：官方 ReleasesNode.js/npm 或 Docker上游 provider 凭据需要自定义 base URL 的客户端同时使用多个模型 provider 或多个 Coding Agent，需要统一 base URL、回退和模型别名的人。
来源：官方 Releasesv3.8.50（2026-08-26，官方 release）。
来源：官方 Releasesstatus: official_docs_checked_not_locally_installed | checked_at: 2026-09-22 | environment: 核对官方 README 与 v3.8.50 release；未在当前工作区启动 gateway 或连接真实 provider | limitations: 未验证每个 provider 的实时额度、OAuth 流程或客户端高级协议兼容性 | observed_output: 官方命令包含 npm install -g omniroute、omniroute setup、默认端口 20128 和 omniroute doctor；
来源：官方 Releases相比每个客户端分别配置 provider，OmniRoute 统一了 base URL 和路由；如果只用一个 provider，直接使用官方 SDK 或客户端配置更少。
来源：官方 Releases同时使用多个模型 provider 或多个 Coding Agent，需要统一 base URL、回退和模型别名的人。采用前需要核对：本地 gateway 不代表请求留在本机。
来源：官方 Releases默认使用 20128；dashboard 是 http://localhost:20128，API 是 http://localhost:20128/v1。可用 PORT 修改。
命名卷 omniroute-data 挂载到 /app/data；如果使用源码或 npm，可通过 DATA_DIR 指定目录。
先用 auto 验证路由能工作；需要稳定复现时再填写明确的 provider/model，并记录版本和配置。
gateway 自己在本机运行，但它会把请求转发给你配置的上游 provider。
运行 omniroute --version，并对照官方 v3.8.50 release；若版本不同，应优先看对应 release notes。