Codex Router

Codex Router 是一个独立的社区项目，旨在解决 Codex 原生仅支持 GPT 模型的局限。它通过一个本地、凭证隔离的路由服务，将 Anthropic Claude、Kimi、DeepSeek、Grok、Qwen 等外部模型整合进 Codex 的原生模型选择器中，使这些第三方模型能够像官方 GPT 模型一样被直接调用。

该工具支持 Responses API，兼容 Codex 应用与 CLI，且所有凭证均存储在本地，不经过任何中间服务器。

核心特性

• 原生集成体验：路由后的模型直接出现在 Codex 的标准模型下拉菜单中，无需修改工作流或切换客户端。
• 广泛的模型支持：涵盖 Kimi K3/K2.7、DeepSeek V4 Pro/Flash、Claude Opus 4.8、Grok 4.5、GLM-5.2、MiniMax M3、Qwen3.8 Max 等主流模型。
• 灵活的认证方式：支持 OAuth 会话复用（如 Kimi Code CLI、Grok CLI）、API Key、Ollama Cloud、ClinePass、GitHub Copilot PAT 及各类订阅计划密钥。
• 凭证安全隔离：所有 API Key 和 Token 仅保存在本地受保护的状态文件中，路由器本身不存储也不传输用户凭证。
• 动态模型策划：对于 GitHub Copilot、opencode Zen 等提供商，支持交互式筛选可用模型，并自定义上下文窗口、图像支持及推理力度等元数据。
• 智能搜索适配：自动识别模型是否支持独立网页搜索（如 DeepSeek V4 Flash），并为 Grok OAuth 路由附加原生的 web_search 和 x_search 工具。

安装与配置

Homebrew（推荐 macOS/Linux）

brew tap duolahypercho/codex-router https://github.com/duolahypercho/codex-router
brew install codex-router
codex-router setup --guided

引导安装脚本

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/duolahypercho/codex-router/main/install.sh \
  | sh -s -- --target codex --guided

# Windows PowerShell
$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

安装向导会引导完成提供商选择、凭证安全录入、后台服务注册及 Codex 集成。设置完成后需完全重启 Codex 以使新模型生效。

支持的模型与认证方式

注意：Qwen 已停止 OAuth 免费层，仅支持 Model Studio 计划密钥；GitHub Copilot 需使用细粒度 PAT（github_pat_），不支持经典 Token；ClinePass 需同时具备 API Key 和有效订阅。

高级功能：模型策划与搜索适配

• 交互式策划：运行 ./bin/curate-models PROVIDER 可浏览提供商实时目录，勾选所需模型并配置元数据。未回答的问题默认采用保守值。
• 强制工具调用降级：若某模型在 tool_choice=auto 时正常但在强制模式下返回 400，可在策划时标记为 auto-tool-choice，路由器会自动降级处理。
• 搜索能力声明：兼容模型需在注册表或元数据中声明 "searchTool": { "mode": "standalone" }，路由器不会从端点推断搜索兼容性。

重要说明

• Codex Router 是独立社区项目，与 OpenAI、GitHub、Anthropic、Moonshot AI、DeepSeek、xAI 等公司无关，也未获其认可。
• 原生 GPT 模型仍直接使用 Codex 官方通道，路由器不包含 GPT 或 ChatGPT OAuth 提供商。
• 所有外部模型请求均消耗对应提供商的配额或订阅额度，请遵守各平台的使用条款。
• 更改模型启用状态后，需完全退出并重新打开 Codex；已打开的任务保留启动时的模型选择。