[AI] Gemini-Cli 安装和使用教程

Gemini生成（2025年10月26日20:58:40）

gemini-cli 是一个命令行界面工具，它让你能够直接在终端中与 Google 的 Gemini 系列大语言模型进行交互，而无需通过浏览器访问 Bard 或其他图形化界面。

01 需求

1.1 Node.js 20或者更高版本

这是因为Gemini CLI 是基于 Node.js 运行的。

可以执行下面命令查询自己当前的nodejs版本：

node -v

如果没有安装node.js，可以参考：Node.js： JavaScript运行环境安装

Ubuntu 24.04不建议使用apt直接下载nodejs，因为官方apt源的nodejs版本为18，并不满足gemini-cli的需求。

1.2 Google 账号

Google 账号用于认证和使用免费层级服务。

免费层级优势: 每天最多 1000 个请求，每分钟最多 60 个请求，并可以使用 Gemini 2.5 Pro 模型（上下文窗口高达 100 万个 token）。

02 安装

Gemini CLI 可以通过 npm (Node Package Manager) 进行安装。

# 安装
npm install -g @google/gemini-cli
# 安装后查询
gemini --version

如果成功，它会显示当前安装的版本号。

03 认证与配置 (初次启动)

3.1 首次启动认证

首次运行 gemini 命令时，它会引导您完成认证过程。

# 启动gemini
gemini

3.2 选择主题

启动后，CLI 可能会先提示您选择一个主题（颜色方案），使用键盘上的方向键选择您喜欢的主题，然后按回车键确认。

3.3 选择认证方法

接下来，它会提示您选择认证方式。对于初学者和个人用户，强烈推荐使用 "Login with Google (OAuth login)"

1. 选择 “Login with Google”: 按回车键确认。

2. 浏览器认证: 您的默认浏览器会自动打开一个 Google 登录页面。

3. 登录并授权: 按照提示使用您的 Google 账号登录并授予 Gemini CLI 必要的权限。

4. 认证成功: 浏览器会显示认证成功的消息。回到终端，您会看到 CLI 显示认证成功的提示，并进入主界面。

3.4 关联 Google Cloud Project ID（推荐）

为了充分利用 Gemini API 的所有功能和 Google Cloud 的生态系统（特别是对于更高级的用例和计费管理），建议将您的 CLI 关联到一个 Google Cloud 项目。

1. 准备 Google Cloud 项目:

   • 进入 Google Cloud 控制台: 访问 https://console.cloud.google.com/。
   • 找到项目 ID: 在页面顶部选择您希望关联的项目（例如："My First Project"），并复制其项目 ID（Project ID）。项目 ID 通常是一串唯一的字母数字组合（例如：my-project-123456）。

2. 启用 Gemini API 服务:

   • 导航至 API 和服务: 在左侧导航栏中，点击 “API 和服务” > “库”。
   • 搜索并启用 API:
     • 在搜索框中输入 Gemini API 或 Gemini for Google Cloud。
     • 找到对应的服务，点击进入详情页面。
     • 点击 “启用” 按钮以确保您的项目可以访问 Gemini API。

3. 设置环境变量:

   • 复制项目 ID: 将您在上一步中复制的项目 ID（例如：xx-xx-xx-xx）准备好。
   • 设置环境变量: 在您的终端中，使用 export 命令将项目 ID 设置为环境变量。这使得 gemini CLI 能够自动识别并使用这个项目。

   export GOOGLE_CLOUD_PROJECT_ID=xx-xx-xx-xx
   # 请将上面的 "xx-xx-xx-xx" 替换为您自己的项目 ID
   

---

恭喜！您现在已经完成了 Gemini CLI 的安装、认证和项目关联，可以开始使用了！

04 Gemini CLI 基本使用

Gemini CLI 的操作界面非常友好，类似一个交互式的聊天界面。

4.1 基础对话 (提问)

您可以直接输入您的问题或任务描述，然后按回车键。

• 示例:

  > 给我写一个 Python 函数，用来计算斐波那契数列的前 N 个数。
  

  Gemini 会生成并显示相应的代码或文本。

4.2 使用斜杠命令 (Slash Commands)

Gemini CLI 提供了许多内置命令来帮助您管理会话、配置工具等。所有命令都以 / 开头。

命令	作用	示例
/help	显示所有可用命令、键盘快捷键和使用说明。 (初学者必用!)	/help
/chat	重新开始一个新的聊天会话。	/chat
/stats	查看当前会话的使用统计信息。	/stats
/tools	管理和查看可用的工具（如 grep, terminal, file_read 等）。	/tools
/exit	退出 Gemini CLI。	/exit

4.3 引用文件和目录 (@ 符号)

Gemini CLI 的强大之处在于它可以访问您的本地文件系统（在您的明确许可下），让它能够理解和处理您的代码库或文档。

使用 @ 符号可以将文件或文件夹的内容作为上下文提供给 Gemini。

• 引用单个文件:

  > 帮我检查一下 @main.py 中的逻辑错误。
  

• 引用整个目录:

  > 查看 @src 目录下的所有文件，并总结一下这个项目的功能。
  

  • 注意: 首次尝试访问文件时，CLI 会提示您授权访问权限。

4.4 高级功能：代码修改与执行

Gemini CLI 作为 AI 代理，可以执行更复杂的任务，例如：

• 代码修复:

  > 在 @app.js 中添加一个路由来处理用户注册。
  

  当您要求它进行更改时，它会先显示建议的更改 (Diff)，并询问您是否同意应用 (Apply) 更改。这给了您完全的控制权，避免意外修改。

• 生成测试:

  > 为 @utils.py 中的所有函数生成单元测试代码。
  

05 进阶配置 (可选)

5.1 上下文文件 (GEMINI.md)

您可以在您的项目目录中创建一个名为 GEMINI.md 的文件。这个文件中的内容会被 Gemini CLI 自动加载，作为项目的持久化上下文。

• 用途: 存放项目描述、技术栈、编码规范、重要依赖等信息。
• 好处: 这样每次您在项目目录中启动 gemini 时，它都能更好地理解您的项目，提供更准确的帮助。