如何安装使用 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：

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

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 提示词可以写明让它美观一点，用现代化风格的样式）：

开发必备：API 全流程管理神器 Apifox

介绍完上文的工具，我想额外介绍一个对开发者同样重要的效率工具 —— Apifox。作为一个集 API 文档、API 调试、API 设计、API 测试、API Mock、自动化测试等功能于一体的 API 管理工具，Apifox 可以说是开发者提升效率的必备工具之一。

如果你正在开发项目需要进行接口调试，不妨试试 Apifox。注册过程非常简单，你可以直接在这里注册使用。

立即体验 Apifox

注册成功后可以先看看官方提供的示例项目，这些案例都是经过精心设计的，能帮助你快速了解 Apifox 的主要功能。

使用 Apifox 的一大优势是它完全兼容 Postman 和 Swagger 数据格式，如果你之前使用过这些工具，数据导入会非常方便。而且它的界面设计非常友好，即使是第一次接触的新手也能很快上手，快去试试吧！

免费使用 Apifox

如何安装使用 Google Gemini CLI？详细的图文教程