Codex Grok：使用 Grok 4.7、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.7 同时提供 OAuth 与独立计费的 API 路线。

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 系列路线，Codex Router 现在会把已识别的工作区指令段落调整为适合 Grok 可用文件工具的说明。发布给模型的指令会使用 read_file、grep、list_dir 和 search_replace，并要求把互不依赖的读取作为独立调用发出，而不是调用不存在的 multi_tool_use.parallel。这改变的是 Grok 看到的指令，不会更改路线的工具或认证配置。

启用 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.7

Grok 4.7 已内置于 grok-oauth、grok-api、OpenCode Go、Command Code、Nous Research 和 OpenRouter。500K 上下文支持文本与图片；OAuth 和 OpenRouter 提供 low/medium/high/xhigh，Command Code 保守地提供 low/medium/high。直连 OAuth 与 API 路线现在提供可选 Fast；4.7 OAuth 路线仍没有 v2 子代理认证。

Grok 直连路线与可选 Fast 档位

OAuth 路线发布的 Grok 4.6 具有 500K 上下文、文本与图片输入、托管网页/X 搜索，以及 low、medium、high、xhigh 推理级别。可选的 priority 档位 Fast 现覆盖所有 xAI 直连预设：OAuth 4.5/4.6/4.7 与 API 4.5/4.7。Fast 仍须按请求主动选择；路由器不会全局开启，也不会转给未声明该档位的故障转移模型。更新后需完全退出并重新打开 Codex 才能重载模型控制项。转售路线保留各自的供应商行为。

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

Grok OAuth 4.6/4.7 的结构化编辑现在默认使用带类型的补丁与整行 replace_lines，同时保留原生权限和终端参数。在路由器服务环境中设置 CODEX_ROUTER_GROK_STRUCTURED_PATCH=0 可继续使用原生补丁文本。已完成的简短回答不会再因推理 token 数而被推测性重试；工具结果之后，只有没有工具调用的空白完成响应才会进行一次有界恢复。

发送给 Codex 的上下文估算现在以最终供应商请求为准，不再累加内部搜索提示词。实际计费 token 仍记入本地用量账本；Grok 流失败会报告终止错误，不再自动重放。

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