Codex Grok：使用 Grok 4.6、4.5、OAuth 与 API

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

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.6 或 4.5。实时检查：

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

Grok 4.6 与可选 Fast 档位

OAuth 路线发布的 Grok 4.6 具有 500K 上下文、文本与图片输入、托管网页/X 搜索，以及 low、medium、high、xhigh 推理级别。支持服务档位控制的客户端还会显示可选的 priority 档位 Fast。Fast 必须按请求主动选择；Codex Router 不会全局开启，也不会把它转发给未声明该档位的故障转移模型。

长时间 Grok 推理停顿现在会由有界心跳保持连接；修复尝试失败或不完整时会向 Codex 返回终止错误，不再放出不完整的私有答案，也不会静默重放可能重复计费的回合。

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 安装说明、故障排查。