​
使用 Grok Build

Grok Build 是 xAI 官方提供的终端编码 Agent。它既可以在项目目录中提供交互式全屏体验，也支持面向脚本和机器人的 headless 使用，并可通过 Agent Client Protocol（ACP）接入其他应用。
本文只记录 xAI 官方文档中已经确认的产品能力和认证方式，不把某个版本或某个模型写成唯一支持范围。

​
使用形态

​
安装

macOS、Linux 或 WSL 可以执行官方安装脚本：
安装完成后检查命令是否可用：

​
启动交互式会话

进入需要处理的项目目录，然后启动 Grok Build：
首次启动会打开浏览器完成认证。认证成功后回到终端，即可在当前项目中开始交互式会话。

​
无浏览器环境认证

在服务器、容器或其他无法打开浏览器的环境中，可以设置 xAI API Key 后启动：
请通过环境变量或密钥管理服务注入 Key，不要把真实 Key 写入项目文件、命令历史或公开文档。

​
Headless 与 ACP

Grok Build 官方文档提供 Run headlessly、CLI 和 ACP 相关说明。自动化运行前，应先在隔离项目中确认命令权限、文件修改范围、退出码和输出格式，再接入脚本、机器人或其他应用。 本页暂不复制未核验的命令参数。headless 和 ACP 的具体启动参数、配置字段与支持范围，请以 xAI 官方文档当前内容为准。

​
AIMax 接入状态

官方文档目录中存在 Custom models 章节，但当前尚未取得其具体配置字段和协议说明，也尚未完成真实端到端验证。因此，当前尚未确认 Grok Build 可以直接接入 AIMax，也不能确认它是否支持自定义 Base URL 或第三方 Provider。 在官方配置方式和真实请求链路得到确认前，本页不提供 AIMax 配置示例。需要通过 AIMax 调用 Grok 模型时，可先使用平台公开 API 或已完成相应协议配置的开发工具。

​
使用边界

  1. Grok Build、xAI 账号、xAI API Key 和相关配额由 xAI 的产品与服务规则决定；
  2. TUI 可用不代表 headless、ACP、工具调用和所有终端权限已经在当前环境验证；
  3. 模型、命令、设置项和企业部署能力以 xAI 官方文档的当前内容为准；
  4. 未经官方证据或真实验证，不把自定义模型章节推断为 AIMax 兼容承诺。

​
官方参考