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
- 開啟 Node.js 官方下載頁。
- 找到標示 LTS 的 Windows 安裝程式,下載
.msi檔案。 - 打開下載的檔案,依安裝程式一路按「下一步」。第一次使用請保留預設選項;不用特別勾選或加裝其他工具。
- 安裝結束後,關掉所有 PowerShell/Windows Terminal 視窗,再重新開一個 PowerShell。
Mac:下載並安裝 LTS
- 開啟 Node.js 官方下載頁。
- 找到標示 LTS 的 macOS 安裝程式,下載
.pkg檔案。 - 打開下載的檔案,依安裝程式一路按「繼續」。第一次使用請保留預設選項。
- 安裝結束後,關掉所有「終端機」視窗,再重新開一個「終端機」。
確認這一步完成
完成條件:node 與 npm 都顯示版本。
在重新開啟的 PowerShell 或終端機裡,貼上:
node --version
npm --version
看到兩行版本號就完成了:第一行會像 v…,第二行是 npm 的數字版本。接下來回到第 1 步建立的練習資料夾:
Windows(PowerShell):
cd $HOME\gemini-cli-lab
Mac(終端機):
cd "$HOME/gemini-cli-lab"
如果畫面說找不到這個資料夾,請回第 1 步確認或建立它;不要在目前資料夾另建同名資料夾,也不要自行改成其他位置。
node 或 npm 顯示「不是指令」?
先確認你已經關掉舊視窗、重新開 PowerShell/終端機;仍失敗才前往Node.js 安裝卡關。