Gemini CLI 全攻略：從安裝到專案應用，AI 助你高效開發

作者：台南意向 (更新日期：2025-07-25)
Gemini CLI 全攻略：從安裝到專案應用，AI 助你高效開發

想要將 Google Gemini 強大的 AI 智慧深度整合到你的開發工作流程中，徹底顛覆你的程式碼撰寫與專案管理方式嗎？本教學將手把手引導你完成 Gemini CLI (命令列介面) 的安裝與設定，並揭示一系列革命性的操作技巧，讓你輕鬆駕馭 AI，不僅能閃電般加速程式碼修改，更能以前所未有的效率進行專案管理，將你的開發效率推向全新巔峰！

前置準備：安裝 Node.js

Gemini CLI 依賴於 Node.js 環境運行。請依照以下步驟下載並安裝：

  1. 下載 Node.js：
    前往 Node.js 官方網站下載 Windows 安裝程式 (.msi) 版本：https://nodejs.org/zh-tw/download
  2. 執行安裝程式：
    下載完成後，直接執行 .msi 檔案。在安裝過程中，請勾選所有選項，確保完整安裝所需元件。安裝程式會自動運行 Windows PowerShell，你需要在對話框中點擊確認，以允許其完成所有必要的程式安裝。

設定 PowerShell 執行策略

為了讓 Gemini CLI 能夠正常運行，你需要調整 PowerShell 的執行策略。

  1. 以最高權限開啟 Windows PowerShell：
    在 Windows 搜尋欄中輸入 "PowerShell"，然後右鍵點擊 "Windows PowerShell"，選擇 "以系統管理員身分執行"。
  2. 設定執行策略：
    在 PowerShell 視窗中輸入以下指令，並在提示時按 Y 鍵確認： 
    Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

    此指令允許 PowerShell 執行您在本機建立的腳本，同時阻止執行未經簽章的遠端腳本，確保安全性。

安裝 Gemini CLI

現在，你可以透過 npm (Node.js 套件管理器) 來安裝 Gemini CLI。

  1. 執行安裝指令：
    在已開啟並以最高權限運行的 Windows PowerShell 中輸入以下指令： 
    npm install -g @google/gemini-cli

    -g 參數表示全域安裝，這樣你就能在任何目錄下使用 gemini 指令。

  2. 首次啟用與登入：
    安裝完成後，直接在 PowerShell 中輸入 gemini 並按下 Enter 鍵。首次運行時，Gemini CLI 會引導你登入 Google 帳戶。按照提示操作，直接允許存取即可。

Gemini CLI 實用技巧

掌握這些技巧，能讓你更有效地運用 Gemini CLI 協助你的開發工作。

切換工作目錄的重要性

在使用 Gemini CLI 處理專案時，務必先切換到你的專案工作目錄。這能讓 AI 更好地理解你的專案結構和內容，提供更精準的協助。

操作步驟：

  1. 開啟 Windows PowerShell (以最高權限運行)。 預設情況下，PowerShell 可能會在 C:\WINDOWS\system32> 目錄下啟動。
  2. 切換到你的專案目錄：
    假設你的專案位於 C:\網頁修改\，你需要在 PowerShell 中輸入以下指令： 
    cd C:\網頁修改\

    按下 Enter 鍵後，PowerShell 的路徑會變更為 C:\網頁修改>，表示你已成功切換到該目錄。

  3. 執行 Gemini CLI：
    在專案目錄下輸入 gemini 即可啟用 AI 對話。

使用情境範例：

當你進入對話後，可以先詢問 Gemini AI 「你看到這個目錄中有什麼內容？」。等待 AI 讀取並分析完畢後，你就可以開始針對你要調整的內容，讓 AI 自動協助你修改程式碼。

重要提醒：備份你的程式碼！

Gemini CLI 能夠直接替換工作目錄中的程式碼檔案。為了避免不必要的損失，務必在進行任何修改前，將你的專案資料夾備份到另一個目錄。 這樣即使 AI 修改後的結果不符合你的預期，你也能輕鬆恢復到原始版本。

常用指令概覽

以下是一些你在 Gemini CLI 中常用的指令，它們能幫助你更有效地與 AI 互動：

  • /quit 或 /exit:
    • 功能: 結束當前的 Gemini CLI 對話會話。
    • 使用時機: 當你完成了所有需要 AI 協助的工作，或者需要重新啟動一個新的對話時。
  • /help:
    • 功能: 顯示 Gemini CLI 可用的所有指令列表及其簡要說明。
    • 使用時機: 當你不確定有哪些指令可以使用，或者想查看特定指令的用法時，這是一個很好的起點。
  • /set [選項] [值]:
    • 功能: 配置 Gemini CLI 的設定，例如 API 金鑰、模型參數等。具體選項會根據 Gemini CLI 的版本和功能而異。
    • 使用時機: 在你需要調整 AI 行為或連接不同資源時使用。通常用於高級配置。
  • /history:
    • 功能: 顯示你與 Gemini CLI 之前的對話歷史記錄。
    • 使用時機: 當你需要回顧之前的對話內容，或者想從之前的對話中複製訊息時。
  • /clear:
    • 功能: 清除當前對話介面上的所有文字，但不會結束會話或刪除歷史記錄。
    • 使用時機: 當你的螢幕內容過多，需要一個乾淨的介面來開始新的對話時。
  • /load [檔案路徑]:
    • 功能: 載入指定檔案的內容到當前對話中，讓 Gemini AI 閱讀並分析。
    • 使用時機: 當你需要 AI 針對特定程式碼檔案、設定檔或文件提供建議、修改或解釋時，這是一個非常強大的功能。例如，你可以輸入 /load my_script.py 讓 AI 分析 Python 腳本。