Google Gemini CLI(基于Google AI技术的开源（Apache 2.0 许可）命令行 AI 代理)推出有段时间了，但还有不少同学没法顺畅的体验到，我来整理一个简单的教程，以 Windows 环境为例，五步快速上车。

        先唠叨两句，AI发展日新月异，不断爆出新款王炸，尤其今年AI编程领域，我的感受是一切还只是刚刚开始。

        国产虽然有字节的Trae、百度Comate，还有阿里的VSCode扩展等等，但实际使用体验下来，高下立判，“外面的”（Claude Code、Google Gemnini CLI）是真的好，真的香。

        怎么用到这些好东西呢，第一要务是“解决你的网络问题”，你懂的。这个解决不了，直接右上角不用看后续了。

        重申一次，以下内容的前提是“解决你的网络问题”！

1| 创建 Google Cloud 账户和项目:

       打开 Google Cloud console

       这是基础，你的 Gemini 模型将运行在 Google Cloud 上。

       * 如果你是新用户，需要创建一个结算账号 (Billing Account)。不过，Google Cloud 提供免费试用额度和永久免费层级，对于初级使用通常是足够的。

       * 创建一个新的项目 (Project)。给它起一个好记的名字，例如 gemini-cli-test。
 

        * 在控制台顶部的项目选择器中，找到你的项目，并复制其 ID (通常是一串包含字母和数字的字符串)。
        记录下这个ID，后面要用到。

2| 安装Node.js 18+

Node.js — Download Node.js®Node.js® is a free, open-source, cross-platform JavaScript runtime environment that lets developers create servers, web apps, command line tools and scripts.https://nodejs.org/zh-cn/download

# 验证版本
node -v

3| 配置代理

        Win10/Win11 的控制台操作要区分PowerShell、CMD，我们分别讲解。

        假设你的代理端口号是10086

• PowerShell 设置

临时设置

# 设置代理环境变量（替换为你的实际代理地址和端口）
$env:HTTP_PROXY = "http://127.0.0.1:10086"
$env:HTTPS_PROXY = "http://127.0.0.1:10086"

 永久设置

# 永久设置用户环境变量
[Environment]::SetEnvironmentVariable("HTTP_PROXY", "http://127.0.0.1:10086", "User")
[Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://127.0.0.1:10086", "User")

• CMD 设置

临时设置

# 临时设置
set HTTP_PROXY=http://127.0.0.1:10086
set HTTPS_PROXY=http://127.0.0.1:10086

永久设置

# 永久设置
setx HTTP_PROXY "http://127.0.0.1:10086"
setx HTTPS_PROXY "http://127.0.0.1:10086"

以上配置好后，都建议重启你的终端（CMD、powershell或vscode）。

4| 安装 gemini 

       安装： 一条命令 

npm install -g @google/gemini-cli

        跑起来看看是不是正常的

gemini --version 

       如果正常输出了版本号，恭喜你，环境成功安装完毕。

        

5| 配置认证方式

         * 前面提到的 GOOGLE_CLOUD_PROJECT  ID，这里就要用到了，终端中输入

$env:GOOGLE_CLOUD_PROJECT="你的项目ID"

        不过，以上的方法重启控制台就无效了。更好的方法是在.env文件中设置。

        .env 文件 在C:\Users\用户名\.gemini

        GOOGLE_CLOUD_PROJECT=”xxxxx“

        * 终端中输入 gemini 启动，认证登录。

        认证：选择“使用 Google 登录”后，浏览器会打开，要求使用 Google 账户登录。按照提示完成认证。

         如果看到这个页面，恭喜你，一切顺利，你将正式进入 gemini cli 环境。

6| 可能遇到的问题

以下内容摘抄自 Gemini CLI 国区使用常见问题解决方法本文着重解决国内用户在安装和使用过程中可能遇到的网络、登录和配置问题。同时 - 掘金

症状：执行 gemini 命令后，长时间卡在 Waiting for auth...，或者在浏览器完成 Google 授权后终端自动退出，没有任何提示。使用调试模式 (gemini -d) 可能会看到 ETIMEDOUT (连接超时) 的错误。

根源：这是典型的网络问题。由于众所周知的原因，直接访问 Google 服务会失败。gemini-cli 默认不会读取系统的全局代理设置，需要为其所在的终端会话单独配置代理，检查代理设置或更换你懂得。

症状：

• 报错A (Workspace): Failed to login. Ensure your Google account is not a Workspace account...
• 报错B (缺少环境变量): GOOGLE_CLOUD_PROJECT environment variable not found.

根源：这两种报错通常关联出现。使用 Google 账户（无论是个人账户还是 Workspace 账户）进行登录时，gemini-cli 都需要关联一个 Google Cloud 项目来进行额度管理和 API 调用。

        启用相关 API 服务：这是至关重要的一步，否则会遇到权限不足 (Permission Denied, 403) 的错误。

• 在 Google Cloud 控制台的搜索框中，搜索 “Gemini”。
• 找到并启用 Gemini for Google Cloud API (也可能叫 Cloud AI Companion API)。 有些教程建议启用搜索到的所有三个相关库以确保万无一失。

症状：交互中迟迟没有响应，ESC 中断后提示：

 根源：模型繁忙，被自动切换到了 flash 模型以便快速响应

症状：回答终端，提示如下

 根源：超出免费额度限制了， Gemini 2.5 Pro（每分钟 60 次请求，每日 1000 次请求）。交钱或等明天 ：）

---

• btw，欢迎关注我
• @0x0007 ～ 😃
• Windows｜HarmonyOS｜AIGC