GROK CLI · CONFIG.TOML · 约 8 分钟

Grok CLI 配置教程

安装 Grok CLI,将可可AI 的 Base URL 与 API Key 写入配置文件,然后直接运行 grok。

  1. 01
    创建密钥确认 Grok 分组可用
  2. 02
    安装 CLI使用官方安装脚本
  3. 03
    写入配置保存 config.toml
  4. 04
    启动验证运行 grok 并检查用量

创建密钥并确认端点

API Key控制台 → API 密钥 → 创建或复制
Grok CLI Base URLhttps://kekeshop.top/v1
配置文件macOS / Linux:~/.grok/config.toml
Windows:%USERPROFILE%\.grok\config.toml
模型使用控制台当前可用的 Grok 模型;下方示例使用 grok-4.5
已有配置? 先备份原 config.toml,再合并新的模型配置,避免覆盖其他设置。

安装 Grok CLI

Terminal

安装与检查
curl -fsSL https://x.ai/cli/install.sh | bash
grok --version
找不到 grok 命令? 先关闭并重新打开终端。macOS / Linux 可检查 ~/.local/bin 与 ~/.grok/bin,Windows 可检查 %USERPROFILE%\.grok\bin 是否在 PATH 中。

写入 config.toml

把 你的_API_Key 替换为控制台中的完整密钥。模型 ID 以控制台当前可用列表为准。

config.toml
[models]
default = "grok"
web_search = "grok"
default_reasoning_effort = "high"

[model.grok]
model = "grok-4.5"
base_url = "https://kekeshop.top/v1"
name = "Grok"
description = "Grok through Keke AI"
api_key = "你的_API_Key"
api_backend = "responses"
context_window = 1000000
supports_backend_search = true
MACOS / LINUX

~/.grok/config.toml

目录不存在时先执行 mkdir -p ~/.grok。

WINDOWS

%USERPROFILE%\.grok\config.toml

目录不存在时先在用户目录创建 .grok 文件夹。

运行 Grok

01

启动

终端运行 grok。默认模型已设为 grok。

02

按需调整

会话中可用 /effort low|medium|high|xhigh 调整推理强度。

03

检查用量

发送一条消息后,在控制台确认是否出现 Grok 用量。

日常启动
grok

# 仅排错时检查生效配置
grok inspect

常见问题

命令找不到 grok

重新打开终端并检查 PATH。仍失败时重新运行对应系统的安装脚本。

401 Unauthorized

重新从控制台复制完整 API Key,写入配置后重新启动 Grok CLI。

连接超时

确认 base_url 为 https://kekeshop.top/v1,不要使用 xAI 官方地址。

model not found

将配置中的模型 ID 改为当前 Key 所属分组支持的模型。

控制台没有新增用量

运行 grok inspect,检查实际生效的 Base URL 与 API Key。

消耗速度过快

降低推理强度,例如使用 /effort medium,并根据任务复杂度调整。