U UU AI Hub
展开目录 ▾
#Codex#Kimi#DeepSeek#AI编程#工具评测#开源

Codex Router 深度指南：把 Kimi 和 DeepSeek 装进 Codex，模型随心切换

Codex Router 让你在 Codex 中直接使用 Kimi K3 和 DeepSeek V4，保留 ChatGPT 登录，安装仅需一条指令。本文从安装到进阶配置全流程拆解。

预计阅读 7 分钟

一句话总结

Codex Router 是本周 GitHub 上最火的 Codex 扩展项目——让你在 Codex 原生模型选择器里直接使用 Kimi K3 和 DeepSeek V4，不用替换 ChatGPT 账号，不用手动输入 Token，安装只需一条指令。

为什么你需要 Codex Router？

OpenAI Codex 是当前最强的 AI 编程终端之一，但它默认只能使用 GPT 系列模型。如果你的工作流涉及：

  • 需要 Kimi K3 的超长上下文（1M token）处理大型代码库
  • 想用 DeepSeek V4 Pro 的高性价比做日常编码
  • 在不同任务间切换模型但不想反复登录不同平台
  • 希望保留 ChatGPT 订阅，同时接入国产模型

那你一定会遇到「复制粘贴地狱」——在 Codex、Kimi Chat、DeepSeek 网页之间来回搬运代码和上下文。Codex Router 就是为解决这个问题而生的。

Codex Router 是怎么工作的？

Codex Router 是一个独立的社区项目（与 OpenAI、Moonshot AI、DeepSeek 均无隶属关系），它在 Codex 的模型目录层注入外部模型入口，让 Codex 的模型选择器出现 Kimi 和 DeepSeek 选项。

核心原理：

┌─────────────────────────────────────┐
│           Codex 模型选择器            │
├─────────┬─────────┬─────────────────┤
│ GPT-5   │ GPT-4o  │ Kimi K3 (OAuth) │  ← 原生模型
│         │         │ Kimi K3 (API)   │  ← Router 注入
│         │         │ DeepSeek V4 Pro │  ← Router 注入
└─────────┴─────────┴─────────────────┘
         │                  │
    OpenAI API      ┌───────┴───────┐
                    │  Codex Router │
                    │  (本地服务)    │
                    └───────┬───────┘
              ┌─────────────┼─────────────┐
              ▼             ▼             ▼
        Kimi Platform  DeepSeek API   Kimi Code
           (计费)        (计费)      (OAuth)

Codex Router 作为一个本地后台服务运行，拦截模型选择请求并将其路由到对应的第三方 API。所有的 API Key 通过安全的隐藏终端输入，不会以明文形式出现在聊天记录中。

安装指南（全平台）

前提条件

  • Codex App（桌面版）或 Codex CLI，已登录 ChatGPT 账号
  • Node.js 22.19+（推荐 Node.js 24 LTS）
  • uv 或 Python 3.10+（带 venv）
  • Git

方式一：一条指令安装（推荐）

在 Codex 中新建一个任务，粘贴以下指令：

Install Codex Router from this public repository:
https://github.com/duolahypercho/codex-router

Follow AGENTS.md. Preserve my existing Codex model, profiles, settings, and
ChatGPT login. Detect and safely migrate only recognized older versions, show
only providers whose authentication I choose, run the doctor, and leave the
final Codex restart to me. Never ask me to paste a token or API key into chat.

Codex 会自主完成安装流程。如果已有兼容的凭证，安装过程完全自动化，最后你只需要手动重启 Codex。

方式二：手动引导安装

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/duolahypercho/codex-router/main/install.sh | sh -s -- --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 -Guided

引导安装器会：

  1. 询问需要启用哪些模型提供商
  2. 检测已有的认证信息
  3. 提供 kimi login 引导（OAuth 方式）
  4. 安全地提示输入 API Key（终端输入，不回显）
  5. 创建回滚快照（支持一键恢复）
  6. 安装后台服务并验证结果

第一步：配置模型提供商

安装完成后，进入 Codex Router 目录：

cd ~/codex-router  # 或你的安装路径

添加 Kimi（两种方式任选）

OAuth 方式（推荐，使用已有的 Kimi Code CLI 会话）：

kimi login           # 浏览器 OAuth 认证
./bin/providers      # 确认 Kimi OAuth 显示为 ready

API Key 方式（独立计费）：

./bin/provider-key kimi-api set   # 输入 Kimi Platform API Key

添加 DeepSeek

./bin/provider-key deepseek set   # 输入 DeepSeek API Key

管理提供商开关

./bin/providers                  # 查看所有提供商状态
./bin/providers enable deepseek  # 启用
./bin/providers disable kimi-api # 禁用

Windows 用户使用 PowerShell：

./codex-router.ps1 providers
./codex-router.ps1 provider-key deepseek set

第二步：让 Kimi 出现在 Codex 中

  1. 运行健康检查：./bin/doctor（确保没有 FAIL 行）
  2. 确认提供商就绪：./bin/providers（应显示 SHOW 和 ready）
  3. 完全退出 Codex（不是关闭窗口，是完全退出应用）
  4. 重新打开 Codex
  5. 新建任务 → 点击模型选择器 → 看到 Kimi 和 DeepSeek

如果 Kimi 仍未出现：

./bin/refresh-catalog   # 刷新模型目录
# 然后完全退出 Codex 再重新打开

第三步：支持的模型一览

选择器标签模型 ID认证方式适用场景
Kimi K3 (OAuth)kimi-oauth/k3Kimi Code CLI OAuth已有 Kimi 订阅用户
Kimi K3 (API)kimi-api/kimi-k3Kimi Platform API Key独立计费、更高并发
DeepSeek V4 Flash (API)deepseek/deepseek-v4-flashDeepSeek API Key快速、低成本任务
DeepSeek V4 Pro (API)deepseek/deepseek-v4-proDeepSeek API Key复杂推理和编码

注意： Kimi Code OAuth 和 Kimi Platform API 是两套独立的认证和计费系统。两个 Kimi 入口可以共存——OAuth 走订阅套餐，API 走按量计费。

进阶功能一：安全修复与回滚

Codex Router 内置了完善的安全机制：

./bin/doctor          # 全面诊断：权限、路径、版本兼容性
./bin/doctor --fix    # 自动修复常见问题

如果升级出了问题，安装时会自动创建回滚快照：

./bin/rollback        # 一键恢复到安装前的状态

所有敏感文件（API Key、OAuth Token）使用 600 权限（POSIX）或继承禁用的当前用户 ACL（Windows），诊断工具只检查凭证是否存在，绝不打印密钥内容。

进阶功能二：模型选择策略

不同场景推荐不同模型：

场景推荐模型理由
大型代码库重构Kimi K31M token 上下文，理解全项目
日常 CRUD 编码DeepSeek V4 Flash速度快、成本低
复杂算法/架构设计DeepSeek V4 Pro推理能力强
多轮对话调试Kimi K3超长记忆，不丢上下文
快速原型DeepSeek V4 Flash响应快，迭代效率高

常见问题与排错

Q: 安装后 Codex 启动变慢了？ A: Router 仅在 Codex 启动时加载模型目录，运行时不影响性能。首次启动会做一次目录刷新（1-3 秒），后续几乎无感。

Q: 可以用自己的 OpenRouter Key 吗？ A: 目前官方支持 Kimi 和 DeepSeek。OpenRouter 等其他提供商在路线图中。

Q: 会影响 Codex 原生的 GPT 模型吗？ A: 不会。Router 只注入新选项，不修改或替换已有的 GPT 模型入口。你的 ChatGPT 登录完全不受影响。

Q: Windows 上安装失败怎么办？ A: 确保 PowerShell 以管理员权限运行，且执行策略允许脚本运行（Set-ExecutionPolicy RemoteSigned）。

同类工具对比

工具模型切换安装复杂度开源国产模型支持
Codex Router模型选择器内切换极简（一条指令）✅ MITKimi + DeepSeek
KlaatCode智能路由自动选中等✅DeepSeek
OpenRouter需手动配置 endpoint较复杂-部分支持
手动切换复制粘贴低效-全支持但麻烦

总结

  • 🚀 零门槛：一条 Codex 指令完成安装，不需要手动配置环境变量
  • 🔐 安全第一：API Key 通过隐藏终端输入，磁盘文件 600 权限保护
  • 🔄 一键回滚：安装时自动创建快照，出问题随时恢复
  • 🌏 国产模型友好：原生支持 Kimi K3 和 DeepSeek V4，无需额外适配
  • 📦 MIT 开源：社区驱动，代码透明可审计

仓库地址：github.com/duolahypercho/codex-router

数据来源：GitHub API（⭐111，创建于 2026-07-19），README 内容截止 2026-07-21。

Related

相关文章

延伸阅读

查看全部 →
MCP

FastCtx 深度评测：用 Rust 重构 AI Agent 工具层，上下文消耗直降 60%

FastCtx 是一款 Rust 写的 MCP 工具运行时，用结构化接口替代 Shell 命令来操作代码仓库。实测让 AI Agent 减少 60% 工具调用，把更多 Token 留给真正的代码理解。
AI视频

AI 颠覆内容行业：从 Netflix 6 亿美元收购到「一人成片工厂」

Netflix 斥资 5.87 亿美元收购 Ben Affleck 的 AI 公司 InterPositive，开源社区出现「一键生成 Vox 风格视频」的 Agent 工具，AI 音乐创作从「不能听」进化到「分辨不出」——内容生产正经历范式级变革。
GitHub

2026 年第 30 周 GitHub 热榜 TOP 10：AI 安全工具井喷，智能画布与本地推理重塑开发体验

本周 GitHub 趋势呈现三大主线：AI 安全与合规工具集中爆发、空间画布类应用跻身主流、轻量级推理引擎让大模型跑进消费级硬件。10 个项目横跨安全、效率、创作与基础设施。