Gemini CLI 是一款開源的 AI agent（AI 代理人），讓你可以直接在終端機中體驗 Gemini 的強大功能。它提供輕量級的 Gemini 存取方式，讓你從命令列提示直接連接到我們的模型，路徑最短、效率最高。
- 🎯 免費方案：使用個人 Google 帳戶，每分鐘可發送 60 次請求、每日 1,000 次請求
- 🧠 強大的 Gemini 2.5 Pro：支援 100 萬 token 的 context window
- 🔧 內建工具：Google Search grounding、檔案操作、shell 指令、網頁擷取
- 🔌 可擴充：支援 MCP（Model Context Protocol），方便自訂整合
- 💻 終端機優先：專為習慣命令列介面的開發者設計
- 🛡️ 開源：採用 Apache 2.0 授權
# Using npx (no installation required)
npx https://github.com/google-gemini/gemini-clinpm install -g @google/gemini-clibrew install gemini-cli- Node.js 版本 20 或以上
- macOS、Linux 或 Windows
請參閱 Releases 以取得更多詳細資訊。
新的預覽版本將於每週二 UTC 2359 發佈。這些版本尚未經過完整驗證，可能包含回歸或其他尚未解決的問題。請協助我們測試，並使用 preview 標籤安裝。
npm install -g @google/gemini-cli@preview- 新的穩定版本將於每週二世界協調時間（UTC）20:00 發布，這將是上週
preview版本的完整升級，並包含任何錯誤修正與驗證。請使用latest標籤。
npm install -g @google/gemini-cli@latest- 新版本將於每週的 UTC 0000 發佈，內容包含截至發佈時 main 分支 (main branch) 上的所有變更。請注意，此版本可能尚有待驗證事項與已知問題。請使用
nightly標籤。
npm install -g @google/gemini-cli@nightly- 查詢與編輯大型程式碼庫
- 利用多模態能力，從 PDF、圖片或草圖生成全新應用程式
- 以自然語言進行除錯與故障排除
- 自動化操作任務，例如查詢 Pull Request 或處理複雜的 rebase
- 使用 MCP 伺服器 (MCP servers) 連接新功能，包括使用 Imagen、Veo 或 Lyria 進行媒體生成
- 可於腳本 (script) 中非互動式執行，以實現工作流程自動化
- 透過內建的 Google Search 讓查詢具備即時資訊
- 對話檢查點功能，可儲存與恢復複雜的會話
- 自訂 context 檔案（GEMINI.md），針對您的專案調整行為
將 Gemini CLI 直接整合進您的 GitHub 工作流程，透過 Gemini CLI GitHub Action：
- Pull Request 程式碼審查：自動化程式碼審查，提供情境化回饋與建議
- Issue 分流：根據內容分析，自動標記與優先排序 GitHub Issues
- 隨需協助：在 Issue 與 Pull Request 中提及
@gemini-cli，即可獲得除錯、說明或任務分派協助 - 自訂工作流程：建立自動化、排程或隨需的工作流程，滿足團隊需求
請選擇最適合您的認證方式：
✨ 最適合：
- 個人開發者
- Google AI Pro 與 AI Ultra 訂閱者
- 擁有 Gemini Code Assist 授權的使用者
詳情請參閱 配額限制與服務條款。
優點：
- 免費方案：每分鐘 60 次、每日 1,000 次請求
- Gemini 2.5 Pro 與 Flash：支援 1M token context window
- 無需 API 金鑰管理：只需以 Google 帳戶登入
- 自動更新：自動取得我們最新的模型
gemini# Set your Google Cloud Project
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_NAME"
gemini✨ 最適合對象： 需要特定模型控制或付費等級存取的開發者
優點：
- 免費方案：Gemini 2.5 Pro 每日可用 100 次請求
- 模型選擇：可選擇特定 Gemini 模型
- 依用量計費：需要更高額度時可升級
# Get your key from https://aistudio.google.com/apikey
export GEMINI_API_KEY="YOUR_API_KEY"
gemini✨ 最適合： 企業團隊與生產環境工作負載
優點：
- 企業級功能：進階安全性與合規性
- 可擴展性：搭配計費帳戶可享有更高的速率限制
- 整合性：可與現有 Google Cloud 基礎架構整合
# Get your key from Google Cloud Console
export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini如需 Google Workspace 帳戶及其他驗證方式，請參閱 authentication guide。
geminigemini --include-directories ../lib,../docsgemini -m gemini-2.5-flash取得簡單的文字回應：
gemini -p "Explain the architecture of this codebase"若需進行更進階的腳本（script）操作，包括如何解析 JSON 及處理錯誤，請使用 --output-format json 旗標（flag）以取得結構化輸出：
gemini -p "Explain the architecture of this codebase" --output-format jsoncd new-project/
gemini
> Write me a Discord bot that answers questions using a FAQ.md file I will providegit clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all of the changes that went in yesterday- 指令參考 - 所有斜線指令（
/help、/chat、/mcp等） - 檢查點（Checkpointing） - 儲存與恢復對話
- 記憶體管理 - 使用 GEMINI.md context 檔案
- Token 快取 - 優化 token 使用
- 架構總覽 - Gemini CLI 的運作方式
- IDE 整合 - VS Code 伴侶工具
- 沙箱機制與安全性 - 安全的執行環境
- 企業部署 - Docker、系統層級設定
- 遙測（telemetry）與監控 - 使用狀況追蹤
- 工具 API 開發 - 建立自訂工具
- 設定參考 - 所有組態選項
- 佈景主題自訂 - 視覺自訂化
- .gemini 目錄 - 專案專屬設定
- 環境變數
在 ~/.gemini/settings.json 中設定 MCP 伺服器，以擴充 Gemini CLI 的自訂工具功能：
> @github List my open pull requests
> @slack Send a summary of today's commits to #dev channel
> @database Run a query to find inactive users
請參閱 MCP Server Integration guide 以取得設定說明。
我們歡迎各界貢獻！Gemini CLI 完全開源（Apache 2.0），我們鼓勵社群：
- 回報錯誤與提出功能建議
- 改善文件
- 提交程式碼改進
- 分享您的 MCP 伺服器與擴充套件
開發環境設定、程式碼標準與提交 pull request 的方式，請參閱我們的 Contributing Guide。
Gemini CLI 未來規劃與優先事項，請參考 Official Roadmap。
- Official Roadmap - 查看即將推出的功能
- NPM Package - 套件註冊中心
- GitHub Issues - 回報錯誤或提出功能需求
- Security Advisories - 安全性更新
移除說明請參閱 Uninstall Guide。
- 授權條款：Apache License 2.0
- 服務條款：Terms & Privacy
- 安全性：Security Policy
由 Google 與開源社群用 ❤️ 打造