Skillget

codex-model-router

skill
Security Audit
Fail
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 22 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in claude-probe-diag.sh
  • process.env — Environment variable access in claude-probe-diag.sh
  • fs module — File system access in claude-probe-diag.sh
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Codex 多模型路由：在 Codex Desktop 使用 Claude、第三方 API 和自定义模型。Local LLM proxy for OpenAI Responses / Chat Completions & Anthropic Messages; experimental Claude Code CLI routing. macOS & Windows.

README.md

codex-model-router — Codex 多模型路由工具

简体中文 · 繁體中文 · English

在 Codex Desktop 的模型菜单里加入 Claude 和第三方 API 模型，官方 GPT 照常使用。 支持 macOS 与 Windows。

它是一个运行在你电脑上的小型路由器（本机 LLM proxy）：选官方模型时，请求照常发往 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）。
  • 网页管理页：在浏览器里增删模型、管理供应商和 API Key、一键更新。
  • 可选功能：中转 API 生图、Claude Code 订阅路由。

安装

开始前请准备：

  • 已用 ChatGPT 账号登录的 Codex Desktop（ChatGPT Desktop）
  • 供应商的 Base URL 和 API Key
  • macOS，或 Windows 10 1809 以上／Windows 11（需要 Node.js 22.15 以上，桌面版自带的即可，通常不用另外安装）

macOS：在「终端」中运行

curl -fsSL 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 https://github.com/funkeyyou/codex-model-router/raw/refs/heads/main/codex-model-router.ps1 -o codex-model-router.ps1; powershell -ExecutionPolicy Bypass -File .\codex-model-router.ps1

运行后会先出现菜单，直接按回车（第 1 项「安裝或重新配置」）开始。安装器会依次询问 Base URL、API Key 和要添加的模型；输入 API Key 时屏幕不会显示任何字符，粘贴后直接按回车。选中的模型会先发送测试请求确认可用，可能产生少量费用。安装器的终端提示目前为繁体中文。

想固定版本或先校验文件哈希，见固定版本并验证下载。

完成后重新打开 Codex，就能在模型菜单里选到新模型：

Codex Desktop 模型菜单：官方 GPT、ark 自定义 GPT 与两家供应商的 Claude 模型并列

实际模型菜单示例。前缀与模型可用性取决于你的供应商及账号；截图不是预装模型清单。

使用

大部分操作都能在网页管理页完成，任选一种方式打开：

  • Codex 里的「自訂模型管理」入口（安装后需重启 Codex 一次才会出现）
  • 「Codex 模型路由器」快捷方式（Windows 在开始菜单，macOS 在 ~/Applications）
  • 运行 ui 命令

也可以直接用命令（在安装器所在的文件夹运行）：macOS 用 bash codex-model-router.sh <命令>，Windows 用 powershell -ExecutionPolicy Bypass -File .\codex-model-router.ps1 <命令>。不带命令运行会显示菜单。

命令 用途
ui 打开网页管理页
update 升级到新版，保留所有设置
add、remove 添加、删除自定义模型
providers 新增或移除供应商、更换 API Key
imagegen 设置中转 API 生图
repair-models 模型菜单出现旧名称或已删除的模型时修复
status 查看安装与服务状态
diagnostics 导出诊断包到桌面（自动遮蔽 Key），反馈问题时附上
rollback 移除路由器

其他命令见完整说明。

升级与移除

升级：在网页管理页左上角的版本菜单一键更新；或重新运行上面的安装命令，在菜单中输入 3（「更新到最新版本」，等同 update）。Base URL、API Key 和已添加的模型都会保留，不用重新设置；更新失败会自动还原。

移除：运行 rollback。用过 Claude 模型的旧对话，移除后切回官方模型可能无法继续，请新开对话（原因）。

注意事项

  • 第三方 API 的费用由供应商计算；本工具不提供模型额度，也不解锁账号未开放的功能。
  • Claude 与 Chat Completions 模型可以使用终端、文件编辑、MCP 等常规工具（Chat Completions 需上游支持工具调用），但不能使用 OpenAI 平台内置的联网搜索、内置生图等工具；生图可改用中转 API 生图。详见工具兼容性。
  • 非官方社区项目，与 OpenAI、Anthropic 无隶属关系。

更多文档

反馈问题请到 Issues，附上操作系统、桌面版版本、路由器版本和错误信息；请勿贴出 API Key 或登录令牌。

授权

MIT

Reviews (0)

No results found