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/，之後不需重複登入。
三種登入方式比較
| 方式 | 費用 | 適合對象< /th> |
|---|---|---|
| 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 安裝教學，兩者功能類似但各有側重。
延伸閱讀
對 AI 終端機工具有興趣？也可以參考以下相關教學：
常見問題 FAQ
Gemini CLI 安裝需要額外付費嗎？
通常可以先用 Google 帳號登入開始使用，但實際可用範圍與限制仍要以官方最新規則為準。
Gemini CLI 支援哪些作業系統？
一般會支援 macOS、Linux 與 Windows，但實際安裝方式會依平台不同而有差異。
如果 Gemini CLI 登入失敗怎麼辦？
先確認 Google 帳號狀態、CLI 版本與網路連線，再重新登入通常能解決大部分問題。
