GROK · CLI / SETUP GUIDE

Grok 配置教程

通过自定义模型配置连接 mid-route。先确认控制台有可用的 Grok 分组和模型,再安装并配置客户端。

01确认模型与 Key

登录控制台,在 Key 所属分组中确认可用的 Grok 模型 ID。下方使用占位值,不代表某个 Grok 模型已在本站开通。

查看分组和 API Key
如果控制台没有提供 Grok 渠道,请先联系站点管理员确认。把 OpenAI Key 填进 Grok CLI,并不会自动获得 Grok 模型权限。

02安装 Grok CLI

安装入口来自 xAI,建议先查看官方说明,再执行适合系统的安装命令。

Grok 官方入门
macOS / Linux
curl -fsSL https://x.ai/cli/install.sh | bash
grok version

命令找不到时,重新打开终端并确认 CLI 安装目录已加入 PATH。

03保存模型配置

将内容保存到 ~/.grok/config.toml;Windows 路径为 %USERPROFILE%\.grok\config.toml。

config.toml
[models]
default = "mid-route"

[model.mid-route]
model = "YOUR_GROK_MODEL_ID"
name = "mid-route Grok"
base_url = "https://mid-route.site/v1"
env_key = "MID_ROUTE_API_KEY"

将 YOUR_GROK_MODEL_ID 换成当前分组支持的 Grok 模型 ID。密钥通过下一步的环境变量提供。已有文件先备份再合并。

BASE URL

https://mid-route.site/v1

04设置密钥并启动

将占位值换成自己的 Key;环境变量对当前终端有效。

Terminal
export MID_ROUTE_API_KEY="YOUR_API_KEY"
grok

先发送一条短消息,再在控制台检查用量。需要排查生效配置时可以运行 grok inspect,分享结果前请遮挡凭据。

检查用量记录

05连接排错

提示 401,应该检查哪里?

确认使用的是 mid-route 控制台创建的完整 API Key。登录密码、其他平台的 Key 都不能替代它。

提示 503 或模型不可用?

检查 Key 所属分组是否支持该模型,以及是否存在可调度账号。相同域名下,不同分组的模型和渠道可能不同。可到API 密钥核对分组。

如何确认请求走了 mid-route?

发送一条简短消息后,到用量记录核对模型和时间。只查询模型列表不等于完成了一次模型调用。

模型列表里没有 Grok?

核对当前 Key 的分组和模型权限。此教程提供配置方法,不代表本站每个分组均支持 Grok。

参考文档:Grok 安装与自定义模型 ↗Grok CLI 官方参考 ↗
客户端版本会影响菜单和配置项,请以当前版本及控制台生成的配置为准。