命令系統

Gemini CLI 的互動命令主要有三類：/ 控制 CLI 本身，@ 把檔案或目錄加入上下文，! 直接執行 Shell 命令。三者不要混用：上下文用 @，會話和配置用 /，系統命令才用 !。

flowchart LR
    Slash["/ slash commands"] --> Control["控制會話、配置、MCP、記憶"]
    At["@ file / dir"] --> Context["注入檔案和目錄上下文"]
    Bang["! shell"] --> Shell["直接執行系統命令"]

    style Slash fill:#dbeafe,stroke:#3b82f6
    style At fill:#dcfce7,stroke:#22c55e
    style Bang fill:#fef3c7,stroke:#f59e0b

1. slash commands

Slash commands 是 CLI 控制面。它們不等於給模型的業務需求，而是用來管理專案上下文、切換認證、控制工具、檢視用量、恢復 checkpoint、過載配置。下表按"新手最先用 → 進階"分組，完整 38 個命令以官方 Commands reference 為準。

起步必學（第一次啟動後最先用這幾條）：

模型與用量：

上下文與配置：

工具與許可權：

擴充套件生態：

會話管理 / 排錯：

介面調整（可選）：

2. @ 檔案引用

典型寫法：

• @src/components/UserProfile.tsx 解釋這個元件如何處理 user data
• @src/types/User.ts @src/components/UserProfile.tsx 幫我檢查型別是否一致
• @src/utils/ 檢查這個目錄裡是否還有 deprecated API

@ 適合你已經知道路徑時強制把檔案放進上下文。如果不知道路徑，可以直接讓 Gemini CLI 先找。

@ 引用目錄時要控制範圍。不要一上來 @. 或把整個 monorepo 放進去；先指定一個檔案、一個子目錄或一組強相關檔案。上下文越大，越容易浪費 token，也越容易把無關檔案帶進判斷。

3. ! Shell 命令

常見寫法包括 !ls -la、!git status、!npm test。

! 執行的命令會把輸出放進當前 session，上下文裡後續可以引用。輸出太大時可能被截斷。

4. 使用建議

• 查 CLI 能力先 /help。
• 修改上下文檔案後用 /memory reload 或 /memory refresh。
• 接 MCP 後用 /mcp list 確認工具是否載入。
• 大改前先 /chat save <tag> 或啟用 checkpoint。
• Shell 命令預設要確認，不要長期放開高風險命令。

一個穩的日常順序是：

1. 用 @ 指定檔案。
2. 讓 Gemini CLI 只讀解釋。
3. 用 /memory show 或 /memory reload 確認規則。
4. 用 !git status、!npm test 獲取事實。
5. 再授權小範圍修改。

5. 接下來去哪

官方來源

• Gemini CLI Commands Reference
• Gemini CLI Cheatsheet