让 Codex Desktop 和 Claude Desktop 都能用上 Claude 与第三方 API 模型。 在 Codex 的模型菜单里加入自定义模型，官方 GPT 照常使用；也能一键把第三方 Claude API 接入 Claude Desktop。两者择一安装即可，支持 macOS 与 Windows。
交给 AI 安装：把下面这段话复制给 Codex 或 Claude（Claude Code），它会替你下载并运行安装器。
请帮我安装 codex-model-router（https://github.com/funkeyyou/codex-model-router）。
先判断我的系统，再运行对应的命令：
- macOS：curl -fsSL --connect-timeout 10 --max-time 120 https://gh-proxy.com/https://github.com/funkeyyou/codex-model-router/raw/refs/heads/main/codex-model-router.sh -o codex-model-router.sh && bash codex-model-router.sh
- Windows（PowerShell）：curl.exe -fsSL --connect-timeout 10 --max-time 120 https://gh-proxy.com/https://github.com/funkeyyou/codex-model-router/raw/refs/heads/main/codex-model-router.ps1 -o codex-model-router.ps1; if ($LASTEXITCODE -eq 0) { powershell -ExecutionPolicy Bypass -File .\codex-model-router.ps1 }
如果下载失败，去掉网址开头的 https://gh-proxy.com/ 改用 GitHub 直连再试一次。
如果提示缺少 Node.js 22.15 以上，先帮我安装 Node.js LTS 再重试。
安装器会在浏览器打开管理页，供应商和 API Key 由我自己在页面里填写，不要向我索取 API Key。
完成后告诉我管理页是否已经打开。
它是一个运行在你电脑上的小型路由器（本机 LLM proxy），附带网页管理页：在 Codex 选官方模型时，请求照常发往 OpenAI；选你添加的自定义模型时，才发往你设置的 API。Codex 的登录、已有对话和官方模型都不受影响。
- 支持的 API：OpenAI Responses API、Anthropic Claude Messages API，以及只有 Chat Completions 的兼容端点（DeepSeek、Qwen、GLM、Kimi、Gemini、Ollama、vLLM 等，安装时会实际探测能力）。
- 多家供应商：可同时接入多家，API Key 各自加密保存（macOS 钥匙串／Windows DPAPI）。
- 独立安装：不必安装 Codex；只装 Claude Desktop 也能用。需要 Node.js 22.15 以上。
- 网页管理页：在浏览器里增删模型、管理供应商和 API Key、一键更新。
- 官方模型显示：在「Codex设置 → 隐藏官方模型选项」整理账号模式的模型菜单，随时恢复；API Key 模式下此功能停用。
- 可选功能：中转 API 生图、Claude Code 订阅路由。
- Claude Desktop 接入：在「Claude → Claude 客户端」一键配置第三方 Claude API 模型，也可一键回退。设置自动备份，聊天和其他偏好保留；暂不支持在 Claude 客户端使用 GPT 或 CLI 订阅路由。使用说明
开始前请准备：
- 要使用的客户端：Claude Desktop 或 Codex Desktop（ChatGPT Desktop）；只安装管理页时两者都不是必需
- 连接 API 模型时准备供应商的 Base URL 和 API Key；只安装管理页可暂不添加
- macOS，或 Windows 10 1809 以上／Windows 11；需要 Node.js 22.15 以上，建议使用 Node.js LTS。已有 Codex 自带的兼容 Node.js 时也可直接使用
macOS：在「终端」中运行
curl -fsSL --connect-timeout 10 --max-time 120 https://gh-proxy.com/https://github.com/funkeyyou/codex-model-router/raw/refs/heads/main/codex-model-router.sh -o codex-model-router.sh && bash codex-model-router.shWindows：在 PowerShell 中运行
curl.exe -fsSL --connect-timeout 10 --max-time 120 https://gh-proxy.com/https://github.com/funkeyyou/codex-model-router/raw/refs/heads/main/codex-model-router.ps1 -o codex-model-router.ps1; if ($LASTEXITCODE -eq 0) { powershell -ExecutionPolicy Bypass -File .\codex-model-router.ps1 }推荐使用上方的加速指令；只有加速服务不可用时，才改用下方的 GitHub 直连指令，两者选一即可。
GitHub 直连（加速不可用时使用）
macOS：
curl -fsSL --connect-timeout 10 --max-time 120 https://github.com/funkeyyou/codex-model-router/raw/refs/heads/main/codex-model-router.sh -o codex-model-router.sh && bash codex-model-router.shWindows（PowerShell）：
curl.exe -fsSL --connect-timeout 10 --max-time 120 https://github.com/funkeyyou/codex-model-router/raw/refs/heads/main/codex-model-router.ps1 -o codex-model-router.ps1; if ($LASTEXITCODE -eq 0) { powershell -ExecutionPolicy Bypass -File .\codex-model-router.ps1 }下载来源与校验说明
安装指令优先推荐第三方加速服务 gh-proxy.com，同时提供独立的 GitHub 直连指令。安装器的版本检查和管理页更新会优先使用代理，失败后自动直连 GitHub。仅代理本项目的公开文件，不转发模型请求或 API Key；更新仍检查 SHA-256、安装器格式与版本。代理提供的文件及校验清单经过同一服务，校验不代表独立的发布签名验证。
运行后会先安装网页管理页和快捷方式，并在浏览器打开；检测到 Codex 时才另外建立 Codex 入口，不要求安装 Codex。在管理页点「连接 API 供应商」，选择常用供应商或填入 Base URL、API Key，勾选要添加的模型即可完成安装；选中的模型会先发送测试请求确认可用，可能产生少量费用。只用 Claude 的话，添加 Claude API 模型后，到「Claude → Claude 客户端」一键接入。Codex 的全局上下文等功能需要安装并连接 Codex；独立安装后可在「Codex设置」手动连接。已经安装过的话会直接打开管理页。习惯终端操作可以在命令后加上 menu 使用终端菜单（提示目前为繁体中文）。
想固定版本或先校验文件哈希，见固定版本并验证下载。
完成后重新打开 Codex，就能在模型菜单里选到新模型：
实际模型菜单示例。前缀与模型可用性取决于你的供应商及账号；截图不是预装模型清单。
大部分操作都能在网页管理页完成，任选一种方式打开：
- Codex 里的「自定义模型管理」入口（名称跟随 Codex 界面语言；安装后需重启 Codex 一次才会出现）
- 「模型路由器」快捷方式（Windows 在开始菜单，macOS 在
~/Applications） - 运行
ui命令
截图中的供应商名称与网址已替换或模糊处理。
也可以直接用命令（在安装器所在的文件夹运行）：macOS 用 bash codex-model-router.sh <命令>，Windows 用 powershell -ExecutionPolicy Bypass -File .\codex-model-router.ps1 <命令>。不带命令会打开网页管理页，menu 显示终端菜单。
| 命令 | 用途 |
|---|---|
ui |
打开网页管理页 |
menu |
终端菜单（网页管理页的备用方式） |
update |
升级到新版，保留所有设置 |
add、remove |
添加、删除自定义模型 |
providers |
新增或移除供应商、更换 API Key |
imagegen |
设置中转 API 生图 |
repair-models |
模型菜单出现旧名称或已删除的模型时修复 |
status |
查看安装与服务状态 |
diagnostics |
导出诊断包到桌面（自动遮蔽 Key），反馈问题时附上 |
rollback |
移除路由器 |
其他命令见完整说明。
升级：在网页管理页左上角的版本菜单一键更新；或运行 update 命令。Base URL、API Key 和已添加的模型都会保留，不用重新设置；更新失败会自动还原。
移除：运行 rollback。用过 Claude 模型的旧对话，移除后切回官方模型可能无法继续，请新开对话（原因）。
- 第三方 API 的费用由供应商计算；本工具不提供模型额度，也不解锁账号未开放的功能。
- Claude 与 Chat Completions 模型可以使用终端、文件编辑、MCP 等常规工具（Chat Completions 需上游支持工具调用），但不能使用 OpenAI 平台内置的联网搜索、内置生图等工具；生图可改用中转 API 生图。详见工具兼容性。
- 非官方社区项目，与 OpenAI、Anthropic 无隶属关系。
- 完整说明：网页管理页、升级细节、多家供应商、Chat Completions 模型、中转生图、兼容性与运行细节
- 疑难排解与健康检查
- Claude Code 订阅路由（繁体中文）
- 开发与发布
- 版本更新内容
反馈问题请到 Issues，附上操作系统、桌面版版本、路由器版本和错误信息；请勿贴出 API Key 或登录令牌。
MIT