Windows11部署Gemini-cli过程踩坑及解决方案

Google这次推出的Gemini-cli给广大开发者带来福音，解决了使用Cursor/Augment Code/ Claude Code高额费用问题。你只需要用个人Google账户登录，就能获得免费的Gemini Code Assist许可证，每分钟60次调用，每天1000次调用，完全免费使用Gemini 2.5 Pro的完整版本这个额度对个人开发者来说真的很够用了。
虽然官方给出了部署和启动方案，但实际操作中会遇到各种问题，下面我将对我遇到的问题进行总结，并给出解决方案。

问题一：

Failed to login. Workspace accounts and licensed Code Assist users must configure GOOGLE_CLOUD_PROJECT (see https://goo.gle/gemini-cli-auth-docs#workspace-gca).

遇到这个问题时，我才用的运行方式是官方给出的部署方式，在CMD下运行命令：

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

部署可以直接登录个人账户，但是一直显示这个上面提到的报错。
解决方案
需要配置变量环境：GOOGLE_CLOUD_PROJECT=“项目ID”。

1. 打开 https://console.cloud.google.com/

2. 选择一个项目，或者创建一个新项目。然后复制项目ID。
   
   3.设置环境变量，方法有多种：
   （1）我的电脑右键-属性-高级选项-环境变量，建立环境变量。
   （2）Windows (CMD):

set GOOGLE_CLOUD_PROJECT=你的项目ID

（3）Windows (PowerShell):

$env:GOOGLE_CLOUD_PROJECT="项目ID"

这样我们的GOOGLE_CLOUD_PROJECT就配置好了。
但是我发现电脑中无法运行gemini，解决方案是需要在PowerShell下进行运行：

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

问题二：

执行npx https://github.com/google-gemini/gemini-cli，没有反应，不管是在cmd还是Powershell中，都没有反应。采用下面部署也存在失败：

npm install -g @google/gemini-cli
gemini

解决方案：
找一个路径下CMD执行下面命令。

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
npm install -g
gemini

执行之后就顺利安装了gemini-cli。

问题三：

报错：`Message: request to https://oauth2.googleapis.com/token failed, reason: connect ETIMEDOUT 127.0.0.1:7897`

在解决问题二基础上登录google账户，会卡在登录页面，报错如上。
解决方案
设置代理，需要在powershell中设置，CMD中设置会无效。设置内容：

$env:HTTP_PROXY = "http://127.0.0.1:端口号"
$env:HTTPS_PROXY = "http://127.0.0.1:端口号"
$env:http_proxy = "http://127.0.0.1:端口号"
$env:https_proxy = "http://127.0.0.1:端口号"

设置代理环境变量（替换为您的实际代理地址和端口）

端口号查看方法下面两种都可以。
powershell

# 查看系统代理设置
Get-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings" | Select-Object ProxyServer, ProxyEnable
# 查看环境变量中的代理设置
Get-ChildItem Env: | Where-Object {$_.Name -like "*PROXY*"}

CMD

# CMD中查看所有代理相关环境变量
set | findstr PROXY

设置好之后执行gemini就可以顺利登录了。

总结

对于初用者，经常出现问题解决不了。本人也是搞了两个多小时才把gemini-cli成功运行。
主要的问题体现在下面几点：
（1）“GOOGLE_CLOUD_PROJECT”变量环境配置问题；
（2）按照github给的运行方式无法正常部署；
（3）无法顺利登录google账号；
要想顺利执行需要完成“GOOGLE_CLOUD_PROJECT”的环境变量配置、全局安装gemini-cli、设置代理环境变量。