# @google/gemini-cli 中文文档

规范地址：https://npmcn.com/package/%40google/gemini-cli/

版本：0\.68\.0
npm 元数据更新时间：2026-11-10T21:22:49.497Z
中文译文更新时间：2026-11-16T19:45:09.783Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40google/gemini-cli
原文对照：https://npmcn.com/package/%40google/gemini-cli/?lang=original
项目主页：https://github.com/google-gemini/gemini-cli#readme
源码仓库：https://github.com/google-gemini/gemini-cli

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：99.1 MB，449 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2025-06-25T13:03:27.977Z
- 最新版本发布：2026-11-10T21:22:49.277Z
- 近 30 天下载量：1789160（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：810（近 12 个月 526 个）

## 中文简介

双子座CLI

## 安装

```sh
npm install @google/gemini-cli
```

也可以使用：`pnpm add @google/gemini-cli`、`yarn add @google/gemini-cli`、`bun add @google/gemini-cli`

## README

# 双子座CLI

[![Gemini CLI CI](https://github.com/google-gemini/gemini-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/google-gemini/gemini-cli/actions/workflows/ci.yml) [![Gemini CLI E2E (Chained)](https://github.com/google-gemini/gemini-cli/actions/workflows/chained_e2e.yml/badge.svg)](https://github.com/google-gemini/gemini-cli/actions/workflows/chained_e2e.yml) [![Version](https://img.shields.io/npm/v/@google/gemini-cli)](https://www.npmjs.com/package/@google/gemini-cli) [![License](https://img.shields.io/github/license/google-gemini/gemini-cli)](https://github.com/google-gemini/gemini-cli/blob/main/LICENSE) [![View Code Wiki](https://assets.codewiki.google/readme-badge/static.svg)](https://codewiki.google/github.com/google-gemini/gemini-cli?utm_source=badge&utm_medium=github&utm_campaign=github.com/google-gemini/gemini-cli)

> \[大 **安装前读取——双子座 CLI 状态和工具指南**
> 
> -   **企业代码只协助:** 设计用途 **双子密码辅助标准/企业** 许可证和 **GitHub 代码辅助** 在Google Cloud上(您的访问权限保持不变).
> -   **没有免费等级或谷歌AI计划:** 个人免费使用和 **Google AI Pro / Ultra (英语)** (Google 1) 移动到 [反重力CLI](https://antigravity.google/product/antigravity-cli) 2026年6月18日 (中文(简体) )[过渡后](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/)) (中文(简体) ).
> -   **未优化双子座 4+ :** 没有调制 **双子座4** 系列(例如, [双子座4 Argon](https://blog.google/innovation-and-ai/models-and-research/gemini-models/gemini-4-argon/)或未来在今世或后世释放.
> -   **不用于示范基准:** 不要用双子座CLI来作为双子座模型的基准——它的取材不为双子座4+调取并产生无代表性分数.
> 
> **你需要哪个谷歌CLI?**
> 
> | 工具 | 最好还是 | 链接 |
> | :-- | :-- | :-- |
> | **[反重力CLI](https://antigravity.google/product/antigravity-cli)** (单位:千美元)`agy`(中文(简体) ) | 交互式多代理编码终端. 用于 **双子座4 Argon**+, 免费 / **谷歌 AI Pro & Ultra** 账户,或谷歌云. | [下载](https://antigravity.google/download) • 妇女 [迁移](https://antigravity.google/docs/cli/gcli-migration) • 妇女 [阿尔贡站](https://antigravity.google/blog/gemini-4-argon-in-google-antigravity) |
> | **[双子座 API CLI](https://github.com/google-gemini/gemini-api-cli)** (单位:千美元)`gemini-api`(中文(简体) ) | 无国籍人 API CPI _(不是一个编码带)_给予代理人(`agy`, Claude Code, Codex),脚本,和CI直接命令双子座模型,介质基因,文件分析,以及管理的代理. | [GitHub 图像](https://github.com/google-gemini/gemini-api-cli) • 妇女 [释放](https://github.com/google-gemini/gemini-api-cli/releases) • 妇女 [API 文件](https://ai.google.dev/gemini-api/docs) |
> | **双子座CLI** (单位:千美元)`gemini`, (中文(简体) ), _此还原_(中文(简体) ) | 组织 **双子密码辅助标准/企业** 或者说 **GitHub 代码辅助** 在Google Cloud上搜索到的图像 _(加上已支付的API / Vertex 密钥)_。 。 。 . | [文档](https://geminicli.com/docs/) |

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

## \* 安装

见 [双子体CLI的安装、执行和释放](https://www.geminicli.com/docs/get-started/installation) 建议的系统规格和详细的安装指南.

### 快速安装

#### Npx 立即运行

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

#### 用 npm 在全球安装

```bash
npm install -g @google/gemini-cli
```

#### 在全球安装Homebrew(macOS/Linux)

```bash
brew install gemini-cli
```

#### 在全球安装 MacPorts (macOS)

```bash
sudo port install gemini-cli
```

#### 安装 Anaconda (用于限制环境)

```bash
# 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
```

## 释放频道

见 [释放](https://www.geminicli.com/docs/changelogs) 更多细节.

### 预览

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

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

### 稳定

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

```bash
npm install -g @google/gemini-cli@latest
```

### 夜来

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

```bash
npm install -g @google/gemini-cli@nightly
```

## 关键特性

### 代码理解生成( G)

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

### 自动化和整合

-   自动操作任务, 如查询拉动请求或处理复杂程序 重新基数
-   使用 MCP 服务器连接新的能力,包括 [有图像、 Veo 或 Lyria 的媒体生成](https://github.com/GoogleCloudPlatform/vertex-ai-creative-studio/tree/main/experiments/mcp-genmedia)
-   为工作流程自动化在脚本中进行非交互运行

## QQ 认证选项

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

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

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

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

### 选项2:双子座 API 密钥

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

**福利:**

-   **模型选择**: 选择特定的双子座模型
-   **使用费计费**: 必要时升级以达到更高的限度

```bash
# Get your key from https://aistudio.google.com/apikey
export GEMINI_API_KEY="YOUR_API_KEY"
gemini
```

### 备选案文3:大赦国际

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

**福利:**

-   **企业特征**高级安保和合规
-   **可缩放**: 记账账户利率限额较高
-   **一体化**: 现有谷歌云基础设施的工程

```bash
# Get your key from Google Cloud Console
export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini
```

关于谷歌工作空间账户和其他认证方法,见 [认证指南](https://www.geminicli.com/docs/get-started/authentication)。 。 。 .

## 开始

### 基本用途

#### 在当前目录中开始

```bash
gemini
```

#### 包含多个目录

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

#### 使用特定模式

```bash
gemini -m gemini-2.5-flash
```

#### 脚本的非交互模式

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

```bash
gemini -p "Explain the architecture of this codebase"
```

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

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

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

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

### 快速示例

#### 启动新项目

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

#### 分析现有代码

```bash
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

### 开始

-   [**快速启动指南**](https://www.geminicli.com/docs/get-started) - 起来 跑快点.
-   [**认证设置**](https://www.geminicli.com/docs/get-started/authentication) - 说吧 详细认证配置 .
-   [**配置指南**](https://www.geminicli.com/docs/reference/configuration) - 说吧 设置与定制.
-   [**键盘快捷键**](https://www.geminicli.com/docs/reference/keyboard-shortcuts) - 说吧 生产力小费.

### 核心特征

-   [**图标参考**](https://www.geminicli.com/docs/reference/commands) - 说吧 所有斜线命令( A)`/help`, (中文(简体) ), `/chat`(见e/cn.4/sub.2/2002/l.48等).
-   [**自定义命令**](https://www.geminicli.com/docs/cli/custom-commands) - 说吧 创建自己的可重复使用的命令 .
-   [**上下文文件 (GEMINI.md)**](https://www.geminicli.com/docs/cli/gemini-md) - 说吧 向双子座CLI提供持久的上下文.
-   [**检查**](https://www.geminicli.com/docs/cli/checkpointing) - 留着 并恢复对话.
-   [**Token 缓存**](https://www.geminicli.com/docs/cli/token-caching) - 说吧 优化符用.

### 工具扩展( S)

-   [**内建工具概览**](https://www.geminicli.com/docs/reference/tools)
    -   [文件系统操作](https://www.geminicli.com/docs/tools/file-system)
    -   [贝壳命令](https://www.geminicli.com/docs/tools/shell)
    -   [网络获取搜索( S)](https://www.geminicli.com/docs/tools/web-fetch)
-   [**MCP 服务器集成**](https://www.geminicli.com/docs/tools/mcp-server) - 说吧 以自定义工具扩展 .
-   [**自定义扩展名**](https://geminicli.com/docs/extensions/writing-extensions) - 说吧 构建并共享您自己的命令 .

### 高级主题

-   [**无头模式( 脚本)**](https://www.geminicli.com/docs/cli/headless) - 说吧 在自动化工作流程中使用双子座CLI.
-   [**IDE 整合**](https://www.geminicli.com/docs/ide-integration) - VS (英语) 代码伴.
-   [**沙箱安全( S)**](https://www.geminicli.com/docs/cli/sandbox) - 安全吗 执行环境.
-   [**信任的文件夹**](https://www.geminicli.com/docs/cli/trusted-folders) - 说吧 通过文件夹控制执行策略 .
-   [**企业指南**](https://www.geminicli.com/docs/cli/enterprise) - 部署 并在公司环境中进行管理.
-   [**遥测和监测**](https://www.geminicli.com/docs/cli/telemetry) - 说吧 用法追踪.
-   [**工具参考**](https://www.geminicli.com/docs/reference/tools) - 说吧 内建工具概述.
-   [**地方发展**](https://www.geminicli.com/docs/local-development) - 说吧 地方发展工具.

### 解决问题和支持( S)

-   [**解决问题指南**](https://www.geminicli.com/docs/resources/troubleshooting) - 说吧 共同的问题和解决办法.
-   [**财务问题**](https://www.geminicli.com/docs/resources/faq) - 经常问 问.
-   使用 `/bug` 命令直接从 CLI 报告问题.

### 使用 MCP 服务器

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

```text
> @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 服务器集成指南](https://www.geminicli.com/docs/tools/mcp-server) 用于设置指令.

## 捐款

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

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

看我们的 [贡献指南](https://npmcn.com/package/%40google/gemini-cli/CONTRIBUTING.md) 用于开发设置、编码 标准,以及如何提交拉动请求.

检查我们 [正式路线图](https://github.com/orgs/google-gemini/projects/11) (c) 规划的特征和优先事项.

## 资源

-   **[免费课程](https://learn.deeplearning.ai/courses/gemini-cli-code-and-create-with-an-open-source-agent/information)** - 说吧 学道入道.
-   **[正式路线图](https://npmcn.com/package/%40google/gemini-cli/ROADMAP.md)** - 看接下来会怎样.
-   **[更改日志](https://www.geminicli.com/docs/changelogs)** -见最近 值得注意的最新情况.
-   **[国家防范机制一揽子计划](https://www.npmjs.com/package/@google/gemini-cli)** - 包裹 登记.
-   **[GitHub 问题](https://github.com/google-gemini/gemini-cli/issues)** - 说吧 报告错误或请求特性 .
-   **[安保顾问](https://github.com/google-gemini/gemini-cli/security/advisories)** - 说吧 安保最新消息.

### 卸载

见 [卸载指南](https://www.geminicli.com/docs/resources/uninstall) 用于清除指令.

## · 法律

-   **许可证**数字 : [Apache 许可证 2.0](https://npmcn.com/package/%40google/gemini-cli/LICENSE)
-   **服务条件**数字 : [术语和隐私](https://www.geminicli.com/docs/resources/tos-privacy)
-   **警卫**数字 : [安全政策](https://npmcn.com/package/%40google/gemini-cli/SECURITY.md)

[![Star History Rank](https://api.star-history.com/badge?repo=google-gemini/gemini-cli)](https://www.star-history.com/google-gemini/gemini-cli)

* * *

由Google和开源社区共同创建

## 常见问题

### @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 和提交记录判断。

