Hub Google AI CLI 教學

Gemini CLI 限定路線 · 準備 2 / 4

Gemini CLI 限定路線:安裝 Node.js LTS

Gemini CLI 需要 Node.js 才能執行;Antigravity CLI 個人起步不需要。本頁只給已確認組織、API key 或 Vertex AI 路線的人。

開始前:你已確認 Gemini CLI 是正確工具。

還沒確認就先回工具選擇;一般個人帳號不應因為舊教學而先裝 Node.js。確認後,再建立 gemini-cli-lab 與選擇 LTS(長期支援)

Windows:下載並安裝 LTS

  1. 開啟 Node.js 官方下載頁
  2. 找到標示 LTS 的 Windows 安裝程式,下載 .msi 檔案。
  3. 打開下載的檔案,依安裝程式一路按「下一步」。第一次使用請保留預設選項;不用特別勾選或加裝其他工具。
  4. 安裝結束後,關掉所有 PowerShell/Windows Terminal 視窗,再重新開一個 PowerShell

Mac:下載並安裝 LTS

  1. 開啟 Node.js 官方下載頁
  2. 找到標示 LTS 的 macOS 安裝程式,下載 .pkg 檔案。
  3. 打開下載的檔案,依安裝程式一路按「繼續」。第一次使用請保留預設選項。
  4. 安裝結束後,關掉所有「終端機」視窗,再重新開一個「終端機」。

確認這一步完成

完成條件:node 與 npm 都顯示版本。

重新開啟的 PowerShell 或終端機裡,貼上:

node --version
npm --version

看到兩行版本號就完成了:第一行會像 v…,第二行是 npm 的數字版本。接下來回到第 1 步建立的練習資料夾:

Windows(PowerShell):

cd $HOME\gemini-cli-lab

Mac(終端機):

cd "$HOME/gemini-cli-lab"

如果畫面說找不到這個資料夾,請回第 1 步確認或建立它;不要在目前資料夾另建同名資料夾,也不要自行改成其他位置。

nodenpm 顯示「不是指令」?

先確認你已經關掉舊視窗、重新開 PowerShell/終端機;仍失敗才前往Node.js 安裝卡關