Gemini CLI 硬件要求：系统、内存与显卡配置
Gemini CLI 是运行在终端里的 Gemini 编程代理，可在确认配置后完成安装、启动与账号验证。
两件事、两个日期，分别出自不同来源：系统与运行时要求来自 2026 年 5 月 13 日发布的官方安装文档（推荐 macOS 15+、Windows 11 24H2+ 或 Ubuntu 20.04+，要求 Node.js 20.0.0+）；账号迁移是更晚发生的事件——2026 年 6 月 18 日起个人免费账号与 Google AI Pro、Ultra 订阅转向 Antigravity CLI（出自 6 月 18 日后的官方说明，与安装文档的发布日期无关）。硬件门槛并不高，但装之前先按下面一节确认账号类型，而不是只看电脑配置。
先判断你该装哪个 Google CLI
Gemini CLI 的主要计算工作在远端服务完成，终端里运行的是负责交互、读取项目和调用工具的客户端。因此它不是在本机运行完整大模型，普通电脑通常也不需要独立显卡或 CUDA 环境；官方推荐规格中没有列出显存要求。这是根据官方运行方式和规格清单作出的边界判断，不是官方对所有显卡型号作出的兼容性承诺。
账号和用途决定命令选择：
| 你的情况 | 应选工具 | 原因 |
|---|---|---|
| 个人使用，原来使用免费额度或 Google AI Pro、Ultra | Antigravity CLI（agy） |
相关个人访问已于 2026 年 6 月 18 日迁移 |
| 企业使用 Gemini Code Assist Standard 或 Enterprise | Gemini CLI（gemini） |
当前仓库面向这些企业工作流 |
| 使用 Code Assist for GitHub on Google Cloud | Gemini CLI（gemini） |
官方仓库列出的适用场景 |
| 只需要脚本或 CI 调用 Gemini API | Gemini API CLI（gemini-api） |
它是无状态 API 客户端，不是编程代理终端 |
如果你只是照着旧教程执行 gemini，但个人账号登录后无法获得原先的免费访问，应先阅读 Gemini CLI 官方仓库的 “Which Google CLI do you need?” 表格，再选择 Antigravity CLI 的下载或迁移入口。
机型与内存：先按使用强度选择
官方安装文档把内存需求分成两类：“Casual”使用需要 4GB 以上 RAM，适合短会话、常见任务和编辑；“Power”使用需要 16GB 以上 RAM，适合长时间会话、大型代码库和较深的上下文。这里的重点不是“能不能启动”，而是你是否经常让代理持续读取一个大型仓库、保留长对话，并同时运行测试、构建工具或多个编辑器。
可按下面的方法选：
- 只是修改少量文件、运行短命令，4GB 以上内存可以作为起点，但系统同时运行浏览器和 IDE 时更容易变慢。
- 要分析多模块项目、持续运行代理会话，直接选择 16GB 以上内存。
- 操作系统版本优先满足官方推荐值：macOS 15+、Windows 11 24H2+、Ubuntu 20.04+。Windows 原生环境之外，还可以按仓库说明使用 WSL2。
- GPU 不列入硬性门槛。没有独立显卡时，不要额外安装 CUDA，也不要下载本地模型；这类安装与 Gemini CLI 的远端调用方式并不对应。
官方没有给出 CPU 核心数下限，也没有公布某款笔记本的“最佳型号”。选机器时，真正有明确依据的指标只有操作系统版本、内存档位和 Node.js 版本。购买第三方标注的“Gemini CLI 专用配置”，应回到这三项重新核对。
三步检查并安装
1. 确认系统与 Node.js
先打开终端，执行：
node --version版本号应达到 v20.0.0 或更高。若输出低于 v20.0.0，先升级 Node.js，再继续安装；不要同时保留两个 npm 全局安装目录，否则后一次安装可能写入不同的命令路径。
Windows 用户还要确认当前终端确实位于准备使用 Gemini CLI 的环境内；Linux 和 macOS 用户则应确认使用的是日常开发账号，而不是权限受限的系统账号。
2. 先临时运行，确认账号和网络可用
不想改系统目录时，直接使用官方仓库给出的临时运行命令：
npx @google/gemini-cli这个方式无需预先全局安装，适合先检查账号登录、权限和网络是否正常。首次执行时，npm 会下载所需包；如果浏览器弹出 Google 授权页面，完成授权后再回到终端。
3. 确认可用后改为全局安装
如果临时运行成功，再安装全局命令：
npm install -g @google/gemini-climacOS 或 Linux 也可以使用 Homebrew：
brew install gemini-cli受管电脑无法修改全局 npm 目录时，可以建立独立 Conda 环境，再在环境内安装：
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
npm install -g @google/gemini-cli这三种方式不要在同一台电脑上同时使用。先选一种并验证，避免更新时出现“当前终端找不到命令”或实际运行了另一个版本的问题。完整命令与系统规格见 Gemini CLI installation, execution, and releases。
账号、显存与配置目录
按 2026 年 6 月 18 日后的官方说明，Gemini CLI 面向 Gemini Code Assist Standard、Enterprise、Code Assist for GitHub on Google Cloud，以及仍持有旧版付费 API 或 Vertex AI 密钥的组织。官方 README 明确写有：“No free tier or Google AI plans”。所以，个人订阅 Google AI Pro 或 Ultra 并不自动获得 Gemini CLI 的个人免费访问；这些用户应转到 Antigravity CLI。
显卡方面，同样不需要在 Gemini CLI 配置文件中填写 CUDA 路径或显存上限。官方规格清单只给出操作系统、内存、Node.js、Shell 和支持地区，没有独立的 GPU、VRAM 或 CUDA 字段。模型推理请求由服务端完成，本地 GPU 主要影响你同时运行 IDE、编译器和容器时的资源竞争，不会因为显卡较弱而要求启用某个模型配置。
Gemini CLI 的用户级配置位于 ~/.gemini/，其中 settings.json 保存用户级设置，项目级配置则放在项目的 .gemini/ 目录。该路径来自 Google Gemini CLI 完整使用指南 的配置说明，可用于排查项目设置是否覆盖了用户设置；涉及模型、认证和区域限制时，仍以官方仓库和官方安装文档为准。
常见卡点与对应处理
登录后没有个人免费访问
官方 README 的状态提示是：“No free tier or Google AI plans”。这不是显卡或内存不足造成的。个人用户应进入仓库首页的 “Which Google CLI do you need?”，选择 Antigravity CLI 的下载或迁移入口；企业用户则核对是否拥有 Code Assist Standard、Enterprise、Code Assist for GitHub on Google Cloud，或仍有效的旧版 API、Vertex AI 密钥。
误以为它适合测试 Gemini 4 系列
官方 README 还写明：“Not optimized for Gemini 4+”，并说明其测试框架没有针对 Gemini 4 及后续系列调优。因此，不要用 Gemini CLI 对 Gemini 4 系列跑模型基准，也不要把结果当成代表性评测。需要 Antigravity CLI 或 Gemini API CLI 的用户，应按用途进入对应工具入口。
终端提示 Node.js 版本不满足
先用 node --version 检查实际版本。低于 v20.0.0 时，升级到 20 或更高版本后重新打开终端，再执行 npx @google/gemini-cli。如果终端仍显示旧版本，说明 PATH（系统用于查找可执行命令的环境变量）仍指向旧 Node.js；此时先修正 PATH，不要反复重装 Gemini CLI。
全局安装后找不到 gemini
先确认当前使用的是哪种安装方式。npm 安装应检查 npm 全局目录是否在 PATH 中；Homebrew 安装应确认 Homebrew 环境已初始化；Conda 安装则必须先执行 conda activate gemini_env。不要同时安装三种版本再猜测当前运行的是哪一个。
怎么算配置成功
完成配置后，应同时看到三类结果：
node --version输出v20.0.0或更高版本。- 执行
npx @google/gemini-cli或启动全局安装的gemini后，终端出现 Gemini CLI 的交互界面或登录入口。 - 企业账号能够完成 Google 授权，并在项目目录中正常进入交互会话；个人账号则根据官方迁移说明改用 Antigravity CLI。
如果终端能打开但没有模型访问权，问题在账号、地区或授权范围，不在显卡。官方仓库同时给出了文档入口和不同 Google CLI 的选择表，可在安装或迁移前再次核对：Gemini CLI 官方仓库。
参考来源
评论区
登录后可评论。