第一次使用
這一頁帶你從零完成一次完整的任務：下指令、看代理規劃、審查它寫的檔案、執行結果、退出。過程中會學到最重要的兩件事：怎麼審查 artifact，以及三種執行模式的差別。
動手做一次
-
建立資料夾並啟動
-
下達任務：在輸入框輸入，按
Enter送出。代理會顯示推理過程並排定要做的動作。
-
審查檔案：代理產生
main.py後，按Ctrl+R開啟 artifact 挑選面板。用y核准、n退回；按Enter可進入全螢幕的詳細檢視。 -
執行：請代理執行腳本，輸出結果會即時顯示在畫面上。需要核准的動作會停下來等你按
y或n。 -
離開：按
Ctrl+D（或輸入/quit）結束。
如何審查 artifact
Ctrl+R 打開的面板列出待審查的檔案與狀態。常用按鍵：
| 按鍵 | 作用 |
|---|---|
y / n |
核准／退回目前檔案 |
Shift+A |
一次核准所有待審檔案 |
Enter |
開啟全螢幕詳細檢視 |
c |
在指定行留下意見，代理會依此修正 |
l |
顯示或隱藏行號 |
g / Shift+G |
跳到最上／最下 |
m |
切換 Mermaid 圖的顯示方式（圖形、ASCII 或原始碼） |
用行內意見比重新描述一次任務更精準，代理會針對那一行修正。
三種執行模式
執行模式決定代理修改檔案前要不要先問你。在對話中按 Shift+Tab 循環切換。
| 模式 | 行為 | 適合 |
|---|---|---|
| 預設（Default） | 每次修改前暫停，顯示行內的 diff 預覽，按 y 接受、n 拒絕、f 全螢幕檢視 |
不熟的專案、重要程式碼 |
| 自動接受編輯（Accept-Edits） | 自動核准檔案操作，不打斷 | 快速試作、你信任的程式碼 |
| 規劃（Plan） | 先分析、規劃，再動手修改 | 探索陌生架構、設計多步驟功能 |
想預設用某個模式，在 ~/.gemini/antigravity-cli/settings.json 設定 "agentMode": "accept-edits"；只想這次啟動臨時改用，加上 --mode 旗標。用 /permissions 設定的工具權限在所有模式下都有效。
權限層級
除了模式，CLI 還有四個工具權限層級，控制指令與檔案存取的鬆緊（官方 Codelab 的說法）：
| 層級 | 意義 |
|---|---|
request-review |
預設。需要時先請你核准 |
proceed-in-sandbox |
在沙盒內直接執行 |
always-proceed |
一律直接執行，風險最高 |
strict |
最嚴格 |
可在 /config 的設定選單調整。完整說明見 權限與沙盒。
管理對話
| 指令 | 作用 |
|---|---|
/resume |
回到先前的對話 |
/rewind（或 /undo） |
把對話倒回較早的時間點 |
/fork |
從較早的時間點分支出新對話，不影響原本的 |
/clear |
開始全新的對話 |
讓代理做得更準的三個習慣
- 先給驗證方式：官方建議最有效的做法，是先讓代理有本機驗證機制（單元測試、建置指令、格式化腳本），它就能自己檢查修改是否正確。
- 分階段：複雜任務依序做探索、規劃（產出計畫 artifact）、執行；用
/plan或規劃模式。 - 善用
@與圖片：輸入@會跳出檔案路徑建議；除錯畫面問題時，用Ctrl+V貼上截圖或錄影。
推薦影音
簡述：官方 CLI 導覽的另一個角度，可與上面的實作對照，看官方如何示範下指令、審查與執行。
接下來查 指令與快捷鍵。