两分钟在 macOS、Linux 或 Windows 上安装 Grok Build

安装之前

Grok Build 是 SpaceXSI（前身为 xAI）推出的终端应用。macOS、Linux 和 Windows 都有预编译的二进制文件。你需要：

• 一个终端：macOS 上的 Terminal 或 iTerm，Linux 上的任意 shell，Windows 上的 PowerShell 或 Git Bash。
• 一个用于首次登录的网页浏览器；如果你是在服务器上设置，则需要一个 API 密钥。
• 一个账号。Grok Build 可以免费试用，X Subscription 的 Plus 套餐（每月 $8）及更高档位提供更多用量。

安装命令

1. macOS、Linux 或 Git Bash：运行 curl -fsSL https://x.ai/cli/install.sh | bash
2. Windows PowerShell：运行 irm https://x.ai/cli/install.ps1 | iex
3. 检查是否成功：运行 grok --version。如果输出了版本号，说明安装成功。

这两条命令都来自官方 Grok Build 页面和 GitHub 仓库。根据一份第三方安装指南，安装程序会把程序放在 ~/.grok/bin 中。

开发者也可以从源代码构建。这需要 Rust 工具链（通过 rustup 安装并固定版本）、DotSlash（cargo install dotslash）和 protoc。macOS 和 Linux 是受支持的构建主机。Windows 构建仅为“尽力而为”，所以 Windows 用户应使用预编译的二进制文件。

首次运行与登录

1. 在你的项目文件夹（而不是主文件夹）中打开终端。
2. 运行 grok。
3. 会打开一个浏览器窗口供你登录，通常是在 grok.com。
4. 登录后，终端界面就会启动。凭据存储在 ~/.grok/auth.json 中。

为什么项目文件夹很重要：2026年7月，运行 Grok Build 可能会把整个当前目录上传到公司的云存储。SpaceXSI 当天就禁用了这一行为，并表示 Build 现在可以完全在本地运行。从项目文件夹启动仍然是更安全的习惯，因为智能体可以读取和编辑其运行位置的文件。

默认情况下，Grok Build 使用计划模式：它会提出一个计划，在你批准之前不做任何修改。

更新与检查设置

• grok update 将 Grok Build 更新到最新版本。
• grok doctor 检查你的终端设置并报告问题。
• grok --version 显示已安装的版本。

请经常更新。SpaceXSI 推出功能的速度很快，像 Grok 4.7 这样的新模型会在发布当天登陆 Grok Build。

在 CI 中使用 API 密钥

浏览器登录在构建服务器上行不通。用于 CI 时，请改为设置 XAI_API_KEY 环境变量，并在脚本和流水线中使用无头模式。

1. 在 console.x.ai 创建账号。
2. 充值额度。API 采用预付费方式，额度用完后请求会被拒绝。
3. 在 API Keys 页面生成密钥。
4. 将其作为密钥（secret）存储在你的 CI 系统中，并以 XAI_API_KEY 的形式暴露出来。

通过 API 密钥产生的用量按 API 费率计费，而不是从你的订阅用量池中扣除。grok-build-0.1 模型的费用为每百万输入 token $1、每百万输出 token $2。

配置文件与权限

Grok Build 将设置保存在 ~/.grok/config.toml 中。MCP 服务器就在这里配置，用于连接 Linear、Sentry 或 Postgres 等工具。

每个项目的规范写在各目录下的 AGENTS.md 文件中。一份第三方指南列出了以下权限模式：default、acceptEdits、auto、dontAsk、bypassPermissions 和 plan。有用的参数包括 --worktree、--no-plan 和 --no-subagents。除非你在沙盒中运行 Build，否则请避免使用 bypassPermissions。

常见问题

• “grok: command not found”：打开一个新终端，让 shell 重新加载路径，并检查 ~/.grok/bin 是否在你的 PATH 中。
• 显示异常：运行 grok doctor 检查终端支持情况。
• 登录窗口没有打开：在远程机器上，请改用 XAI_API_KEY。
• API 密钥被拒绝：检查你的控制台账号是否已充值额度。
• 找不到 Grok 4.7 Fast：Fast 不包含在免费档中。
• 用量耗尽：付费套餐与 Grok 聊天和 Cursor 共用一个每周用量池。在一处大量使用，其他地方可用的就会减少。

常见问题