Gemini CLI完全指南：Google开源终端AI Agent，免费额度用到爽

Google在2026年初开源了Gemini CLI，一个直接在终端中运行的AI Agent。与Claude Code、Codex类似，Gemini CLI让你可以在命令行中与AI对话、编写代码、执行任务，但它的免费额度非常慷慨，对个人开发者非常友好。

Gemini CLI是什么？

Gemini CLI是Google官方推出的开源终端AI工具。它把Gemini大模型的能力带到了命令行环境中，你可以用自然语言与它对话，让它帮你写代码、分析文件、执行shell命令、搜索网络等。

项目托管在GitHub的google-gemini组织下，使用Apache 2.0许可证开源。这意味着你可以自由使用、修改和分发。

核心特性

1. 免费使用：Gemini CLI对个人用户提供免费额度，不需要付费订阅。这对于预算有限的开发者来说是个大利好。免费额度包括每天的请求次数和token用量，足够日常开发使用。

2. 多模态支持：与纯文本的CLI工具不同，Gemini CLI支持图片输入。你可以截图、传图，让它分析UI设计、识别代码截图中的内容等。

3. 工具调用：Gemini CLI内置了多种工具能力：

• 文件读写：读取、创建、修改项目文件
• Shell执行：运行终端命令，查看输出
• 网络搜索：通过Google搜索获取实时信息
• 代码分析：理解项目结构，分析代码逻辑

4. MCP协议支持：Gemini CLI支持Model Context Protocol（MCP），可以连接各种外部工具和数据源。这意味着你可以扩展它的能力，接入数据库、API、自定义工具等。

5. 会话管理：支持多轮对话，保持上下文连续性。你可以在一个会话中逐步完成复杂任务，而不必每次都重新描述需求。

安装教程

前置条件

• Node.js 18+（推荐使用nvm管理版本）
• Google账号（用于免费额度认证）

安装步骤

方法一：npm全局安装

npm install -g @anthropic-ai/gemini-cli

抱歉，更正一下，正确的包名是：

npm install -g @google/gemini-cli

方法二：使用npx直接运行（不安装）

npx @google/gemini-cli

首次启动：

gemini

首次运行时，Gemini CLI会引导你完成Google账号认证。按提示在浏览器中登录Google账号并授权即可。

基础使用

代码编写

# 在项目目录下启动
cd my-project
gemini

# 然后用自然对话
> 帮我创建一个Express服务器，包含用户注册和登录接口
> 重构这个函数，用async/await替代回调
> 给这个模块写单元测试

文件操作

# 分析项目结构
> 分析一下这个项目的目录结构，告诉我主要模块是什么

# 批量修改
> 把所有文件中的var替换成const
> 给所有API接口添加错误处理

Shell命令

# 执行命令
> 查看当前目录下所有大文件
> 检查哪些端口正在被占用
> 查看git最近的提交记录

网络搜索

# 搜索技术问题
> 搜索一下Next.js 15的新特性
> 查找React Server Components的最佳实践

配置文件

Gemini CLI支持通过配置文件自定义行为。配置文件位于项目根目录的.gemini/文件夹下：

# .gemini/settings.json
{
  "model": "gemini-2.5-pro",
  "temperature": 0.7,
  "maxTokens": 8192
}

你还可以创建.gemini/rules文件来定义项目特定的行为规则，类似于.cursorrules或CLAUDE.md：

# .gemini/rules
这是一个Next.js项目，使用TypeScript。
代码风格遵循ESLint配置。
测试使用Jest和Testing Library。

与其他CLI Agent对比

实用技巧

1. 用它做代码审查：把PR的diff贴给Gemini CLI，让它分析潜在问题。

2. 批量重构：描述你想要的重构目标，让它自动修改多个文件。

3. 学习新技术：让它解释不熟悉的代码，或者生成某个框架的示例代码。

4. 调试助手：把报错信息贴给它，让它分析原因和解决方案。

5. 文档生成：让它读取代码后自动生成README、API文档等。

注意事项

– 免费额度有每日限制，重度使用可能需要搭配API Key

– 首次认证需要浏览器，在纯SSH环境中需要额外配置

– 对中文的支持较好，但英文提示通常效果更好

– 不要在包含敏感信息的项目中使用，代码会发送到Google服务器

GitHub仓库：https://github.com/google-gemini/gemini-cli