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，需你確認。第一小時只批准可讀的小改動。

免費開始開會