Gemini CLI

说明

**免费套餐和 Google One 用户：**Gemini CLI 已于 June 18th, 2026 被 Antigravity CLI 替代。了解详情，请参阅我们的 博客文章。

**Gemini CLI 尚未针对 Gemini 4 Argon 进行优化。**如需使用 Gemini 4 Argon，请使用 Antigravity。

Gemini CLI

说明

Gemini CLI 未针对最新 Gemini 模型进行优化。若要使用 Gemini 模型获得最佳编码 体验，请使用 Antigravity CLI

Gemini CLI 是一款开源 AI Agent，可将 Gemini 的强大功能直接带入终端。它以轻量的方式 提供 Gemini 访问能力，让你能以最直接的方式将提示词发送给我们的模型。

在我们的文档中了解 Gemini CLI 的全部内容。

📦 安装

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

Nightly 版

• 每天 UTC 00:00 发布新版本，包含发布时主分支中的所有更改。请预期仍有待完成的验证 和待解决的问题。使用 nightly 标签。

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

📋 主要功能

代码理解与生成

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

自动化与集成

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

🔐 身份验证选项

选择最符合你需求的身份验证方式：

选项 1：使用 Google 登录（通过 Google 帐户进行 OAuth 登录）

使用组织提供的付费 Code Assist 许可证时，请记得设置 Google Cloud Project

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

选项 2：Gemini API 密钥

✨ 最适合： 需要精确控制模型或使用付费层级的开发者

优势：

• 模型选择： 选择特定的 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 CLI 针对最新的 Gemini 模型进行了优化。若要获得最佳的 Gemini 模型编码体验，请使用 Antigravity CLI

基本用法

在当前目录中启动

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 License 2.0
• 服务条款： 条款与隐私
• 安全：安全政策

---

由 Google 和开源社区倾力打造 ❤️