Skip to content

Gemini Windows使用指南

强烈推荐：优先使用 install_script.bat 一键完成全部环境部署。只要遇到安装或配置问题，第一选择就是重新运行该脚本。

(一) 一键安装脚本（推荐）

想一次性完成 Node.js、npm 镜像、Claude Code / Codex / Gemini / Droid CLI / OpenClaw 以及环境变量配置，请优先使用随文档提供的 install_script.bat，而不是手动逐步安装。

  1. 下载或找到官方一键安装脚本 install_script.bat（与本教程同一套文档中的 Windows 安装脚本）。
  2. 在资源管理器中右键该脚本，选择 ”以管理员身份运行”（脚本会先检查管理员权限）。
  3. 按照脚本提示依次完成：
  4. 检查 / 安装 Node.js（如未安装会自动下载安装 Node 20+）。
  5. 将 npm 源切换为 https://registry.npmmirror.com。
  6. 安装或更新 Claude Code / Codex CLI / Gemini CLI / Droid CLI / OpenClaw。
  7. 如系统未安装 Git，会自动从国内镜像下载并安装 Git。
  8. 提示输入 API Base（默认 https://api.share-ai.woolen.wang）和 API Token（如 sk-xxxx），脚本会自动：
    • 写入环境变量：GEMINI_API_KEY、GOOGLE_GEMINI_BASE_URL、GOOGLE_GENAI_USE_GCA、CODE_ASSIST_ENDPOINT 等；
    • 生成 Gemini 配置目录 C:\Users\你的用户名\.gemini 及 .env、settings.json 文件。
  9. 脚本执行结束后，关闭当前终端窗口，重新打开 PowerShell / CMD，执行：
gemini --version

如果能看到版本号，说明 Gemini CLI 已安装完成。

只有在不方便使用脚本或脚本执行失败时，才需要参考下面的“手动安装”步骤。

(二) 手动安装 Node.js 环境

如果你已经通过 install_script.bat 完成安装并确认 node --version 能正常输出版本号，可以跳过本节。后续任何步骤出错，都可以直接回到这里，重新运行 install_script.bat 来修复环境。

Windows 安装方法

方法一：官网下载（推荐）

  1. 打开浏览器访问 https://nodejs.org/
  2. 点击 LTS 版本进行下载（推荐使用 18 或以上版本，脚本默认安装的是 Node 20 LTS）
  3. 下载完成后双击 .msi 文件
  4. 按照安装向导完成安装，保持默认设置即可

方法二：使用包管理器

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

# 使用 Chocolatey
choco install nodejs
# 或使用 Scoop
scoop install nodejs

Windows 注意事项

  • 建议使用 PowerShell 而不是 CMD
  • 如果遇到权限问题，尝试以管理员身份运行
  • 某些杀毒软件可能会误报，需要添加白名单

验证安装是否成功

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

node --version
npm --version

如果显示版本号，说明安装成功了！

(三) 手动安装 Gemini CLI

打开 PowerShell 或 CMD，运行以下命令（与一键安装脚本内部使用的命令等价）：

# 全局安装 Gemini CLI
npm install -g @google/gemini-cli@latest --registry=https://registry.npmmirror.com

这个命令会通过 npmmirror 镜像源下载并安装最新版本的 Gemini CLI（更新时也重复执行此命令即可）。

提示

  • 建议使用 PowerShell 而不是 CMD，功能更强大
  • 如果遇到权限问题，以管理员身份运行 PowerShell

验证 Gemini CLI 安装

安装完成后，输入以下命令检查是否安装成功：

gemini --version

如果显示版本号，恭喜你！Gemini CLI 已经成功安装了。

提示：如果此处验证失败，最简单可靠的方式是直接再次运行 install_script.bat，让脚本自动检查并修复 Node/npm/CLI 安装问题。

(四) 手动配置 Gemini 环境变量

如果你已经在 install_script.bat 中输入过 API Base 和 API Token，本节的环境变量和配置文件已经由脚本自动写入，只需了解配置位置即可。如果你不确定当前环境变量是否正确，最简单的办法是重新运行一次 install_script.bat。

1. PowerShell 临时设置（当前会话）

$env:GEMINI_API_KEY = "你的API密钥"
$env:GOOGLE_GEMINI_BASE_URL = "https://api.share-ai.woolen.wang"
$env:GOOGLE_GENAI_USE_GCA = "true"
$env:CODE_ASSIST_ENDPOINT = "https://api.share-ai.woolen.wang"

使用与 Claude Code / Codex 相同的 ShareAI API 密钥即可，格式如 sk-xxxxxxxx。

2. PowerShell 永久设置（用户级）

# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.share-ai.woolen.wang", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GENAI_USE_GCA", "true", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("CODE_ASSIST_ENDPOINT", "https://api.share-ai.woolen.wang", [System.EnvironmentVariableTarget]::User)

设置后需要重新打开 PowerShell / CMD 窗口才能生效。

3. 通过配置文件方式（与一键脚本一致，可选）

在 C:\Users\你的用户名\.gemini 目录下创建或编辑 .env 文件（如果已运行过 install_script.bat，该文件已自动生成），内容示例：

GEMINI_API_KEY=你的API密钥
GOOGLE_GEMINI_BASE_URL=https://api.share-ai.woolen.wang

同一目录下的 settings.json 也会由脚本生成，通常无需手动修改。

4. 验证 Gemini 相关环境变量

在 PowerShell 中验证：

echo $env:GEMINI_API_KEY
echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GOOGLE_GENAI_USE_GCA
echo $env:CODE_ASSIST_ENDPOINT

(五) 开始使用 Gemini CLI

完成上述步骤后，你可以在任意代码目录中直接启动 Gemini CLI：

gemini

如需查看命令帮助：

gemini --help