My Docs

Appearance

Grok 配置教程 ​

本教程说明如何在 Codex CLI 中切换到 Grok 4.5。

1. 创建 API 密钥 ​

登录 控制台，在「API 密钥」中创建或选择密钥，并将密钥分组设置为 Grok 分组。

WARNING

只有 Grok 分组的密钥可以调用 Grok 模型。请勿将 API 密钥提交到 Git 仓库、截图或发送给他人。

2. 修改 Codex 配置 ​

打开 config.toml：

系统路径
Windows%USERPROFILE%\.codex\config.toml
macOS / Linux~/.codex/config.toml

在文件顶部的模型配置中，添加或修改为：

toml
model = "grok-4.5"

保留原有的 model_provider 与 API 服务地址配置即可。例如使用本站默认提供商时：

toml
model_provider = "codex-for-me"
model = "grok-4.5"

[model_providers.codex-for-me]
name = "openai"
base_url = "https://blackaicoding.com/v1"
wire_api = "responses"
requires_openai_auth = true

保存后重启 Codex CLI：

bash
codex

一键切换模型 ​

以下脚本会提示你输入 API Key。输入前请确认该密钥在控制台中选择了 Grok 分组；脚本会保存密钥，并在配置文件中新增或更新 model = "grok-4.5"。

Windows ​

下载 Windows 配置脚本（.bat）

双击运行，或在命令提示符中运行：

bat
configure-grok.bat

macOS / Linux ​

下载 macOS / Linux 脚本

在下载目录运行：

bash
chmod +x configure-grok.sh
./configure-grok.sh

常见问题 ​

切换后仍无法调用 Grok ​

确认以下事项：

  1. API 密钥在控制台中选择了 Grok 分组。
  2. config.toml 中模型名完全为 grok-4.5。
  3. 保存配置后重新启动了 Codex CLI。
  4. API 密钥有效且账户余额充足。

如何切回其他模型？ ​

编辑同一份 config.toml，将 model 改为需要使用的模型名称后重启 Codex CLI。