如果你每天都在終端機裡工作,那麼 Google 最新開源的 Gemini CLI 絕對值得你關注。這款工具將 Gemini AI 直接整合到命令列中,讓你無需離開終端就能完成程式碼撰寫、除錯、文件查詢等各種任務。

什麼是 Gemini CLI?

Gemini CLI 是 Google 官方開源的命令列 AI 助手,讓開發者可以直接在終端機中與 Gemini 模型互動。相較於傳統的網頁版 AI 助手,Gemini CLI 提供了更加流暢的開發體驗:

  • 終端優先設計:專為命令列工作者打造,無需切換視窗
  • 免費使用:個人 Google 帳號即可享受每天 1000 次請求
  • 強大模型:支援 Gemini 3 系列模型,1M token 上下文視窗
  • 內建工具:Google Search 即時搜尋、檔案操作、Shell 指令執行
  • 開源免費:Apache 2.0 授權條款,完全開源

快速安裝

方式一:使用 npx(無需安裝)

npx @google/gemini-cli

這是最快的體驗方式,無需全域安裝即可立即使用。

方式二:全域安裝(推薦)

npm install -g @google/gemini-cli

方式三:使用 Homebrew(macOS)

brew install gemini-cli

方式四:使用 Conda 環境

# 建立並啟用新環境
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env

# 在環境中全域安裝
npm install -g @google/gemini-cli

認證配置

Gemini CLI 提供三種認證方式,你可以根據需求選擇:

方式一:Google 帳號登入(推薦個人開發者)

gemini

首次執行會提示你登入 Google 帳號。

優勢: - 免費額度:60 次/分鐘,1000 次/天 - 自動獲取最新模型 - 無需管理 API Key

方式二:API Key(需要特定模型控制)

# 從 https://aistudio.google.com/apikey 取得金鑰
export GEMINI_API_KEY="YOUR_API_KEY"
gemini

優勢: - 可選擇特定 Gemini 模型 - 依使用量計費,可升級更高額度

方式三:Google Cloud 專案(企業使用者)

export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
export GOOGLE_API_KEY="YOUR_CLOUD_API_KEY"
gemini

核心功能

1. 程式碼查詢與編輯

Gemini CLI 可以理解整個程式碼庫的上下文,幫助你:

# 詢問程式碼庫結構
gemini> 解釋這個專案的架構

# 尋找特定功能
gemini> 找到所有處理使用者認證的檔案

# 產生程式碼
gemini> 建立一個 Python 函式來解析 JSON 設定檔

2. 除錯與問題排查

遇到 bug 時,可以直接讓 Gemini 幫你分析:

# 貼上錯誤訊息
gemini> 這個錯誤是什麼意思?
TypeError: Cannot read property 'map' of undefined

# 請求修復建議
gemini> 幫我修復這個非同步函式的問題

3. 自動化任務

Gemini CLI 可以執行各種自動化操作:

# 查詢 Git 狀態
gemini> 檢視目前分支的未提交變更

# 處理複雜 Git 操作
gemini> 幫我 rebase 到 main 分支並解決衝突

# 批次檔案操作
gemini> 將所有 .jpg 檔案轉換為 .webp 格式

4. 即時搜尋(Google Search Grounding)

Gemini CLI 內建 Google Search,可以獲取最新資訊:

# 查詢最新技術動態
gemini> 2026 年最新的 Node.js 版本有什麼新特性?

# 尋找文件
gemini> 尋找 React Server Components 的官方文件

5. 多模態支援

Gemini CLI 支援從圖片、PDF 產生程式碼:

# 從設計圖產生程式碼
gemini> 根據這個 UI 截圖產生 HTML/CSS 程式碼

# 從 PDF 文件提取資訊
gemini> 分析這個技術文件並總結要點

進階用法

會話檢查點

Gemini CLI 支援儲存和恢復複雜會話:

# 儲存目前會話
gemini> /save my-debug-session

# 恢復會話
gemini> /load my-debug-session

自訂上下文檔案

在專案根目錄建立 GEMINI.md 檔案,自訂 AI 行為:

# GEMINI.md

## 專案規範
- 使用 TypeScript
- 遵循 ESLint Airbnb 設定
- 測試框架:Jest

## 常用指令
- 建置:npm run build
- 測試:npm test
- 部署:npm run deploy

MCP 擴充支援

透過 Model Context Protocol (MCP) 連線自訂服務:

# 連線媒體產生服務
gemini> 使用 Imagen 產生一張科技風格插圖

版本更新

Gemini CLI 採用快速迭代策略:

版本類型 發佈時間 說明
Preview 每週二 UTC 23:59 預覽版,可能包含未驗證功能
Latest 每週二 UTC 20:00 穩定版,推薦使用
Nightly 每天 UTC 00:00 每日建置,包含最新改動

安裝特定版本:

# 預覽版
npm install -g @google/gemini-cli@preview

# 穩定版
npm install -g @google/gemini-cli@latest

# 每日建置
npm install -g @google/gemini-cli@nightly

GitHub 整合

Gemini CLI 還提供 GitHub Action,可以整合到 CI/CD 流程中:

# .github/workflows/gemini-review.yml
name: Gemini Code Review
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: google-github-actions/run-gemini-cli@v1
        with:
          api-key: *** secrets.GEMINI_API_KEY }}

支援的功能包括: - 自動程式碼審查 - Issue 自動分類和標籤 - 在 PR 中提及 @gemini-cli 獲取協助

與其他工具對比

特性 Gemini CLI GitHub Copilot CLI Claude Code
免費額度 1000 次/天 需訂閱 有限免費
上下文視窗 1M tokens 較小 200K tokens
即時搜尋 ✅ 內建 ⚠️ 需配置
開源 ✅ Apache 2.0
多模態

總結

Gemini CLI 是 2026 年最值得關注的開發者工具之一。它將強大的 AI 能力無縫整合到終端工作流中,無論是日常編碼、問題除錯還是自動化任務,都能顯著提升效率。

推薦理由: - 🎯 完全免費,額度充足 - 🚀 終端原生體驗,無需切換上下文 - 🔧 功能全面,從程式碼到搜尋一站式解決 - 📦 開源透明,社群驅動發展

如果你還沒有在終端中使用 AI 助手,Gemini CLI 是最佳起點。


相關連結: