先安装Node.js v20+并勾选Add to PATH，再运行npm install -g @google/gemini-cli全局安装，最后执行gemini --version验证版本并用gemini命令测试响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在Windows、macOS或Linux上三分钟内让gemini命令可用，却卡在Node.js版本检查、npm权限报错、环境变量拼写错误、.gemini目录权限拒绝这四个连环坑里？本教程提供可直接复制粘贴执行的部署脚本，跳过所有手动配置环节。
Windows PowerShell 一键安装与配置
适用于 Windows 11/10，默认使用 PowerShell（非 CMD），自动处理管理员权限、Node.js 检查、npm 全局安装、配置目录创建和 .env 写入。
第一步：以管理员身份打开 PowerShell（右键开始菜单 → “Windows Terminal (管理员)”）。
第二步：复制粘贴并执行以下完整脚本：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force; $nodeVer = node --version 2>$null; if (-not $nodeVer -or ($nodeVer.Trim() -lt 'v20.0.0')) { Write-Error "Node.js v20+ required. Install from https://nodejs.org"; exit 1 }; npm install -g @google/gemini-cli --silent; $geminiDir = "$env:USERPROFILE\.gemini"; if (-not (Test-Path $geminiDir)) { New-Item -ItemType Directory -Path $geminiDir -Force >$null }; $envPath = "$geminiDir\.env"; $apiKey = Read-Host "请输入你的 GEMINI_API_KEY（sk-开头）"; $content = @"
GEMINI_API_KEY=$apiKey
GOOGLE_GEMINI_BASE_URL=https://letaicode.cn/gemini
GEMINI_MODEL=gemini-3-pro-preview
"@; Set-Content -Path $envPath -Value $content -Encoding UTF8; Write-Host "✅ Gemini CLI 已安装，配置已写入 $envPath"
注意：脚本中 【GEMINI_API_KEY=$apiKey】 这一行必须由你手动输入真实密钥，不可留空或填占位符，否则后续所有调用均会返回 401 错误。
macOS/Linux 一行命令全自动部署
适用于 zsh/bash 用户，自动检测 Shell 类型、校验 Node.js 版本、安装 CLI、创建 ~/.gemini 目录及配置文件，并永久写入环境变量。
在终端中直接运行以下单行命令（支持复制整行执行）：
curl -fsSL https://raw.githubusercontent.com/google-gemini/gemini-cli/main/scripts/install.sh | bash -s -- -y
该脚本会自动完成：Node.js 版本校验（v20+）、npm install -g @google/gemini-cli、mkdir -p ~/.gemini、生成 ~/.gemini/.env 与 ~/.gemini/settings.json、将 GEMINI_API_KEY 注入当前 Shell 配置（~/.zshrc 或 ~/.bashrc）。执行完毕后，关闭并重新打开终端即可使用 gemini 命令。
若你已手动设置过 GEMINI_API_KEY 环境变量，脚本会跳过重复写入，避免污染配置。
跨平台免 Node.js 方案：gmn 二进制极速部署
如果你只需要快速调用模型生成文本（不依赖交互式聊天、不处理图片/PDF），且追求启动速度与零依赖，gmn 是更优选择——它用 Go 编译，无需 Node.js，单文件即用。
方法一：macOS（Homebrew）
brew install tomohiroyoc/gmn/gmn
方法二：Linux/macOS（curl + chmod）
curl -L https://github.com/tomohiroyoc/gmn/releases/download/v0.8.2/gmn_$(uname -s)_$(uname -m) -o gmn && chmod +x gmn && sudo mv gmn /usr/local/bin/
方法三：Windows（PowerShell）
Invoke-WebRequest -Uri "https://github.com/tomohiroyoc/gmn/releases/download/v0.8.2/gmn_windows_amd64.exe" -OutFile "$env:USERPROFILE\gmn.exe"; $env:Path += ";$env:USERPROFILE"; [Environment]::SetEnvironmentVariable("Path", $env:Path, "User")
部署完成后，直接运行 gmn "解释什么是 HTTP 状态码 429" 即可获得响应。它不读取 .gemini 配置，所有参数需通过命令行传入，例如 gmn -k "sk-xxx" -m gemini-3-pro-preview "优化这段 Python 代码"。
验证安装是否成功
在任意终端窗口中运行：
gemini --version
如果输出类似 @google/gemini-cli/2.4.1 darwin-arm64 node-v22.16.0 的版本信息，说明 CLI 已正确安装。
接着运行一次最小测试：
gemini "只回答'OK'，不要加任何其他字符"
若终端在 3 秒内打印出 OK，且无 ERROR、Unauthorized、Connection refused 提示，表示 API 密钥、代理（如有）、基础 URL 全部配置就绪。
