codex-model-router

skill
Guvenlik Denetimi
Basarisiz
Health Gecti
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 22 GitHub stars
Code Basarisiz
  • 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 Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

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

Yorumlar (0)

Sonuc bulunamadi