这只是一篇最初级的安装手记，适合首次简单的尝试
1. 安装 nodejs
官网 https://nodejs.org/zh-cn/download 下载 v24.15.0 LTS 版本的 Windows x64 的 独立安装包文件(.zip)，解压缩到 D:\program\node-v24.15.0-win-x64
2. 设置必要的系统环境变量
Windows 设置 – 系统 – 系统信息 – 右边栏相关设置 – 高级系统设置 – 系统属性对话框 – 高级 – 环境变量 – 系统环境变量
修改 PATH ，添加 D:\program\node-v24.15.0-win-x64
推荐使用系统环境变量，而非用户级环境变量；系统级的优先级更高，也避免冲突造成的混乱
如果之前安装过其它版本的 nodejs，可以直接使用或改掉；如果环境变量较多，注意检查是否有造成冲突的
注意检查 PATH 中是否有 git 安装目录，比如 C:\Program Files\Git\bin ，后面一步 gemini ci 安装过程需要调用 git
3. 安装 gemini-cli
新打开一个命令提示符，执行 npm install -g @google/gemini-cli
必须是新打开的，否则前面设置的环境变量还未生效
4. 验证安装是否成功
gemini –version
5. 临时设置系统代理的环境变量
临时设置系统代理的环境变量，在 cmd 中，执行 set http_proxy=http://127.0.0.1:1080 及 set https_proxy=http://127.0.0.1:1080
这里主要是 gemini-cli 登录google账号需要用梯子，没必要系统级默认生效，
5. 初始化（首次启动登录）
在上一步打开的 cmd 中执行命令 gemini ，启动后，会有提示选择信任当前目录（v0.38.2，其它版本不一定），这步可以最好不选择；
下一步提示选择身份认证的方法，选择 Login with Google，会自动打开浏览器，Google 账号登录后，按提示操作即可。
如果没有正确设置代理，可能无法完成。因为，浏览器与 gemini 命令都需要连接 google 服务器，缺一不可。
6. 日常使用
每次启动 gemini 时，都要先通过环境变量设置代理（上面第 5 步中两个命令），这确实有点麻烦。
可以写个小脚本，比如如下，并把目录放到 PATH 变量里，这样只要在 cmd 里执行 setproxy 即可，每次都要执行一次
C:\Users\<name>\AppData\xscript\setproxy.cmd
@echo on set http_proxy=http://127.0.0.1:1080 set https_proxy=http://127.0.0.1:1080
tips:关于网络代理的一些规则
- 系统设置 – 网络和 Internet – 代理 ，设置代理服务器地址端口或 PAC 路径，这很常用，但它主要针对浏览器有效，Linux 移植来的工具一般不认。
- WinHTTP 代理，建议无视（主要影响系统更新、应用商店及部分后台服务，可通过 netsh winhttp show proxy 查看状态，不建议做设置）。
- 环境变量http_proxy/https_proxy，许多跨平台工具都支持，（如 git, curl, npm, python, go）名称 ，要特别关注。变量名推荐使用小写，与 linux 工具的习惯保持一致；而 Windows 本身不区分大小写都行。
- 通常建议仅在 cmd 中针对本会话生效，而不要设置在系统环境变量中；把 http/https 请求发给代理服务器（本机 1080端口上的http代理），即前面用过的两条 set 命令
Last Updated on 2026/04/23