必须安装 Node.js v20.0.0+（推荐 LTS 24.12），配置 npm 全局路径避开权限问题，再执行 npm install -g @google/gemini-cli 并验证 gemini --version 和交互启动成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在终端里直接调用 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）或使用 Homebrew 安装（macOS）：
brew install node@24 && brew link --overwrite node@24
装完再跑一遍 node -v 和 npm -v，两个都得输出带小数点的版本号才算过关。
改 npm 全局路径，避开系统盘权限陷阱
Windows 默认把全局包装进 C:\Users\用户名\AppData\Roaming\npm，这个路径受系统保护，后续安装 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"
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
最后一步不能漏：把 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 提示符，即表示安装与基础连通性全部完成。
