Gemini CLI Windows下安装

我差不多是VS Code Copilot的第一批用户，Copilot的问题在于仅能同时处理有限的代码文件（通过引用的方式），而不能很好地理解整个项目。除此以外，如其名称一样，它更多像是一个辅助编程的助理，自主编程的能力差一些。今年Claude Code发布后， AI工具可以自行编码了，但它不仅使用费用比较高（基础版$20/月，高级版$100/月），而且限制大陆地区的注册和付费。随后，或许是为了竞争，Google推出了Gemini CLI，几乎是Claude Code的平替。于是迫不及待试用了一下，本身安装Gemini CLI应当是一件很简单的事情，官方也已经有详尽的文档。然而，由于墙的问题、Google验证的问题，还是费了一番周折。这篇文章简要介绍了在windows 11上安装Gemini的步骤。

安装Node

在这个页面下载Node：https://nodejs.org/en/download

假设文件的本地保存路径是：C:\Users\Administrator\Downloads\node-v22.17.0-x64.msi

那么，打开管理员命令行，执行如下命令：

PS C:\Users\Administrator\Downloads> msiexec /i "node-v22.17.0-x64.msi"

我第1次没有以管理员身份安装，结果出现了问题；注意ADD_PATH一定要选中

验证安装：

PS C:\Users\Administrator\Downloads> node -v v22.17.0 PS C:\Users\Administrator\Downloads> npm -v 10.9.2

配置PowerShell本地代理

众所周知，Google的很多服务是被墙的。使用Gemini CLI时，很多请求都是通过控制台（PowerShell）执行的，那么可以先行配置好本地代理。例如，如果使用的是Clash，那么其本地代理的默认端口号是 7890。

在 PowerShell 中运行以下命令，打开配置文件（若不存在会自动创建）：

if (!(Test-Path $PROFILE)) { New-Item -Path $PROFILE -Type File -Force } notepad $PROFILE

此时会打开notepad，输入下面的内容，然后保存：

$Env:http_proxy = "http://127.0.0.1:7890" $Env:https_proxy = "http://127.0.0.1:7890"

重新启动PowerShell，输入下面的命令，验证代理已经启用：

# 查看当前代理变量 $env:https_proxy # 测试网络连通性 curl -Uri "https://www.google.com" -UseBasicParsing

安装Gemini CLI

以管理身份打开命令行，执行下面的命令进行安装：

npm install -g @google/gemini-cli

在这个过程中，出现问题的环节就是即便跳浏览器，登录了Google账号，依然会报错，缺少 GOOGLE_CLOUD_PROJECT 环境变量。

这个环境变量，需要登录Google Cloud账号，创建一个项目，然后将项目ID设置为环境变量。如下图所示：

启动Gemini

假设项目路径是：C:\home\codes\go\awsdk\gm-cms，那么，打开PowerShell，定位到这个目录下。此时，该目录就是当前的工作目录（work directory），接下来，在这个目录下执行gemini ：

PS C:\home\codes\go\awsdk\gm-cms> gemini

首次使用时，会出现下面的 403 权限错误：

复制上面message中的地址，类似：https://console.developers.google.com/apis/cloudaicompanion.googleapis.com/overviews?project=xxxxxx。在浏览器中打开，然后在页面上点击“启用”。

重新启动Powershell，再次执行gemini，成功后应当可以看到下面这样的界面：

试用Gemini

作为初次体验，我们可以输入下面的任务，让gemini为我们分析整个项目：

请分析整个项目的目录结构，说明每个模块的作用，然后给出整个项目的架构图。使用中文进行回答。

可以看到输出了详尽的说明：

因为架构图显示在控制台上，不便于查看，我随后又在提问框输入了一个新的请求：将架构图保存在项目根目录下。于是，gemini将刚才的架构图在根目录下，保存成了ARCHITECTURE.md：

至此，我们完成了Gemini的试用。关于Gemini的使用方式，仍在学习和探索中，后面会继续进行分享。

感谢阅读，希望这篇文章能给你带来帮助！