Grok Build

Grok Build 属于命令行工具（CLI），启动命令是 grok。目前本教程不使用 CC-Switch 配置 Grok Build，请按本页手动设置。

开始前请到模型广场搜索 grok，创建包含目标模型的 API 令牌，并复制完整模型 ID。下文中的 your-grok-model-id 是占位符，不代表平台当前固定提供某个 Grok 模型。

一、安装 Grok Build

macOS / Linux / WSL：

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

Windows PowerShell：

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

重新打开终端后检查：

grok --version

二、配置玖亿AI

配置文件位置：

系统	配置文件
macOS / Linux / WSL	`~/.grok/config.toml`
Windows	`%USERPROFILE%\.grok\config.toml`

目录或文件不存在时，可以手动创建。写入：

[model.jiuyi-grok]
model = "your-grok-model-id"
base_url = "https://api.9e.lv/v1"
name = "玖亿AI Grok"
env_key = "JIUYI_API_KEY"
api_backend = "responses"
 
[models]
default = "jiuyi-grok"

model 替换为模型广场中的完整模型 ID
env_key 填的是环境变量名称，不是实际 API Key
Base URL 需要包含 /v1

三、在当前终端设置 API Key

为了避免令牌直接出现在 shell 历史中，请通过隐藏输入设置环境变量。

macOS / Linux / WSL：

printf "请输入 API Key："
read -s JIUYI_API_KEY
export JIUYI_API_KEY
printf "\n"

Windows PowerShell：

$secureKey = Read-Host "请输入 API Key" -AsSecureString
$env:JIUYI_API_KEY = [System.Net.NetworkCredential]::new("", $secureKey).Password

以上变量只在当前终端会话有效。重新打开终端后需要再次设置；需要长期使用时，请按照操作系统的安全方式保存环境变量，不要把令牌写进公开脚本或仓库。

四、检查并测试

grok inspect
grok -p "请用一句话介绍你能帮我做什么"

能正常返回内容，并且玖亿AI 控制台出现请求日志，说明配置成功。

五、可选：直接调用 Grok API

下面的 macOS / Linux / WSL 示例复用上一步的 JIUYI_API_KEY，不会把令牌明文写进 curl 命令。先设置模型 ID：

export JIUYI_GROK_MODEL="your-grok-model-id"

Responses API

curl https://api.9e.lv/v1/responses \
  -H "Authorization: Bearer ${JIUYI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"${JIUYI_GROK_MODEL}\",
    \"input\": \"请用一句话介绍 Grok Build\"
  }"

Chat Completions API

curl https://api.9e.lv/v1/chat/completions \
  -H "Authorization: Bearer ${JIUYI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"${JIUYI_GROK_MODEL}\",
    \"messages\": [
      {\"role\": \"user\", \"content\": \"请用一句话介绍 Grok Build\"}
    ]
  }"

⚠️

API Key 仍然属于敏感信息。不要执行会打印环境变量的命令，也不要把包含环境变量值的终端截图发送给他人。

常见问题

仍然打开 xAI 登录页：运行 grok inspect，检查自定义模型和环境变量是否被读取
env_key = "sk-..."：写法错误，env_key 必须填写环境变量名称
401：检查当前终端是否已设置 JIUYI_API_KEY，以及令牌、余额和额度
模型不存在：重新从模型广场复制完整模型 ID，并检查令牌分组
Responses 不兼容：确认平台当前是否支持该模型的 Responses 协议；需要改用 Chat Completions 时，再将 api_backend 调整为 Grok Build 当前文档支持的对应值

仍无法解决时查看常见问题。

Gemini CLI 简介