第 6 篇收尾 · 附錄 A

Gemini CLI 指令速查

把常用啟動命令、slash commands、檔案 include、shell escape、headless、自動化、設定、安全與排查命令放在一頁。實際可用旗標與行為請以你安裝的版本為準。

版本敏感，先驗證

Gemini CLI 的旗標、slash command、設定檔、sandbox/approval、MCP 與 headless 輸出格式都可能隨版本改變。使用前請先查官方文件、GitHub repo、release notes，並在 CLI 內執行 /help 或用 gemini --help 驗證。

常用命令

gemini
gemini --version
gemini --help

命令	用途
`gemini`	進入互動式 Gemini CLI。
`gemini --version`	確認目前安裝版本；回報問題或寫 CI log 時必備。
`gemini --help`	查看目前版本支援的旗標與說明。

Slash Commands

/help
/clear
/chat
/memory
/mcp
/tools
/stats

指令	用途
`/help`	列出目前版本可用的互動式命令與快捷說明。
`/clear`	清空目前對話上下文，保留必要工作狀態後重新開始。
`/chat`	管理或切換聊天工作階段；細節以 `/help` 為準。
`/memory`	查看或管理專案記憶，例如 `GEMINI.md` 的載入狀態。
`/mcp`	檢查 MCP server、資源與工具狀態。
`/tools`	查看目前可用工具與權限狀態。
`/stats`	查看 token、請求或工作階段統計；欄位依版本而異。

@ Include 與 ! Shell

@ 通常用來把檔案或目錄內容帶入上下文；! 通常用來在互動式 CLI 中執行 shell 命令。兩者都會碰到權限、sandbox 與輸出長度限制。

@README.md
@src/
!git status --short
!npm test

Headless 與輸出格式

自動化腳本應指定 prompt 與輸出格式，分開 stdout/stderr，並保存原始輸出以便排查。旗標名稱、支援格式與結構化輸出細節請以目前 headless 文件和 gemini --help 為準。

gemini -p "Summarize this repository in five bullets"

gemini -p "Return one JSON object with keys: summary, risks" \
  --output-format json \
  > gemini-output.json \
  2> gemini-debug.log

設定、環境變數、API Key、Vertex

認證方式不要混用。個人互動式登入、GEMINI_API_KEY、Vertex AI/Google Cloud ADC、service account 與企業路線各有不同的權限、計費與審計模型。排查時只顯示 secret 是否存在，不要把完整 key 寫進 log。

export GEMINI_API_KEY="YOUR_API_KEY"

test -n "$GEMINI_API_KEY" && echo "GEMINI_API_KEY is set"
gcloud auth application-default login
gcloud config get project

MCP JSON 範例

MCP 設定通常是 JSON。實際檔名、位置、欄位與 server 啟動方式請看目前 configuration 文件；stdio server 的 debug log 應寫到 stderr，避免污染協定輸出。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/workspace"
      ],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Sandbox、Approval、安全

安全檢查：
- 只在可信任 workspace 內讓 agent 讀寫檔案。
- 執行 ! shell 前先看命令是否會刪檔、推送、部署或外傳資料。
- 對會修改檔案、安裝套件、開網路、使用 secret 的步驟保留人工審核。
- CI 中避免把 API key、service account JSON、token 或完整 prompt log 公開。
- sandbox/approval 旗標與預設值依版本而異，先查 /help 與官方文件。

疑難排解命令

gemini --version
gemini --help
node -v
npm -v
command -v gemini
command -v node
command -v npm
npm config get prefix
pwd
env | sort | grep -E '^(GEMINI|GOOGLE|VERTEX|CLOUDSDK)_'

官方參考

GitHub repo、configuration docs、headless docs、commands docs