@google/gemini-cli

中文文档
0.68.0发布于 2026/11/11Apache-2.0ES Module零依赖近 30 天下载 178.9万

双子座CLI

中文使用文档
文档目录27 节
  1. * 安装
  2. 快速安装
  3. 释放频道
  4. 预览
  5. 稳定
  6. 夜来
  7. 关键特性
  8. 代码理解生成( G)
  9. 自动化和整合
  10. QQ 认证选项
  11. 选项1: 与 Google 签名( OAuth 登录使用您的 Google 账户)
  12. 选项2:双子座 API 密钥
  13. 备选案文3:大赦国际
  14. 开始
  15. 基本用途
  16. 快速示例
  17. 页:1
  18. 开始
  19. 核心特征
  20. 工具扩展( S)
  21. 高级主题
  22. 解决问题和支持( S)
  23. 使用 MCP 服务器
  24. 捐款
  25. 资源
  26. 卸载
  27. · 法律

双子座CLI

Gemini CLI CI Gemini CLI E2E (Chained) Version License View Code Wiki

[大 安装前读取——双子座 CLI 状态和工具指南

  • 企业代码只协助: 设计用途 双子密码辅助标准/企业 许可证和 GitHub 代码辅助 在Google Cloud上(您的访问权限保持不变).
  • 没有免费等级或谷歌AI计划: 个人免费使用和 Google AI Pro / Ultra (英语) (Google 1) 移动到 反重力CLI 2026年6月18日 (中文(简体) )过渡后) (中文(简体) ).
  • 未优化双子座 4+ : 没有调制 双子座4 系列(例如, 双子座4 Argon或未来在今世或后世释放.
  • 不用于示范基准: 不要用双子座CLI来作为双子座模型的基准——它的取材不为双子座4+调取并产生无代表性分数.

你需要哪个谷歌CLI?

工具最好还是链接
反重力CLI (单位:千美元)agy(中文(简体) )交互式多代理编码终端. 用于 双子座4 Argon+, 免费 / 谷歌 AI Pro & Ultra 账户,或谷歌云.下载 • 妇女 迁移 • 妇女 阿尔贡站
双子座 API CLI (单位:千美元)gemini-api(中文(简体) )无国籍人 API CPI (不是一个编码带)给予代理人(agy, Claude Code, Codex),脚本,和CI直接命令双子座模型,介质基因,文件分析,以及管理的代理.GitHub 图像 • 妇女 释放 • 妇女 API 文件
双子座CLI (单位:千美元)gemini, (中文(简体) ), 此还原(中文(简体) )组织 双子密码辅助标准/企业 或者说 GitHub 代码辅助 在Google Cloud上搜索到的图像 (加上已支付的API / Vertex 密钥)。 。 。 .文档

双子座CLI(gemini)是为企业维护的开源终端代理 双子座代码协助Google Cloud上的工作流程. 学多一点 双子座 CLI 文档。 。 。 .

* 安装

见 双子体CLI的安装、执行和释放 建议的系统规格和详细的安装指南.

快速安装

Npx 立即运行

# Using npx (no installation required)
npx @google/gemini-cli

用 npm 在全球安装

npm install -g @google/gemini-cli

在全球安装Homebrew(macOS/Linux)

brew install gemini-cli

在全球安装 MacPorts (macOS)

sudo port install gemini-cli

安装 Anaconda (用于限制环境)

# Create and activate a new environment
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env

# Install Gemini CLI globally via npm (inside the environment)
npm install -g @google/gemini-cli

释放频道

见 释放 更多细节.

预览

每周二UTC23:59发布新的预览版. 这些 释放将未经充分审查,可能包含回归或其他 尚未解决的问题。 帮我们测试安装 preview 标签.

npm install -g @google/gemini-cli@preview

稳定

  • 每周二 UTC20:00发布新的稳定版本 上个礼拜将全面推广 preview 释放 + 任何错误修正 和验证。 使用 latest 标签.
npm install -g @google/gemini-cli@latest

夜来

  • 每日UTC00:00发布新版. 这将是所有的变化 由释放时代表的主要分支机构提交。 应该假设 还有一些有待审定的问题。 使用 nightly 标签.
npm install -g @google/gemini-cli@nightly

关键特性

代码理解生成( G)

  • 查询并编辑大型代码库
  • 利用多模式能力从 PDF 、 图像或草图生成新应用程序
  • 调试问题和自然语言故障

自动化和整合

  • 自动操作任务, 如查询拉动请求或处理复杂程序 重新基数
  • 使用 MCP 服务器连接新的能力,包括 有图像、 Veo 或 Lyria 的媒体生成
  • 为工作流程自动化在脚本中进行非交互运行

QQ 认证选项

选择最适合您需要的认证方法 :

选项1: 与 Google 签名( OAuth 登录使用您的 Google 账户)

当使用您组织的付费代码协助许可时, 请记住设置 Google Cloud 项目

# Set your Google Cloud Project
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
gemini

选项2:双子座 API 密钥

最佳服务: 需要特定模型控制或付费级访问的开发者

福利:

  • 模型选择: 选择特定的双子座模型
  • 使用费计费: 必要时升级以达到更高的限度
# Get your key from https://aistudio.google.com/apikey
export GEMINI_API_KEY="YOUR_API_KEY"
gemini

备选案文3:大赦国际

最佳服务: 企业团队和生产工作量

福利:

  • 企业特征高级安保和合规
  • 可缩放: 记账账户利率限额较高
  • 一体化: 现有谷歌云基础设施的工程
# Get your key from Google Cloud Console
export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

关于谷歌工作空间账户和其他认证方法,见 认证指南。 。 。 .

开始

基本用途

在当前目录中开始

gemini

包含多个目录

gemini --include-directories ../lib,../docs

使用特定模式

gemini -m gemini-2.5-flash

脚本的非交互模式

获得一个简单的文本响应 :

gemini -p "Explain the architecture of this codebase"

对于更先进的脚本,包括如何解析 JSON 和处理错误,使用 页:1 --output-format json 要获得结构化输出的旗帜 :

gemini -p "Explain the architecture of this codebase" --output-format json

用于实时活动流(用于监测长期运行), 使用情况 --output-format stream-json 获取新线限定 JSON 事件:

gemini -p "Run tests and deploy" --output-format stream-json

快速示例

启动新项目

cd new-project/
gemini
> Write me a Discord bot that answers questions using a FAQ.md file I will provide

分析现有代码

git 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

页:1

开始

核心特征

工具扩展( S)

高级主题

解决问题和支持( S)

使用 MCP 服务器

配置 MCP 服务器 ~/.gemini/settings.json 以 自定义工具 :

> @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 服务器集成指南 用于设置指令.

捐款

我们欢迎捐款! 双子座 CLI 完全开源( Apache 2. 0), 我们 鼓励社区:

  • 报告错误并推荐特征.
  • 改进文件编制.
  • 提交代码改进 .
  • 共享您的 MCP 服务器和扩展 .

看我们的 贡献指南 用于开发设置、编码 标准,以及如何提交拉动请求.

检查我们 正式路线图 (c) 规划的特征和优先事项.

资源

卸载

见 卸载指南 用于清除指令.

Star History Rank


由Google和开源社区共同创建

版本与发布记录

@google/gemini-cli 共发布 810 个版本,首次发布于 2025/06/25;过去 12 个月发布了 526 个版本。

版本发布日期距今
0.68.0latest2026/11/115 天前
0.69.0-preview.0preview2026/11/115 天前
0.67.02026/11/0511 天前
0.68.0-preview.02026/11/0512 天前
0.67.0-nightly.20261104.g89e9d25d6nightly2026/11/0412 天前
0.67.0-nightly.20261103.g0ac57c0292026/11/0313 天前

其他发布通道:false → 0.42.0-nightly.20260512.g11a9edc80,nightly → 0.67.0-nightly.20261104.g89e9d25d6,preview → 0.69.0-preview.0。

关于 @google/gemini-cli 的常见问题

@google/gemini-cli 是什么?

双子座CLI

如何安装 @google/gemini-cli?

在项目目录运行 npm install @google/gemini-cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 gemini,可以用 npx gemini 直接运行。

@google/gemini-cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/google__gemini-cli 是否存在。

@google/gemini-cli 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@google/gemini-cli 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@google/gemini-cli 可以商用吗?

@google/gemini-cli 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@google/gemini-cli 的下载量有多少?

根据 npm 官方下载统计,@google/gemini-cli 在 2026/10/17 – 2026/11/15 这 30 天内被下载 1,789,160 次,日均约 59,639 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@google/gemini-cli 还在维护吗?

最新版本 0.68.0 发布于 2026/11/11(5 天前);至今共发布 810 个版本,其中过去 12 个月发布了 526 个;首次发布于 2025/06/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。