duolahypercho/codex-router

External-model router for Codex with guided Kimi OAuth/API, DeepSeek, safe migration, and rollback.

什么是 Codex Router？

Codex Router 是一个客户端路由层，让 Codex 桌面/命令行应用能够与许多不同的大型语言模型（LLM）提供商通信——Anthropic、Kimi、DeepSeek、xAI（Grok）、GitHub Copilot、Claude、Gemini 等数十家——而无需您切换应用或手动管理 API 密钥。

它安装了一个小型后台服务、一个基于 Electron 的控制中心（带有托盘/菜单栏应用和 macOS 灵动岛小组件），以及一个命令行工具（model-router）。该服务在本地存储您的提供商凭据（通过隐藏提示），并在 Codex 内部展示合并后的模型目录，因此您可以在开始任务时选择“路由模型”。

主要功能（如 README 中所述）

多提供商支持 – 适用于基于 OAuth 的会话（例如 Kimi Code、Grok、Claude）和纯 API 密钥提供商（DeepSeek、StepFun、Qwen 等）。
订阅代理桥接（实验性） – 可选的只读桥接，连接到现有的 Claude、Cursor 和 Gemini CLI 代理，让 Codex 可以路由提示通过这些工具，而无需暴露其 OAuth 令牌。
安全的凭据处理 – 凭据永远不会离开机器；路由器仅存储最小的元数据（会话 ID、时间戳），并且永远不会记录提示文本。
跨平台安装程序 – 适用于 macOS/Linux 的引导式安装脚本、适用于 Windows 的 PowerShell 安装程序、Homebrew 配方，以及未来的 npm 包计划。
桌面集成 – 菜单栏/托盘应用和可移动的 macOS 小组件（灵动岛），充当“控制中心”，用于启用/禁用提供商、查看使用情况和配置路由策略。
广泛的模型目录 – README 列出了数十个模型 ID，每个都配有所需的认证方法（OAuth 会话、API 密钥或 Ollama Cloud）。路由器仅显示具有有效凭据的模型。
无虚假订阅代理 – 它不模拟 OpenAI 的令牌到端点的行为；它只是将请求转发到所选提供商。

适合谁？

Codex 用户想要在不离开 Codex 界面的情况下尝试多种 LLM 后端。
需要在一个地方管理多种 LLM 服务的 API 密钥/OAuth 会话的开发者。
希望将凭据保存在本地并避免将其暴露给第三方代理的团队。

如何安装（快速开始）

# macOS / Linux（引导式，带托盘组件）
curl -fsSL https://raw.githubusercontent.com/duolahypercho/codex-router/main/install.sh \
  | sh -s -- --target codex --guided --with-tray

# Windows
$installer = Join-Path $env:TEMP "codex-router-install.ps1"
Invoke-WebRequest https://raw.githubusercontent.com/duolahypercho/codex-router/main/install.ps1 -OutFile $installer
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installer -Target codex -Guided -WithTray

该脚本会引导您选择提供商、登录（例如 kimi login）并安装后台服务。完成后，退出并重新打开 Codex 应用，开始新任务，您会在选择器中看到路由模型。

典型工作流程

运行安装程序 – 选择您想要的提供商。
认证 – 安装程序会打开隐藏的终端提示，用于输入 API 密钥或进行 OAuth 登录。
打开 Codex Router 控制中心 – 通过 Spotlight（macOS）或托盘图标。
创建 Codex 任务时选择路由模型。
（可选）使用桥接 – 例如，./bin/model-router codex agents probe anthropic 来检查 Claude 或 Gemini 桥接。

命令行使用示例

# 列出可用代理
./bin/model-router codex agents status

# 通过桥接向 Anthropic 发送提示（从标准输入读取）
printf '%s' '解释这个仓库。' |
  ./bin/model-router codex agents prompt anthropic --cwd "$PWD"

项目状态

社区维护，不隶属于任何列出的提供商。
对 Claude、Cursor 和 Gemini 的实验性桥接支持。
macOS 小组件使用 SwiftUI/WidgetKit 构建；Windows 和 Linux 依赖 Electron 界面。
提供 Homebrew tap 用于仅命令行安装；npm 包计划中。

上述所有细节均直接取自该仓库的 README。