Grok Build 安装与配置：在 Windows、macOS、Linux 上用 Grok 写代码

想让 Grok 直接读取电脑里的代码、修改文件并运行命令，可以使用官方 Grok Build。它提供终端交互界面，启动命令是 grok。

资料核对日期：2026 年 9 月 8 日。日常聊天和手机应用见 Grok 多端入门；程序接入见 Grok API 教程。

macOS / Linux 安装

打开终端，运行 Grok Build 官方文档 给出的命令：

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

按提示完成安装后，重新打开终端，检查：

grok version
grok --help

看到版本信息和帮助内容，说明命令已经可用。

Windows 安装

打开 PowerShell，运行：

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

安装完成后重开终端，检查：

grok version
grok --help

这条命令用于 PowerShell。若你正在使用 CMD，先打开 PowerShell 再操作。

Windows 用户如果把开发环境放在 WSL 中，应进入 WSL 的 Linux 终端，运行前面的 Linux 安装命令，并在同一个环境中安装项目依赖。

登录并选定工作目录

先进入一个练习项目：

cd "你的项目路径"
grok

第一次启动会打开浏览器进行认证。完成后回到终端，确认工作目录和账号信息。

也可以单独启动登录：

grok login

没有浏览器的远程环境可以参考官方的设备认证或 API 密钥方式。初次在个人电脑使用，先完成浏览器登录即可。

是否能使用某个模型，以实际账号权限为准。可用模型可以查看：

grok models

配置文件放在哪里

日常界面选项可以优先通过会话里的 /settings 调整。手工编辑个人配置时，一个简单的起点是：

[ui]
theme = "auto"
permission_mode = "ask"

theme = "auto" 跟随环境主题，ask 是遇到尚未允许的工具操作时进行确认的权限模式。若已有 [ui] 段，把字段合并到该段中。

项目配置只支持对应范围的 MCP、插件和权限规则，不能把完整个人配置照搬进去。例如，默认权限模式应放在用户配置中。

修改后在项目目录运行：

grok inspect

它会列出找到的配置、项目规则和工具来源，适合检查“文件写了，但工具有没有读到”。

用 AGENTS.md 记录项目约定

在项目根目录创建 AGENTS.md：

# 项目约定

使用简体中文解释修改。
先阅读 README，按已有项目结构工作。
完成后列出改动文件和验证结果。
涉及产品行为时，给出一个可以手动检查的例子。

Grok Build 还兼容读取官方列出的 CLAUDE.md 等规则文件。如果项目已经有约定，先检查现有文件，再补充缺少的内容，避免不同文件给出冲突要求。

在项目中运行 grok inspect，确认规则文件出现在结果里。

第一次任务：改一份真实文件

在练习目录准备 README.md，然后启动 grok，发送：

阅读 README.md，告诉我它适合什么读者。把它改成“项目用途、快速开始、如何验证”三个部分。只补充能从当前文件确认的信息。

根据工具显示的权限提示处理修改请求。完成后，自己打开 README.md 检查；如果项目使用 Git，再用 git diff 查看具体变化。

需要重新进入最近的会话时，可使用：

grok --continue

会话恢复依赖对应机器和目录中的会话记录。换电脑后，先同步代码与规则，再重新登录和检查环境。

在编辑器或另一台电脑上使用

已经安装 CLI 后，可以在 VS Code、JetBrains 等编辑器的集成终端中进入项目并运行 grok，这是最容易验证的接入方式。

Grok Build 也提供 ACP 接口，可通过 grok agent stdio 接入支持 Agent Client Protocol 的应用。只有目标应用明确支持该协议时再按它的说明配置。

浏览器里的 Grok 聊天记录同步，与本地 Grok Build 的项目文件、运行环境和会话记录，是不同的事情。不要假设在手机上登录同一账号后，就自动获得了电脑项目的远程控制能力。

更新与常见问题

检查更新和执行更新分别使用：

grok update --check
grok update

官方参考

• Grok Build 安装
• 设置文件
• 命令参考
• AGENTS.md 项目规则
• 权限模式