Gemini CLI 是 Google 开源的 AI 终端工具，将 Gemini 模型直接带入命令行环境。个人 Google 账号可免费使用（60次/分钟，1000次/天），支持 100 万 token 超长上下文。本站收录完整中文文档，从安装到进阶工作流一站式覆盖。

Gemini CLI 中文文档

Gemini CLI 是 Google 发布的开源 AI 终端工具，让你可以在命令行里直接使用 Gemini 模型。它内置了文件读写、Shell 命令执行、Google 搜索、网页抓取等工具，并支持通过 MCP 接入更多第三方服务。

为什么选择 Gemini CLI？

• 免费额度慷慨：个人 Google 账号每分钟 60 次、每天 1000 次请求，完全免费
• 超长上下文：Gemini 3 模型支持 100 万 token，处理整个代码库不在话下
• 内置工具完善：Google Search 接地气、文件操作、Shell 命令、网页抓取，开箱即用
• MCP 扩展支持：通过 Model Context Protocol 接入自定义工具和数据源
• 开源 Apache 2.0：源码在 github.com/google-gemini/gemini-cli

快速开始

# 无需安装，直接运行
npx @google/gemini-cli

# 或全局安装
npm install -g @google/gemini-cli
gemini

文档导航

入门指南

• 快速开始 — 安装、认证、第一次使用
• 安装方式详解 — npx / npm / Homebrew / 源码构建
• 认证配置 — Google 账号 / API Key / Vertex AI

命令参考

• CLI 命令速查表 — 所有命令、参数、交互命令汇总
• 配置项参考 — settings.json 完整字段说明
• GEMINI.md 上下文文件 — 类似 Claude Code 的 CLAUDE.md

功能教程

• 文件管理 — 读写、批量处理本地文件
• Shell 命令执行 — 安全执行系统命令
• 会话与历史 — 恢复会话、管理历史
• MCP 服务器接入 — 接入第三方工具和数据源
• Skills 工作流 — 封装可复用的专业工作流
• Web 搜索与抓取 — Google 搜索接地气 + 网页内容获取
• Plan Mode 任务规划 — 复杂任务的分步执行模式
• 自动记忆（Auto Memory） — AI 自动积累上下文知识

常见问题

• 已知问题总索引 — 社区踩坑经验汇总

常见问题

Q: Gemini CLI 和 Claude Code 有什么区别？

A: Gemini CLI 使用 Google Gemini 模型，免费额度更高（每天 1000 次）且完全开源；Claude Code 使用 Anthropic Claude 模型，在代码编辑和多文件重构方面体验更流畅。两者都支持 MCP 扩展，可以根据需要配合使用。

Q: Gemini CLI 支持中文吗？

A: 支持。Gemini 模型本身支持中文，日常中文对话、中文代码注释、中文文档生成均可使用。

Q: 国内能正常使用 Gemini CLI 吗？

A: 需要能访问 Google 服务的网络环境（代理或 VPN）。如果有 Google AI Studio 的 API Key，也可通过 API Key 方式接入，部分中转服务可以绕过网络限制。