Grok 安装与接入 RootFlowAI

Grok 可通过两种客户端接入 RootFlowAI：使用 xAI 官方 Grok CLI，或继续使用 Codex CLI / App 并把底层模型切换为 Grok。两种方式都使用 OpenAI 兼容地址 https://api.rootflowai.com/v1。

两个客户端读取不同配置文件，不要混用。开始前请在账户中心创建独立 API Key，并在模型价格页确认当前可用的 Grok 模型 ID。

方式一：官方 Grok CLI

安装

macOS、Linux 或 WSL：

curl -fsSL https://x.ai/cli/install.sh | bash

Windows PowerShell：

irm https://x.ai/cli/install.ps1 | iex

重新打开终端后验证：

which grok
grok --version

使用环境变量保存 Key

不要把真实 Key 写入公开脚本或仓库。先设置一个只供 Grok 使用的环境变量：

export ROOTFLOWAI_GROK_API_KEY="sk-你的RootFlowAI令牌"

需要长期使用时，把这行加入本机的 ~/.zshrc 或 ~/.bashrc，并确保这些文件不会被提交到仓库。

配置模型

编辑 ~/.grok/config.toml：

[model.rootflowai-grok]
model = "grok-4.3"
base_url = "https://api.rootflowai.com/v1"
name = "RootFlowAI Grok"
env_key = "ROOTFLOWAI_GROK_API_KEY"

[models]
default = "rootflowai-grok"

grok-4.3 是示例模型。只有当账户模型列表包含该 ID 时才可使用；否则替换为当前可用的 Grok 模型。

default 填写的是 [model.rootflowai-grok] 的配置段名称，而不是模型 ID。env_key 填写环境变量名称，不能把 sk-... 密钥本身写在这里。

验证

先执行不产生模型推理费用的模型列表查询：

curl https://api.rootflowai.com/v1/models \
  -H "Authorization: Bearer $ROOTFLOWAI_GROK_API_KEY"

确认模型存在后再运行 Grok CLI：

grok inspect
grok -p "Reply with exactly: ROOTFLOW_OK"

最后一条命令会调用模型并产生正常用量。grok inspect 应显示 RootFlowAI 的 Base URL、配置段和认证来源。

方式二：在 Codex 中使用 Grok

这种方式的客户端仍是 Codex，只是模型改为 Grok。先按 Codex 安装与接入 RootFlowAI完成安装，再修改 ~/.codex/config.toml：

model = "grok-4.3"
model_provider = "rootflowai"

[model_providers.rootflowai]
name = "RootFlowAI"
base_url = "https://api.rootflowai.com/v1"
wire_api = "responses"
requires_openai_auth = true

API Key 仍放在 ~/.codex/auth.json：

{
  "OPENAI_API_KEY": "sk-你的RootFlowAI令牌"
}

如果目标 Grok 模型只支持 Chat Completions 而不支持 Responses，请改用官方 Grok CLI 或兼容 Chat Completions 的客户端。以模型价格页显示的接口能力为准。

常见问题

Grok CLI 仍跳转 x.ai 登录

通常是 CLI 没有读到 env_key 指定的环境变量，或 [models].default 没有指向正确配置段。执行 grok inspect 检查配置来源。

env_key 配置后仍提示缺少 Key

env_key 的值应是 ROOTFLOWAI_GROK_API_KEY，不是 sk-...。可用下面的命令确认当前终端能读取变量，但不要把完整 Key 截图或发给他人：

test -n "$ROOTFLOWAI_GROK_API_KEY" && echo "API Key 已加载"

返回 404

Base URL 必须是 https://api.rootflowai.com/v1。不要使用门户网页地址，也不要重复拼接 /v1。

返回 model not found

模型可能已更新、当前分组不可用，或 Key 设置了模型白名单。查询 /v1/models 并在账户中心检查令牌权限。

Codex 中的 Grok 行为与官方 CLI 不同

这是正常现象。Codex 仍负责工具调用、权限和会话管理，Grok 只作为底层模型；需要 Grok 原生交互时请使用官方 Grok CLI。

下一步

• 获取 API Key
• Codex 安装与接入 RootFlowAI
• API 接口参考
• 服务定价