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。

先看懂，再批准寫入

模型可以口述一條聽起來對的改動。沒有你點頭的寫檔批准，它不該改倉庫。測試仍要你自己跑。

開始畫