安装、升级与发布渠道

选择包管理器和运行环境，区分 stable、preview、nightly 与临时执行。

This page has not been translated into English yet. The original Chinese version is shown below.

官方推荐 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-cli

macOS/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-cli

Google 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；本指南不承诺安装后自动获得沙箱，应按沙箱配置显式启用并验证。