Codex Router 社区文档 EN GitHub
最后更新

Codex Router 安装指南 — macOS、Windows、Linux

本指南覆盖在 macOS、Windows 和 Linux 上安装 Codex Router 的全部方式：每种方法做什么、如何在 OAuth 与 API Key 之间选择、以及如何验证、更新和移除集成。Codex App 支持 macOS 与 Windows；Codex CLI 支持 macOS、Windows 与 Linux。

前置要求

开始前请从官方来源安装以下软件。安装器不会替你静默安装包管理器或运行时。

  • Codex App 或 CLI。
  • Node.js 22.19 或更高版本（推荐 Node.js 24 LTS）。
  • uv，或 Python 3.10+（含 venv）。
  • Git，用于托管式一键安装与回滚。
  • 至少一个 Kimi OAuth、Kimi API 或 DeepSeek API 凭据——你也可以在引导过程中选择其他供应商。

选择安装方式

有三种受支持的安装方式，最终都会得到同一个经过验证的按用户后台服务：

  • 引导式终端安装——一个编号向导，带你完成供应商选择、凭据录入与验证。适合大多数人。
  • AI Agent 安装——把一段指令粘贴进 Codex 任务，让 Agent 按仓库 AGENTS.md 流程安装。适合想要可复现安装或省事的用户。
  • 克隆后审查安装——先克隆仓库、审阅代码，再从检出目录运行安装器。适合想先看代码再执行的人。

三种方式见下文。如果你已确定供应商，可以直接跳到模型教程。

引导式终端安装

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

向导按编号分步进行：用编号切换供应商列表（a 全选、n 清空、回车继续），每个供应商实时显示 ready/needs-key/needs-sign-in 状态；为你选择的、尚未接入的项目做凭据引导；最后在改动前给出确认摘要。

在 macOS 和 Linux 上，引导式安装还可以选择构建并启动桌面伴侣（macOS 菜单栏应用或 Windows/Linux 托盘）。--with-tray 直接安装、--no-tray 从不询问、自动模式跳过。

克隆后审查安装

git clone https://github.com/duolahypercho/codex-router.git
cd codex-router
./install.sh --target codex --guided
git clone https://github.com/duolahypercho/codex-router.git
Set-Location codex-router
./install.ps1 -Target codex -Guided

认证方式选择

Codex Router 支持两种认证方式，它们即使属于同一厂商也是独立的账户与计费体系：

方式供应商原理
OAuthKimi Code CLI、Grok CLI复用官方 CLI 的已登录会话，无需保存密钥
API KeyDeepSeek、Kimi Platform、xAI、Anthropic、Ollama Cloud、Z.ai、Qwen plan 等通过隐藏提示输入一次，保存在受保护的按用户文件中

API Key 只通过隐藏的终端提示（或桌面托盘的替换/移除操作）输入。永远不要把 token 或 API Key 粘贴到对话、命令行参数、shell 历史或受版本控制的文件里。

详细对比见常见问题与各模型页（DeepSeek、Kimi、GLM、Grok、Claude）。

验证安装

model_catalog_json 在 Codex 启动时加载，所以安装后必须完全退出 App、重新打开并新建任务，然后检查：

./bin/model-router codex doctor
./bin/model-router codex providers
codex debug models

doctor 对每个健康层报告 OK，对每个 FAIL 给出针对性修复。目标供应商必须同时显示 SHOW 与 ready。

更新、回滚、停用与卸载

./bin/model-router codex update
./bin/model-router codex rollback
./bin/model-router codex disable
./bin/model-router codex enable
./bin/model-router codex uninstall

update 要求干净的 main 检出与可识别的 GitHub 源，并把上一版本保留为回滚引用。disable 只移除 Codex 集成与当前服务。uninstall 有意保留检出目录、日志、备份与供应商凭据，避免常规卸载销毁认证或恢复数据。

平台细节见 macOS 安装、Windows 安装 与 Agent 安装，出问题时看故障排查。