wbmeet

如何使用 Google Gemini CLI：npm 或 brew 安装、Google 登录与 @ 文件上下文

npm 或 Homebrew 安装 Gemini CLI，Google 账号登录，用 @ 引用文件完成第一条终端 Agent 提示。

第一次在终端跑 Google Gemini CLI，卡住的多半是 Node 版本、gemini 不在 PATH，或还没完成 Google 账号登录。按官方 README 与 geminicli.com/docs 装好 CLI，在项目目录登录，再用 @ 把文件上下文塞进第一条提示。

检索词是 如何使用 Google Gemini CLI 安装与 @ 文件。下文对照 GitHub 仓库 google-gemini/gemini-cli 的安装与认证说明，以及文件管理教程里的 @ 引用语法。这是 Google 的终端 AI Agent，不是本站会议产品。要约短会对齐 diff，用 wbmeet 建房即可，步骤见 如何创建与加入房间。

安装 CLIGoogle 登录@ 文件与首条提示

Gemini CLI 适合谁

Gemini CLI 是开源（Apache 2.0）的终端优先 AI Agent：读仓库、改文件、跑 shell、按需做 Google Search grounding。个人开发者常用Sign in with Google（OAuth）；官方 README 写明个人 Google 账号有免费额度（以当前 cloud.google.com/gemini/docs/quotas 与条款为准）。也可用 GEMINI_API_KEY（AI Studio）或 Vertex AI 企业路径。

npm / brew
常见安装路径
@ path
强制注入文件上下文
OAuth / key
Google 账号或 API Key

用 npm 或 Homebrew 安装

  1. 1

    准备 Node.js

    npm 路径需要受支持的 Node.js（版本以官方 installation 页为准）。确认 node -v 与 npm -v 可用。受限环境可用 README 里的 conda + nodejs 方案。

  2. 2

    全局安装或 npx 试跑

    推荐：npm install -g @google/gemini-cli。macOS/Linux：brew install gemini-cli。不想全局装时：npx @google/gemini-cli。稳定通道：@latest；尝鲜可用 @preview 或 @nightly（见官方 Release Channels）。

  3. 3

    验证命令

    新开终端，运行 gemini --version（或按当前版本文档）。若 command not found，检查 npm 全局 bin 目录是否在 PATH（常见 ~/.npm-global/bin 或 nvm 路径）。

用 Google 账号登录（或 API Key）

  1. 1

    进入项目目录并启动

    cd 到你要改的仓库，执行 gemini。首次交互里选择 Sign in with Google，按提示在浏览器完成 OAuth。

  2. 2

    组织 Code Assist 许可证（可选）

    若公司发放 Gemini Code Assist，README 建议设置 export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID" 后再跑 gemini。项目 ID 以 Google Cloud 控制台为准。

  3. 3

    API Key 路径（可选）

    在 aistudio.google.com/apikey 创建密钥，export GEMINI_API_KEY="YOUR_API_KEY" 后启动。不要把密钥写进 Git 或截图发群。

第一条提示与 @ 文件上下文

  1. 1

    用 @ 强制读入文件

    官方文件管理教程：在提示里写 @src/foo.ts 会立即读取该文件并注入上下文。例：@src/utils/helpers.ts 解释这个模块的导出函数各自做什么。

  2. 2

    多文件与目录

    可链式引用：@src/A.tsx @src/types/User.ts。整目录：@src/utils/（大文件夹会消耗更多 token，第一次尽量点名单文件）。

  3. 3

    做一个可审查的小任务

    第二条提示要可 diff：例如「在 @README.md 修正一处拼写，先展示 unified diff 等我确认再写入」。Gemini CLI 改文件前会展示 diff，第一小时只批准小改动。

# First hour · Gemini CLI · 2026-09
npm install -g @google/gemini-cli
# or: brew install gemini-cli
gemini --version
cd /path/to/your/repo
gemini
# choose: Sign in with Google
# first prompt:
@src/main.ts Summarize the entry point and list public exports.
# second prompt:
@src/main.ts Add a one-line JSDoc to the main export; show diff before writing.

安装方式与认证对照

方式适合第一次注意
npm 全局跨平台日常用PATH 含 npm global bin
HomebrewmacOS / Linuxbrew upgrade gemini-cli
npx零安装试跑每次拉包，较慢
Google OAuth个人开发者额度见官方 quotas 页
GEMINI_API_KEY要指定模型/计费密钥勿进 Git
01

gemini 找不到

查 npm 全局路径、新开终端。npx 试跑可隔离 PATH 问题。

02

浏览器登录没弹出

按终端提示复制 OAuth URL；检查默认浏览器与代理。

03

@ 路径不对

相对路径从当前工作目录解析；先 pwd 确认在仓库根目录。

官方路径：安装 Gemini CLI → Google 登录或 API Key → 在项目里用 @file 注入上下文 → 小改动并审查 diff。以 geminicli.com/docs 与你安装的版本为准。

和 Claude Code / Copilot CLI 的区别
各家终端 Agent 命令与认证不同；可同时安装，按任务选工具。本站另有 Claude Code 安装笔记 可对照。
GEMINI.md 是什么
官方支持项目级上下文文件（类似其他工具的 rules 文件），可在熟悉 @ 引用后再配置。
教程页不是会议说明书
只讲 Gemini CLI 第一次。短会白板见 wbmeet。

还想核对的问题

必须用 Homebrew 吗？

不必。npm 全局安装是 README 里的主路径；macOS/Linux 可选 brew install gemini-cli。

免费 Google 账号够用吗？

个人 OAuth 有官方文档写的免费额度与速率限制，以 cloud.google.com/gemini/docs/quotas 及当前条款为准；超出需 API Key 或付费方案。

@ 和大文件夹有什么区别？

单文件 @ 精确、省 token；@整个目录 适合 broad 问题但消耗更大。第一次优先 1–2 个关键文件。

改文件会自动写入吗？

官方强调改前展示 unified diff，需你确认。第一小时只批准可读的小改动。

免费开始开会