Codex Router 常见问题 — 安装、认证、安全、卸载
Codex Router 是什么？
Codex Router 是一个免费、开源、本地的模型路由器，适用于 Codex App 与 CLI。它把外部模型——DeepSeek、Kimi、GLM、Grok、Claude、opencode Go、Command Code、Meta 等——加进原生 Codex 模型选择器，并按供应商隔离凭据。一切都在 127.0.0.1 本地运行。
Codex Router 是官方的吗？
不是。它是一个独立的社区项目，与 OpenAI、Anthropic、Moonshot AI、DeepSeek、xAI、OpenRouter、opencode 或 opencodex 均无关联，也不受其认可。它不包含 “GPT” 或 “ChatGPT” 供应商——原生 GPT 模型继续直接使用 Codex。
Codex Router 免费吗？
是的。路由器是 MIT 许可、免费使用。你只需为接入的外部供应商账户付费（例如 DeepSeek API Key 或 Z.ai Coding Plan）。未经显式开启 smoke test，安装器绝不发起付费测试请求。
使用外部模型需要 ChatGPT 或 OpenAI 登录吗？
不需要。外部模型通过自己的 OAuth 会话或 API Key 认证。托盘的”无需 OpenAI 登录”开关会让新 Codex 会话选择托管自定义供应商，因此未登录的 Codex 也能使用已连接的外部供应商。原生 GPT 模型、ChatGPT 用量与云端任务仍需要 OpenAI 认证。
OAuth 和 API Key 有什么区别？
OAuth 复用官方 CLI 的已登录会话——Kimi Code OAuth 读取 ~/.kimi-code，Grok OAuth 读取 ~/.grok/auth.json。API Key 是独立计费的开发者密钥（DeepSeek、Kimi Platform、xAI、Anthropic、Ollama Cloud、Z.ai、Qwen plan），通过隐藏提示输入一次。即使同一厂商，OAuth 与 API 访问也是独立的计费体系，其条目刻意共存。
Codex Router 会破坏我的 GPT 模型或 ChatGPT 登录吗？
不会。集成保留内置 OpenAI 供应商、原生 GPT 模型、ChatGPT 登录、配置档案、MCP 设置、项目信任与推理默认值。disable 只移除标记配置块与当前服务，关闭免登录模式会精确恢复此前的 model 与 model_provider。
输入我的 API Key 安全吗？
安全。密钥通过关闭回显的隐藏终端提示输入、保存在受保护的按用户文件（POSIX mode 600、Windows 当前用户 ACL）中、只发送给该供应商的配置端点。诊断只报告存在与来源，绝不报告值。路由器绝不会让你在对话中粘贴密钥。
供应商允许通过 Codex Router 路由吗？
不一定。模型供应商可能限制或封禁代理流量。通过第三方工具路由外部模型风险自负（UAYOR），本站内容也不保证任何供应商允许这么做。请查阅各供应商条款。
如何更新或卸载 Codex Router？
./bin/model-router codex update
./bin/model-router codex rollback
./bin/model-router codex uninstall更新要求干净的 main 检出，并把上一版本保留为回滚引用。卸载移除活动集成与后台服务，但按设计保留检出目录、日志、备份与供应商凭据——删除任何内容前先手动检查状态目录。
在哪里可以获得帮助？
运行 ./bin/model-router codex doctor、按照故障排查指南、用 ./bin/support-bundle 创建支持包，然后在 Codex Router 仓库 开 issue。绝不要把凭据或完整托管 URL 粘贴进 issue。