TERMINAL COURSE / 01—18

Grok Build 野戰手冊

12 份有順序的 CLI 手冊，帶你從乾淨安裝走到受控自動化；另保留 6 份 API 手冊作為獨立進階 track。

CHANNEL12 CORE CLI + 06 ADVANCED API

來源核對日期2026-07-26

ORIGINOFFICIAL DOCS / PRIMARY

PRIMARY TRACK / GROK BUILD

核心 CLI 課程

依序完成 01–12：建立終端、repository 規則、安全邊界、平行工作、extensions 與自動化。

MODULE / 01

基礎建置

MANUAL / 01 · 核心 CLI

安裝並驗證 Grok Build

安裝官方 grok 執行檔、確認 shell 實際解析到哪個 binary，並在進入專案前建立可重複的更新檢查。

基礎建置 · 基礎 · 8 分鐘 MANUAL / 02 · 核心 CLI

完成認證，但不要散播憑證

依真正的執行環境選擇互動、device-code 或 API key 認證，然後能夠驗證並乾淨撤銷。

基礎建置 · 基礎 · 8 分鐘 MANUAL / 03 · 核心 CLI

以嚴謹方式完成第一個 repository session

從 repository 邊界啟動 Grok、檢查它發現的內容，並把模糊需求轉成證據、驗收條件與已驗證變更。

基礎建置 · 基礎 · 9 分鐘

MODULE / 02

Repository 上下文

MANUAL / 04 · 核心 CLI

編寫 project rules，並驗證 Claude Code 相容性

為每個 session 提供持久的 repository instructions、依 directory 分層 monorepo rules，並稽核 Grok 聲稱能發現的 Claude Code assets。

Repository 上下文 · 中階 · 11 分鐘

MODULE / 03

受控執行

MANUAL / 05 · 核心 CLI

先規劃、審查與核准，再開始編輯

對模糊或高影響工作使用 Plan Mode、逐項註解建議路徑，並讓 approval 成為有意義的工程閘門。

受控執行 · 中階 · 10 分鐘 MANUAL / 06 · 核心 CLI

分層使用 permissions 與 sandbox

先控制 tool call 是否能執行，再獨立限制已核准 process 可以讀、寫與連到哪裡。

受控執行 · 進階 · 12 分鐘

MODULE / 04

Session 操作

MANUAL / 07 · 核心 CLI

安全 resume、compact 與復原 sessions

把本機 session history 視為操作狀態：恢復正確 thread、有意識地回收 context，並理解 recovery 何時會重寫檔案。

Session 操作 · 中階 · 11 分鐘

MODULE / 05

平行工程

MANUAL / 08 · 核心 CLI

用 worktrees 與 subagents 安全平行化

把並行工作放入隔離 checkout 與聚焦 child context，再透過正常 review 整合，不讓多個 agent 搶寫共用檔案。

平行工程 · 進階 · 12 分鐘

MODULE / 06

擴充系統

MANUAL / 09 · 核心 CLI

用 skills、plugins 與 hooks 擴充 Grok

封裝可重用知識、從已審查來源安裝 extension bundle，並在 agent lifecycle events 周圍加入 deterministic policy。

擴充系統 · 進階 · 12 分鐘 MANUAL / 10 · 核心 CLI

以明確 trust 連接 MCP servers

加入 local stdio 或 remote HTTP tools、讓 secrets 留在 committed configuration 之外，並在使用前診斷 effective server set。

擴充系統 · 進階 · 12 分鐘

MODULE / 07

自動化

MANUAL / 11 · 核心 CLI

在 headless CI 與 ACP client 自動化 Grok

選擇穩定 machine output、保留 session identity、限制 tool authority，並在另一個 application 擁有互動介面時使用 ACP。

自動化 · 進階 · 12 分鐘 MANUAL / 12 · 核心 CLI

用 Grok Workflows 操作大型任務

以自然語言描述真正可平行的工作、監看 phases，並把成功 workflow 保存成團隊可重用 command。

自動化 · 進階 · 10 分鐘

SECONDARY TRACK / API

進階 / xAI API

當你是在自行打造 xAI API 應用，而不是操作 Grok Build CLI 時，再進入 13–18。

MANUAL / 13 · 進階 API

建立第一條 API 訊號

從空白專案走到可控的第一個請求，同時避免洩漏金鑰或把短生命週期的模型名稱寫死。

API 基礎 · 基礎 · 9 分鐘 MANUAL / 14 · 進階 API

設計可長期維護的文字生成迴路

把 response 視為包含狀態、串流、保存政策與復原的生命週期，而不是一段神奇字串。

Responses API · 中階 · 10 分鐘 MANUAL / 15 · 進階 API

建立有邊界的工具系統

分清哪些工具在 xAI 基礎設施執行、哪些會把控制權交回你的程式，以及安全閘門應放在哪裡。

工具系統 · 進階 · 11 分鐘 MANUAL / 16 · 進階 API

安全關閉 function-calling 迴路

定義精準 schema、依 policy dispatch、回傳結果並持續，直到模型能作答或預算用盡。

工具系統 · 進階 · 12 分鐘 MANUAL / 17 · 進階 API

把模型輸出變成型別邊界

有意識地使用支援的 JSON Schema、在 runtime 再次驗證，並追求語意而不只是語法正確。

可靠輸出 · 中階 · 10 分鐘 MANUAL / 18 · 進階 API

選模型，但不要把時間凍結

把即時 catalog 當庫存、把自己的評估當證據、把設定當替換點。

模型操作 · 中階 · 9 分鐘