Codex Router多客户端接入指南：一套本地路由器同时服务 Cursor、Claude Code 与 Gemini CLI 的完整教程

Codex Router多客户端接入指南一套本地路由器同时服务 Cursor、Claude Code 与 Gemini CLI 的完整教程【免费下载链接】codex-routerExternal-model router for Codex with guided Kimi OAuth/API, DeepSeek, safe migration, and rollback.项目地址: https://gitcode.com/gh_mirrors/co/codex-routerCodex Router 是一个运行在你电脑上的本地 AI 模型路由器一次安装就能让Cursor、Claude Code、Gemini CLI等多个客户端共享同一套外部模型Kimi、DeepSeek、Anthropic 等凭据全部留在本机互不串用。这篇多客户端接入指南带你用 3 个目标命令把三大客户端逐个接入同一个路由器。为什么需要 Codex Router 多客户端接入不同客户端各说各的方言Gemini CLI 只懂 Gemini APIClaude Code 只走 Anthropic MessagesCursor 走 OpenAI BYOK。如果你分别配置就要维护多套 API Key、多套模型列表、多次计费统计。Codex Router 的做法是本机起一个统一的路由服务默认 4202 端口每个客户端只需把出口指过来路由器负责协议翻译、凭据注入和模型选择。原生 GPT 流量仍走原来的 ChatGPT 后端外部模型按名字空间路由互不干扰。详细机制可阅读 docs/HOW-IT-WORKS.md。第一步安装并启用第一个客户端Codex先装好路由器本体后续三个客户端都挂载在这份安装之上./install.sh --target codex --guided --with-tray安装器会引导你选择服务商、在隐藏的本地终端提示中输入凭据不会出现在聊天记录或进程列表里。完成后完全退出并重新打开 Codex新建任务时即可看到codex_router/...前缀的路由模型打开控制中心Control Center做日常查看。第二步接入 Gemini CLI —— 一行命令Gemini CLI 官方没有自带模型选项但它会读取环境变量里的接口地址、凭据和默认模型——这就是整个集成的全部入口。最快配置方法./install.sh --target gemini --auto --providers configured # 已装好路由器的机器直接执行 ./bin/model-router gemini enable它会在~/.gemini/.env中写入一个带标记的管理块GOOGLE_GEMINI_BASE_URL指向本地路由、GEMINI_API_KEY是路由器的本地调用凭据、GEMINI_MODEL为默认模型。下次运行gemini时自动生效无需重启任何服务被问到认证方式时选择Use Gemini API key即可该 Key 从不出本机。常用管理命令./bin/model-router gemini doctor # 体检 ./bin/model-router gemini status # 查看状态 ./bin/model-router gemini disable # 移除管理块其余内容原样保留单次临时换模型可用--model vendor/slug覆盖默认值。客户端细节见 docs-site/src/content/docs/clients/gemini-cli.md。第三步接入 Claude Code —— 私有启动器不动你的登录claude目标不会修改 Claude Code 的设置也不替换你的 Claude.ai 登录而是新增一个私有启动器claude-router只把这一个进程指向路由器的本地 Anthropic Messages 接口./bin/model-router claude enable claude-router # 然后 /model 选择 codex_router/anthropic/provider/model所有已配置凭据的路由模型都能被发现不只是 Anthropic 系模型消息、工具、图片、流式与 Token 估算都会被翻译成路由器的标准/v1/responses请求因此故障切换、用量统计与凭据隔离对 Claude Code 同样生效。完整说明见 docs-site/src/content/docs/clients/claude-code.md。第四步接入 Cursor —— 本地 Agent 与云端 App 双通道Cursor 是唯一需要公共出口的客户端因为零售版 Cursor 的 BYOK 请求会经过其云端后端无法直接访问你的 127.0.0.1。Codex Router 用两条通道分别解决Cursor Agent完全本地cursor-router-agent直接连接路由器的本地认证接口无需公网域名Cursor App公共 HTTPS 隧道通过 Cloudflare 命名隧道把本地 4214 端口的仅 App 接口转发出去。一键接入步骤./bin/model-router cursor enable --hostname cursor-router.example.com前提是拥有一个 Cloudflare 账号下的域名。也可以直接在控制中心的 Harness 页面点击Connect Cursor自动安装连接器、完成 Cloudflare 登录、创建唯一主机名、等你完全退出 Cursor 后发布路由目录并重新打开 Cursor全程进度显示在 Cursor 行内。接入后重启 Cursor在模型选择器里挑codex_router/...模型末尾后缀表示推理档位。注意Cursor 的 base-URL 覆盖是全局的切回 Cursor 自家模型时记得关闭覆盖。详见 docs-site/src/content/docs/clients/cursor.md。三个客户端的统一管理速查客户端启用命令接口形态是否需公网域名Gemini CLImodel-router gemini enable本地 .env 管理块否Claude Codemodel-router claude enableclaude-router 启动器否Cursor Appmodel-router cursor enable --hostname ...Cloudflare 隧道 → 4214是Cursor Agent同上同一命令覆盖cursor-router-agent 本地回环否每个客户端都有对应的doctor体检、status状态、disable干净卸载三件套disable 只移除路由器的管理块你的原始配置、注释和历史记录原样保留。安全设计凭据永远不离开本机这是多客户端接入时最值得关注的一点。Codex Router 对每条路由做凭据边界隔离客户端带来的认证信息在转发前被丢弃上游只注入所选服务商自己的凭据外部客户端如 Claude Code、Gemini CLI的 OAuth Token 路由器从不读取或复制只保存有界的会话元数据。凭据文件的权限为 600日志与状态输出会自动脱敏。常见问题速答 ️接入后客户端看不到新模型完全退出并重启客户端让它重新加载模型目录再跑对应doctor定位问题。想用回原来的模型disable即可一键还原例如./bin/model-router gemini disable会移除管理块并保留.env其余内容。凭据安全吗API Key 通过隐藏本地终端提示输入从不进入聊天、日志或进程列表支持 docs/TROUBLESHOOTING.md 中列出的排障流程。小结用一套 Codex Router 本地路由器同时服务 Cursor、Claude Code 与 Gemini CLI 只需三步gemini enable、claude enable、cursor enable。共享模型目录、共享用量统计、凭据严格隔离卸载时各自干净还原。多客户端接入后你的 AI 编码工具链从此只需要维护一份配置。【免费下载链接】codex-routerExternal-model router for Codex with guided Kimi OAuth/API, DeepSeek, safe migration, and rollback.项目地址: https://gitcode.com/gh_mirrors/co/codex-router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考