終端機神器！Gemini CLI 安裝與設定教學，輕鬆玩轉 Gemini 2.5 Pro

Google 推出了官方的 Gemini CLI (Command-Line Interface) 工具 gemini-cli，讓開發者與技術愛好者可以直接在終端機環境中，與強大的 Gemini 模型進行互動。這不僅提升了效率，更棒的是，它採用了極其便利的帳號驗證方式，讓你無需手動管理 API 金鑰，就能享受慷慨的免費額度。

本篇文章將帶你從零開始，完成 gemini-cli 的安裝與首次設定。

步驟一：安裝 Node.js (如果尚未安裝)

這是安裝 gemini-cli 的必要前提。gemini-cli 是基於 Node.js 開發的工具，因此你的電腦中必須先有 Node.js 執行環境。

Node.js：一個執行 JavaScript 程式的環境。
npm：Node.js 的套件管理器，安裝 Node.js 時會一併安裝。

如果你不確定是否已安裝，可以在終端機輸入 node -v 與 npm -v 來檢查。若未安裝，請至 Node.js 官方網站下載並安裝。

步驟二：安裝 gemini-cli

當你確認環境中已安裝 Node.js 與 npm 後，開啟你的終端機 (例如 PowerShell、Command Prompt 或 Terminal)，執行以下指令來進行全域安裝：

npm install -g @google/gemini-cli

安裝過程會自動下載所需的套件。完成後，你會看到類似下方的成功訊息：

PS D:\Portable\gemini-cli> npm install -g @google/gemini-cli

added 425 packages in 45s

步驟三：首次執行與設定

安裝完成後，直接在同一個終端機視窗中輸入 gemini 並執行：

gemini

第一次執行時，程式會引導你進行一些簡單的互動式設定：

選擇顏色主題 (Choose a color theme)：你可以根據個人喜好選擇亮色或暗色主題，這會影響 gemini-cli 在終端機中的顯示樣式。
帳號驗證 (Authenticate)：這是最關鍵也最方便的一步！程式會提示你在瀏覽器中用你的 Google 帳號登入。點擊連結、登入並授權後，gemini-cli 就會自動完成憑證設定。

Google 帳號授權成功畫面

這種驗證方式遠比手動複製、貼上及設定 API 金鑰要方便得多。更重要的是，根據官方文件，透過此方式登入，你可以獲得非常慷慨的免費額度（Gemini 2.5 Pro 模型，每分鐘 60 次請求），對於日常使用與測試來說綽綽有餘！

開始使用！

初始設定是一次性的。 未來你每次要使用時，只需遵循以下簡單步驟：

1. 打開你的終端機

直接打開 PowerShell 即可（或你慣用的任何終端機，如 Windows Terminal）。

2. 直接執行 gemini 指令

你不需要再安裝或設定任何東西。npm 全域安裝已經將 gemini 指令註冊到了你的整個系統中。你只需要像使用 git 或 ping 一樣，直接呼叫它。

因此，設定完成後，gemini-cli 就準備就緒了。現在你可以直接在 PowerShell 中與 Gemini 對話。

gemini-cli 成功執行，並使用 Gemini 2.5 Pro 模型

常見使用方式範例：

直接提問（單次問答）： 這也是最常見的用法。直接在 gemini 後面加上用引號包起來的問題。

gemini "請用繁體中文，為我的新咖啡店想 5 個有創意的名字"
```    ```powershell
gemini "用 Python 寫一個函式，可以計算檔案的 SHA256 校驗和"

使用管線 (Piping) 處理本機檔案： 這是 CLI 工具的精髓，讓 Gemini 處理你電腦上的檔案內容。

# 讓 Gemini 解釋一個程式碼檔案
cat .\my_script.js | gemini "解釋這段 JavaScript 程式碼的主要功能"

# 讓 Gemini 總結一個會議記錄
cat .\meeting_notes.txt | gemini "總結這份會議記錄的重點，並列出待辦事項"

(註：cat 在 PowerShell 中是 Get-Content 的別名，可以直接使用)

進入對話模式 (Chat)： 如果你需要進行一連串的追問和對話，可以使用對話模式。
```
gemini chat
```
執行後，你會進入一個互動式的聊天環境，可以直接輸入問題，Gemini 會記住上下文。輸入 exit 或 quit 即可退出。

使用 gemini-cli 評析本網站

總結一下關鍵點：

動作	指令	說明
首次安裝	`npm install -g @google/gemini-cli`	已完成，無需再做。
首次設定	`gemini` (然後跟隨嚮導)	已完成，無需再做。
未來日常使用	打開 PowerShell，直接輸入 `gemini "你的問題..."`	這就是你未來每天要做的事！

其他補充說明 - 關於更換帳號或切換認證

更換帳號或切換認證方式都有對應的指令。

之前的初始設定雖然感覺是一次性的，但它只是在本機上儲存了一個設定檔。我們隨時可以透過指令來修改或刪除這個設定檔。

以下是具體的操作方法：

方法一：更換登入的 Google 帳號

如果你想從目前的 Google 帳號登出，然後換另一個帳號登入，流程非常簡單：登出後再重新登入。

步驟 1：登出目前的帳號

在 PowerShell 中執行以下指令：

gemini auth logout

這個指令會清除本機儲存的帳號認證權杖 (token)。

步驟 2：用新帳號重新登入

登出後，你可以執行以下任一指令來觸發新的登入流程：

# 專門用來登入的指令
gemini auth login

或者，更簡單地，直接執行任何一個需要認證的 gemini 指令：

# 例如，直接提問也會觸發登入
gemini "Hello"

執行後，CLI 會發現你尚未登入，並再次自動打開瀏覽器，讓你進入 Google 帳號的選擇與授權頁面。這時，你就可以選擇另一個新的 Google 帳號來進行登入了。

方法二：從帳號登入模式切換到 API Key 模式

有時候，你可能不想透過瀏覽器登入，而是想直接使用一個從 Google AI Studio 取得的 API 金鑰。這種方式在自動化腳本或伺服器環境中特別有用。

步驟 1：(可選) 登出目前帳號

雖然不是絕對必要，但為了保持設定乾淨，建議先登出：

gemini auth logout

步驟 2：設定 API 金鑰

使用 config set 指令來設定你的金鑰。將 <你的API金鑰> 替換成你自己的金鑰字串。

gemini config set api_key <你的API金鑰>

重要：CLI 的優先級是，如果設定了 API Key，會優先使用 API Key，而忽略帳號登入的認證。

如何從 API Key 模式換回帳號登入模式？

如果你設定了 API Key，但現在又想用回瀏覽器帳號登入，你需要先移除已設定的 API Key。

步驟 1：移除 API Key 設定

gemini config remove api_key

步驟 2：重新登入

gemini auth login

管理與檢查你的設定

如果你不確定現在是用哪個模式，或想查看所有設定，可以使用以下指令：

查看目前的設定列表：
```
gemini config list
```
這個指令會顯示你設定過的所有參數，例如佈景主題、API 金鑰（如果有的話）等。
終極大絕招：完全重設 如果有一天你把設定搞亂了，想回到最原始的狀態，可以手動刪除設定檔。
1. Gemini CLI 的設定檔儲存在你的使用者主目錄下的一個名為 .gemini 的資料夾中。在 PowerShell 中，你可以用 Remove-Item 指令刪除它：
```
# `$HOME` 指向你的使用者主目錄，例如 C:\Users\YourName
Remove-Item -Path "$HOME\.gemini" -Recurse -Force
```
2. 刪除後，當你下一次執行 gemini 時，它會像第一次安裝一樣，再次啟動初始設定嚮導。

總結表格

你的目的	應執行的指令	說明
更換登入的 Google 帳號	1. `gemini auth logout` 2. `gemini auth login`	先登出，再用新帳號登入。
改用 API 金鑰認證	`gemini config set api_key <金鑰>`	設定後，CLI 會優先使用此金鑰。
從 API 金鑰改回帳號登入	1. `gemini config remove api_key` 2. `gemini auth login`	先移除金鑰，再重新登入帳號。
檢查目前所有設定	`gemini config list`	列出所有已設定的參數。
恢復到出廠設定	`Remove-Item -Path "$HOME\.gemini" -Recurse -Force`	刪除設定資料夾，下次執行時重新設定。

重要： CLI 的優先級是，如果設定了 API Key，會優先使用 API Key，而忽略帳號登入的認證。

官方資源

如果你想了解更多進階用法、回報問題或查看原始碼，可以參考官方的 GitHub 儲存庫：

gemini-cli 官方 GitHub 儲存庫

現在，你已經成功地將強大的 Gemini 模型整合到你的命令列工作流中了！開始探索它的無限可能吧！