在 Windows 和 Linux 上安裝 Gemini CLI 的終極指南

開始使用一個強大的新命令列工具有時會讓人望而生畏，尤其是在環境設定方面。本指南提供了清晰、易於遵循的說明，以確保官方 Gemini CLI 在您的 Windows 或 Linux 機器上順利運行。

前提條件：Node.js 和 npm

Gemini CLI 是作為 Node.js 套件分發的，這意味著您首先需要在您的系統上安裝 Node.js 及其套件管理器 npm。

• 檢查您是否已安裝它們： 開啟您的終端機（命令提示字元、PowerShell 或您的 Linux 終端機）並執行 node -v 和 npm -v。如果您看到版本號碼，那麼您就準備好了！
• 如何安裝它們： 如果您沒有安裝它們，我們強烈建議您造訪 Node.js 官網 並為您的作業系統下載 LTS (長期支援) 版本。安裝程式將為您處理一切。

第1步：安裝 Gemini CLI 套件

準備好 Node.js 和 npm 後，安裝 Gemini CLI 只需一個指令。-g 旗標很重要，因為它會在您的系統上「全域」安裝該套件，使得 gemini 指令可以從任何目錄存取。

開啟您的終端機並執行以下指令：

npm install -g @google/generative-ai

此指令從 npm 註冊表下載該套件並在您的系統上進行設定。

替代方案：無需安裝快速啟動 (npx)

如果您不想全域安裝該套件或只是想快速試用，您可以使用 npx。這個與 npm 捆綁在一起的指令會臨時下載並執行該套件，而不會在您的系統上永久安裝它。

只需在您的 gemini 指令前加上 npx @google/generative-ai：

npx @google/generative-ai "迄今為止發現的最遙遠的星系是什麼，它有多遠？"

這是一個立即開始的絕佳方式。在本指南的其餘部分，我們將假設您已經執行了全域安裝。

第2步：取得您的 Google AI API 金鑰

要使用 CLI，您需要使用 Google AI API 金鑰進行身分驗證。此金鑰告訴 Google 是誰在發出請求。如果您還沒有金鑰，我們有一個完整的教學，「如何透過3個簡單步驟取得您的Google Gemini API金鑰（2025年指南）」，它將引導您完成整個過程。

一旦您有了金鑰，請將其複製到剪貼簿並進行下一步。

第3步：設定 API 金鑰

您需要讓 gemini 指令能夠存取您的 API 金鑰。最安全和推薦的方法是設定一個環境變數。

對於 Linux 和 macOS

1. 開啟您的 shell 設定檔。這通常是 ~/.bashrc、~/.zshrc（對於大多數現代系統，包括 macOS）或 ~/.profile。

2. 將以下行新增到檔案末尾。請確保將 YOUR_API_KEY 取代為您複製的實際金鑰。

   export GOOGLE_API_KEY="YOUR_API_KEY"

3. 儲存檔案並重新啟動您的終端機，或執行 source ~/.zshrc（或您對應的檔案）以立即套用變更。

對於 Windows

1. 在開始功能表中搜尋「環境變數」，然後選取「編輯系統環境變數」。
2. 在「系統屬性」視窗中，點擊「環境變數...」按鈕。
3. 在頂部的「使用者變數」部分，點擊「新增...」。
4. 對於「變數名稱」，輸入 GOOGLE_API_KEY。
5. 對於「變數值」，貼上您先前複製的 API 金鑰。
6. 在所有視窗上點擊「確定」以儲存。

影片演練

有關視覺指南，這些簡短的影片涵蓋了該過程的關鍵步驟。

1. 如何全域安裝 NPM 套件：

2. 如何在 Windows 上設定環境變數：

第4步：驗證您的安裝

一切就緒！要確認一切正常，請在您的終端機中執行一個簡單的測試指令：

gemini "迄今為止發現的最遙遠的星系是什麼，它有多遠？"

如果安裝成功，您應該會從 Gemini 模型收到詳細的回答。恭喜，您已成功安裝和設定 Gemini CLI！

疑難排解提示

• command not found: gemini：這通常意味著全域 npm 安裝目錄不在您系統的 PATH 中。Node.js 安裝程式應該會處理這個問題，但如果沒有，您可能需要手動新增它。
• 身分驗證錯誤：如果您收到關於身分驗證的錯誤，請仔細檢查您是否已正確設定 GOOGLE_API_KEY 環境變數，並且沒有拼字錯誤。確保在設定後已重新啟動終端機。

現在您已經準備好從命令列探索 AI 的全部功能。查看我們的其他教學和使用案例，看看您能建構什麼！