Grok Build 使用与配置

Grok Build 是 xAI 通过网页提供的编程工作区。它与可在终端安装的 Claude Code、Gemini CLI 产品形态不同：截至本文核对日期，没有公开的官方 Grok Build CLI、本地安装包或本地配置文件规范。

一、准备工作

• 使用受支持的现代浏览器，并准备可登录 Grok 的账户。
• 打开 Grok Build 官方入口。产品可用性、套餐和地区限制以页面实际显示为准。
• 如需处理现有代码仓库，准备相应的 GitHub 账户和仓库权限；授权前先确认组织策略。
• Grok Build 与 xAI API 是不同入口。API 密钥不能替代 Grok Build 网页账户登录。

二、安装（macOS、Windows）

macOS

Grok Build 不需要本地安装。在 Safari、Chrome 或其他受支持浏览器中访问 https://grok.com/build，登录后按页面提示创建工作区或连接仓库。可以把页面添加到 Dock，但这只是浏览器快捷方式，不是 Grok Build CLI。

Windows

Grok Build 不需要本地安装。在 Edge、Chrome 或其他受支持浏览器中访问 https://grok.com/build 并登录。可以通过浏览器安装为站点应用或固定到任务栏，但这不会安装命令行工具。

WARNING

不要运行声称用于安装 Grok Build 的非官方 npm、brew、PowerShell 或 Shell 命令。官方入口未公布此类本地安装流程。

三、配置目录（macOS、Windows）

macOS

没有官方公布的 Grok Build 用户配置目录或配置文件。登录状态和站点数据由浏览器配置文件管理，不应手工修改 Safari 或 Chrome 的内部数据目录。

Windows

没有官方公布的 Grok Build 用户配置目录或配置文件。登录状态和站点数据由浏览器配置文件管理，不应把浏览器缓存目录当作 Grok Build 配置目录。

某些第三方工具可能创建 .grok 目录，但这不能证明它是 Grok Build 官方本地配置规范；本文不建议据此创建或维护配置。

四、配置文件示例

Grok Build 当前没有可验证的官方本地配置文件，因此没有 JSON、TOML、YAML 或 .env 示例。实际设置应在网页中完成，通常包括：

1. 登录 Grok Build。
2. 仅在需要时连接 GitHub。
3. 授权所需的个人账户或组织，并尽量只选择必要仓库。
4. 在网页中选择仓库、分支和任务；按页面提供的流程审查变更。

这一流程故意不提供伪造的文件内容。若官方以后发布 CLI 或配置格式，应以官方新文档替换本节。

五、配置说明

• 账户、仓库授权和工作区状态由 Grok Build 服务端及其网页界面管理，而不是由 macOS 或 Windows 下的固定本地文件管理。
• GitHub 授权可在 GitHub 的应用授权设置中复核或撤销；组织仓库可能还需要管理员批准。
• Ya Code 密钥和自定义 API 基础地址不用于 Grok Build 网页登录。需要调用 Grok 模型 API 时，请使用独立的 xAI API 文档，不要将 API 客户端配置写成 Grok Build 配置。
• 网页界面和功能可能按账户、地区或发布批次变化，以 Grok Build 官方入口 当前显示为准。

六、注意事项

• 截至本文核对时，未发现官方公开的 Grok Build CLI、本地安装命令或跨平台本地配置路径；因此 macOS 和 Windows 都应通过浏览器访问。
• 仓库授权遵循最小权限原则。不要授权与当前任务无关的组织或私有仓库，并定期检查已授权应用。
• 不要把 xAI API、名称相似的第三方 CLI 或第三方 .grok 目录误认为 Grok Build 官方客户端。
• 云端编程代理可能读取仓库内容并生成变更。合并前应检查差异、测试结果及是否包含密钥或隐私数据。