英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

双子座 CLI

双子座 CLI 是一个开源 AI 代理，将双子座的强大功能直接带入你的终端。它提供轻量级访问双子座的方式，为你从提示到模型提供最直接的路径。

在我们的文档中了解有关双子座 CLI 的所有信息。

🚀 为什么选择 Gemini CLI？

• 🎯 免费套餐：使用个人谷歌账户，每分钟 60 次请求，每天 1,000 次请求。
• 🧠 强大的双子座 3 模型：访问改进的推理能力和 1M 令牌上下文窗口。
• 🔧 内置工具：谷歌搜索基础、文件操作、Shell 命令、网页抓取。
• 🔌 可扩展：支持 MCP（模型上下文协议）进行自定义集成。
• 💻 终端优先：为习惯在命令行环境中工作的开发者设计。
• 🛡️ 开源：采用 Apache 2.0 许可证。

📦 安装

请参阅 Gemini 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

发布渠道

有关更多详细信息，请参见 发布说明。

预览

新的预览版本将于每周二 UTC 时间 23:59 发布。这些版本尚未经过全面验证，可能包含回归或其他未解决的问题。请帮助我们进行测试并使用 preview 标签安装。

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

稳定

• 新的稳定版本将于每周二 UTC 20:00 发布，这将是对上周 preview 版本的完整推广，包括任何错误修复和验证。使用 latest 标签。

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

夜间构建

• 新版本将于每天的 UTC 00:00 发布。这将包括从主分支在发布时的所有更改。应假设存在待验证和问题。使用 nightly 标签。

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

📋 主要功能

代码理解与生成

• 查询和编辑大型代码库
• 使用多模态功能从PDF、图像或草图生成新应用
• 使用自然语言调试问题和排除故障

自动化与集成

• 自动化操作任务，如查询拉取请求或处理复杂的变基
• 使用MCP服务器连接新功能，包括使用Imagen、Veo或Lyria进行媒体生成
• 在脚本中非交互式运行以实现工作流自动化

高级功能

• 通过内置的Google搜索为查询提供实时信息支持
• 会话检查点以保存和恢复复杂会话
• 自定义上下文文件（GEMINI.md）以为项目定制行为

GitHub集成

通过Gemini CLI GitHub Action将Gemini CLI直接集成到GitHub工作流

• 拉取请求审核：提供带上下文的自动化代码审核和建议
• 问题分类：根据内容分析自动标记和优先排序GitHub问题
• 按需帮助：在问题和拉取请求中提及 @gemini-cli，以获取调试、解释或任务分配帮助
• 自定义工作流：构建适合团队需求的自动化、定时或按需工作流

🔐 认证选项

选择最适合您需求的身份验证方法：

选项 1：使用 Google 登录（通过您的 Google 账号进行 OAuth 登录）

✨ 最适合: 个人开发者以及拥有 Gemini Code Assist 许可证的任何人。（详情请参阅 配额限制和服务条款）

优势:

• 免费套餐：每分钟 60 次请求，每天 1,000 次请求
• Gemini 3 模型，支持 1M 令牌上下文窗口
• 无需管理 API 密钥 - 只需使用您的 Google 账号登录
• 自动更新至最新模型

启动 Gemini CLI，然后选择 使用 Google 登录，并在提示时按照浏览器身份验证流程操作

gemini

如果您正在使用来自您组织的付费 Code Assist 许可证，请记得设置 Google 云项目

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

选项 2：Gemini API 密钥

✨ 适合: 需要特定模型控制或付费等级访问的开发者

好处:

• 免费等级：每天 1000 次请求，可使用 Gemini 3（闪电版和专业版混合）
• 模型选择：选择特定 Gemini 模型
• 按使用计费：在需要时升级以获得更高的限制

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

选项 3：Vertex AI

✨ 最适合： 企业团队和生产工作负载

优点：

• 企业功能：高级安全性和合规性
• 可扩展性：使用计费账户可获得更高的速率限制
• 集成：可与现有的 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 帐户和其他身份验证方法，请参阅 身份验证指南。

🚀 入门

基本用法

在当前目录启动

gemini

包含多个目录

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

使用特定模型

gemini -m gemini-2.5-flash

脚本的非交互模式

获取简单的文本响应：

gemini -p "Explain the architecture of this codebase"

对于更高级的脚本编写，包括如何解析 JSON 和处理错误，请使用 --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

📚 文档

入门指南

• 快速开始指南 - 快速运行和使用。
• 身份验证设置 - 详细的认证配置。
• 配置指南 - 设置与自定义。
• 键盘快捷键 - 提高效率的小技巧。

核心功能

• 命令参考 - 所有斜杠命令（/help、/chat 等）。
• 自定义命令 - 创建你自己的可重用命令。
• 上下文文件 (GEMINI.md) - 为 Gemini CLI 提供持久化上下文。
• 检查点功能 - 保存并恢复对话。
• 令牌缓存 - 优化令牌使用。

工具与扩展

• 内置工具概览
  • 文件系统操作
  • Shell 命令
  • 网页抓取与搜索
• MCP 服务器集成 - 使用自定义工具扩展功能。
• 自定义扩展 - 构建并分享你自己的命令。

高级主题

• 无头模式 (脚本化) - 在自动化工作流中使用 Gemini CLI。
• IDE 集成 - VS Code 插件。
• 沙箱与安全 - 安全执行环境。
• 受信任文件夹 - 通过文件夹控制执行策略。
• 企业指南 - 在企业环境中部署和管理。
• 遥测与监控 - 使用情况跟踪。
• 工具参考 - 内置工具概览。
• 本地开发 - 本地开发工具。

故障排除与支持

• 故障排除指南 - 常见问题和解决方案。
• 常见问题解答 - 常见问题。
• 使用 /bug 命令可直接从 CLI 报告问题。

使用 MCP 服务器

在 ~/.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 服务器集成指南 获取安装说明。

🤝 贡献

我们欢迎贡献！Gemini CLI 完全开源（Apache 2.0），我们鼓励社区：

• 报告错误并提出功能建议。
• 改进文档。
• 提交代码改进。
• 分享您的 MCP 服务器和扩展。

请参阅我们的 贡献指南 了解开发环境设置、编码标准以及如何提交拉取请求。

查看我们的 官方路线图 了解计划中的功能和优先事项。

📖 资源

• 免费课程 - 学习基础知识。
• 官方路线图 - 查看接下来的计划。
• 更新日志 - 查看近期的重要更新。
• NPM 包 - 包注册表。
• GitHub 问题 - 报告错误或请求功能。
• 安全公告 - 安全更新。

卸载

查看卸载指南了解卸载说明。

📄 法律

• 许可：Apache 许可证 2.0
• 服务条款：条款与隐私
• 安全：安全政策

由 Google 和开源社区 ❤️ 制作