Windows Gemini CLI 使用说明

在 Windows 系统上安装官方 Gemini CLI，并配置为使用积木AI代码助手。

返回 下载脚本 登录后创建 Gemini Key
开始前先做这一步：先到 Key 管理 创建 Gemini Key。文档里所有 你的Gemini_API_KEY 都必须替换成你自己的真实 Key，否则无法使用。

先选一种方式

如果你是不熟悉命令行的用户，优先用“下载脚本”；如果你更习惯直接在终端执行命令，就用“复制脚本”；只有需要逐步排障时，再看完整说明。
下载脚本 完整说明 
powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr -useb https://code.jimuxyz.com/env_deploy/gemini-install.ps1 | iex"
powershell -NoProfile -ExecutionPolicy Bypass -Command "npm install -g @google/gemini-cli --registry=https://registry.npmmirror.com"
powershell -NoProfile -ExecutionPolicy Bypass -Command "$env:JIMUXYZ_GEMINI_KEY='你的Gemini_API_KEY'; iwr -useb https://code.jimuxyz.com/env_deploy/gemini-deploy.ps1 | iex"

系统要求

系统
Windows 10（版本 1809 / build 17763）及以上
依赖
Node.js 20+ + npm
Node.js 安装（如果没有安装）
前往 nodejs.org/zh-cn/download 下载。
Git 安装（可选）
前往 git-scm.com/downloads/win 下载，保持默认一路下一步（不要改路径）。如访问不稳定，可用清华镜像 mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/，选择 Git for Windows 下载。

安装步骤（Windows 终端）

1

环境检查（推荐）

powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr -useb https://code.jimuxyz.com/env_deploy/gemini-install.ps1 | iex"

可在 PowerShell / CMD / Windows Terminal / VSCode 终端执行；脚本会检查 Node.js / npm 版本，并提示修复方式。

2

卸载已安装的 Gemini CLI（可选，未安装请跳过）

powershell -NoProfile -ExecutionPolicy Bypass -Command "npm uninstall -g @google/gemini-cli"
3

安装 Gemini CLI 官方原版包

powershell -NoProfile -ExecutionPolicy Bypass -Command "npm install -g @google/gemini-cli --registry=https://registry.npmmirror.com"
4

验证安装

gemini -v

若 PowerShell 提示“无法加载 gemini.ps1，因为在此系统上禁止运行脚本”，请先执行：Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser，然后重新打开终端再试。

5

登录后创建并复制 Gemini Key

登录后到「Key 管理」页面创建一个新的 Gemini Key，并复制你自己的 你的Gemini_API_KEY 对应真实值。

6

一键写入配置（脚本写入配置）

把 Gemini Key 写进命令（替换 你的Gemini_API_KEY 后执行）：

powershell -NoProfile -ExecutionPolicy Bypass -Command "[Environment]::SetEnvironmentVariable('JIMUXYZ_GEMINI_KEY','你的Gemini_API_KEY','Process'); iwr -useb https://code.jimuxyz.com/env_deploy/gemini-deploy.ps1 | iex"

可在 PowerShell / CMD / Windows Terminal / VSCode 终端执行。设置完成后请重启终端；若在 VSCode / Windows Terminal 中，新开终端无效，请完全退出应用后再打开。

或者

如果你不想用脚本，可手动写入系统环境变量（新终端生效）：

setx GOOGLE_GEMINI_BASE_URL "https://code.jimuxyz.com/p"
setx GEMINI_API_KEY "你的Gemini_API_KEY"

设置完成后请重启终端；若在 VSCode / Windows Terminal 中，新开终端无效，请完全退出应用后再打开。

7

启动 Gemini

设置完成后请先关闭当前终端，再打开一个新的终端使用，或在插件中使用。

# 导航到你的项目（可选）
cd your-project

# 启动 Gemini
gemini

在登录页直接选择 3（不执行任何操作），或选择 “Use Gemini API Key” 继续。

进入 Gemini 后可输入 /settings 开启 Preview Features（可选），输入 /model 选择模型。