AiDuo123 Logo
简体|繁體
充值登录注册
★ 105,502· 14,152 forks· TypeScript· Apache-2.0开发工具

Gemini CLI - 終端裡的 Google AI 助手

google-gemini/gemini-cli

Google 官方開源的命令列 AI 工具,將 Gemini 3 模型能力直接接入終端,支援程式碼理解、檔案操作、MCP 擴充套件和 Google 搜尋聯網

成熟度：維護極活躍,最近提交0天前,周釋出節奏,open issues 1355 個顯示使用者基數大

GitHub 仓库 →对标：GitHub Copilot CLI

项目体检

部署 · 基于 Docker 多阶段构建,Node.js 20 环境,需传入 GIT_COMMIT 参数,构建后生成 npm 包,无默认端口(CLI 工具)

成本 · 需 GEMINI_API_KEY 或 Google OAuth 认证,可选 GOOGLE_CLOUD_PROJECT(企业版)、GOOGLE_GENAI_USE_VERTEXAI(Vertex AI),开箱支持 npx 免安装运行

技术 · TypeScript + Node.js,基于 esbuild 构建,包含 CLI/Core/SDK/VSCode 扩展等多包架构

许可 · Apache-2.0 协议,可自由商用、修改和分发,需保留版权声明

活跃 · 极活跃维护,最新版本 v0.47.0 发布于 5 天前,685 名贡献者,每周二发布 preview/stable 版本

解決什麼

開發者在終端工作時需要頻繁切換到瀏覽器查詢 AI、複製貼上程式碼,打斷思維流。Gemini CLI 將 Google 最新的 Gemini 3 模型直接嵌入命令列,讓你無需離開終端即可完成程式碼審查、檔案操作、Shell 命令執行、聯網搜尋等任務。支援 100 萬 token 的超大上下文視窗,能一次性處理整個程式碼倉庫級別的查詢。

為何火

作為 Google 官方推出的開源專案,上線兩個月即獲得 10.5 萬 stars,核心原因是三點:1) 免費額度慷慨,個人 Google 賬號每天 1000 次請求,每分鐘 60 次,遠超競品;2) 終端原生體驗,無需瀏覽器外掛或 IDE 擴充套件,npx 即可執行;3) 生態整合深度,內建 Google 搜尋聯網、支援 MCP 協議擴充套件第三方工具,還提供 GitHub Action 實現 PR 自動審查。

核心功能

  • 多模態程式碼理解:上傳 PDF、圖片或手繪草圖生成完整應用,支援自然語言除錯和大規模程式碼庫查詢
  • 內建工具鏈:檔案讀寫、Shell 命令執行、網頁抓取、Google 搜尋即時聯網(需梯子)
  • 會話管理:支援 checkpoint 儲存複雜對話上下文,可通過 GEMINI.md 檔案定製專案專屬行為
  • MCP 擴充套件:相容 Model Context Protocol,可接入 Vertex AI 的 Imagen/Veo 媒體生成等外部服務
  • 非互動模式:可嵌入 Shell 指令碼實現自動化工作流,例如批次處理 PR 或定時任務

安裝

快速體驗(無需安裝):

npx @google/gemini-cli

全域性安裝:

# npm 方式
npm install -g @google/gemini-cli

# macOS Homebrew
brew install gemini-cli

# 受限環境用 Anaconda
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
npm install -g @google/gemini-cli

認證配置(三選一):

  1. OAuth 登入(推薦個人使用者):執行 gemini 後選擇瀏覽器登入
  2. API Key:訪問 https://aistudio.google.com/apikey 獲取後 export GEMINI_API_KEY="YOUR_KEY"
  3. Vertex AI(企業):設定 GOOGLE_API_KEY 和 GOOGLE_GENAI_USE_VERTEXAI=true

適合誰

  • 終端重度使用者:習慣用 Vim/Tmux 工作,不想切換到 IDE 或瀏覽器
  • 指令碼自動化需求:需要在 CI/CD 或 Cron 任務中呼叫 AI 能力
  • 開源專案維護者:通過 GitHub Action 實現 PR 自動審查和 Issue 分類
  • 企業開發團隊:已有 Google Cloud 基礎設施,需要 Vertex AI 的企業級安全和合規特性

社群評價

暫無足量社群公開討論,以下為基於專案本身的中立評估:

從 GitHub 資料看,該專案在短時間內積累了超 10 萬 stars 和 685 名貢獻者,顯示出極高的關注度。每週二固定釋出 preview/stable 版本的節奏表明團隊工程化成熟。1355 個 open issues 中大部分是功能請求而非 bug 報告,說明核心功能穩定。官方文件站 geminicli.com 和 GitHub Action 整合顯示 Google 在認真運營該專案,而非實驗性質。

選型對比

vs GitHub Copilot CLI:

  • Gemini CLI 免費額度更高(1000次/天 vs Copilot 需訂閱),上下文視窗更大(100萬 vs 約10萬 token)
  • Copilot CLI 與 GitHub 生態整合更緊密,Gemini CLI 通過 MCP 擴充套件性更強
  • Gemini CLI 支援 Google 搜尋聯網和多模態輸入,Copilot 專注程式碼補全

vs 自建 LLM API 呼叫:

  • Gemini CLI 提供開箱即用的工具鏈(檔案操作/Shell執行),自建需手動封裝
  • 官方維護保證模型更新同步,自建需跟蹤 API 變更
  • 企業使用者可選 Vertex AI 獲得 SLA 保障

已知坑

  1. 網路依賴:OAuth 登入和 Google 搜尋功能在中國大陸需要特殊網路環境,建議直接用 API Key 認證
  2. 免費額度限制:個人賬號每天 1000 次請求看似充足,但大型程式碼庫分析或頻繁除錯可能超限,需監控用量
  3. MCP 服務端配置:擴充套件第三方工具需手動配置 MCP 伺服器,文件中示例較少,需參考社群案例
  4. Docker 映象體積:多階段構建後鏡像約 500MB,包含完整 Node.js 環境,不適合資源受限的邊緣裝置
  5. Windows 支援:README 未明確說明 Windows 相容性,從 Dockerfile 看主要針對 Linux/macOS,Windows 使用者建議用 WSL2

來源: GitHub 倉庫 google-gemini/gemini-cli + 官方文件 geminicli.com

安装方式：npm/npx/homebrew

← 浏览全部项目