安装、升级与发布渠道
选择包管理器和运行环境，区分 stable、preview、nightly 与临时执行。
官方推荐 macOS 15+、Windows 11 24H2+ 或 Ubuntu 20.04+，Node.js 20.0.0+，Shell 为 Bash、Zsh 或 PowerShell。短会话建议至少 4 GB 内存，大仓库或长会话建议 16 GB+；需要联网且位于 Gemini Code Assist 支持地区。
安装方式
选择适合现有环境的一种，不必同时安装多个渠道：
npm install -g @google/gemini-climacOS/Linux 可用 brew install gemini-cli，macOS 也可用 sudo port install gemini-cli。受限环境可先建立 Conda 环境：
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
npm install -g @google/gemini-cliGoogle Cloud Shell 和 Cloud Workstations 已预装 CLI。启动 gemini 后按认证选择账号或 API 后端。
临时执行
npx @google/gemini-cli这不建立永久全局安装，但仍会取得运行所需的 npm 包。直接测试 GitHub 主分支的方式是 npx https://github.com/google-gemini/gemini-cli，适合验证开发中的功能，不能当作固定版本发布。
渠道与升级
| 渠道 | 标签与节奏 |
|---|---|
| Stable | latest，默认安装，约每周从前一周 preview 加修复发布 |
| Preview | preview，每周发布，可能含未解决回归 |
| Nightly | nightly，每天取得主分支状态，仍有待验证内容 |
npm install -g @google/gemini-cli@latest
npm install -g @google/gemini-cli@preview
npm install -g @google/gemini-cli@nightly以上是可选渠道命令，按需求执行其中一个。gemini update 用于升级，gemini --version 用于确认实际版本。引用官方安装页中的旧示例镜像标签时应另查当前版本，不能把示例日期视为最新发布。
容器与沙箱
可以用 --sandbox 在配置好的隔离环境运行。安装页泛称有副作用工具默认在容器执行，但 CLI 参考列出 --sandbox 默认 false；本指南不承诺安装后自动获得沙箱，应按沙箱配置显式启用并验证。