Grok 中文网

深色模式

Grok Build 使用指南：xAI 官方 CLI 编程 Agent 安装、登录与实战教程（2026 最新） ​

更新时间：2026 年 7 月 19 日

Grok Build 是 xAI 推出的官方编码 Agent 产品，grok 则是它在终端中运行的 CLI（命令行程序）。它不是传统意义上“问一句答一句”的代码补全插件，而是可以读项目、规划任务、修改文件、运行命令、检查测试结果的开发工作流工具。

2026 年 5 月，xAI 先开放 Grok Build Beta，随后发布面向 Agent 编程工作流的 grok-build-0.1。目前官方文档显示，Grok 4.5 是 Grok Build 的默认模型，并可通过 xAI API 直接调用。

本文基于 xAI Grok Build 官方文档、CLI Reference 和 Grok 4.5 文档 编写。命令、模型和计费可能随官方更新调整，请以官方实时页面为准。

先分清：Grok Build、Grok CLI 和 Grok 4.5 是什么关系？ ​

名称它是什么你怎么接触它
Grok 4.5xAI 的模型，擅长编程、Agent 任务和知识工作API、Grok Build、部分第三方网关或产品
Grok BuildxAI 的编码 Agent 产品与开发工作流终端 TUI、自动化脚本、ACP 集成
Grok CLI安装后在终端执行的 grok 命令grok、grok -p、grok inspect 等
ACPAgent Client Protocol，用于把 Agent 接入 IDE 或其他应用grok agent stdio
MCPModel Context Protocol，用于给 Agent 接入额外工具和服务grok mcp ... 或 TUI 中的 MCP 设置

可以把它理解为：Grok 4.5 是大脑，Grok Build 是能完成开发任务的工作台，Grok CLI 是从终端进入这个工作台的入口。

Grok Build 能做什么？ ​

相比只生成一小段代码的聊天工具，Grok Build 的设计重点是完整任务链路：

  • 阅读当前代码仓库，解释架构和依赖；
  • 定位报错原因，提出修改计划；
  • 创建或编辑多个文件；
  • 执行安装、构建、测试、Lint 等终端命令；
  • 借助 Git worktree 在独立工作区处理任务；
  • 通过 MCP、插件、Skills 和 Hooks 扩展能力；
  • 用无头模式接入脚本、CI 或自动化任务；
  • 用 ACP 对接支持该协议的 IDE 或宿主应用。

它仍然是一个会出错的 Agent。生产项目中，尤其是涉及删除文件、数据库迁移、权限变更和密钥配置的任务，应先让它给出计划，再人工审查 diff 和测试结果。

官方安装方式 ​

使用前准备 ​

建议先准备好：

  • 一个可正常使用的 xAI/Grok 账号，或 xAI API Key；
  • Git 和项目所需的运行时环境，例如 Node.js、Python、Java；
  • 一个有版本控制的项目目录，便于查看和回滚 Agent 的改动；
  • 不要在包含生产密钥、客户数据或未备份文件的目录中直接开启自动批准模式。

Windows PowerShell 安装 ​

官方 Windows 安装命令如下：

powershell
irm https://x.ai/cli/install.ps1 | iex

安装完成后，重新打开 PowerShell，验证命令是否可用：

powershell
grok version
grok --help

macOS、Linux 和 WSL 安装 ​

官方安装命令：

bash
curl -fsSL https://x.ai/cli/install.sh | bash

完成后关闭并重新打开终端，再执行：

bash
grok version

安装脚本安全提醒

上面的命令会从网络下载并执行官方安装脚本。请只从 xAI 官方文档复制命令，确认域名为 x.ai；企业环境应按内部软件分发与安全审计流程安装。

第一次启动与登录 ​

进入你的项目目录，运行：

bash
cd your-project
grok

首次启动时，Grok Build 通常会打开浏览器完成登录授权。若你在远程服务器、容器或无图形界面环境中工作，可使用设备码登录：

bash
grok login --device-auth

也可以使用环境变量提供 API Key：

bash
# macOS / Linux / WSL
export XAI_API_KEY="xai-your-key"
grok
powershell
# Windows PowerShell，仅对当前终端生效
$env:XAI_API_KEY = "xai-your-key"
grok

不要把 API Key 写进代码、截图、README 或 Git 仓库。更合适的做法是配置系统环境变量、密钥管理服务或 CI 平台的 Secrets。

最实用的 5 个起步命令 ​

命令用途
grok在当前项目启动交互式 TUI
grok login浏览器登录
grok login --device-auth无浏览器/远程环境的设备码登录
grok inspect查看当前目录发现的配置、规则、Skills、插件、Hooks 与 MCP
grok models查看可用模型
grok --help查看完整命令帮助

启动交互界面后，建议先不要让它直接修改代码，而是先输入：

text
Explain this repo. Identify the entry point, build command, test command, and the most important directories. Do not edit files yet.

如果项目中有关键文件，也可以指向文件提问：

text
@src/main.ts Explain this file and its callers. Do not change anything.

用 Grok Build 处理一个真实项目任务 ​

下面以“修复一个接口测试失败”为例。一个好的 Agent 指令应包含范围、约束和验收标准。

text
Investigate the failing tests in this repository.

Requirements:
1. Do not modify dependencies or lockfiles unless necessary.
2. Identify the root cause before editing files.
3. Make the smallest safe fix.
4. Run the relevant tests and report the exact command and result.
5. Show a concise summary of changed files and remaining risks.

这种写法比“帮我修一下测试”可靠得多，因为它明确限制了改动范围，也要求模型用测试验证结果。

推荐工作流：先计划，再执行，再审查 ​

  1. 先让它解释项目与问题，确认它没有理解错目录和命令。
  2. 使用 /plan 要求先生成方案，审查可能修改的文件和风险。
  3. 同意后再让它执行修改与测试。
  4. 查看 git diff，核对不该动的文件、依赖和配置没有被改动。
  5. 关键改动应由开发者再跑一次完整测试或代码审查。

推荐提示词

“先给出计划，不要修改文件。等我确认后，再逐步执行每一步，并在每次执行命令前说明目的。”

权限模式：不要一开始就全自动 ​

默认情况下，Grok Build 会在操作前请求你的确认。TUI 中可通过 /always-approve 切换为自动批准，命令行也支持：

bash
grok --always-approve

这很适合隔离的临时仓库、低风险重复任务或已审计的自动化环境；但它允许 Agent 跳过确认执行工具调用。因此不建议在主分支、生产服务器、含密钥的目录或不熟悉的项目中直接使用。

更稳妥的策略是让 Agent 先用只读任务建立上下文，再按需批准文件修改与命令执行。

无头模式：把 Grok Build 接入脚本和 CI ​

Grok CLI 支持使用 -p 或 --single 直接执行一次提示词。这适用于脚本、机器人和自动化任务：

bash
grok -p "Explain this codebase"

常见输出格式：

bash
# 最终返回一个 JSON 对象，适合脚本解析
grok -p "List TODO comments" --output-format json

# 流式 JSON，适合实时消费结果
grok -p "Explain the architecture" --output-format streaming-json

长任务可使用会话参数持续上下文：

bash
grok -p "Inspect the test failures" --session-id fix-tests-20260719
grok -r fix-tests-20260719 -p "Apply the smallest safe fix and run the focused tests"

在 CI、Cron 或其他自动化环境中，官方建议增加 --no-auto-update，避免后台更新检查影响任务：

bash
grok --no-auto-update -p "Review the changed files and return JSON" --output-format json

CI 中的自动改代码

将 Agent 放进 CI 时，优先让它输出报告、生成建议或创建草稿补丁。只有在隔离分支、最小权限令牌、明确命令白名单和人工合并审核都具备时，再考虑让它自动写入代码。

ACP：接入 IDE 或其他应用 ​

Grok Build 提供 Agent Client Protocol（ACP）模式：

bash
grok agent stdio

该命令使用 JSON-RPC 通过标准输入输出通信，适合由 IDE、桌面工具或其他宿主程序来管理会话与展示界面。它不是“安装一个 VS Code 扩展后自动可用”的同义词，是否能集成要看你的 IDE 或插件是否支持 ACP。

对普通开发者而言，优先在终端熟悉 grok 的项目阅读、计划和执行流程；需要对接工具时，再按宿主应用的 ACP 配置文档处理。

MCP、Skills、插件和 Claude Code 兼容性 ​

Grok Build 的扩展能力是它和普通终端聊天工具差别最大的地方之一。

MCP ​

MCP 可以让 Agent 使用额外服务或工具。CLI 提供管理入口：

bash
grok mcp list
grok mcp doctor

在 TUI 中也可以用 /mcps 打开统一扩展面板。连接 MCP 前应检查服务权限、数据会流向哪里、是否需要执行命令或访问数据库。

Skills 与插件 ​

Skills 是可复用的说明、脚本和资源目录，插件还能扩展 Skills、子 Agent、Hooks、MCP 和 LSP 服务器。官方支持项目级 .grok/ 和用户级 ~/.grok/ 配置。

对于团队项目，可以把编码规范、测试步骤、部署约束沉淀成 AGENTS.md 或项目规则，让 Agent 每次进入仓库都能获得一致上下文。

Claude Code 兼容性 ​

官方说明 Grok Build 能读取 Claude Code 的市场、插件、Skills、MCP、Agents、Hooks 和 CLAUDE.md 等说明文件，也能读取 AGENTS.md 文件族。这意味着迁移或并用这些工具时，已有项目规范有机会被复用；但首次启用前仍应执行 grok inspect 验证实际加载结果。

用第三方 API 在 Grok CLI 中配置模型 ​

除了直接使用 xAI API，Grok Build 官方文档还支持自定义 OpenAI 兼容模型。对希望使用统一模型网关的开发者，可以在用户配置文件中定义模型。

你提供的第三方 API 入口是：https://www.zeoapi.com/register?aff=Pe3N

ZeoAPI 页面将自己描述为多模型聚合与分发网关，提供 OpenAI、Claude、Gemini 兼容接口。是否提供 Grok 4.5、具体模型 ID、价格、并发限制和数据策略，必须以注册后的实时控制台为准。

配置思路 ​

在 Windows 中，用户配置通常是：

text
%USERPROFILE%\.grok\config.toml

在 macOS、Linux、WSL 中通常是：

text
~/.grok/config.toml

以下示例展示配置形态。将 model-id-from-provider、https://provider.example.com/v1 和环境变量名替换为 ZeoAPI 控制台实际提供的值；不要猜测或硬编码模型 ID。

toml
[model.zeo-grok]
model = "model-id-from-provider"
base_url = "https://provider.example.com/v1"
name = "ZeoAPI Grok"
env_key = "ZEOAPI_API_KEY"

[models]
default = "zeo-grok"

随后在终端中设置密钥，并验证配置：

powershell
# Windows PowerShell
$env:ZEOAPI_API_KEY = "your-api-key"
grok inspect
grok -p "Explain this repository" -m zeo-grok
bash
# macOS / Linux / WSL
export ZEOAPI_API_KEY="your-api-key"
grok inspect
grok -p "Explain this repository" -m zeo-grok

第三方 API 注意事项

第三方 API 与 xAI 官方服务在价格、模型版本、可用地区、速率限制、数据留存和隐私政策上可能不同。接入前请阅读服务条款，不要提交生产密钥、客户隐私数据或未经授权的源代码；部署到团队或生产环境前，请先用非敏感仓库验证模型 ID、接口兼容性和计费。

Grok Build 与直接调 Grok 4.5 API，怎么选？ ​

场景更适合的方式
在本地仓库里读代码、改文件、跑测试Grok Build CLI
为自己的产品提供 AI 功能直接调用 Grok 4.5 API
要做 CI 脚本或批量代码报告Grok CLI 无头模式
要接入 IDE、桌面工具或编排器ACP
要增加数据库、文档库、内部工具等上下文MCP / Skills / 插件
要集中管理多家模型和兼容接口评估第三方 API 网关，例如 ZeoAPI

Grok 4.5 官方标准价格是输入 2 美元/100 万 tokens、输出 6 美元/100 万 tokens；长上下文请求、缓存输入和第三方网关会有不同计费。成本敏感的 Agent 工作流应记录 token 消耗，并使用清晰的任务边界、prompt cache 和上下文压缩来避免不必要的重复输入。

常见问题 ​

Grok Build 是免费的吗？ ​

产品可用性、登录方式、套餐和 API 费用会随 xAI 的政策调整。使用前请查看 xAI 官方控制台与定价页；第三方网关的额度和价格则以其控制台为准。

Grok Build 默认使用什么模型？ ​

xAI 官方文档目前说明 Grok Build 的默认模型是 Grok 4.5。你也可以通过 grok models 查看当前账号可用模型，或在自定义配置中通过 -m 选择模型。

Grok CLI 能替代 IDE 吗？ ​

不能完全替代。它擅长在终端中理解并执行仓库级任务；代码浏览、断点调试、界面设计和人工审查仍更适合在 IDE 中完成。ACP 能让它作为 Agent 集成到支持该协议的应用中。

为什么要先执行 grok inspect？ ​

它会显示当前目录发现的配置、规则、Skills、插件、Hooks 和 MCP 服务器。首次进入陌生仓库时，先检查它实际读取了什么规则，可以避免 Agent 忽略团队约束或加载不该加载的扩展。

可以直接使用 --always-approve 吗？ ​

可以，但不建议作为默认习惯。这个模式会跳过工具调用确认，应只在隔离、可回滚且权限受限的环境中使用。

ZeoAPI 一定支持 Grok 4.5 吗？ ​

本文不作此保证。请通过 ZeoAPI 注册入口 登录后，在模型列表与 API 文档中确认 Grok 4.5 的实际名称、价格和接口兼容性。

总结 ​

Grok Build 让 Grok 4.5 从“能写代码的模型”变成了可以参与项目开发流程的 Agent：在终端里读仓库、提出计划、修改代码、执行测试，也能通过无头模式和 ACP 被脚本与工具调用。

建议从一个有 Git 版本控制、无敏感数据的小项目开始，先用只读提示词理解仓库，再逐渐让它完成低风险修复。需要多模型网关时，可以研究 ZeoAPI 的实际 API 文档，但要把第三方服务与 xAI 官方渠道清楚区分。

延伸阅读 ​

本站为 Grok 中文教程与导航站，非 xAI 或 ZeoAPI 官方网站。命令、模型、价格及第三方服务能力请以各平台实时说明为准。

本站为 Grok 中文教程与导航站，非 xAI 官方网站。

Copyright © 2026 grok-blog.com