Gemini CLI 工具使用教程

1. 简介

这是一个在终端直接与 Gemini AI 进行交互的命令行工具。 核心功能： 快速问答、代码审查、无需离开终端即可处理文本任务。

2. 环境准备

  • Node.js: 版本大于 20 （建议）
  • Google 账号: 优先使用个人账号

3. 具体步骤：

1. 安装 Gemini CLI

打开终端,使用 npm 进行全局安装 @google/gemini-cli

# 1. 安装工具
npm install -g @google/gemini-cli

# 2. 验证安装是否成功（如果看到版本号说明成功）
gemini --version

2. 配置环境

由于终端的流量默认不走系统代理，需要单独给终端做代理，否则无法连接谷歌服务器，进行愉快的使用 Gemini cli

# 1. 设置代理 要求你和你使用的代理地址一致
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:HTTP_PROXY  = "http://127.0.0.1:7890"

以 Win11 为例，可以通过查看设置 - 网络和 Internet - 代理 - 手动设置代理 - 编辑 进行查看

3. 启动Gemini

# 要求先设置终端代理，如果长时间没反应，检查是否启动了代理
gemini

如图所示，表示登录google账号成功 image-20260119172011586 如果出现了验证失败情况

  • 可能使用的Google账号有问题，建议切换账号
  • 终端没有做代理

4. 设置模型

登录成功后，在终端启动成功，就可以愉快的进行交流了 img.png 初始默认是使用 gemini 2.5 可以通过修改settings进行修改模型

/settings

搜索Preview关键字，在弹出的列表中找到 Preview Features (或者类似 Preview features (e.g., models)) 使用键盘回车键Enter将其状态切换为 true (开启)，按 Esc 退出设置菜单 img_1.png

然后在对话框中输入/model回车，进入模型选择界面，将模型设置到Gemini 3 即可白嫖gemini 3 pro 和 gemini 3 flash： img_2.png

5. 连接vscode使用

我们的目的是要ai来Vibe Coding，所以需要在vscode或其他编辑工具中使用 （只要能只用终端就能起，本质就是用终端去访问） 笔者以vscode为例，步骤如下

  • 打开项目代码
  • 启动终端，运行gemini
  • 选择yse,表示连接vscode img_3.png

连接成功就可以愉快的使用使用免费的gemini3pro 模型 img_4.png

6. 使用示范

当你连接上Gemini后，就可以想使用agent一样进行去交流，要求Gemini帮你修改代码或者写文档。

对于刚刚接手的项目，无从下手，可以使用ai工具帮你分析项目，梳理业务

img_5.png

  • Allow once (仅允许这一次)
  • Allow for this session (本次会话期间全部允许)
  • Modify with external editor (调用外部编辑器修改)
  • No, suggest changes (拒绝 / 取消)

根据自己的实际情况，是否选择保存，点击运行保存，修改的内容就会出现在你的项目中 img_6.png