# Codex Router

> Use DeepSeek, Kimi, GLM, Grok and Claude inside the Codex App and CLI
> through one local, credential-isolating model router.

Codex Router is an independent community project, not affiliated with or
endorsed by OpenAI, Anthropic, Moonshot AI, DeepSeek, xAI, OpenRouter,
opencode, or opencodex.

Official repository: https://github.com/duolahypercho/codex-router
Full text version: https://codex-router.com/llms-full.txt

## Docs

- [Codex Router：在 Codex 中使用 DeepSeek、Kimi、GLM、Grok 与 Claude](https://codex-router.com): Codex Router 是免费开源的模型路由器，为 Codex App 与 CLI 接入 DeepSeek、Kimi、GLM、Grok 和 Claude。在这里完成安装、配置与故障排查。
- [Codex Router Installation Guide — macOS, Windows, Linux](https://codex-router.com/install/): Install Codex Router on macOS, Windows or Linux: guided terminal setup, AI-agent installation, authentication choices, verification, updates and uninstall.
- [Install Codex Router on macOS (Codex App & CLI)](https://codex-router.com/install/macos/): Step-by-step macOS installation of Codex Router: guided curl install, Kimi OAuth, the menu-bar tray, verification with doctor, and uninstall.
- [Install Codex Router on Windows (Codex App & CLI)](https://codex-router.com/install/windows/): Step-by-step Windows installation of Codex Router: PowerShell guided install, the codex-router.ps1 wrapper, WSL notes, Task Scheduler and verification.
- [Install Codex Router with an AI Agent (AGENTS.md)](https://codex-router.com/install/agent/): Let an AI agent install Codex Router for you: paste one instruction into a Codex task, and the agent follows the repository's AGENTS.md procedure safely.
- [Codex Router 模型矩阵 — DeepSeek、Kimi、GLM、Grok、Claude](https://codex-router.com/models/): Codex Router 完整模型矩阵：每个受支持的供应商、选择器标签、模型 ID 与认证方式，以及 OAuth 与 API Key 的对比。
- [Codex DeepSeek：在 Codex 中使用 DeepSeek V4 Flash 与 Pro](https://codex-router.com/models/deepseek/): 如何用 Codex Router 在 Codex 中使用 DeepSeek V4 Flash 和 V4 Pro：API Key 配置、启用命令、验证、行为说明与常见坑。
- [Codex Kimi：在 Codex 中使用 Kimi K3 与 K2.7](https://codex-router.com/models/kimi/): 如何用 Codex Router 在 Codex 中使用 Kimi K3 和 K2.7：Kimi Code CLI OAuth 与 Kimi Platform API Key 的对比、启用命令与常见坑。
- [Codex GLM：在 Codex 中使用 GLM-5.2](https://codex-router.com/models/glm/): 如何用 Codex Router 在 Codex 中使用 GLM-5.2 和 GLM-5-Turbo：Ollama Cloud 密钥与 Z.ai GLM Coding Plan 密钥、设置命令与常见坑。
- [Codex Grok：在 Codex 中使用 Grok 4.5](https://codex-router.com/models/grok/): 如何用 Codex Router 在 Codex 中使用 Grok 4.5：官方 Grok CLI OAuth 登录与 xAI API Key、托管搜索、Windows 注意事项与验证。
- [Codex Claude：在 Codex 中使用 Claude Opus 4.8](https://codex-router.com/models/claude/): 如何用 Codex Router 在 Codex 中使用 Claude Opus 4.8：Anthropic API Key 配置、启用命令、Messages 协议路由、验证与常见坑。
- [Codex Router 无法工作？故障排查与修复](https://codex-router.com/troubleshooting/): 修复 Codex Router 常见问题：doctor 命令、模型缺失、OAuth 未就绪、Grok CLI 被阻止、密钥错误、服务停止等。
- [Codex Router doctor — 诊断与修复安装问题](https://codex-router.com/troubleshooting/doctor/): Codex Router doctor 命令检查哪些内容、如何解读 FAIL 项、何时使用 doctor --fix、状态所有权与 support bundle。
- [Codex Router 模型缺失？修复模型选择器](https://codex-router.com/troubleshooting/picker/): 外部模型为什么不出现在 Codex 模型选择器里以及如何修复：供应商状态、目录刷新、完整重启 App、子代理与 doctor。
- [Codex Router 兼容应用 — T3 Code 指南](https://codex-router.com/compatible-apps/): 包装官方 CLI 的应用会自动继承 Codex Router 的模型。本页介绍 T3 Code 与通用的适配器模式。
- [Codex Router 工作原理 — 架构与请求流程](https://codex-router.com/how-it-works/): 理解 Codex Router 的架构：目录合并、LiteLLM 翻译、凭据隔离、请求流程以及哪些仍留在 Codex 内。
- [Codex Router 更新日志 — 版本历史](https://codex-router.com/changelog/): Codex Router 的分版本更新日志，每周与仓库 CHANGELOG.md 同步：更新、修复、新供应商与模型注册表变更。
- [codex-router 对比 claude-code-router 与 opencodex](https://codex-router.com/comparison/): 对比 codex-router 与 claude-code-router (CCR) 和 opencodex：目标应用、目录方式、选择器集成、认证与维护。
- [Codex Router 常见问题 — 安装、认证、安全、卸载](https://codex-router.com/faq/): Codex Router 常见问题：它是什么、OAuth 与 API Key、ChatGPT 登录、安全、更新、卸载以及在哪里求助。
- [关于 Codex Router — 社区文档与免责声明](https://codex-router.com/about/): 关于 Codex Router 社区文档站：内容来源、更新节奏、完整免责声明、MIT 许可与如何参与。