Codex Grok：在 Codex 中使用 Grok 4.5

本指南教你如何用 Codex Router 把 Grok 4.5 加进 Codex 模型选择器。Grok 有两条认证路径——官方 Grok CLI OAuth 会话与独立计费的 xAI API Key——OAuth 路径还会为路由模型附加托管 web search 与 x_search 工具。

GrokOAuthAPI Key

可以添加什么

选择认证方式

• Grok OAuth 复用 ~/.grok/auth.json 中的官方 Grok CLI 凭据。路由器只把它发送给 xAI 文档化的 Grok CLI 推理代理。这条路径还会附加裸托管 web_search 与 x_search 工具——与 Grok Build 使用的同一 agentic 界面——由 xAI 后端决定何时搜索、如何过滤结果。
• Grok API 使用通过隐藏提示输入的、独立计费的 xAI API Key。不想装 Grok CLI，或在 Windows 上 Smart App Control 会阻止 CLI（见下）时选这个。

启用 Grok OAuth

安装官方 Grok CLI 并认证：

npm install -g @xai-official/grok
grok login --oauth

然后启用供应商：

./bin/model-router codex providers enable grok-oauth
./bin/model-router codex doctor

OAuth token 保留在 ~/.grok/auth.json，只发送给 Grok CLI 推理代理。绝不要把它复制进 Codex 配置、密钥文件或环境变量。

启用 Grok API

./bin/model-router codex provider-key grok-api set
./bin/model-router codex providers enable grok-api

Windows 上用 ./codex-router.ps1 codex provider-key grok-api set。隐藏提示关闭终端回显，密钥保存在受保护的按用户文件中。

验证集成

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

所选供应商必须报告 SHOW 与 ready。然后完全退出 Codex、重新打开、新建任务，在选择器中找 Grok 4.5。实时检查：

./bin/test-model 'grok-oauth/grok-4.5' --live --yes

Windows 注意事项：Smart App Control

在 Windows 上，Smart App Control 可能阻止官方 Grok CLI。如果 grok --version 报 spawn UNKNOWN、“An Application Control policy has blocked this file,” 或 Smart App Control 通知，Grok OAuth 无法完成登录或刷新会话。保持 Smart App Control 开启——它没有安全的单应用绕过方式——改用带 xAI API Key 的 grok-api 供应商：

./model-router.ps1 codex provider-key grok-api set
./model-router.ps1 codex providers enable grok-api
./model-router.ps1 codex doctor

在可执行文件被允许时创建的 OAuth 会话不是持久方案：路由器会在 token 临近过期时再次调用官方 CLI，如果 Windows 之后阻止了可执行文件，会话最终会停止刷新。

常见坑

• OAuth 与 API 是独立计费体系。 Grok CLI 订阅不支付 grok-api 用量，xAI API Key 也不能刷新 Grok OAuth 会话。
• 搜索行为由上游控制。 路由器附加搜索工具但不接收搜索环境开关或请求侧过滤配置；由 xAI 决定何时、如何搜索。
• 供应商策略风险。 xAI 可能限制或封禁代理流量。通过 Codex Router 使用 Grok 风险自负。

官方链接

• Grok CLI (npm)
• xAI API

相关：模型总览、Windows 安装说明、故障排查。