全网最火的Google Gemini CLI，详细安装图文教程来了

什么是 Gemini CLI？

Gemini CLI 是由 Google Gemini 团队开源的一款命令行 AI 工具，专为开发者设计。它能够理解代码、执行复杂查询、自动化任务，并利用 Gemini 的多模态能力（如图像识别）生成创意内容。GitHub 地址：https://github.com/google-gemini/gemini-cli

     
主要功能亮点：

• 处理大型代码库 ：支持超过 100 万个 token 上下文长度，轻松分析大型项目。
• 多模态应用生成 ：通过 PDF 或草图快速生成应用程序原型。
• 自动化运维任务 ：如 Git 操作、PR 查询、代码迁移计划制定等。
• 集成外部工具 ：通过 MCP 服务器连接 Imagen、Veo、Lyria 等媒体生成模型。
• 联网搜索支持 ：内置 Google Search，确保回答基于最新信息。

如何安装 Gemini CLI？

前提条件

已安装 Node.js 18 或更高版本（可通过 node -v 查看当前版本）。

本文以 mac 平台为例来介绍，Windows 的配置方式其实差不多，都是在终端里配置。

方法一：直接运行（无需安装）

npx https://github.com/google-gemini/gemini-cli

方法二：全局安装（推荐）

在“终端”里输入如下命令行，然后按回车键运行（使用 sudo 时会提示你输入当前用户的密码）：

npm install -g @google/gemini-cli

// 或（适用于 Mac）

sudo npm install -g @google/gemini-cli

安装完成后，输入 gemini 即可启动交互式 CLI。首次运行会请求一些权限，确认即可。

首次配置引导

启用后，CLI 会引导你完成以下设置：

步骤 1：选择主题风格

根据提示，选择默认主题或其他可选主题，按下回车键继续：

步骤 2：选择登录方式

接着，选择认证方式，笔者这里选择“Login with Google”，因为它默认支持每分钟 60 次、每天 1000 次的免费请求，选择后按下回车键确认。

如果你需要更高的请求频率或企业级访问，那么可以使用 API Key：

1. 在 Google AI Studio 中获取 API Key。
2. 设置环境变量：

export GEMINI_API_KEY="YOUR_API_KEY"

不过用 API Key 的方式一般都是直接调 API 了，这里就不做具体介绍，有关 Google Gemini API 的使用你也可以看看这篇文章：【Google Gemini API 接口调用教程，图文讲解】

步骤 3：浏览器授权登录

确认后会跳到浏览器让你登录，选一个谷歌账号来登录即可（需要科学上网）

成功后的提示如下，如果登录不成功，提示了“localhost 拒绝了我们的连接请求”，将你的梯子模式切换为“全局模式”或者开启“TUN 模式”后重试。登录成功后，你会看到如下提示：

快速上手体验

可以直接在 CLI 中输入指令开始对话。例如：

如果需要引入本地文件，可通过输入 @ 来选择文件：

在 VSCode 中使用 Gemini CLI

试试在 VSCode 等编辑器的终端中启动 Gemini CLI，同样的，先输入gemini，然后再选文件（@命令）开启对话：

写个简单的计算器试试，例如：

> 帮我写一个简单的计算器

过程中可能会要你的“写入”权限，确定即可。最后看看效果（嗯...真丑，不过你的 Prompt 提示词可以写明让它美观一点，用现代化风格的样式）：

更多使用技巧

其它效果你可以自己试试。不过如果网络不好它就从 gemini-2.5-pro 自动切换到gemini-2.5-flash模型了。

 
在命令行里输入 / 可以查看相关的使用技巧，建议先熟悉一下。

Gemini CLI 是一个强大的 AI 辅助工具，特别适合开发者、DevOps 工程师和数据分析师。它让复杂的代码分析、自动化任务和创意生成变得极其简单，只需自然语言指令即可完成。