Gemini CLI 支持多种安装方式：无需安装直接用 npx @google/gemini-cli；或用 npm install -g @google/gemini-cli 全局安装；macOS 用户可用 Homebrew。本页覆盖所有安装方式和系统要求，帮你在 5 分钟内跑起来。

Gemini CLI 安装指南

系统要求

项目	要求
操作系统	macOS 15+ / Windows 11 24H2+ / Ubuntu 20.04+
运行时	Node.js 20.0.0+
Shell	Bash、Zsh 或 PowerShell
RAM（轻度使用）	4GB+
RAM（重度使用）	16GB+（大型代码库、长会话）
网络	需要能访问 Google 服务

国内用户注意：需要代理或 VPN 才能访问 Gemini 服务。也可使用 Gemini API Key 配合支持国内访问的中转服务。

安装方式

方式一：npx（无需安装，立即体验）

npx @google/gemini-cli

适合临时使用或首次体验，不会在系统上留下任何文件。

方式二：npm 全局安装（推荐）

npm install -g @google/gemini-cli
gemini

安装完成后，全局可用 gemini 命令。

方式三：Homebrew（macOS / Linux）

brew install gemini-cli

方式四：MacPorts（macOS）

sudo port install gemini-cli

方式五：Anaconda 隔离环境

适合受限环境（如公司 IT 政策下不允许全局安装）：

# 创建并激活新环境
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env

# 在环境内全局安装
npm install -g @google/gemini-cli

更新到最新版本

gemini update

或通过 npm 更新：

npm update -g @google/gemini-cli

验证安装

gemini --version

下一步

安装完成后，需要进行认证配置才能开始使用。

常见问题

Q: 安装报错 EACCES: permission denied

A: 说明 npm 全局目录权限不足。推荐用 nvm 管理 Node.js 版本，或运行 npm config set prefix ~/.npm-global 将全局包安装到用户目录。

Q: Windows 上 gemini 命令找不到

A: 检查 npm 全局 bin 目录是否在 PATH 中。运行 npm bin -g 查看路径，手动添加到系统环境变量。

Q: 能在 VS Code 集成终端中使用吗？

A: 可以，Gemini CLI 是纯命令行工具，在任何终端（包括 VS Code、Windows Terminal、iTerm2）中均可正常运行。