Windows WSL2 方案（Gemini CLI）
如果你更习惯 Linux 终端环境，或者希望在 Windows 上直接按 Linux 方式使用 Gemini CLI，可以使用 WSL2 + Ubuntu 方案。
适用场景：你希望在 Windows 上使用 Linux 终端环境，或希望把 Gemini CLI 放在 Ubuntu 环境里安装与使用。这一页提供的是完整的 WSL2 路线。
你会用到的官方页面
开始前先确认
系统
建议 Windows 11，或已开启虚拟化能力的 Windows 10。
管理员 PowerShell
安装 WSL2 时，建议以管理员身份打开 PowerShell。
Gemini Key
请先到 Key 管理 创建 Gemini Key。后面的命令里会用到 你的Gemini_API_KEY。
第一步：安装 WSL2
# 1) 以管理员身份打开 PowerShell
wsl --install -d Ubuntu
# 2) 安装完成后重启电脑
# 3) 打开 Ubuntu，第一次设置 Linux 用户名和密码第二步：在 Ubuntu 里准备环境
下面所有命令都在 Ubuntu 终端里执行，不是在 Windows PowerShell 里执行。
sudo apt update
sudo apt install -y curl git build-essential第三步：安装 Node.js 20+
推荐使用 nvm 安装，后续升级更方便。
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20
node -v
npm -v第四步：安装 Gemini CLI
npm install -g @google/gemini-cli@latest
gemini -v如果你只想先确认是否安装成功，执行 gemini -v 即可。
第五步：写入积木AI的 Gemini 配置
把下面命令里的 你的Gemini_API_KEY 替换成你在 Key 管理里创建的真实 Gemini Key。
curl -fsSL https://code.jimuxyz.com/env_deploy/gemini-deploy.sh | bash -s -- "你的Gemini_API_KEY"第六步：开始使用
# 进入你的项目目录（可选）
cd your-project
# 启动 Gemini
gemini在登录页直接选择 3（不执行任何操作），或选择 “Use Gemini API Key” 继续。
如果遇到问题
wsl --install不可用：看微软官方旧版系统手动安装文档。node -v不是 20+：重新执行nvm install 20和nvm use 20。- 配置后仍不是积木AI：重新执行一次
gemini-deploy.sh，并确认你替换的 Key 是真实值。 - 如果只是想看 Gemini 在 Linux 环境里的常规说明，也可以直接进入 macOS / Linux Gemini 使用说明。