一句话：Grok Build 是 xAI 出的"终端编程智能体"，底层跑 Grok 4.6。你在命令行里用大白话告诉它"读一下这个仓库""修掉这个 bug""跑一下测试"，它就真去读文件、改代码、执行命令。本文从安装到实战全讲透，每一步命令都可直接复制，完全零基础也能跟着做。

一、Grok Build 到底是什么

很多人把 Grok 当成"网页聊天框"，但开发者真正爱用的是 Grok Build：它是一个安装在你电脑上的命令行工具（CLI），把 Grok 4.6 变成能操作你本地项目的"编程同事"。它和网页版 Grok 的核心区别：

  • 能读写你的文件：直接打开、修改、创建项目里的代码，而不是只给你贴一段文本让你自己复制。
  • 能跑真实命令：git、npm、pytest、node 等，它可以在你授权下执行。
  • 能连外部工具：通过 MCP 协议接 GitHub、数据库、文件系统，以及 Linear、Sentry、Postgres 等外部工具。
  • 三种用法：交互式终端（TUI）、无头脚本模式（塞进 CI/CD）、以及被其他 App 通过 ACP 协议调用。
适合谁如果你写代码、做运维、或只是想"让 AI 帮我改改本地文件"，Grok Build 比网页版高效得多。纯聊天娱乐用网页版即可。想了解它和网页版会员的关系，看 Grok 免费版够用吗。

二、开始之前：你需要准备什么

  1. 一个 xAI 订阅或 xAI API Key：Grok Build 调用的是 Grok 4.6 模型，需要有效的调用额度。可以用 xAI 账号订阅（SuperGrok 及以上），也可以用自己的 xAI API Key（BYOK 模式）。具体档位与额度以 xAI 官方为准。
  2. 一台装了终端的电脑：macOS、Linux、Windows（PowerShell 或 WSL）都支持。
  3. 一个项目目录：随便一个你自己的代码文件夹，用来练手。
国内用户特别注意Grok Build 的调用额度来自 xAI 订阅或 API Key。国内不便绑国际信用卡的用户，可走 grok代充 开通 SuperGrok 后使用订阅权益；或自备 xAI API Key。下文第四步会讲三种登录方式。

三、第一步：安装 Grok Build CLI

官方提供一行命令安装，按你的系统选一条。

macOS / Linux / WSL

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

Windows（PowerShell）

irm https://x.ai/cli/install.ps1 | iex
验证是否装好安装完执行下面任一命令，能看到版本号就成功了：
grok --version
# 或
which grok      # macOS/Linux
where grok      # Windows

如果提示"command not found"，通常是 PATH 没刷新，关掉终端重开，或执行 source ~/.bashrc（或 source ~/.zshrc）再试。

四、第二步：登录与授权（新手最容易卡的一步）

安装和登录是两回事：安装只把程序放进来，登录才把你的账号权限挂上。有三种方式，挑你能用的。

方式一：浏览器 OAuth（最省事，有图形界面时用）

进到你的项目目录，直接运行 grok，它会自动弹出浏览器让你登录 xAI 账号，授权完终端就进去了。

cd your-project
grok

方式二：设备码登录（服务器 / 远程 / 无浏览器环境）

如果你在云服务器、容器、或打不开浏览器的环境，用设备码方式：终端会给你一段码，你去另一台能上网的设备上输一下就能授权。

grok login --device-auth

方式三：API Key 环境变量（BYOK，适合脚本和 CI）

把 xAI API Key 设成环境变量，下次启动 grok 就直接用它，不用每次登录。

# macOS / Linux / WSL
export XAI_API_KEY="xai-your-key-here"
grok

# Windows PowerShell（仅当前终端生效）
$env:XAI_API_KEY = "xai-your-key-here"
grok
安全红线API Key 等同于你的账号密码，千万不要写进代码、截图、README 或 Git 仓库。正确做法是配置系统环境变量、密钥管理服务或 CI 平台的 Secrets。

五、第三步：第一次启动，先别急着改代码

进项目后，新手最容易犯的错是一上来就让 AI 乱改文件。正确姿势是：先让它"只读"地理解项目，确认它懂了，再让它动手。

cd your-project
grok

进入交互界面后，建议第一条指令这样写（注意那句"先别改文件"）：

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

你也可以用 @文件路径 指向具体文件提问，比如 @src/main.ts Explain this file and its callers.

六、核心命令速查表

命令用途
grok在当前项目启动交互式终端（TUI）
grok login浏览器登录 xAI 账号
grok login --device-auth无浏览器/远程环境的设备码登录
grok inspect查看当前目录被识别到的配置、规则、Skills、插件、Hooks 与 MCP
grok models查看可用模型
grok mcp list列出已连接的 MCP 工具服务器
grok mcp doctor诊断 MCP 连接问题
grok -p "..."无头模式：不进界面，直接用一句话跑任务（适合脚本）
grok --help查看完整命令帮助

七、实战一：让 Grok Build 读懂你的项目

这是最安全也最有用的第一步。让它通读仓库、告诉你架构，你边看边确认它理解得对不对。适合接手别人代码、或很久没碰自己的项目时快速热身。

Explain this codebase in one page: what it does, the tech stack, and where the main logic lives. Do not change anything.

想深入某个文件：

@src/utils/format.ts Walk me through this file. What depends on it? Do not change anything.

八、实战二：修复一个 bug（写好指令的模板）

让 AI 改代码，指令越具体越好。一个好指令 = 范围 + 约束 + 验收标准。下面是修复"接口测试失败"的示例：

Fix the failing test in tests/api.test.ts. The test expects a 201 but gets 500. 
Scope: only the handler in src/routes/createUser.ts. 
Constraint: do not change the public API or other tests. 
When done, run: npm test -- tests/api.test.ts and confirm it passes.
小技巧先用"Do not edit files yet / 先给出方案"让它出计划，你看过没问题再让它动手，比直接改更安全。复杂任务它会进入 Plan Mode（见下一节）。

九、Plan Mode 与并行子 Agent

当你给的任务比较复杂（比如"给这个项目加一个用户登录模块"），Grok Build 会自动进入 Plan Mode：先生成一份结构化执行计划，展示每一步会改哪些文件、预期 diff，你审批、评论或修改后再真正执行。这能避免它"自作主张"把项目改乱。复杂项目里它还会并行起多个子 Agent 分别做代码分析、测试生成、文档检索，效率明显高于单线聊天。

十、无头模式：把 Grok Build 塞进脚本和 CI

-p 参数让 grok 不进交互界面、直接执行一句话并返回结果，输出可以是普通文本或流式 JSON，非常适合写进自动化脚本、定时任务或 CI/CD 流水线。

grok -p "Explain this codebase in 3 bullet points"
# 流式 JSON 输出，方便程序解析
grok -p "Summarize the diff in this branch" --output-format streaming-json

十一、进阶：用 MCP 连接外部工具

MCP（Model Context Protocol）是让 AI 调用外部工具的通用协议。Grok Build 原生支持，连上后它就能查 GitHub issue、读数据库、读写指定文件夹。下面是新手最该试的两个例子（命令里的 token 换成你自己的）。

连接 GitHub

grok mcp add github \
  --command "npx @modelcontextprotocol/server-github" \
  --env GITHUB_TOKEN=ghp_your_token_here

连接本地文件系统（限定某个目录）

grok mcp add filesystem \
  --command "npx @modelcontextprotocol/server-filesystem /home/yourname/documents"
参数以实际为准上面是官方常用写法示例，不同版本参数可能略有差异，连接前先跑 grok mcp --help 确认你本地的命令格式。

连接后在交互界面输入 /mcps 可查看所有已连工具；命令行用 grok mcp list 检查状态。配置会存在用户级 ~/.grok/ 或项目级 .grok/ 目录，团队协作时可把项目级配置一起提交。

十二、自定义模型与 BYOK

除了默认 Grok 4.6，你还能在配置文件里指定任意兼容 OpenAI 的自定义模型（比如接自己的模型网关）。编辑用户级配置 ~/.grok/config.toml（Windows 是 %USERPROFILE%\.grok\config.toml）：

[model.my-model]
model = "model-id"
base_url = "https://api.example.com/v1"
name = "Display Name"
env_key = "API_KEY"

[models]
default = "my-model"

改完后用 grok inspect 看是否被正确识别，交互界面里用 /model 切换，或在无头模式用 grok -p "..." -m my-model。

十三、国内用户避坑指南

  • 调用额度来源：Grok Build 跑的是 Grok 4.6，需要有效 xAI 订阅或 API Key。国内不便绑国际信用卡时，可走 grok代充 开通 SuperGrok 后使用订阅权益。
  • API Key 获取：xAI API Key 在 x.ai 控制台生成，同样涉及海外支付；若不便自行开通，可关注代充渠道是否提供 API 额度服务，或先用订阅方式。
  • 安装脚本下载：安装命令从 x.ai 拉取二进制，若本地网络拉取慢，可重试或换个网络环境，与站点服务器无关。
  • 密钥安全：API Key 绝不进代码仓库、截图或聊天记录；用环境变量或 Secrets 管理。
  • 别混环境：WSL 里装的 grok 在 Windows PowerShell 看不到，反之亦然，装完记得在对应环境验证。

十四、给新手的 7 天上手路线

  1. Day 1：装好 CLI，用浏览器登录，跑通 grok --version。
  2. Day 2：进一个练手项目，只做"Explain this repo"，习惯只读模式。
  3. Day 3：让它改一个无关紧要的小文件，体验 Plan Mode 审批。
  4. Day 4：修一个真实 bug，练习"范围+约束+验收"指令写法。
  5. Day 5：试 -p 无头模式，把一句话任务写进一个 shell 脚本。
  6. Day 6：接一个 MCP（GitHub 或文件系统），感受工具调用。
  7. Day 7：回顾 Grok 编程完整教程，把 Grok Build、Cursor、API 三种用法串起来。
下一步Grok Build 是"本地编码"这条线；想了解怎么在 Cursor 里切 Grok 模型、或用 xAI API 自己写程序，看 Grok 编程完整教程。要开通 SuperGrok 跑 Grok Build，走 grok代充 开通教程。