安装 Gemini CLI 工具其实并不复杂，但大多数用户卡住的地方往往不是命令本身，而是环境准备环节。版本不对、路径没配好、权限被拦截——任何一个细节没到位，gemini 命令都无法正常启动。先说清楚几个硬性条件：Node.js 至少需要 v20.0.0，推荐使用长期支持版 LTS 24.12；npm 全局路径需要避开系统盘的权限限制；最后才是执行 npm install -g @google/gemini-cli 这一步。下面逐项拆解，按步骤操作基本不会出现问题。
如果想在终端中直接调用 Gemini 模型来分析代码、生成文档或调试 API，必须先安装好 Gemini CLI 工具并确保 Node.js 环境稳定可靠——版本不符、路径配置错误、权限被拦截，任何一个环节出错都会导致 gemini 命令无法运行。
确认并安装正确版本的 Node.js
打开终端（Windows 使用 CMD 或 PowerShell，macOS/Linux 使用 Terminal），执行：
node -v如果返回空、报错“不是内部或外部命令”，或者版本低于 v20.0.0，必须重新安装。目前最稳定的选择是 LTS 版本 24.12，不建议使用 v18 或 v22 这类非长期支持版——v18 缺少 fetch 全局对象，v22 在 Windows 上会触发 undici 的 TLS 握手失败。
请前往正式 https://nodejs.org/zh-cn/download/ 下载 Windows Installer (.msi) 或 macOS .pkg，安装时务必勾选 Automatically install the necessary tools（Windows），在 macOS 上可以使用 Homebrew 安装：
brew install node@24 && brew link --overwrite node@24安装完成后再次运行 node -v 和 npm -v，两个命令都必须输出带小数点的版本号才能确认环境就绪。
修改 npm 全局路径，避免系统盘权限限制
Windows 默认会将全局包安装到 C:Users用户名AppDataRoamingnpm，这个路径受系统保护，后续安装 Gemini CLI 时极易因为 EACCES 权限错误而中断。
方法一：手动创建目录并修改配置
在 D 盘新建两个文件夹：
mkdir D:Nodejs_global && mkdir D:Nodejs_cache然后执行：
npm config set prefix "D:Nodejs_global"
npm config set cache "D:Nodejs_cache"最后一步绝不能忽略：将 D:Nodejs_global 添加到系统环境变量 PATH 的用户变量中，而不是系统变量——否则后续所有 npm 全局操作都需要管理员权限才能写入，必然导致失败。
方法二（macOS/Linux）：
直接运行：
mkdir -p ~/.local/share/npm-global && npm config set prefix ~/.local/share/npm-global && echo 'export PATH=~/.local/share/npm-global/bin:$PATH' >> ~/.zshrc && source ~/.zshrc安装 Gemini CLI 并验证是否可执行
第一步：使用 npm 进行全局安装（推荐，兼容性最佳）
npm install -g @google/gemini-cli第二步：安装完成后立即验证
gemini --version如果输出类似 @google/gemini-cli/0.7.3 darwin-arm64 node-v24.12.0 的字符串，说明二进制文件已经就位；如果提示 command not found 或 gemini : 无法将“gemini”项识别为 cmdlet、函数、脚本文件或可运行程序的名称，说明上一步的 PATH 配置未生效，请重启终端后再试一次。
第三步：运行工具查看是否能拉起交互界面
gemini首次运行会弹出 Google 登录页面——需要注意：必须使用绑定美区手机号且未开启两步验证的 Google 账号，否则授权页面会卡在“正在加载”。在网页上点击同意后，终端若出现 > Type your message or @path/to/file 提示符，即表示安装与基础连通性全部完成。