文档导航
INTEGRATION GUIDE

Grok CLI 接入核对:同名命令、社区项目与官方 Grok Build

比较同名 Grok CLI 社区项目的包名、配置位置及地址变量,区分官方 Grok Build,给出识别安装来源、最小请求和停止配置的明确边界。

内容复核中 接入能力待核验,不能将本文视作已经确认可用的配置。 图解为本站原创示意,不是客户端运行截图。

查看教程占位服务地址
控制台
https://80321.cn
创建 Key
https://80321.cn/keys
钱包充值
https://80321.cn/wallet
文档站
https://80321.cn/docs.html

以上服务地址仅为教程占位示例,不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。

本页目录

Grok CLI 原创接入配置示意,非真实运行截图

一个 grok 命令对应多个项目

“Grok CLI”不是足够精确的客户端身份。stevederico/grok-cli 使用 @stevederico/grok-cli 包;superagent-ai/grok-cli 的 README 使用 grok-dev,并明确声明与 xAI 没有隶属、背书或赞助关系。 xAI 自己的 Grok Build 也提供 grok 命令和另一套配置规范。

本批次没有指定作者、包名或发行版本,所以本页标记 pending。下面给的是具体核对步骤,不是三种产品共用的接入配置。名字相同、提示符相似,都不能证明协议与认证变量相同。

先找安装来源,不先填 Key

在包管理器已安装清单、安装记录或程序关于信息里查完整包名,再对照项目 README。记录可执行程序位置、作者和版本;如果多个程序占用同一命令,应先选定要用的那个,避免终端执行了旧包而自己却看着新文档。

stevederico 项目文档介绍 /auth,并说明会将密钥保存到 ~/.grok-cli/.env。 superagent-ai 项目则使用自己的用户设置,还包含子 Agent 与远程控制功能。 两者配置位置与能力不同,不应复制彼此的文件来试错。

对照各自的地址变量

stevederico 的自定义入口使用 GROKCLI_PROVIDER、CUSTOM_BASE_URL 和 CUSTOM_API_KEY;其自动探测会按已有密钥选择 provider,所以环境里已有其他凭证可能改变选择。 核对时应查是否明确指定了目标 provider,而不是只确认某个 Key 已存在。

superagent-ai README 列出 GROK_BASE_URL 与 GROK_MODEL,这是该项目的命名,不能推导成 xAI 官方 CLI 的配置字段。 若服务要求 Responses、Messages 或带服务器端搜索的请求,还需找所选版本的协议说明;可改地址不等于完整支持这些功能。

暂不生成可运行配置

准备一份不含秘密的参数清单:选定项目、文档版本、协议、认证头、模型标识、根路径和必要的流式能力。https://80321.cn/v1 只能作占位示例,本站没有经本教程核验的真实接口;示意密钥和模型仅为 YOUR_API_KEY、YOUR_MODEL_ID。

如果拿到的教程字段不在所选项目的资料里,停止应用,不凭经验补一个环境变量。本页也不提供混合三套客户端字段的启动命令;只有先确认具体产品,后续请求结果才有解释价值。

最小验证与停手条件

身份与正式协议确定后,在不含业务文件的目录,只请求“返回 OK,不读文件、不执行命令”。先确认程序和 provider,再分别记录认证、模型与响应解析的结果。若输出调用了其他上游、需要额外的账户令牌,或继续要求开启远程控制,应停下来查设置,而不是追加敏感权限。

第一轮不要连接 Telegram、外部 MCP 或桌面自动化。项目 README 确实提供这些能力,但它们不是文本接口检查的前提。 反馈问题只给项目版本、脱敏字段和错误;不要上传用户设置、环境文件或密钥。