第 1 课

打开 Marketplace 并安装第一个插件

装好 Grok Build CLI，在 TUI 里打开 /marketplace，或用 CLI 列出并安装一个插件。

图文18 分钟Grok Build 官方文档 ↗

课程目录第 1 / 2 课

返回课程介绍

学习位置仅保存在当前浏览器，有效期 180 天。

打开 Marketplace 并安装第一个插件

本课按 xAI 官方文档整理，目标是：装好 Grok Build CLI，在 TUI 里打开 /marketplace，或用 CLI 列出并安装一个插件。
主要来源：Grok Build Plugin Marketplace · Grok Build Overview · CLI Reference · Skills, Plugins & Marketplaces

你将得到什么

本机可运行的 grok 命令
在交互 TUI 里打开 Marketplace 并安装插件的路径
等价的 CLI：grok plugin marketplace list 与 grok plugin install <name> --trust
对「插件里到底装了什么」的最小心智模型

课前准备

macOS、Linux，或 Windows（官方提供 PowerShell 安装脚本；也可在 Git Bash 里用 bash 脚本）。
能打开浏览器完成首次登录，或准备 xAI API Key（本课占位 YOUR_XAI_API_KEY）。
建议在一个真实代码仓库目录里跟做（任意小项目即可）。

一、插件与 Marketplace 是什么

官方新闻写明：一个 plugin 把 skills、slash commands、agents、hooks、MCP servers、LSPs 打成可安装的一包。Marketplace 内置在 Grok Build 里，你可以在终端里浏览、安装、更新，不必离开会话。

启动时目录里已有合作方插件示例（以新闻页「Available at launch」为准，目录会更新）：

MongoDB — 探索数据、管理集合、优化查询
Vercel — 管理部署、看构建状态、配置域名
Sentry — 分析堆栈、调试生产错误
Chrome DevTools — 控制浏览器、录性能、看网络
Cloudflare — Workers、Durable Objects 等相关 skills
Superpowers — 常见 agent 驱动工作流

Skills / Plugins 文档补充：插件还会从工作区与用户目录加载，Marketplace 安装落在 ~/.grok/plugins/marketplaces/ 一带（下一课细讲路径）。

二、动手：安装 Grok Build CLI

官方 Overview 给出的安装方式：

macOS / Linux / Git Bash：

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

Windows PowerShell：

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

装完后核对：

grok version

或：

grok --help

对照结果（成功时你会看到）：

安装脚本结束无报错
grok version 打出版本信息（具体字符串随版本变化）
grok --help 列出子命令，其中应出现与 plugin / marketplace 相关的管理项（CLI Reference 表：grok plugin …、grok plugin marketplace …）

若命令找不到：检查脚本是否把二进制放进了 PATH，新开一个终端再试。

三、登录或设置 API Key

进入项目目录：

cd /path/to/YOUR_PROJECT
grok

官方说明：首次启动会打开浏览器做鉴权。无浏览器环境可用 API Key：

export XAI_API_KEY="YOUR_XAI_API_KEY"
grok

对照结果：

浏览器登录成功后，TUI 进入可输入提示的界面；或
设置 XAI_API_KEY 后 grok 能启动，不再卡在登录页
不要把真实 Key 写进仓库、截图或聊天；本课只用占位符

可选自检（CLI Reference）：

grok inspect

会打印当前目录发现的 rules、skills、plugins、hooks、MCP 等（装插件前后各跑一次更好对比）。

四、方式 A：TUI 里用 `/marketplace`（推荐先练）

在已启动的 grok 会话中输入：

/marketplace

官方新闻：在 Marketplace 里浏览目录，按 i 安装插件。

你也可以用扩展总面板（Skills/Plugins 文档）：/plugins、/hooks、/skills、/mcps 任一命令打开同一类扩展管理界面，再到 Marketplace 相关标签。

对照结果：

出现可搜索/可浏览的插件列表（名称、描述随目录更新）
选中某一插件后按 i，安装过程结束无报错
安装后该插件的 skills / 命令等可在会话中出现（例如文档示例里的 slash 形式），或可在 /plugins 里看到已安装项

五、方式 B：纯 CLI 安装（脚本/无 TUI 时）

官方新闻给出的终端命令：

grok plugin marketplace list
grok plugin install <name> --trust

把 <name> 换成列表里看到的插件 id（kebab-case，以 grok plugin marketplace list 输出为准）。例如若列表里有 sentry 一类名称，则：

grok plugin install sentry --trust

（以你本机 list 输出的真实 name 为准，不要臆造。）

对照结果：

marketplace list 打印可安装条目（名称 + 简短描述）
plugin install … --trust 成功结束；失败时会有明确错误（网络、名称不存在、校验失败等）
再跑 grok inspect 或进入 TUI /plugins，能看到新装插件

关于 --trust 的含义与 SHA 钉死，放在第 2 课展开；本课只要你能完成一次成功安装。

六、装完后怎么「用上」

插件装好后，常见用法：

在 TUI 里用插件带来的 slash 命令（若 skill 设为 user-invocable）。
让 agent 在匹配任务时 自动调用 相关 skill（Skills 文档：可按描述 / when-to-use 触发）。
若插件带了 MCP，可在 /mcps 里确认服务已加载。

最小自测提示（按你装的插件改写）：

用刚安装的插件，帮我列出它提供的 skills 或斜杠命令。

对照结果： 模型能指出新装插件带来的能力，或你在 /skills / /plugins 里能看到对应项。

七、本课检查清单

grok version 或 grok --help 可用
能 grok 进入会话（浏览器登录或 YOUR_XAI_API_KEY）
用过 /marketplace 或 grok plugin marketplace list
成功执行过一次安装（TUI 按 i 或 grok plugin install <name> --trust）

官方来源

下一课：弄清 --trust、远程 SHA 校验、插件落盘路径，以及 Grok 如何零配置兼容 Claude Code 的 marketplace。

本课资料

Grok BuildxAI 终端编程 Agent，支持规划、并行子代理与 ACP

官方文档

Grok Build ↗