主题
欢迎使用 Gemini CLI 文档
本文档提供了安装、使用和开发 Gemini CLI 的完整指南。Gemini CLI 是一个让你通过命令行界面与 Gemini 模型交互的工具。
Gemini CLI 概述
Gemini CLI 将 Gemini 模型的能力带到你的终端，提供交互式的读取-求值-打印循环（REPL）环境。Gemini CLI 由客户端应用程序（packages/cli）组成，它与本地服务器（packages/core）通信，后者管理对 Gemini API 及其 AI 模型的请求。Gemini CLI 还包含各种工具，用于执行文件系统操作、运行 shell 命令和网页获取等任务，这些都由 packages/core 管理。
快速开始
重要提示
如果不确定之前是否安装过，请先清空 ~/.gemini/ 目录下所有的文件，否则如果以前安装运行过，会导致 bug。
bash
rm -rf ~/.gemini/安装
bash
npm install -g @google/gemini-cli@latest环境变量配置
测试服务器：
bash
export GOOGLE_GEMINI_BASE_URL="https://api.leagsoft.com/"
export GEMINI_API_KEY="你的API密钥"正式服务器：
bash
export GOOGLE_GEMINI_BASE_URL="https://api.leagsoft.ai/"
export GEMINI_API_KEY="你的API密钥"将上述配置添加到配置文件后，重启终端：
bash
# macOS
source ~/.zshrc
# Linux
source ~/.bashrc启动
bash
gemini --yolo文档导航
本文档按以下部分组织：
概述
- 架构概述： 了解 Gemini CLI 的高层设计，包括其组件及其交互方式。
入门指南
- Gemini CLI 快速入门： 开始使用 Gemini CLI。
- 在 Gemini CLI 上使用 Gemini 3 Pro： 了解如何启用和使用 Gemini 3。
- 认证配置： 配置 Gemini CLI 的认证。
- 配置说明： 了解如何配置 CLI。
- 安装指南： 安装和运行 Gemini CLI。
- 使用示例： Gemini CLI 的使用示例。
CLI
- CLI 简介： 命令行界面概述。
- 命令参考： 可用 CLI 命令的描述。
- 检查点： 检查点功能文档。
- 自定义命令： 为常用提示创建自己的命令和快捷方式。
- 企业版： 企业版 Gemini CLI。
- 无头模式： 以编程方式使用 Gemini CLI 进行脚本和自动化。
- 快捷键： 所有快捷键参考，提高工作效率。
- 模型选择： 使用
/model选择处理命令的模型。 - 沙箱： 在安全的容器化环境中隔离工具执行。
- 设置： 使用
/settings配置 CLI 的各种行为和外观。 - 遥测： CLI 中的遥测概述。
- 主题： Gemini CLI 的主题。
- Token 缓存： Token 缓存和优化。
- 可信文件夹： 可信文件夹安全功能概述。
- 教程： Gemini CLI 教程。
- 卸载： 卸载 Gemini CLI 的方法。
核心模块
- 核心简介： 关于 Gemini CLI 核心的信息。
- 内存导入处理器： 使用内存导入处理器。
- 工具 API： 关于核心如何管理和暴露工具的信息。
- 系统提示词覆盖： 使用
GEMINI_SYSTEM_MD替换内置系统指令。 - 策略引擎： 使用策略引擎对工具执行进行细粒度控制。
工具
- 工具简介： 关于 Gemini CLI 工具的信息。
- 文件系统工具：
read_file和write_file工具文档。 - Shell 工具：
run_shell_command工具文档。 - 网页获取工具：
web_fetch工具文档。 - 网页搜索工具：
google_web_search工具文档。 - 记忆工具：
save_memory工具文档。 - 待办事项工具：
write_todos工具文档。 - MCP 服务器： 在 Gemini CLI 中使用 MCP 服务器。
扩展
钩子
IDE 集成
- IDE 集成简介： 将 CLI 连接到你的编辑器。
- IDE 伴侣扩展规范： 构建 IDE 伴侣扩展的规范。
支持
官方资源
希望本文档能帮助你充分利用 Gemini CLI！