快速上手：安装、登录与第一个任务

用 npm、Homebrew、MacPorts 或 Anaconda 安装 Gemini CLI，系统要求、发布渠道（稳定、预览、每日构建）、运行方式和第一个任务。

系统要求

官方推荐的配置：

操作系统：macOS 15+、Windows 11 24H2+、Ubuntu 20.04+
硬件：「日常」使用 4 GB 以上内存（短会话、常见任务和编辑）；「重度」使用 16 GB 以上内存（长会话、大型代码库、深度上下文）
运行时：Node.js 20.0.0 或更高版本
Shell：Bash、Zsh 或 PowerShell
位置：Gemini Code Assist 支持的地区
需要互联网连接

Gemini CLI 已预装在 Cloud Shell 和 Cloud Workstations 里。

安装

多数用户推荐下面几种方式之一：

# npm（官方文档里标准的安装方式）
npm install -g @google/gemini-cli

# Homebrew（macOS / Linux）
brew install gemini-cli

# MacPorts（macOS）
sudo port install gemini-cli

在受限环境里可以用 Anaconda：先 conda create -y -n gemini_env -c conda-forge nodejs 并激活环境，再在环境里 npm install -g @google/gemini-cli。

运行

多数用户在项目目录里直接运行 gemini 命令：

gemini

也可以不安装，用 npx 直接运行：npx @google/gemini-cli。想试用主分支上还在开发的功能，可以直接从 GitHub 运行：npx https://github.com/google-gemini/gemini-cli。

出于安全和隔离，Gemini CLI 可以在容器里运行（这也是它默认执行可能有副作用的工具的方式）：用已安装的 CLI 加 --sandbox 标志，例如 gemini --sandbox -y -p "your prompt here"，也可以直接运行发布在注册表里的沙箱镜像。详见「沙箱」页。

发布渠道

Gemini CLI 有三个发布渠道：

Stable（稳定）：每周发布一次，由上一周的预览版加上缺陷修复创建，使用 latest 标签，是默认安装：npm install -g @google/gemini-cli 或 npm install -g @google/gemini-cli@latest
Preview（预览）：每周发布，没有经过充分验证，可能有回归或遗留问题：npm install -g @google/gemini-cli@preview
Nightly（每日构建）：每天发布，包含发布时主分支上的所有改动，应当假定还有待验证的问题：npm install -g @google/gemini-cli@nightly

用 gemini update 更新到最新版本。

第一个任务

登录后直接用自然语言提问或提出任务，例如让它按内容重命名一个目录里的图片、读取一个开源仓库并解释它的工作原理、合并两个 CSV 文件、或为 Login.js 写单元测试。Gemini CLI 执行会改动文件的操作前会请求权限，你可以选择「Allow once」等选项。官方提醒这些示例展示的是潜在能力，实际结果取决于所用模型和你的项目环境。

用 /stats model 命令查看当前会话的 token 用量，以及你在受支持模型上的总体配额和用量。

快速上手：安装、登录与第一个任务

系统要求

安装

运行

发布渠道

登录

第一个任务

接下来