sitdraw

如何安装并使用 Gemini CLI：登录 Google 并完成第一次编码任务

按官方步骤安装 Gemini CLI，用 Google 登录，并在当前仓库完成第一次编码任务。

要在终端里用 Gemini 读仓库、改代码，先完成三件事：安装 Gemini CLI，用 Google 账号登录，再在当前项目里做完第一次编码任务。

按官方入门走，不要猜命令。核心检索词是 如何安装 Gemini CLI、Gemini CLI 登录 Google，以及命令 gemini。文档在 geminicli.com/docs/get-started/。

20+Node.js 最低版本
npm官方推荐安装方式
Google推荐登录方式

先装对运行时，再选安装通道

npm 全局安装

先确认 node -v 不低于 20.0.0，再执行 npm install -g @google/gemini-cli。这是官方标准路径，稳定通道对应 latest 标签。

Homebrew 或其他

macOS / Linux 可用 brew install gemini-cli。只试一次用 npx @google/gemini-cli。不要同时用 npm 和 brew 各装一份，路径会打架。

方式适合谁要注意
Sign in with Google本机、有浏览器个人账号通常不必先建项目；Workspace 常要 GOOGLE_CLOUD_PROJECT
Gemini API 密钥AI Studio 用户、无浏览器环境密钥当秘密保存，不要写进仓库
Vertex AI已有 Google Cloud 项目必须配置 Cloud 项目与地区

安装、登录、第一次编码

  1. 01
    检查 Node 并安装

    官方要求 Node.js 20.0.0+，系统面写了 macOS 15+、Windows 11 24H2+、Ubuntu 20.04+。装完运行 gemini，看到认证提示再往下。

  2. 02
    用 Google 登录

    选 1. Sign in with Google，在浏览器选账号并点 Sign in。本机凭证会缓存。公司账号若要求项目，先设环境变量再开会话。

  3. 03
    进入仓库做第一件事

    在项目根目录开 gemini。先让它只读解释入口文件；确认理解后，再按官方示例请它给现有模块写单元测试，或提出一处小改动。

  4. 04
    批准写文件前先看 diff

    CLI 改文件或跑有副作用的命令前会问你。选 Allow once，不要默认永久放行。额度用 /stats model 看。

node -v
npm install -g @google/gemini-cli
gemini
# 登录后，在仓库根目录提问，例如：
# Read the entry file and explain how the app starts.
# Then write unit tests for Login.js and wait before writing files.
个人 Google 账号一定要 Cloud 项目吗？
官方写：多数个人账号不必。公司、学校或 Workspace 账号通常要。满足官方列出的例外条件时，个人账号也可能被要求设项目。
登录页打不开怎么办？
OAuth 要把浏览器重定向到终端监听的 localhost。远程 SSH、无图形环境或拦截 localhost 的网络会失败。可改用 Gemini API 密钥，或在能打开浏览器的机器上登录。
第一次该让它改多大的代码？
选能立刻跑测试或看出 diff 的小事。官方示例是给 Login.js 写测试，或克隆 chalk 并解释源码。不要一上来让它重构整个仓库。
装完就能当分享会工具吗？
不能。这是终端助手。要对着同一张模块图说话时，再开 sitdraw。

先看懂，再批准写入

模型可以口述一条听起来对的改动。没有你点头的写文件批准，它不该改仓库。测试仍要你自己跑。

开始画