在 Codex CLI / App 中使用 Grok 4.5

Posted July 19, 2026 by XAI 技术团队 ‐ 3 min read

本文介绍如何通过 XAI Control，在 OpenAI Codex CLI 与 Codex App 中使用 grok-4.5。按照下面的步骤完成设置后，即可在日常编码任务中直接使用。

1. 设置 API Key

Linux / macOS 用户在终端执行：

export XAI_API_KEY="你的 XAI Control API Key"

Windows PowerShell 用户执行：

$env:XAI_API_KEY = "你的 XAI Control API Key"

2. 配置 Codex

Linux 和 macOS 的用户配置文件是 ~/.codex/config.toml；Windows 对应 %USERPROFILE%\.codex\config.toml。

将下面的内容合并到配置文件中：

model_provider = "grok"
model = "grok-4.5"
model_reasoning_effort = "xhigh"
model_context_window = 500000
model_auto_compact_token_limit = 450000

[model_providers.grok]
name = "Grok via XAI Control"
base_url = "https://api.xaicontrol.com"
wire_api = "responses"
env_key = "XAI_API_KEY"
stream_idle_timeout_ms = 900000

如果配置文件中已有 [mcp_servers.*]、[features]、[tui] 或其他个人设置，请保留原有内容，只替换冲突的顶层 model* 配置，并新增或更新 [model_providers.grok]。

默认使用 xhigh 推理强度。如果更重视响应速度，可以改为 high 或 medium。

请直接使用示例中的 API 根地址，不要在 base_url 后追加 /v1 或 /responses。保存配置后，完全退出并重新启动 Codex。

3. 验证配置

先查看 Codex CLI 版本：

codex --version

然后运行一次最小测试：

codex exec --strict-config --ephemeral --skip-git-repo-check \
  "只回复：CODEX_GROK_OK"

启动信息中应显示：

model: grok-4.5
provider: grok
reasoning effort: xhigh

并最终返回：

CODEX_GROK_OK

Codex App 使用提示

从桌面图标启动的 Codex App 可能无法读取终端中临时设置的环境变量。遇到 API Key 未设置的提示时，请将 XAI_API_KEY 添加到操作系统的用户环境变量，完全退出 App 后重新打开；也可以从已经设置该变量的终端启动 App。

常见问题

返回 `401 Unauthorized`

请确认：

XAI_API_KEY 已在启动 Codex 的同一环境中生效。
API Key 来自 XAI Control。
base_url 是 https://api.xaicontrol.com。

可以用下面的命令确认变量是否存在。该命令不会显示 Key 的内容：

test -n "$XAI_API_KEY" && echo "XAI_API_KEY is set"

出现 `Model metadata for grok-4.5 not found`

如果测试请求仍能正常返回结果，可以继续使用。请保持本文提供的 model_context_window 和 model_auto_compact_token_limit 配置。

修改后没有生效

确认配置写在用户级 ~/.codex/config.toml 中，并在修改后新建 Codex 会话。已经运行中的会话不会自动切换模型。

API Key 安全建议

不要把真实 API Key 提交到 Git、放进截图或发送到公开聊天中。

完成以上设置后，即可通过 XAI Control 在 Codex CLI 与 Codex App 中使用 grok-4.5。

参考资料：