wbmeet

如何用 Gemini CLI 完成 Git 倉庫首個可審查改動：安裝、Google 登入與終端任務

安裝 Gemini CLI、Google 登入，在自有倉庫完成第一個可 git diff 審查的終端編碼任務。

第一次在自有 Git 倉庫里用 Google Gemini CLI，卡住的多半不是提示词，而是 gemini 没装好、Google 登入没完成，或还没在倉庫根目录跑过 git status。按 geminicli.com/docs 装好 CLI、登入，再完成一条能用 git diff 审查的改动。

檢索詞是 如何用 Gemini CLI 在 Git 倉庫做第一个可审查编码任务。下文对照 GitHub google-gemini/gemini-cli 的安裝与认证说明。终端 @ 文件语法见站内 Gemini CLI @ 文件笔记。这不是 wbmeet 会议说明；要约短会过 diff，用 wbmeet 建房，见 如何建立與加入房間。

安裝 geminiGoogle 登入倉庫首任务 + git diff

Gemini CLI 在倉庫里做什么

Gemini CLI 是 Google 开源的终端 AI Agent（命令 gemini）：读工作区、改文件、在批准下跑 shell。个人开发者常用 Sign in with Google（OAuth）；也可用你在 aistudio.google.com/apikey 创建的 GEMINI_API_KEY。免费额度与速率以 cloud.google.com/gemini/docs/quotas 为准。

git diff
审查改动
OAuth
Google 登入
1 文件
第一小时范围

安裝 Gemini CLI

  1. 1

    准备 Node.js（npm 路径）

    确认 node -v 与 npm -v 可用（版本要求见 geminicli.com/docs/get-started/installation）。受限环境可参考 README 里的 conda 方案。

  2. 2

    全局安裝或试跑

    推荐 npm install -g @google/gemini-cli；macOS/Linux 可选 brew install gemini-cli。不想全局装：npx @google/gemini-cli。装完新开终端，运行 gemini --version。

  3. 3

    排查 command not found

    若找不到 gemini，把 npm 全局 bin 目录加入 PATH（nvm 用户常见 ~/.nvm/versions/node/.../bin）。仍失败对照官方 Troubleshooting。

用 Google 账号登入

  1. 1

    进入倉庫根目录

    cd 到你拥有的 Git 项目根，先跑 git status，看清未提交改动，方便之后 review。

  2. 2

    启动 gemini 并 OAuth

    执行 gemini，选择 Sign in with Google，在浏览器完成官方 OAuth。组织 Gemini Code Assist 用户可按 README 设置 GOOGLE_CLOUD_PROJECT 后再启动。

  3. 3

    API Key 路径（可选）

    在 AI Studio 创建密钥，export GEMINI_API_KEY="…" 后启动。密钥勿写进 Git 或截图外传。

倉庫里第一个可审查编码任务

  1. 1

    第一条：只读摸底

    示例：「用三句话说明这个倉庫的入口模块和主要对外 API；若需要可读 @README.md。」确认它引用的路径与磁盘一致。

  2. 2

    第二条：要小 diff

    示例：「给一个未覆盖的 helper 补单测，或修正 README 里一处 typo；先展示 unified diff，等我确认再写入。」Gemini CLI 改文件前应展示 diff——第一小时只批准单文件小改动。

  3. 3

    用 git diff 自己再过一遍

    任务结束后运行 git diff 全文审查；若 Agent 提议跑 npm test 等命令，先读命令与输出再批准。不满意用 git restore 回滚未提交文件。

# First hour · Gemini CLI · Git repo · 2026-10-14
npm install -g @google/gemini-cli
cd /path/to/your/git/repo
git status
gemini
# Sign in with Google
# Prompt 1: explain entry point (read-only)
# Prompt 2: one unit test; show diff first
git diff

安裝与认证对照

方式适合第一次注意
npm 全局跨平台日常用PATH 含 global bin
HomebrewmacOS / Linuxbrew upgrade gemini-cli
Google OAuth个人开发者额度见 quotas 页
GEMINI_API_KEY指定模型/计费密钥勿进 Git
01

改动文件过多

要求「只改一个文件」；用 @ 点名单文件而非整个目录。

02

与 Codex / Claude Code 并行

可同时安裝多个终端 Agent，但同一倉庫避免两个 Agent 同时写。对照 OpenAI Codex CLI 与 Claude Code。

03

第一任务停在解释

解释倉庫只是热身；必须有一条可 revert 的 diff 并用 git diff 审查。

建议路径：官方安裝 → Google 登入 → 倉庫根 git status → 只读首问 → 小 diff + git diff。细节以 geminicli.com/docs 与你安裝的版本为准。

和 @ 文件专文的关系
本页强调 Git 倉庫里的第一个可审查编码任务；@ 引用语法见 Gemini CLI @ 文件。
GEMINI.md
项目级上下文文件可在熟悉基本流程后再加，勿把密钥写进去。
本页主题
只讲 Gemini CLI 第一次在自有倉庫落地 diff，不是会议产品说明。

还想核对的问题

必须先会 @ 文件语法吗？

不必。第一小时可直接自然语言描述要改的文件路径；熟悉 @ 后上下文更精确，见站内 @ 文件专文。

会自动 git commit 吗？

不应替你 push；是否运行 git 命令取决于你的批准。第一次建议只改工作区，自己 commit。

免费 Google 账号够用吗？

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

第一个任务必须写测试吗？

不必。任何可 revert 的小改动都行，关键是 diff-first 与 git diff 审查。

免費開始開會