Google Gemini CLI 是 Google 推出的 AI 終端機助理，讓你直接在命令列用自然語言與 Gemini 模型協作開發。有 Google 帳號就能免費使用，不需要額外付費或申請 API Key。本篇教學帶你完成安裝、登入，並整理完整指令集供日常參考。
什麼是 Gemini CLI？
Gemini CLI 是 Google 開源的終端機 AI 工具，主要功能包括：
- 用自然語言讀取、編輯、執行專案程式碼
- 支援多輪對話，理解完整專案脈絡
- 支援 Google 帳號 OAuth 登入，免費額度即可使用
- 支援 MCP（Model Context Protocol）擴充外部工具
- 可自訂 Slash 指令（Custom Commands）
安裝前準備
- Node.js 20 以上版本
- npm（隨 Node.js 安裝）
- Google 帳號（免費登入用）
確認 Node.js 版本
node --version若版本低於 20，建議用 nvm 升級：
# 安裝 nvm（如未安裝）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.nvm/nvm.sh
# 安裝最新 LTS
nvm install --lts
nvm use --lts
node --version # 應顯示 v24.x.x 或以上安裝 Gemini CLI
npm install -g @google/gemini-cli確認安裝成功：
gemini --version看到版本號（如 0.35.3）即代表安裝完成。
用 Google 帳號登入（免費）
步驟 1：啟動 Gemini CLI
gemini步驟 2：選擇登入方式
第一次啟動會出現登入提示，選擇 「Sign in with Google」，系統會開啟瀏覽器進行 OAuth 授權。
步驟 3：完成授權
用 Google 帳號登入並授權後，CLI 自動取得 token，登入狀態儲存於 ~/.gemini/，之後不需重複登入。
三種登入方式比較
| 方式 | 費用 | 適合對象 |
|---|---|---|
| Google 帳號登入 | 免費（有配額） | 個人開發者 |
| Gemini API Key | 免費層 + 付費 | 需要更高用量 |
| Vertex AI | GCP 計費 | 企業、生產環境 |
常用 Slash 指令一覽
在 Gemini CLI 中輸入 / 開頭的指令可控制對話、管理 session、切換設定等。
📁 Session 管理
| 指令 | 說明 |
|---|---|
/help | 顯示所有可用指令 |
/clear | 清除目前 session 對話 |
/quit | 退出 Gemini CLI |
/chat save <tag> | 儲存目前對話，標記為 tag |
/chat resume <tag> | 恢復指定 tag 的對話 |
/chat list | 列出目前專案所有已儲存對話 |
/compress | 壓縮對話紀錄，釋放 context window 空間 |
/copy | 複製最後一則回覆到剪貼簿 |
🔧 設定與工具
| 指令 | 說明 |
|---|---|
/about | 顯示 Gemini CLI 版本與系統資訊 |
/auth | 開啟驗證設定（切換帳號或 API Key） |
/tools | 列出目前所有可用工具 |
/tools desc | 顯示每個工具的詳細說明 |
/mcp | 列出已設定的 MCP 伺服器與工具 |
/extensions | 顯示所有已啟用的擴充功能 |
/theme | 切換 CLI 色彩主題 |
/stats | 查看 token 用量與請求統計 |
🧠 記憶與上下文
| 指令 | 說明 |
|---|---|
/memory show | 顯示從 GEMINI.md 載入的專案記憶內容 |
/memory refresh | 重新載入 GEMINI.md 更新記憶 |
/restore | 還原專案狀態或對話 checkpoint |
/bug | 直接從 CLI 提交 bug 回報 |
鍵盤快捷鍵
| 快捷鍵 | 功能 |
|---|---|
Enter | 送出訊息 |
Esc | 取消目前操作 |
Ctrl + L | 清除終端畫面 |
Ctrl + C x2 | 退出 CLI |
Ctrl + T | 切換工具說明顯示 |
↑ / ↓ | 瀏覽歷史提示紀錄 |
Alt + ← / → | 游標按單字移動 |
@路徑 | 將檔案或資料夾加入對話上下文 |
! | 直接執行 shell 指令（繞過 AI） |
設定檔位置
| 檔案路徑 | 說明 |
|---|---|
~/.gemini/settings.json | 全域使用者設定 |
./.gemini/settings.json | 專案層級設定 |
GEMINI.md | 專案記憶設定，AI 每次對話都會讀取 |
.gemini/commands/*.toml | 自訂 Slash 指令設定檔 |
自訂 Slash 指令
Gemini CLI 支援自訂 Slash 指令，在 .gemini/commands/ 目錄下建立 .toml 檔案即可：
# .gemini/commands/git/commit.toml
description = "自動產生 git commit 訊息"
prompt = """
根據以下 diff 內容，幫我寫一個清楚的 git commit 訊息：
!{git diff --staged}
"""存檔後，在 CLI 中輸入 /git:commit 即可執行。
小結
Gemini CLI 是目前門檻最低的 AI 終端機工具之一——只需要 Google 帳號就能免費使用，不需要信用卡或 API Key。對於想嘗試 AI 輔助開發的開發者來說，是非常適合的入門選擇。
如果你同時也在使用其他 AI CLI 工具，可以參考本站的 OpenAI Codex CLI 安裝教學，兩者功能類似但各有側重。