安装 Gemini CLI

Gemini CLI 是 Google 开源的终端代理工具。它对做研究的人有一个别家没有的优势：用 Google 账号登录就有免费额度，不需要先付费才能试。

官方给的免费额度是每分钟 60 次请求、每天 1000 次请求。对「偶尔用一下」来说完全够。

开始之前

• Node.js 20 或更高（仓库的 .nvmrc 指定为 20）
• Google 账号（或 Gemini API key）

检查你的 Node 版本：

node --version

没装或版本太低：

• Mac：brew install node，或去 https://nodejs.org 下载
• Windows：winget install OpenJS.NodeJS，或去 https://nodejs.org 下载

四种装法

一、不安装，直接跑（最快）

想先试试再决定装不装：

npx @google/gemini-cli

npx 会临时下载并运行，不往系统里装东西。

二、npm 全局安装（推荐）

npm install -g @google/gemini-cli

三、Homebrew（Mac / Linux）

brew install gemini-cli

四、MacPorts

sudo port install gemini-cli

验证与启动

gemini

三种登录方式

方式一：Google 账号登录（推荐）

启动 gemini 后选 Sign in with Google，浏览器完成授权。这条路子有免费额度，不用配任何 key。

方式二：Gemini API key

如果你已经有 API key：

export GEMINI_API_KEY="你的_API_KEY"
gemini

写进 ~/.zshrc（Mac）或 ~/.bashrc 可以免得每次都设。但别把 key 提交进任何版本库或共享文档。

方式三：Vertex AI

走 Google Cloud 的话：

export GOOGLE_API_KEY="你的_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

什么场景值得装它

免费额度是最实在的理由。 你想让一个代理工具帮你批量处理文件，但又不想为此再开一份订阅——Gemini CLI 的免费档能覆盖不少日常量。

它是开源的。 代码在 GitHub 上公开，对需要向 IT 部门解释「这个工具在我电脑上做了什么」的人来说，这一点有时比功能更重要。

多一个交叉验证的来源。 同一份材料让两个不同厂商的模型各读一遍，结论一致的部分可信度更高，不一致的部分正是你该亲自去核的地方。做资料核查时，这个用法比任何单一工具都稳。

提醒

它同样能直接改你本地的文件。第一次用先在一个可以随便折腾的目录里跑，看清楚它的行为方式再上真活儿。