2025 年 07 月 02 日
Windows 安装 Gemini CLI
google-gemini/gemini-cli：一个开源的 AI 代理，可将 Gemini 的强大功能直接引入您的终端。
一、前置条件
系统要求：Windows 7 及以上版本。
Node.js 环境：Gemini CLI 基于 Node.js 运行，需提前安装 Node.js ，安装时勾选 Add to PATH 选项，方便在命令行中使用 npm 命令。安装完成后，在命令提示符中输入 node -v 和 npm -v ，若能显示版本号，说明安装成功。
Node.js — Download Node.js®
二、安装 Gemini CLI
打开命令提示符：按 Win + R 组合键，输入 cmd 并回车，打开命令提示符窗口。
安装 Gemini CLI：在命令提示符中输入以下命令：
npm install -g @google/gemini-cli
等待命令执行，若出现 added xxx packages in xxxs 等类似信息，说明安装成功。
输入 gemini 启动设置：
gemini
主题配置（可选）
当前界面是让你选择终端显示主题，操作方式：
- 选主题：用上下箭头键移动光标，选中喜欢的主题（如 ANSI Dark、Atom One Dark 等 ），按 Enter 确认。
- 应用范围：下方 Apply To 可选 User Settings（仅当前用户生效 ）或 Workspace Settings（工作区生效 ），选好按 Enter。
- 跳过配置：若不想改主题，直接按 Enter 用默认（Default 主题 ），或按 Ctrl + C 退出配置流程。
选完主题后，就能进入 Gemini CLI 主交互界面。
三、配置代理（若网络允许访问相关服务，可跳过此步骤）
由于 Gemini CLI 可能需要访问特定网络服务，若在本地网络环境下无法正常访问相关服务，可能需要进行网络配置。此部分内容仅为假设性说明，在实际使用中，请确保你的网络操作符合相关法律法规和服务使用条款。
方法一：临时配置（仅当前命令行窗口生效）
如果你所在的网络环境需要特定的代理设置，可在获取合法合规的代理信息后，在命令提示符中输入以下命令（将 7890 替换为实际端口号 ）：
set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890
如果使用的是 SOCKS5 协议，则输入：
set HTTP_PROXY=socks5://127.0.0.1:7890
set HTTPS_PROXY=socks5://127.0.0.1:7890
方法二：永久配置（所有命令行窗口生效）
打开环境变量设置：右键点击 “此电脑”，选择 “属性”，点击 “高级系统设置”，在弹出的窗口中点击 “环境变量”。
新建代理变量：在 “用户变量” 或 “系统变量”（推荐用户变量）中，点击 “新建”，分别添加以下两个变量：
- 变量名：HTTP_PROXY ，值：http://127.0.0.1:7890 （替换为实际代理信息）
- 变量名：HTTPS_PROXY ，值：http://127.0.0.1:7890
保存设置：点击 “确定” 保存所有设置，重启命令提示符使新环境变量生效。
四、验证代理配置
在命令提示符中输入以下命令测试代理是否生效：
curl -v http://google.com
若输出中出现连接成功的信息（如 Connected to 相关内容 ），则说明代理配置成功；若仍提示连接失败，需检查代理设置和网络环境。
五、登录与认证 Gemini CLI
启动 Gemini CLI：在命令提示符中输入 gemini 并回车，启动 Gemini CLI 。
选择认证方式：启动后会显示认证方式选择界面，常见的有 Login with Google （使用谷歌账号登录）、Gemini API Key (AI Studio) （使用 API 密钥 ）、Vertex AI （使用谷歌云 Vertex AI 服务 ）。
Login with Google
选择该选项并回车，按照提示操作，命令行界面会生成一个授权 URL ，复制该 URL 到浏览器打开（确保浏览器网络环境允许访问相关服务）。
登录谷歌账号并完成授权，将授权码复制回命令行界面，完成登录。
Gemini API Key (AI Studio)
https://aistudio.google.com/apikey
访问 Google AI Studio ，登录谷歌账号后，点击右上角头像，选择 API Keys ，点击 Create API Key 生成 API 密钥 。
在命令行中输入 gemini config set api_key 你的API_KEY （将 “你的 API_KEY” 替换为实际生成的密钥） ，完成配置。
三种认证方式介绍
- 1、Login with Google（推荐个人用户）
适用场景：有谷歌账号，想快速登录使用。
操作步骤：
- 用上下箭头选中 Login with Google，按 Enter。
- CLI 会弹出浏览器链接（或终端显示授权 URL ），复制 URL 到浏览器打开。
- 登录谷歌账号，完成授权（需确保网络环境允许访问相关服务 ）。
- 授权成功后，浏览器会显示一串 “授权码”，复制粘贴回 CLI 终端，完成绑定。
- 2、Gemini API Key (AI Studio)
适用场景：已有 Gemini API Key（在 Google AI Studio 申请 ），适合开发者 / 企业场景。
操作步骤：
https://aistudio.google.com/apikey
- 选中 Gemini API Key (AI Studio)，按 Enter。
- 前往 Google AI Studio（需确保网络环境允许访问相关服务 ），登录后创建 API Key。
- 把生成的 API Key 复制到 CLI 终端，按 Enter 完成配置。
set export GEMINI_API_KEY="YOUR_API_KEY"
或新建变量名：
GEMINI_API_KEY变量值输入Gemini API Key
- 3、Vertex AI
适用场景：用 Google Cloud Vertex AI 服务的企业用户，需提前配置 GCP 项目、权限。
操作步骤： - 选中 Vertex AI，按 Enter。
- 确保本地已配置 Google Cloud SDK，并登录 GCP 账号。
- 终端会自动关联 GCP 项目中的 Vertex AI 服务（需提前在 GCP 控制台启用 Gemini API ）。
优先推荐 “Login with Google” 流程
如果是个人使用，选 Login with Google 最方便，具体走一遍：
Please visit this URL to authorize: https://accounts.google.com/o/oauth2/auth?xxx...
处理底部 “error” 提示
看到底部 X1 error (ctrl+o for details)，先不用慌：
- 这是认证未完成导致的临时错误，完成登录授权后通常会自动消失。
- 若授权后还报错，按 Ctrl + O 查看错误详情（一般是网络或授权失效问题，重新走一遍认证流程即可 ）。
认证后开始使用
完成认证后，就能进入 Gemini CLI 主界面，直接输入问题 / 指令交互啦，比如：
write a Go function to read a JSON file
如果认证过程中遇到网络问题，确保网络环境正常，或换用 Gemini API Key 方式（提前申请 Key 更稳定 ）。
现在选一种认证方式，完成授权就能愉快用 Gemini 啦～
六、使用 Gemini CLI
登录成功后，即可在命令行中与 Gemini 进行交互，例如输入问题，获取回答：
What is the weather like today?
注意事项
- 网络问题：确保网络环境稳定，若遇到连接超时、连接重置等问题，可尝试检查网络设置、更换网络环境等方法解决。
- 权限问题：在安装 Node.js 和运行 Gemini CLI 时，建议以管理员身份运行命令提示符，避免因权限不足导致安装或运行失败。
- 认证问题：使用 Login with Google 方式登录时，确保谷歌账号正常可用，若授权过程中出现异常，可尝试清除浏览器缓存、重新登录谷歌账号等操作。使用 API Key 方式时，注意保护好 API 密钥，避免泄露。
- 更新问题：随着 Gemini CLI 的更新，可能会出现新的特性或兼容性问题。可定期使用以下命令更新到最新版本 ：
npm update -g @google/gemini-cli
)
