Grok 中转站教程

Grok 中转站教程:用 Grok CLI 接入可可AI

推荐流程与控制台「使用密钥」一致:安装官方 Grok CLI → 写入 ~/.grok/config.toml → 直接运行 grok。配置里默认模型是 grok,一般不用再 /model

准备工作

先准备 Key 和端点

约 2 分钟

1. 创建可可AI API Key

登录控制台,进入 API 密钥页面,创建或复制一枚可用 Key。购买套餐或充值后,也请确认 Key 所属分组可用。

打开控制台

2. 确认 API 端点

站内 API 端点为 https://kekeshop.top。写入 Grok CLI 时,Base URL 填 https://kekeshop.top/v1,不要填 xAI 官方域名。

3. 模型别名说明

配置里用别名 grok,底层模型 ID 为 grok-4.5。默认已设好,启动后无需再 /model 切换。

详细步骤

三步完成接入

重点
1
安装官方 Grok CLI

macOS / Linux 用 bash 安装脚本;Windows 用 PowerShell 安装脚本。装完执行 grok --version 验证。

2
写入 config.toml

把下方配置保存到 ~/.grok/config.toml(Windows 为 %USERPROFILE%\.grok\config.toml)。把 API Key 换成你自己的。

3
运行 grok

终端执行 grok 即可。config 已默认 grok,一般不用再 /model

4
(可选)调节 effort

在 CLI 里输入 /effort high。可选:low / medium / high / xhigh。默认配置里已是 high

5
(可选)inspect 排障

只有异常时才需要 grok inspect 查看生效配置,日常启动不必跑。

6
回看控制台用量

调用成功后到控制台看用量。若没有新增,请检查 base_url 是否指向本站。

和「使用密钥」弹窗一致

控制台 Keys 页点击「使用」→ Grok CLI,会按系统给出安装命令、config.toml 和启动说明。本页是同一套流程的静态版,方便收藏和分享。

第一步

安装官方 Grok CLI

macOS · Linux · Windows

macOS / Linux

在 Terminal / zsh / bash 中执行:

# 安装官方 Grok CLI
curl -fsSL https://x.ai/cli/install.sh | bash

# 若当前 shell 还找不到 grok,先加载 PATH(或新开一个终端)
# export PATH="$HOME/.local/bin:$HOME/.grok/bin:$PATH"

# 验证安装
grok --version

# 可选:更新到最新版
# grok update

Windows(PowerShell)

需要 PowerShell 5.1+;安装后会自动把 %USERPROFILE%\.grok\bin 加入用户 PATH。

# 推荐原生安装
irm https://x.ai/cli/install.ps1 | iex

# 新开一个终端后验证
grok --version

# 可选:更新到最新版
# grok update
安装后找不到 grok?

新开一个终端再试。macOS / Linux 也可临时执行 export PATH="$HOME/.local/bin:$HOME/.grok/bin:$PATH"。Windows 请确认用户 PATH 里包含 %USERPROFILE%\.grok\bin

第二步

写入 config.toml

可直接复制

配置文件路径

macOS / Linux~/.grok/config.toml
Windows%USERPROFILE%\.grok\config.toml
创建目录macOS/Linux:mkdir -p ~/.grok
Windows PowerShell:目录不存在时先创建 .grok
Base URLhttps://kekeshop.top/v1(必须本站,不要填 xAI 官方域名)
API Key填写可可AI控制台生成的 API Key
默认模型别名grok → 底层 grok-4.5

config.toml 示例

你的_API_Key 换成控制台密钥。若已有 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 4.5"
description = "Grok 4.5 through this site"
api_key = "你的_API_Key"
api_backend = "responses"
context_window = 1000000
supports_backend_search = true
第三步

启动与日常使用

运行 grok

macOS / Linux

# 1) 确保配置目录存在
mkdir -p ~/.grok

# 2) 把上方 config.toml 保存到:
#    ~/.grok/config.toml

# 3) 启动 Grok CLI(日常用法;默认已是 grok)
grok

# 4) 按需调节推理强度(effort,可选)
#    /effort high
#    可选:low / medium / high / xhigh

# 可选:检查当前生效配置(排障用,非必须)
# grok inspect

Windows PowerShell

# 1) 确保配置目录存在
if (-not (Test-Path "$env:USERPROFILE\.grok")) {
  New-Item -ItemType Directory -Path "$env:USERPROFILE\.grok" | Out-Null
}

# 2) 把上方 config.toml 保存到:
#    %USERPROFILE%\.grok\config.toml

# 3) 启动 Grok CLI(日常用法;默认已是 grok)
grok

# 4) 按需调节推理强度(effort,可选)
#    /effort high
#    可选:low / medium / high / xhigh

# 可选:检查当前生效配置(排障用,非必须)
# grok inspect

effort 说明

  • config 里默认 default_reasoning_effort = "high"
  • 会话中可用 /effort low|medium|high|xhigh 临时调整
  • 更高 effort 通常更慢、更吃额度,按任务需要选择

控制台一键复制

登录后进入 API 密钥页,点对应 Grok 密钥的「使用」,可按 macOS / Windows 一键复制安装命令、config 和启动说明。

打开密钥页
字段对照

config 关键字段含义

对照表

必填 / 关键

models.defaultgrok,启动后默认用这个别名
model.grok.model底层模型 ID,示例 grok-4.5(以控制台可用列表为准)
base_urlhttps://kekeshop.top/v1
api_key可可AI 控制台 API Key
api_backendresponses(Grok CLI 走 Responses)
default_reasoning_effort默认 high,可按需改

注意点

  • base_url 必须是本站,不要写成 xAI 官方地址
  • 已有 config.toml 时先备份,再合并 [model.grok]
  • 模型名以控制台当前分组可用列表为准;分组未开通对应模型会报错
  • 日常用 grok 即可;grok inspect 只用于排障
相关搜索

Grok 中转站相关入口

如果你在找 Grok 中转站、Grok 中转、Grok CLI 中转、xAI 中转或 Grok API Key,可从下面入口继续。

排查

常见错误处理

命令找不到 grok新开终端;检查 PATH 是否包含 ~/.local/bin~/.grok/bin(Windows 为 %USERPROFILE%\.grok\bin)。可再跑一次安装脚本。
401 UnauthorizedAPI Key 错误或不可用。重新从控制台复制完整 Key,写入 config 后重启 grok
连不上 / 超时检查 base_url 是否为 https://kekeshop.top/v1,不要写成 xAI 官方域名或漏掉 /v1
模型不存在 / model not found确认当前 Key 所属分组支持 Grok,模型 ID 与控制台一致(示例 grok-4.5)。
余额不足 / 无可用分组到控制台确认余额、日卡/月卡或对应 Grok 分组是否可用,再重试。
请求成功但控制台没用量说明请求可能打到了别的地址。用 grok inspect 确认生效配置里的 base_url 与 api_key。