OmniRoute CLI 集成实战用setup-*与omniroute run把所有编码 CLI 接到一个 AI 网关【免费下载链接】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 官方指南 docs/guides/CLI-INTEGRATIONS.md含其 i18n 译本 docs/i18n/pl/docs/guides/CLI-INTEGRATIONS.md的深度展开。它讲解 OmniRoute 内置的一族setup-*配置命令、omniroute configure交互式配方、omniroute run target通用启动器与两个遗留 launch 命令覆盖 Codex、Claude Code、OpenCode、Cline、Kilo、Continue、Cursor、Roo、Crush、Goose、Aider、Qwen 乃至 Gemini CLI 的接入方式。读完你将掌握如何让任意编码 CLI 只面对一个端点、如何让 API Key 只存在于环境变量而不落盘、如何从本地或远程 OmniRoute 实时拉取模型目录并生成对应工具的原生配置文件以及如何用omniroute run零配置临时拉起这些 CLI。一、设计核心一个端点 实时模型目录 环境变量引用OmniRoute 的 CLI 集成思路非常统一你的工具只跟一个后端说话默认http://localhost:20128至于请求被路由到哪家上游、如何自动故障转移auto-fallback全部交给 OmniRoute。每条setup-*命令做三件事实时读取模型目录从一个正在运行的 OmniRoute本地或远程抓取当前的模型列表而不是使用内置的静态清单写出目标工具自己的配置文件例如 Codex 的~/.codex/name.config.toml、Claude Code 的~/.claude/profiles/name/settings.json、OpenCode 的~/.config/opencode/opencode.json尽量用环境变量引用 API Key凡是目标工具支持环境变量的地方密钥只被引用如{env:OMNIROUTE_API_KEY}、$OMNIROUTE_API_KEY不会以明文写进配置文件。个别工具需要持久化本地环境文件时指南会在主表中单独标注。提供方provider的 onboarding 也复用同一个本地/远程上下文。下面这组 API-first 命令把管理端鉴权与上游凭据分开并且结构化输出中绝不打印凭据本身omniroute providers add glm --credential-env GLM_API_KEY --name work omniroute providers import ./providers.json --dry-run --json omniroute providers auth openai omniroute providers edit connection-id --default-model glm/glm-5.2 omniroute providers remove connection-id --yes脚本场景优先用--credential-stdin或--credential-env从标准输入或环境变量取凭据--credential仅保留给受控的本地交互使用。providers remove在非交互终端上必须显式加--yes。这五个命令全部尊重当前的活跃上下文active context也接受全局的--base-url/--api-key选项。二、命令总表每个 CLI 写入什么、支持哪些关键标志下面这张主表完整列出所有集成命令信息与 bin/cli/cli-manifest.mjs 中声明的能力语义一致。表中本地 vs 远程的含义是不带任何标志时默认目标为http://localhost:20128带--remote或存在活跃远程上下文时从该服务器拉取目录但配置文件始终写在你本机。命令工具写入内容关键标志本地 vs 远程omniroute setup-codexOpenAI Codex CLI~/.codex/name.config.toml— 每个兼容文本模型一个 profilecodex --profile name使用--remote--api-key--only--dry-run--port--codex-home两者omniroute setup-claudeClaude Code~/.claude/profiles/name/settings.json— 每个匹配模型一个 profile受CLAUDE_CONFIG_DIR影响--remote--api-key--only--dry-run--port--claude-home两者omniroute setup-opencodeOpenCodeopenai 兼容~/.config/opencode/opencode.json— 名为omniroute的 provider含目录全部模型opencode -m omniroute/model--remote--api-key--only--model--dry-run--port两者omniroute setup-clineCline~/.cline/data/{globalState,secrets}.jsonCLI 模式 打印 VS Code 扩展设置--remote--api-key--model--yes--dry-run--port--cline-dir两者omniroute setup-kiloKilo Code~/.local/share/kilo/auth.jsonCLI 若存在 VS Codesettings.json则合并kilocode.*--remote--api-key--model--yes--dry-run--port--auth-path--vscode-settings两者omniroute setup-continueContinue /cnCLI~/.continue/config.yaml—provider: openai模型密钥经${{ secrets.OMNIROUTE_API_KEY }}--remote--api-key--only--dry-run--port--config-path两者omniroute setup-cursorCursor什么都不写 — 只打印应用内操作步骤Cursor 配置是封闭的 SQLite--remote--api-key--only--port两者omniroute setup-rooRoo Code~/.omniroute/roo-settings.json导入文档 若存在 VS Codesettings.json则设置roo-cline.autoImportSettingsPath--remote--api-key--model--yes--dry-run--port--import-path--vscode-settings两者omniroute setup-crushCrush~/.config/crush/crush.json—openai-compatprovider密钥经$OMNIROUTE_API_KEY--remote--api-key--only--dry-run--port--config-path两者omniroute setup-gooseGoose~/.config/goose/config.yamlGOOSE_PROVIDER/OPENAI_HOST/GOOSE_MODEL 打印环境变量配方--remote--api-key--model--yes--dry-run--port--config-path两者omniroute setup-aiderAider~/.aider.conf.ymlopenai-api-basemodel: openai/id 打印环境变量配方--remote--api-key--model--yes--dry-run--port--config-path两者omniroute setup-qwenQwen Code~/.qwen/settings.json— V4 版modelProviders.openai数组 OMNIROUTE_API_KEY写入~/.qwen/.env--remote--api-key--model--yes--dry-run--port--config-path--env-path两者omniroute run target运行时启动通用什么都不写 — 用正确环境与参数拉起claude/codex/aider/goose/opencode/qwen/geminiQwen 与 Gemini 使用临时隔离主目录--remote--base-url--context--provider--model--api-key--api-key-env--dry-run--json--port--profile--token两者omniroute launchClaude Code什么都不写 — 注入ANTHROPIC_BASE_URL/ANTHROPIC_AUTH_TOKEN后拉起claude--remote--api-key--token--profile--port两者omniroute launch-codexOpenAI Codex CLI什么都不写 — 通过-c标志注入omnirouteprovider 后拉起codex--remote--api-key--profile-p--port两者关键标志语义依据命令源码验证--remote url从远程 OmniRoute 拉取目录覆盖--port与活跃上下文。--api-key key提供该服务器的凭据缺省时回退到环境变量OMNIROUTE_API_KEY或活跃上下文的 token。--only patterns逗号分隔的子串只保留匹配的模型 ID如--only glm,kimi。可用在setup-codex、setup-claude、setup-opencode、setup-continue、setup-cursor、setup-crush上。--dry-run只打印将要写入的内容绝不触碰文件系统。除setup-cursor它本来就不写文件外每个setup-*命令都支持。--model id对于没有模型自动发现能力的工具Cline、Kilo、Roo、Goose、Qwen、Aider是必需的否则交互式选择。这些工具还接受--yes做非交互运行此时仍要求--model。setup-opencode用--model设置顶层默认模型。omniroute run上的--model id遵循清单manifest的 per-target 接线见 bin/cli/cli-manifest.mjsaider收到--model openai/idopencode收到--model omniroute/id仅当 id 自身不带前缀时才追加qwen与gemini原样收到 idclaude通过ANTHROPIC_MODEL环境变量获得goose通过GOOSE_MODELcodex通过-c model_providers.omniroute.*参数。Qwen 是唯一硬性要求--model的 run 目标—omniroute run qwen不带模型会以退出码2结束并给出明确报错。--port port本地 OmniRoute 端口默认20128设置--remote时忽略存在于所有setup-*与两个 launch 命令。omniroute run退出码约定子 CLI 自身的退出码原样透传2 参数非法不支持的目标、缺少必需的--model、容器保护触发127 目标二进制不在PATH中130/143/129 启动被SIGINT/SIGTERM/SIGHUP终止1 其他运行时启动失败。两个遗留启动器launch、launch-codex接受--profile name来选用setup-claude/setup-codex生成的 profile并把多余参数透传给底层的claude/codex二进制。三、omniroute configure共享的交互式配方入口setup-*之外的另一种用法是交互式配置器configure它复用同一个本地/远程模型目录选择器# 从活跃的本地或远程模型目录中选择然后配置目标工具 omniroute configure claude omniroute configure opencode --provider glm omniroute configure qwen --model qwen/qwen3.8-max-preview --yes从源码结构看configure目前委托给经过测试的配方模块对应 bin/cli/commands/configure.mjs 中的SETUP_MODULES覆盖codex、claude、opencode、qwen、aider、goose、cline、continue、kilo仅 IDE、仅 MITM、仅指南类的目录条目仍然走显式的setup-*或手工流程不会作为可启动目标呈现。目标清单、别名解析与模型标志接线全部来自 bin/cli/cli-manifest.mjs 这一份唯一声明run.mjs、configure.mjs、completion.mjs都从它派生并有 tests/unit/cli/cli-manifest-drift.test.ts 防止各消费面与运行时刻表服务端目录src/shared/services/cliRuntime.ts静默漂移。注意区分两个 OpenCode 集成setup-opencode是轻量 openai 兼容接入而omniroute setup opencode注意没有横线是另一种插件式接入会安装omniroute/opencode-plugin。两者是不同命令本文主表记录的是setup-opencode。插件还按 OpenCode 主版本拆成两个包omniroute/opencode-pluginOpenCode v1与omniroute/opencode-plugin-v2OpenCode v2因为两代加载器期望不同的入口点v2 包0.1.0遵循仍在演进的主机契约从 OpenCode 注入目录草稿的形状读取数据而非自行假定。四、本地使用OmniRoute 跑在 localhost:20128OmniRoute 在localhost:20128运行时直接执行对应工具的配置命令即可模型目录从本地服务器拉取# Codex为每个匹配模型写入 profile 到 ~/.codex/ omniroute setup-codex codex --profile glm52 # 使用生成的 profile # Claude Code为每个模型写 profile然后启动其中一个 omniroute setup-claude omniroute launch --profile glm52 # OpenCode写入含全部目录模型的 openai 兼容 provider omniroute setup-opencode export OMNIROUTE_API_KEYsk-... # 通过 {env:OMNIROUTE_API_KEY} 引用绝不落盘 opencode -m omniroute/glm/glm-5.2 ... # 没有自动发现能力的工具需要显式模型 omniroute setup-aider --model glm/glm-5.2 omniroute setup-qwen --model qwen/qwen3.8-max-preview # 预览将写入的内容而不实际写入 omniroute setup-continue --dry-run零配置临时启动launch与omniroute run不想在任何地方留下配置时可以只用环境注入来启动omniroute launch # Claude Code → 本地 OmniRoute omniroute launch-codex # Codex CLI → 本地 OmniRoute omniroute launch-codex --profile glm52 omniroute run claude --model openai/gpt-5.4 omniroute run codex --model openai/gpt-5.4 --dry-run --json omniroute run aider --model glm/glm-5.2 -- --message reply OK omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run reply OK omniroute run qwen --model glm/glm-5.2 -- -p reply OK omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p reply OK # 显式命令路径把 -- 之后的所有参数原样透传 omniroute run claude -- --print-system-prompt review this diffrun的实现bin/cli/commands/run.mjs会为每个目标构造一个启动计划launch plan解析目标别名cc、anthropic→claudeopenai→codex等、决定凭据来源显式选项 / 环境变量名 / 活跃上下文、注入对应的环境变量差集env diff并把--之后的参数原样交给子进程。测试 tests/unit/cli/run-command.test.ts 验证了这些行为例如 Aider 得到--model openai/glm/glm-5.2与OPENAI_API_BASE/OPENAI_API_KEY注入OpenCode 通过OPENCODE_CONFIG_CONTENT进程级覆盖配置且序列化结果中不含密钥明文Qwen 缺--model时按/requires --model/拒绝Gemini 注入GOOGLE_GEMINI_BASE_URL/GEMINI_API_KEY/GEMINI_DEFAULT_AUTH_TYPE。五、远程使用指向 VPS 或 Tailnet 上的 OmniRoute把任意配置命令指向远程 OmniRoute只需--remote--api-key目录从远程拉取配置仍写在本机。# OpenCode 指向远程 VPS只保留 glm/kimi 模型 omniroute setup-opencode --remote http://192.168.0.15:20128 --api-key oma_live_xxx \ --only glm,kimi opencode -m omniroute/glm/glm-5.2 ... # 先导出 OMNIROUTE_API_KEY # 从远程目录生成 Codex profiles omniroute setup-codex --remote http://192.168.0.15:20128 --api-key oma_live_xxx # 直接让 CLI 打到远程 omniroute launch --remote http://192.168.0.15:20128 --api-key oma_live_xxx omniroute launch-codex --remote http://192.168.0.15:20128 --api-key oma_live_xxx与其每次手传--remote/--api-key不如登录一次让活跃上下文自动提供omniroute connect 192.168.0.15 # 铸造限定范围 token 并保存上下文 omniroute setup-codex # ← 此后自动使用远程目录 omniroute setup-opencode # ← 同理 omniroute launch # ← Claude Code 打到远程上下文、token 范围与管理的细节见 docs/guides/REMOTE-MODE.md。六、Base URL 约定哪些工具要/v1OmniRoute 在/v1暴露 OpenAI 兼容面、在根路径暴露 Anthropic 兼容面、在/v1beta暴露原生 Gemini 面。每条集成都被接到其工具期望的形式在命令源码中验证集成写入的 Base URL带/v1setup-clineopenAiBaseUrl根路径否 — Cline 自行追加/v1/chat/completionssetup-gooseOPENAI_HOST根路径否 — Goose 自行追加路径setup-aiderOPENAI_API_BASE根路径否 — LiteLLM 追加/v1/chat/completionssetup-kilo、setup-roo、setup-continue、setup-crush、setup-cursor带/v1是setup-claudeANTHROPIC_BASE_URL、launch根路径否 — Claude Code 追加/v1/messagessetup-codex、launch-codexmodel_providers.omniroute.base_url带/v1是setup-qwenmodelProviders.openai[].baseUrl带/v1是run geminiGOOGLE_GEMINI_BASE_URL根路径否 — SDK 追加/v1beta/models/…这一行看似琐碎却是为什么有些集成写根路径、有些写/v1的直接答案配置写入方总是给出目标工具会自己补全的最小正确形式避免双写路径段如…/v1/v1/chat/completions造成的 404。七、更新时保住原生依赖--includeoptional执行omniroute update确认后或带--apply时更新器内部始终以--includeoptional运行安装npm install -g omniroutelatest --includeoptional注意这不是传给omniroute update的标志而是更新器内建行为。它保证optionalDependenciesbetter-sqlite3、keytar、tls-client、LLMLingua SLM 栈在更新后依然存活——即使你的 npm 配置设了omitoptional否则原生 SQLite 驱动与 OS keyring 绑定会被静默移除。想只看将要执行的精确命令而不真正执行omniroute update --dry-run # [DRY RUN] 将执行: npm install -g omniroutelatest --includeoptionalomniroute update的其他标志源码验证--check有更新时退出 1、--apply不提示直接安装、--changelog、--no-backup、--yes。八、专项通过omniroute run gemini使用 Google Gemini CLIGemini CLI 的启动契约是针对google/gemini-cli0.50.0 验证过的该 CLI 尊重GOOGLE_GEMINI_BASE_URL并向它发出POST /v1beta/models/model:generateContent以及:streamGenerateContent?altsse——正好命中 OmniRoute 的原生 Gemini 面/v1beta。omniroute run gemini自动完成以下接线GOOGLE_GEMINI_BASE_URL→ 活跃的 OmniRoute 根 URL根路径不带/v1GEMINI_API_KEY→ 解析后的 OmniRoute 凭据选项 / 环境变量 / 上下文临时隔离的GEMINI_CLI_HOME其.gemini/settings.json选中gemini-api-key鉴权因此本机存储的 Google OAuth 会话Code Assist永远不会覆盖由 OmniRoute 定向的启动——退出后目录即被删除环境净化子进程环境会清掉GOOGLE_API_KEY、GOOGLE_GENAI_USE_VERTEXAI、GOOGLE_GENAI_USE_GCA它们会把鉴权重定向到 Vertex / Code Assist并设置GEMINI_DEFAULT_AUTH_TYPEgemini-api-key作为双保险——其余run目标对各自冲突的环境变量也做同样的处理--model id由--provider/--model注入。omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p helloGemini 的工作区信任保护在无头模式下仍然生效——请自行传入--skip-trust或交互式信任目录启动器刻意不绕过它。此外这个启动器与ACP 注册src/lib/acp/registry.ts 中的gemini --acp是两回事后者是面向/dashboard/acp-agents的代理协议集成。九、可选的真烟测用真实二进制打真实服务器CI 中跑的是确定性的启动计划回归tests/unit/cli/run-command.test.ts、tests/unit/cli/run-execution.test.ts。要拿真实CLI 二进制去验证真实OmniRoute 服务器仓库提供了一套可选测试装置 tests/integration/upstream-cli-smoke.int.test.ts。它从不自动运行除非设置RUN_CLI_SMOKE1否则每个子测试都跳过凭据通过环境变量名传递绝不传值任何记录的输出中密钥形态的字符串都会被脱敏未安装二进制的目标会被跳过并且把失败归类为鉴权 / 上游 / 配置三类而非简单布尔值RUN_CLI_SMOKE1 \ OMNIROUTE_SMOKE_BASE_URLhttp://localhost:20128 \ OMNIROUTE_SMOKE_MODELprovider/model \ OMNIROUTE_SMOKE_API_KEY_ENVOMNIROUTE_API_KEY \ node --import tsx/esm --test tests/integration/upstream-cli-smoke.int.test.ts可选参数OMNIROUTE_SMOKE_TARGETScodex,opencode,qwen限定目标范围OMNIROUTE_SMOKE_TIMEOUT_MS覆盖每个目标 120 秒的默认超时。十、从源码看这套机制的可靠性保障单一事实来源bin/cli/cli-manifest.mjs 对每个目标声明run/configure能力、别名与runModel接线如 aider 的{flag: --model, prefix: openai/}、opencode 的prefix: omniroute/、qwen 的required: true。run、configure、shell completion 全部从这份清单派生。漂移防护tests/unit/cli/cli-manifest-drift.test.ts 断言清单中的每个目标都存在于服务端运行时刻表src/shared/services/cliRuntime.ts、每个 alias 在两侧映射一致、configure目标都有对应配方模块、bash/zsh/fish 补全输出包含全部目标词以及模型标志接线如manifestModelArgs(aider, glm/glm-5.2)必须返回[--model, openai/glm/glm-5.2]始终与清单一致。密钥不落盘run计划中密钥以环境变量名或临时注入的方式存在测试断言JSON.stringify(plan)不包含密钥明文见 tests/unit/cli/run-command.test.ts 中对 OpenCode、Gemini 的断言。十一、相关文档docs/guides/CLAUDE-CODE-CONFIGURATION.md — Claude Code 深度配置指南含一次性手写的[model_providers.omniroute]基础配置docs/guides/CODEX-CLI-CONFIGURATION.md — Codex CLI 一次性基础配置docs/guides/REMOTE-MODE.md — 远程模式上下文、限定范围访问 token、驱动远程服务器docs/guides/VSCODE-COPILOT.md — OmniCopilot 扩展可在编辑器内代跑这些setup-*命令docs/reference/CLI-TOOLS.md — 受支持工具的完整目录与对应的仪表盘页面docs/guides/SETUP_GUIDE.md — 安装方式与首次运行引导【免费下载链接】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 CLI 集成实战用setup-*与omniroute run把所有编码 CLI 接到一个 AI 网关【免费下载链接】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 官方指南 docs/guides/CLI-INTEGRATIONS.md含其 i18n 译本 docs/i18n/pl/docs/guides/CLI-INTEGRATIONS.md的深度展开。它讲解 OmniRoute 内置的一族setup-*配置命令、omniroute configure交互式配方、omniroute run target通用启动器与两个遗留 launch 命令覆盖 Codex、Claude Code、OpenCode、Cline、Kilo、Continue、Cursor、Roo、Crush、Goose、Aider、Qwen 乃至 Gemini CLI 的接入方式。读完你将掌握如何让任意编码 CLI 只面对一个端点、如何让 API Key 只存在于环境变量而不落盘、如何从本地或远程 OmniRoute 实时拉取模型目录并生成对应工具的原生配置文件以及如何用omniroute run零配置临时拉起这些 CLI。一、设计核心一个端点 实时模型目录 环境变量引用OmniRoute 的 CLI 集成思路非常统一你的工具只跟一个后端说话默认http://localhost:20128至于请求被路由到哪家上游、如何自动故障转移auto-fallback全部交给 OmniRoute。每条setup-*命令做三件事实时读取模型目录从一个正在运行的 OmniRoute本地或远程抓取当前的模型列表而不是使用内置的静态清单写出目标工具自己的配置文件例如 Codex 的~/.codex/name.config.toml、Claude Code 的~/.claude/profiles/name/settings.json、OpenCode 的~/.config/opencode/opencode.json尽量用环境变量引用 API Key凡是目标工具支持环境变量的地方密钥只被引用如{env:OMNIROUTE_API_KEY}、$OMNIROUTE_API_KEY不会以明文写进配置文件。个别工具需要持久化本地环境文件时指南会在主表中单独标注。提供方provider的 onboarding 也复用同一个本地/远程上下文。下面这组 API-first 命令把管理端鉴权与上游凭据分开并且结构化输出中绝不打印凭据本身omniroute providers add glm --credential-env GLM_API_KEY --name work omniroute providers import ./providers.json --dry-run --json omniroute providers auth openai omniroute providers edit connection-id --default-model glm/glm-5.2 omniroute providers remove connection-id --yes脚本场景优先用--credential-stdin或--credential-env从标准输入或环境变量取凭据--credential仅保留给受控的本地交互使用。providers remove在非交互终端上必须显式加--yes。这五个命令全部尊重当前的活跃上下文active context也接受全局的--base-url/--api-key选项。二、命令总表每个 CLI 写入什么、支持哪些关键标志下面这张主表完整列出所有集成命令信息与 bin/cli/cli-manifest.mjs 中声明的能力语义一致。表中本地 vs 远程的含义是不带任何标志时默认目标为http://localhost:20128带--remote或存在活跃远程上下文时从该服务器拉取目录但配置文件始终写在你本机。命令工具写入内容关键标志本地 vs 远程omniroute setup-codexOpenAI Codex CLI~/.codex/name.config.toml— 每个兼容文本模型一个 profilecodex --profile name使用--remote--api-key--only--dry-run--port--codex-home两者omniroute setup-claudeClaude Code~/.claude/profiles/name/settings.json— 每个匹配模型一个 profile受CLAUDE_CONFIG_DIR影响--remote--api-key--only--dry-run--port--claude-home两者omniroute setup-opencodeOpenCodeopenai 兼容~/.config/opencode/opencode.json— 名为omniroute的 provider含目录全部模型opencode -m omniroute/model--remote--api-key--only--model--dry-run--port两者omniroute setup-clineCline~/.cline/data/{globalState,secrets}.jsonCLI 模式 打印 VS Code 扩展设置--remote--api-key--model--yes--dry-run--port--cline-dir两者omniroute setup-kiloKilo Code~/.local/share/kilo/auth.jsonCLI 若存在 VS Codesettings.json则合并kilocode.*--remote--api-key--model--yes--dry-run--port--auth-path--vscode-settings两者omniroute setup-continueContinue /cnCLI~/.continue/config.yaml—provider: openai模型密钥经${{ secrets.OMNIROUTE_API_KEY }}--remote--api-key--only--dry-run--port--config-path两者omniroute setup-cursorCursor什么都不写 — 只打印应用内操作步骤Cursor 配置是封闭的 SQLite--remote--api-key--only--port两者omniroute setup-rooRoo Code~/.omniroute/roo-settings.json导入文档 若存在 VS Codesettings.json则设置roo-cline.autoImportSettingsPath--remote--api-key--model--yes--dry-run--port--import-path--vscode-settings两者omniroute setup-crushCrush~/.config/crush/crush.json—openai-compatprovider密钥经$OMNIROUTE_API_KEY--remote--api-key--only--dry-run--port--config-path两者omniroute setup-gooseGoose~/.config/goose/config.yamlGOOSE_PROVIDER/OPENAI_HOST/GOOSE_MODEL 打印环境变量配方--remote--api-key--model--yes--dry-run--port--config-path两者omniroute setup-aiderAider~/.aider.conf.ymlopenai-api-basemodel: openai/id 打印环境变量配方--remote--api-key--model--yes--dry-run--port--config-path两者omniroute setup-qwenQwen Code~/.qwen/settings.json— V4 版modelProviders.openai数组 OMNIROUTE_API_KEY写入~/.qwen/.env--remote--api-key--model--yes--dry-run--port--config-path--env-path两者omniroute run target运行时启动通用什么都不写 — 用正确环境与参数拉起claude/codex/aider/goose/opencode/qwen/geminiQwen 与 Gemini 使用临时隔离主目录--remote--base-url--context--provider--model--api-key--api-key-env--dry-run--json--port--profile--token两者omniroute launchClaude Code什么都不写 — 注入ANTHROPIC_BASE_URL/ANTHROPIC_AUTH_TOKEN后拉起claude--remote--api-key--token--profile--port两者omniroute launch-codexOpenAI Codex CLI什么都不写 — 通过-c标志注入omnirouteprovider 后拉起codex--remote--api-key--profile-p--port两者关键标志语义依据命令源码验证--remote url从远程 OmniRoute 拉取目录覆盖--port与活跃上下文。--api-key key提供该服务器的凭据缺省时回退到环境变量OMNIROUTE_API_KEY或活跃上下文的 token。--only patterns逗号分隔的子串只保留匹配的模型 ID如--only glm,kimi。可用在setup-codex、setup-claude、setup-opencode、setup-continue、setup-cursor、setup-crush上。--dry-run只打印将要写入的内容绝不触碰文件系统。除setup-cursor它本来就不写文件外每个setup-*命令都支持。--model id对于没有模型自动发现能力的工具Cline、Kilo、Roo、Goose、Qwen、Aider是必需的否则交互式选择。这些工具还接受--yes做非交互运行此时仍要求--model。setup-opencode用--model设置顶层默认模型。omniroute run上的--model id遵循清单manifest的 per-target 接线见 bin/cli/cli-manifest.mjsaider收到--model openai/idopencode收到--model omniroute/id仅当 id 自身不带前缀时才追加qwen与gemini原样收到 idclaude通过ANTHROPIC_MODEL环境变量获得goose通过GOOSE_MODELcodex通过-c model_providers.omniroute.*参数。Qwen 是唯一硬性要求--model的 run 目标—omniroute run qwen不带模型会以退出码2结束并给出明确报错。--port port本地 OmniRoute 端口默认20128设置--remote时忽略存在于所有setup-*与两个 launch 命令。omniroute run退出码约定子 CLI 自身的退出码原样透传2 参数非法不支持的目标、缺少必需的--model、容器保护触发127 目标二进制不在PATH中130/143/129 启动被SIGINT/SIGTERM/SIGHUP终止1 其他运行时启动失败。两个遗留启动器launch、launch-codex接受--profile name来选用setup-claude/setup-codex生成的 profile并把多余参数透传给底层的claude/codex二进制。三、omniroute configure共享的交互式配方入口setup-*之外的另一种用法是交互式配置器configure它复用同一个本地/远程模型目录选择器# 从活跃的本地或远程模型目录中选择然后配置目标工具 omniroute configure claude omniroute configure opencode --provider glm omniroute configure qwen --model qwen/qwen3.8-max-preview --yes从源码结构看configure目前委托给经过测试的配方模块对应 bin/cli/commands/configure.mjs 中的SETUP_MODULES覆盖codex、claude、opencode、qwen、aider、goose、cline、continue、kilo仅 IDE、仅 MITM、仅指南类的目录条目仍然走显式的setup-*或手工流程不会作为可启动目标呈现。目标清单、别名解析与模型标志接线全部来自 bin/cli/cli-manifest.mjs 这一份唯一声明run.mjs、configure.mjs、completion.mjs都从它派生并有 tests/unit/cli/cli-manifest-drift.test.ts 防止各消费面与运行时刻表服务端目录src/shared/services/cliRuntime.ts静默漂移。注意区分两个 OpenCode 集成setup-opencode是轻量 openai 兼容接入而omniroute setup opencode注意没有横线是另一种插件式接入会安装omniroute/opencode-plugin。两者是不同命令本文主表记录的是setup-opencode。插件还按 OpenCode 主版本拆成两个包omniroute/opencode-pluginOpenCode v1与omniroute/opencode-plugin-v2OpenCode v2因为两代加载器期望不同的入口点v2 包0.1.0遵循仍在演进的主机契约从 OpenCode 注入目录草稿的形状读取数据而非自行假定。四、本地使用OmniRoute 跑在 localhost:20128OmniRoute 在localhost:20128运行时直接执行对应工具的配置命令即可模型目录从本地服务器拉取# Codex为每个匹配模型写入 profile 到 ~/.codex/ omniroute setup-codex codex --profile glm52 # 使用生成的 profile # Claude Code为每个模型写 profile然后启动其中一个 omniroute setup-claude omniroute launch --profile glm52 # OpenCode写入含全部目录模型的 openai 兼容 provider omniroute setup-opencode export OMNIROUTE_API_KEYsk-... # 通过 {env:OMNIROUTE_API_KEY} 引用绝不落盘 opencode -m omniroute/glm/glm-5.2 ... # 没有自动发现能力的工具需要显式模型 omniroute setup-aider --model glm/glm-5.2 omniroute setup-qwen --model qwen/qwen3.8-max-preview # 预览将写入的内容而不实际写入 omniroute setup-continue --dry-run零配置临时启动launch与omniroute run不想在任何地方留下配置时可以只用环境注入来启动omniroute launch # Claude Code → 本地 OmniRoute omniroute launch-codex # Codex CLI → 本地 OmniRoute omniroute launch-codex --profile glm52 omniroute run claude --model openai/gpt-5.4 omniroute run codex --model openai/gpt-5.4 --dry-run --json omniroute run aider --model glm/glm-5.2 -- --message reply OK omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run reply OK omniroute run qwen --model glm/glm-5.2 -- -p reply OK omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p reply OK # 显式命令路径把 -- 之后的所有参数原样透传 omniroute run claude -- --print-system-prompt review this diffrun的实现bin/cli/commands/run.mjs会为每个目标构造一个启动计划launch plan解析目标别名cc、anthropic→claudeopenai→codex等、决定凭据来源显式选项 / 环境变量名 / 活跃上下文、注入对应的环境变量差集env diff并把--之后的参数原样交给子进程。测试 tests/unit/cli/run-command.test.ts 验证了这些行为例如 Aider 得到--model openai/glm/glm-5.2与OPENAI_API_BASE/OPENAI_API_KEY注入OpenCode 通过OPENCODE_CONFIG_CONTENT进程级覆盖配置且序列化结果中不含密钥明文Qwen 缺--model时按/requires --model/拒绝Gemini 注入GOOGLE_GEMINI_BASE_URL/GEMINI_API_KEY/GEMINI_DEFAULT_AUTH_TYPE。五、远程使用指向 VPS 或 Tailnet 上的 OmniRoute把任意配置命令指向远程 OmniRoute只需--remote--api-key目录从远程拉取配置仍写在本机。# OpenCode 指向远程 VPS只保留 glm/kimi 模型 omniroute setup-opencode --remote http://192.168.0.15:20128 --api-key oma_live_xxx \ --only glm,kimi opencode -m omniroute/glm/glm-5.2 ... # 先导出 OMNIROUTE_API_KEY # 从远程目录生成 Codex profiles omniroute setup-codex --remote http://192.168.0.15:20128 --api-key oma_live_xxx # 直接让 CLI 打到远程 omniroute launch --remote http://192.168.0.15:20128 --api-key oma_live_xxx omniroute launch-codex --remote http://192.168.0.15:20128 --api-key oma_live_xxx与其每次手传--remote/--api-key不如登录一次让活跃上下文自动提供omniroute connect 192.168.0.15 # 铸造限定范围 token 并保存上下文 omniroute setup-codex # ← 此后自动使用远程目录 omniroute setup-opencode # ← 同理 omniroute launch # ← Claude Code 打到远程上下文、token 范围与管理的细节见 docs/guides/REMOTE-MODE.md。六、Base URL 约定哪些工具要/v1OmniRoute 在/v1暴露 OpenAI 兼容面、在根路径暴露 Anthropic 兼容面、在/v1beta暴露原生 Gemini 面。每条集成都被接到其工具期望的形式在命令源码中验证集成写入的 Base URL带/v1setup-clineopenAiBaseUrl根路径否 — Cline 自行追加/v1/chat/completionssetup-gooseOPENAI_HOST根路径否 — Goose 自行追加路径setup-aiderOPENAI_API_BASE根路径否 — LiteLLM 追加/v1/chat/completionssetup-kilo、setup-roo、setup-continue、setup-crush、setup-cursor带/v1是setup-claudeANTHROPIC_BASE_URL、launch根路径否 — Claude Code 追加/v1/messagessetup-codex、launch-codexmodel_providers.omniroute.base_url带/v1是setup-qwenmodelProviders.openai[].baseUrl带/v1是run geminiGOOGLE_GEMINI_BASE_URL根路径否 — SDK 追加/v1beta/models/…这一行看似琐碎却是为什么有些集成写根路径、有些写/v1的直接答案配置写入方总是给出目标工具会自己补全的最小正确形式避免双写路径段如…/v1/v1/chat/completions造成的 404。七、更新时保住原生依赖--includeoptional执行omniroute update确认后或带--apply时更新器内部始终以--includeoptional运行安装npm install -g omniroutelatest --includeoptional注意这不是传给omniroute update的标志而是更新器内建行为。它保证optionalDependenciesbetter-sqlite3、keytar、tls-client、LLMLingua SLM 栈在更新后依然存活——即使你的 npm 配置设了omitoptional否则原生 SQLite 驱动与 OS keyring 绑定会被静默移除。想只看将要执行的精确命令而不真正执行omniroute update --dry-run # [DRY RUN] 将执行: npm install -g omniroutelatest --includeoptionalomniroute update的其他标志源码验证--check有更新时退出 1、--apply不提示直接安装、--changelog、--no-backup、--yes。八、专项通过omniroute run gemini使用 Google Gemini CLIGemini CLI 的启动契约是针对google/gemini-cli0.50.0 验证过的该 CLI 尊重GOOGLE_GEMINI_BASE_URL并向它发出POST /v1beta/models/model:generateContent以及:streamGenerateContent?altsse——正好命中 OmniRoute 的原生 Gemini 面/v1beta。omniroute run gemini自动完成以下接线GOOGLE_GEMINI_BASE_URL→ 活跃的 OmniRoute 根 URL根路径不带/v1GEMINI_API_KEY→ 解析后的 OmniRoute 凭据选项 / 环境变量 / 上下文临时隔离的GEMINI_CLI_HOME其.gemini/settings.json选中gemini-api-key鉴权因此本机存储的 Google OAuth 会话Code Assist永远不会覆盖由 OmniRoute 定向的启动——退出后目录即被删除环境净化子进程环境会清掉GOOGLE_API_KEY、GOOGLE_GENAI_USE_VERTEXAI、GOOGLE_GENAI_USE_GCA它们会把鉴权重定向到 Vertex / Code Assist并设置GEMINI_DEFAULT_AUTH_TYPEgemini-api-key作为双保险——其余run目标对各自冲突的环境变量也做同样的处理--model id由--provider/--model注入。omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p helloGemini 的工作区信任保护在无头模式下仍然生效——请自行传入--skip-trust或交互式信任目录启动器刻意不绕过它。此外这个启动器与ACP 注册src/lib/acp/registry.ts 中的gemini --acp是两回事后者是面向/dashboard/acp-agents的代理协议集成。九、可选的真烟测用真实二进制打真实服务器CI 中跑的是确定性的启动计划回归tests/unit/cli/run-command.test.ts、tests/unit/cli/run-execution.test.ts。要拿真实CLI 二进制去验证真实OmniRoute 服务器仓库提供了一套可选测试装置 tests/integration/upstream-cli-smoke.int.test.ts。它从不自动运行除非设置RUN_CLI_SMOKE1否则每个子测试都跳过凭据通过环境变量名传递绝不传值任何记录的输出中密钥形态的字符串都会被脱敏未安装二进制的目标会被跳过并且把失败归类为鉴权 / 上游 / 配置三类而非简单布尔值RUN_CLI_SMOKE1 \ OMNIROUTE_SMOKE_BASE_URLhttp://localhost:20128 \ OMNIROUTE_SMOKE_MODELprovider/model \ OMNIROUTE_SMOKE_API_KEY_ENVOMNIROUTE_API_KEY \ node --import tsx/esm --test tests/integration/upstream-cli-smoke.int.test.ts可选参数OMNIROUTE_SMOKE_TARGETScodex,opencode,qwen限定目标范围OMNIROUTE_SMOKE_TIMEOUT_MS覆盖每个目标 120 秒的默认超时。十、从源码看这套机制的可靠性保障单一事实来源bin/cli/cli-manifest.mjs 对每个目标声明run/configure能力、别名与runModel接线如 aider 的{flag: --model, prefix: openai/}、opencode 的prefix: omniroute/、qwen 的required: true。run、configure、shell completion 全部从这份清单派生。漂移防护tests/unit/cli/cli-manifest-drift.test.ts 断言清单中的每个目标都存在于服务端运行时刻表src/shared/services/cliRuntime.ts、每个 alias 在两侧映射一致、configure目标都有对应配方模块、bash/zsh/fish 补全输出包含全部目标词以及模型标志接线如manifestModelArgs(aider, glm/glm-5.2)必须返回[--model, openai/glm/glm-5.2]始终与清单一致。密钥不落盘run计划中密钥以环境变量名或临时注入的方式存在测试断言JSON.stringify(plan)不包含密钥明文见 tests/unit/cli/run-command.test.ts 中对 OpenCode、Gemini 的断言。十一、相关文档docs/guides/CLAUDE-CODE-CONFIGURATION.md — Claude Code 深度配置指南含一次性手写的[model_providers.omniroute]基础配置docs/guides/CODEX-CLI-CONFIGURATION.md — Codex CLI 一次性基础配置docs/guides/REMOTE-MODE.md — 远程模式上下文、限定范围访问 token、驱动远程服务器docs/guides/VSCODE-COPILOT.md — OmniCopilot 扩展可在编辑器内代跑这些setup-*命令docs/reference/CLI-TOOLS.md — 受支持工具的完整目录与对应的仪表盘页面docs/guides/SETUP_GUIDE.md — 安装方式与首次运行引导【免费下载链接】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），仅供参考
