Grok Build 安全起步：先只讀理解，再審閱計畫與 diff

0 · 先知道風險↑ 回本頁選單

Grok Build 不是一般聊天視窗：它可以在終端機讀檔、修改程式、執行命令與搜尋網路。安全起手式不是把工作交出去，而是先確認自己在哪個專案、目前 Git 是否有未提交內容、哪些檔案不能碰，以及你希望 agent 只做什麼理解。Grok Build 總覽 ✅官方

Sandbox profile 也不是機密資料隔離的同義詞。尤其 workspace 仍可讀取全系統；若要保護 .env、私鑰或特定路徑，需依官方文件另設 custom profile 的 deny 規則。帳戶資格、資料保存、ZDR 與企業治理屬當期帳戶或合約條件，本頁不替一般帳戶下結論。⚠️實驗性／待重測

1 · Grok Build 是什麼↑ 回本頁選單

官方定位是 terminal-first coding agent：可用全螢幕互動 TUI、-p 的 headless 腳本模式，或以 Agent Client Protocol（ACP）嵌入其他程式。這些模式說明它能參與工作流，不等於任何環境都已安全設定，也不代表每個 IDE 都原生支援。Grok Build 總覽 ✅官方

把它當作會採取動作的協作者，而不是自動保證正確的結論產生器。好的第一輪輸出是對 repo 的解釋、未知點與計畫；是否允許修改、是否接受 diff、驗證是否足夠，仍是人的決策。

正在比較 WebDev 模型？先讀 Arena WebDev 選型快照；本頁只負責 Grok Build 的安全起步與工作流。

Grok Build 剛推出不久，評估這類新 CLI 在〈為什麼要用 AI CLI？〉學習路線圖屬於第 3–4 階，不是每個人現在都該碰——先對照自己在路線圖第幾階，再決定要不要繼續往下讀。

2 · 開始前檢查↑ 回本頁選單

• 確認你位於正確的專案目錄，先看 Git status 與既有測試，而非假設工作樹乾淨。
• 辨認機密檔、部署設定與不可修改的路徑；不要把 API key 寫進 repo 或提交的設定檔。
• 確認 CLI 版本與當天官方文件。安裝方式、支援 OS、帳戶資格和安全行為在 beta 期間都可能改變。⚠️實驗性／待重測
• 若使用 macOS，預先記住：child-process network restriction 是 no-op；需要網路邊界時不能依賴該限制。官方 Sandbox 文件 ✅官方

3 · 安裝與登入↑ 回本頁選單

以下是官方列出的 macOS／Linux／WSL 安裝方式；把它當成版本敏感的起點，安裝後先確認版本。Grok Build 總覽 ✅官方

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

首次互動啟動會走預設瀏覽器登入；沒有瀏覽器的 SSH、container 或主機可用 grok login --device-auth。CI／headless automation 可使用 XAI_API_KEY，但不應將 key 寫入 repo。實際登入路徑也可能受既有環境變數影響。官方 Authentication 文件 ✅官方

4 · 第一次任務：只讀理解↑ 回本頁選單

第一個 CTA 是只讀探索。先請它解釋 repo 和指定檔案，再用 inspect 看清目前實際載入的設定、指令、skills、plugins、hooks 與 MCP servers。Grok Build 總覽 ✅官方

1. 1

   在正確專案內，以 read-only 開始

   grok --sandbox read-only

   複製

   預期：專案檔不因第一輪理解被修改；若啟動訊息顯示 profile 無法套用，停下來檢查，而不是假設已隔離。

2. 2

   先請它解釋 repo 或指定檔案

   Explain this repo.
   @src/main.rs Walk me through this file.

   複製

   預期：得到架構、未知點和可追問內容；先核對它引用的檔案，而不是把解釋當成事實。

3. 3

   檢查實際載入的擴充與設定

   grok inspect

   複製

   預期：看見當前目錄真正載入的設定、指令、skills、plugins、hooks 與 MCP servers，才有資格評估信任邊界。

5 · 從計畫到 diff↑ 回本頁選單

只有在你已看過只讀結果、審閱計畫並決定目標檔案範圍後，才讓 agent 在目前工作區寫入。這不是把 workspace 當隔離保證：該 profile 仍能讀取全系統。xAI 發布公告 ✅官方

1. 1

   先要求可檢查的 Plan

   核對目標、非目標、預計檔案、風險與驗證方式；不清楚的地方由人重寫或補問。

2. 2

   人類核對計畫後，才開放目前工作區修改

   grok --sandbox workspace

   複製

   預期：修改範圍仍由你指定；不要把它解讀成只能讀取目前 repo。

3. 3

   逐項看 diff，再跑既有驗證

   確認沒有夾帶機密、無關格式化或超出範圍的變更；以專案原有測試、lint、typecheck 或 build 驗證。

4. 4

   由人決定採用、修改或放棄

   驗證通過是證據，不是自動授權；保留 Git 狀態、結果與未驗證的風險。

6 · Headless↑ 回本頁選單

-p 與 JSON／streaming JSON 輸出適合放進腳本、CI、bots 或其他程式。先從固定 cwd 的只讀解釋或 diff review 開始；它不是 deploy 授權，也不替你決定是否採用結果。Grok Build 總覽 ✅官方

grok -p "Explain this codebase"
grok -p "Review this diff for regressions and missing tests" --output-format json
grok -p "Explain the architecture" --output-format streaming-json

7 · 擴充與平行↑ 回本頁選單

AGENTS.md、AGENT.md、Claude.md 與 Agents.md 可作為 project instructions 被載入；官方 README 說明會依 repository root 到目前目錄掃描。這可以幫你讓 agent 讀到規則，不能保證它一定正確遵從。官方 README ✅官方

8 · ACP 與具名實作者實證↑ 回本頁選單

grok agent stdio 是官方的 ACP 入口，以 stdio 上的 JSON-RPC 把 Grok Build 當成外部 agent runtime。ACP 不是通用 API 的同義詞，也不表示所有 IDE 都已有原生支援。官方 README ✅官方

這些是具名、可追溯的特定版本或 integration 證據；每次採用前仍要核對目前 CLI、目標 OS 與宿主程式版本。

9 · 來源與重查清單↑ 回本頁選單

以下矩陣只用來協助你選擇第一步，不是安全保證。內建 profile 無法套用時，官方文件表示程式可能警告後繼續而不強制執行；此時應檢查啟動訊息或 /doctor。官方 Sandbox 文件 ✅官方

表格可使用左右方向鍵捲動；實際 profile、OS 行為與帳戶條件要以發布／採用當天的官方文件及本機訊息再核對。

發布前重查來源（研究日期：2026-08-17）

本頁不宣稱價格、免費額度、帳戶資格、地區可用性、ZDR、保存期限或所有整合的支援度；這些都要在使用當天重查。