Gemini 3 Pro 全平台安装教程：Windows与macOS详细指南
Windows 或 macOS 上部署 Gemini 3 Pro 官方 CLI 工具，完整流程收敛为五个关键步骤：环境准备、包管理安装、API 密钥申请、环境变量配置、模型切换。任何一环缺失，gemini 命令都会报错或无法加载 3 Pro 模型。以下逐层拆解，确保每步可复现。
操作系统检测与 Node.js 版本校验
打开终端（Windows 使用 PowerShell 或 CMD，macOS 使用 Terminal），执行 node -v 查看版本。若显示 v18.0.0 以下或提示“命令未找到”，需立即升级 Node.js。Gemini CLI 强制要求 Node.js ≥ v20.0.0，低版本即使完成安装，首次运行也会直接崩溃。
前往 Node.js 官网下载 LTS 版本（当前 v20.15.1），安装时务必勾选“Add to PATH”。完成后必须重启终端，否则 PATH 不生效——这一步常被遗漏。
【必须重启终端，否则 PATH 不生效】
全局安装 Gemini CLI
提供三种安装方式，按需选择：
方式一（推荐）：npm 全局安装
npm install -g @google/gemini-cli
方式二：临时测试免安装，直接运行
npx https://github.com/google-gemini/gemini-cli
方式三（macOS/Linux）：Homebrew 安装
brew install gemini-cli
安装过程无花哨提示——终端无报错即视为成功。安静才是好消息。
获取并配置 API 密钥
第一步：在 aicodemirror.com 注册账号，新用户自动获得 2000 积分（邀请好友额外获取 1000 积分，可选操作）。
第二步：登录后进入「API密钥」页面，点击「Create new key」生成密钥，立即复制并保存——密钥仅展示一次，关闭页面后永久丢失。
第三步：配置两个核心环境变量：
- 变量名：
GOOGLE_GEMINI_BASE_URL，值：https://api.aicodemirror.com/api/gemini - 变量名：
GEMINI_API_KEY，值：上一步复制的密钥
Windows 用户通过「控制面板 → 系统 → 高级系统设置 → 环境变量」添加；macOS/Linux 用户编辑 ~/.zshrc 或 ~/.bashrc，追加两行 export 语句，然后执行 source ~/.zshrc 生效。
【GEMINI_API_KEY 必须是纯字符串，不允许空格、引号或换行】
启动 CLI 并切换至 Gemini 3 Pro
第一步：任意目录下执行 gemini，首次启动进入交互式初始化流程。
第二步：使用方向键高亮选择 Use Gemini API Key，回车确认——切勿直接回车跳过，否则会卡在登录页。
第三步：输入 /settings → 方向键将 Preview Features 切换为开启 → 回车保存。
第四步：输入 /model → 列表中用方向键选中 Gemini 3 Pro → 回车确认。
此时观察终端顶部状态栏，若显示 Model: gemini-3-pro，说明最新模型已成功激活。