企业官网建设流程全解析

Codex Router完全指南：如何在Codex中用上Kimi、DeepSeek、Claude等30+外部AI模型

【免费下载链接】codex-routerExternal-model router for Codex with guided Kimi OAuth/API, DeepSeek, safe migration, and rollback.项目地址: https://gitcode.com/gh_mirrors/co/codex-router

Codex Router 是一个本地运行的外部模型路由器，让你在 Codex App / CLI 里直接使用 Kimi、DeepSeek、Claude、Grok 等 30 多个外部 AI 模型，原生 GPT 模型照常可用，所有 API 密钥只保存在你自己的电脑上。本指南带你从零完成安装、配置 Kimi 与 DeepSeek 认证、在模型选择器中切换模型，并用安全迁移与回滚机制保护现有 Codex 配置。

为什么需要 Codex Router？

Codex 默认只走 OpenAI 官方后端。如果你想用 Kimi K3 的深度思考、DeepSeek V4 的高性价比、Claude Opus 的编码能力，官方 Codex 并不直接支持。Codex Router 在本地搭起一座桥：

• 统一入口：在 Codex 原有的模型选择器里直接看到外部模型，无需切换客户端；
• 协议翻译：自动把 Codex 的 Responses 请求翻译成各厂商的 Chat Completions / Messages 协议；
• 密钥隔离：请求发出前替换为所选厂商的凭据，Codex 的登录信息绝不会发给第三方；
• 安全可控：旧版本可快照回滚，随时一键恢复。

工作原理的完整图解见 docs/HOW-IT-WORKS.md，30+ 厂商的模型注册表都放在 config/ 目录下（如 config/kimi/、config/deepseek/、config/anthropic/）。

快速安装：一条命令完成

macOS / Linux

要求 Node.js 22.19+（推荐 24 LTS）和 Git。先克隆仓库：

git clone https://gitcode.com/gh_mirrors/co/codex-router cd codex-router ./install.sh --target codex --guided --with-tray

Windows

git clone https://gitcode.com/gh_mirrors/co/codex-router Set-Location codex-router .\install.ps1 -Target codex -Guided -WithTray

安装脚本 install.sh / install.ps1 会执行完整的引导式流程：选择厂商 → 检测已有登录态 → 隐藏式提示输入密钥 → 安装每用户后台服务 → 自动跑 doctor 体检。全程不会发起任何付费测试请求。

💡 macOS 上该命令还会构建Codex Router.app（菜单栏常驻 + Control Center + 桌面小组件）；Linux 支持 Codex CLI；Windows 支持 Codex App 与 CLI。

配置认证：Kimi 与 DeepSeek 两种方式

引导安装会列出所有可选厂商，用数字键勾选（a全选、n清空）。两种典型认证方式：

Kimi（OAuth，免 API 费用）：复用官方 Kimi Code CLI 的登录态。若检测到官方 CLI，引导流程会直接帮你运行kimi login。路由会自动读取~/.kimi-code/config.toml中的区域设置，自动刷新 token，无需额外配置。

DeepSeek（API Key）：在隐藏提示符中粘贴密钥即可（终端不回显，密钥以权限 600 的受保护文件保存）：

./bin/model-router codex provider-key deepseek set ./bin/model-router codex provider-key kimi-api set

🔒 安全提示：密钥永远只在本地隐藏提示符或桌面端输入，绝不要贴进聊天框、命令行参数或历史记录。

支持的 30+ 提供商一览

更多厂商（Ollama 本地模型、Gemini CLI、Cursor Agent、Claude Code 等订阅型 Agent 桥接、免费模型网关）见 README.md 的完整模型表。只想体验本地模型？看 docs/LOCAL-MODELS.md。

在 Codex 中使用外部模型

1. 运行./bin/model-router codex doctor，解决所有FAIL项；
2. 确认providers命令中目标厂商显示SHOW与ready；
3. 完全退出并重新打开 Codex（Codex 只在启动时读取模型目录）；
4. 新建任务，在常规模型选择器里挑选外部模型即可。

如果模型没出现，运行./bin/refresh-catalog后重启 Codex。你还可以把某个外部模型设为新任务的默认模型：

./bin/control router-default set deepseek/deepseek-v4-flash

Control Center：可视化管理面板

安装--with-tray后你会得到菜单栏常驻图标和 Electron 控制中心（macOS 上是Codex Router.app，详见 docs/DESKTOP-TRAY.md）：

• Dashboard：路由器健康、当前模型与厂商、token 流量；
• Models：按模型家族分组，逐路由控制可见性、子代理资格与推理强度；
• Usage：7/30/90 天用量、厂商配额与限速窗口；
• Local LLMs：本机安装/移除 Ollama 模型。

安全迁移与一键回滚

这是 Codex Router 对现有用户的核心承诺：

• 不碰登录：现有 Codex 模型、profile、设置和 ChatGPT 登录全部保留，原生 GPT 流量照旧走官方后端；
• 事务化安装：13 步安装流程任一步失败即自动撤销，已识别的旧版本路由会先打快照再迁移（流程见 docs/INSTALL.md）；
• 随时回滚：移除时只删除路由标记的块和配置，你自己写的内容原样保留。

常见问题速查

• 模型没出现在选择器？运行doctor+refresh-catalog，再完全重启 Codex；
• GUI 客户端报 transport 错误？通常是系统代理没豁免 loopback，doctor会直接给出修复命令；
• 想先验证再信任？用--no-provider --no-discovery做免凭据的空闲安装，详见 docs/INSTALL.md。

更多细节请阅读 docs/HOW-IT-WORKS.md（请求流转全解）、docs/INSTALL.md（安装与升级）、docs/TROUBLESHOOTING.md（排错手册）。

【免费下载链接】codex-routerExternal-model router for Codex with guided Kimi OAuth/API, DeepSeek, safe migration, and rollback.项目地址: https://gitcode.com/gh_mirrors/co/codex-router