欢迎来到 Gemini CLI 文档

本文档全面介绍了如何安装、使用和开发 Gemini CLI，这是一个通过命令行界面与 Gemini 模型进行交互的工具。

Gemini CLI 概述

Gemini CLI 在交互式的 Read-Eval-Print Loop (REPL) 环境中将 Gemini 模型的功能带到了您的终端。Gemini CLI 包括一个客户端应用程序（packages/cli），它与本地服务器（packages/core）通信，后者管理对 Gemini API 及其 AI 模型的请求。Gemini CLI 还包含多种工具，用于执行文件系统操作、运行 Shell 和网络抓取等任务，这些任务由 packages/core 管理。

阅读文档

本文档分为以下几部分：

概览

架构概览： 了解 Gemini CLI 的高级别设计，包括其组件及其交互方式。
贡献指南： 为贡献者和开发者提供信息，包括设置、构建、测试和编码约定。

快速开始

Gemini CLI 快速入门： 开始使用 Gemini CLI。
在 Gemini CLI 上使用 Gemini 3 Pro： 了解如何启用和使用 Gemini 3。
认证： 对 Gemini CLI 进行认证。
配置： 学习如何配置 CLI。
安装： 安装并运行 Gemini CLI。
示例： Gemini CLI 的使用示例。

CLI

…（此处原文未提供后续内容，故未翻译后续部分）

介绍：Gemini CLI： 命令行界面的概述。
命令： 可用 CLI 命令的描述。
检查点： 检查点功能的文档。
自定义命令： 创建您自己的命令和快捷方式，用于频繁使用的提示词。
企业版： 面向企业的Gemini CLI。
无头模式： 以编程方式使用Gemini CLI 进行脚本编写和自动化。
键盘快捷键： 所有键盘快捷键的参考，以提高您的工作效率。
模型选择： 使用 /model 选择处理命令的模型。
沙盒： 在安全的容器化环境中隔离工具执行。
设置： 使用 /settings 配置 CLI 的行为和外观的各个方面。
遥测： CLI 中遥测的概述。
主题： Gemini CLI 的主题。
令牌缓存： 令牌缓存和优化。
信任文件夹： 信任文件夹安全特性的概述。
教程： Gemini CLI 的教程。
卸载： 卸载Gemini CLI 的方法。

核心

介绍：Gemini CLI 核心： 关于Gemini CLI 核心的信息。
Memport： 使用内存导入处理器。
工具 API： 核心如何管理和公开工具的信息。
系统提示词覆盖： 使用 GEMINI_SYSTEM_MD 替换内置系统指令。
策略引擎： 使用策略引擎对工具执行进行细粒度控制。

工具

[工具部分未提供具体内容，故未翻译]

介绍：Gemini CLI 工具： 关于Gemini CLI 的工具信息。 文件系统工具： read_file 和 write_file 工具的文档。 Shell 工具： run_shell_command 工具的文档。 网络获取工具： web_fetch 工具的文档。 网络搜索工具： google_web_search 工具的文档。 内存工具： save_memory 工具的文档。 待办事项工具： write_todos 工具的文档。 MCP 服务器： 使用 MCP 服务器与Gemini CLI。

扩展

介绍：扩展： 如何用新功能扩展 CLI。 开始使用扩展： 学习如何构建自己的扩展。 扩展发布： 如何发布Gemini CLI 扩展。

钩子

钩子： 在关键生命周期点拦截和定制Gemini CLI 行为。 编写钩子： 通过一个全面的示例学习如何创建第一个钩子。 最佳实践： 针对钩子的安全性、性能和调试指南。

IDE 集成

IDE 集成介绍： 将 CLI 连接到您的编辑器。 IDE 伴侣扩展规范： 构建 IDE 伴侣扩展的规范。

开发

NPM： 有关项目包结构的详细信息。 发布： 关于项目的发布和部署节奏的信息。 更新日志： Gemini CLI 的重要亮点和值得注意的变更。 集成测试： 有关本项目使用的集成测试框架的信息。 问题和PR自动化： 我们用于管理和分类问题和拉取请求的自动化流程的详细概述。

支持

常见问题解答： 常见问题。
故障排除指南： 查找常见问题的解决方案。
配额和定价： 了解免费层级和付费选项。
服务条款和隐私声明： 有关适用于您使用 Gemini CLI 的服务条款和隐私声明的信息。

我们希望这份文档能帮助您充分利用 Gemini CLI！