Google Gemini CLI 完整使用指南

在人工智能技术日益普及的今天，如何高效地将 AI 能力融入日常开发工作流成为开发者关注的焦点。Google Gemini CLI 作为一款开源的 AI Agent 工具，将强大的 Gemini 模型能力直接带入终端环境，为开发者提供了智能化的编码与文件操作体验。它不仅仅是一个简单的对话工具，而是一个具备完整推理能力的智能代理，能够理解上下文、执行命令、操作文件，帮助开发者完成从代码分析到功能实现的多种任务。

环境配置与安装

Gemini CLI 的核心竞争力在于其 ReAct（推理-行动）循环机制。该机制使其能够自主分析任务、规划执行步骤并完成具体操作。在功能层面，它支持读取、分析和修改本地文件和代码库，执行带权限控制的 Shell 命令，调用 Google Search 进行联网搜索，抓取网页内容，并通过 MCP 协议连接外部工具。更值得一提的是，它能够理解图片、PDF、音频、视频等多模态输入，这大大扩展了其应用场景。凭借慷慨的免费额度——个人 Google 账号每天 1000 次请求、每分钟 60 次——以及支持 100 万 Token 上下文窗口的 Gemini 3 模型，Gemini CLI 为开发者提供了极具性价比的 AI 辅助开发方案。

认证方式与核心使用

认证方式是使用 Gemini CLI 的关键环节。个人开发者推荐使用 Google 账号 OAuth 认证，简单易用且完全免费；生产环境则可选择 Gemini API Key（付费）或 Vertex AI（企业级）。特别需要注意的是，如果设置了 GOOGLE_API_KEY、GEMINI_API_KEY 或 GOOGLE_GENAI_USE_VERTEXAI 环境变量，系统会优先使用这些变量对应的付费 API 通道。在日常使用中，用户可以通过交互式会话直接与 CLI 对话，也可以使用 -p 参数进行非交互式执行。Gemini CLI 提供了丰富的内置命令（斜杠命令），如 /clear 清空对话历史、/chat save 保存会话、/model 切换模型、/settings 打开配置编辑器等。@ 文件引用机制允许将文件或目录内容注入上下文，而 ! 前缀则可直接执行 Shell 命令。

Gemini CLI 的高级功能极大地提升了开发效率。Plan 模式（--approval-mode plan）允许先规划后执行，避免意外修改文件；Checkpointing 功能（--checkpointing）在每次工具调用前自动保存快照，配合 /rewind 命令可随时回退，有效防止重要操作失误。MCP（Model Context Protocol）协议支持连接外部工具和服务，如 GitHub、数据库、文件系统等，实现更强大的扩展能力。对于大型项目，/init 命令可自动分析项目结构并生成 GEMINI.md 上下文文件，配合 .geminiignore 排除敏感目录，实现精准的上下文管理。

高级功能与最佳实践

在实际工作流中，Gemini CLI 展现出强大的实用性。开发新功能时，可先使用 Plan 模式制定详细计划，确认后再切换到执行模式；修复 Bug 时，配合 Checkpointing 功能自动保存快照，确保可以随时回滚；代码重构时，利用 Flash 模型进行快速探索以节省成本，完成复杂实现时再切换到 Pro 模型。此外，通过自定义斜杠命令可以封装常用提示词，多目录工作区功能支持跨仓库引用，这些特性使其成为团队协作的得力助手。

如有侵权，请联系删除。