Skip to main content

Gemini-CLI 教學手冊：快速安裝與使用指南

前言

Gemini-CLI 是一個方便的命令列工具，讓您無需透過複雜的程式碼，也能直接在終端機中與 Google 的 Gemini 模型互動。本手冊將詳細介紹如何安裝與使用 Gemini-CLI，幫助您快速上手。

 

一、安裝方式系統需求

 在安裝前，請確保您的系統符合以下要求：

    Node.js 版本為 20 或更高。 作業系統為 macOS、Linux 或 Windows。

    安裝方式

    Gemini-CLI 提供多種安裝方法，您可以根據自己的需求和開發環境選擇最適合的方式。

     

    快速安裝 (無需安裝)

     

    如果您不想在系統中安裝任何東西，可以使用 npx 指令直接執行。這對於快速測試或一次性使用非常方便。

    Bash 
    # 使用 npx (無需額外安裝)
npx https://github.com/google-gemini/gemini-cli

     

    全域安裝 (npm)

     

    如果您是 Node.js 開發者，可以透過 npm 將 Gemini-CLI 安裝到您的系統中，以便隨時使用。

    Bash 
    npm install -g @google/gemini-cli

     

    全域安裝 (Homebrew)

     

    如果您是 macOS 或 Linux 使用者，可以使用 Homebrew 這個套件管理工具來安裝，步驟非常簡潔。

    Bash 
    brew install gemini-cli

     

    二、系統需求發佈版本與標籤

     

    在安裝前，請確保您的系統符合以下要求：

      Node.js 版本為 20 或更高。

      作業系統為 macOS、Linux 或 Windows。

       

      三、發布版本與標籤

       

      Gemini-CLI 有不同的發布週期，每個週期都有特定的用途。您可以透過不同的標籤 (tag) 來選擇安裝的版本。

       

      預覽版 (Preview)

       

      • 發布時間： 每週二 UTC 23:59 發布。

      • 特性： 這些版本尚未經過完整測試，可能包含未修復的錯誤或新功能。如果您想協助測試最新功能，這會是個好選擇。

      • 安裝指令：

      安裝指令：

      Bash 
      npm install -g @google/gemini-cli@preview

       

      穩定版 (Stable)

       

      • 發布時間： 每週二 UTC 20:00 發布。

      • 特性： 這是上一週預覽版的完整推廣版本，已包含錯誤修復和驗證。對於日常使用和開發，這是最推薦的版本。

      • 安裝指令：

      安裝指令：

      Bash 
      npm install -g @google/gemini-cli@latest

       

      每夜版 (Nightly)

       

      • 發布時間： 每天 UTC 00:00 發布。

      • 特性： 包含主分支上的所有最新變更。由於未經任何驗證，它可能存在許多問題。僅建議開發者用於測試。

      • 安裝指令：

      安裝指令：

      Bash 
      npm install -g @google/gemini-cli@nightly
      Back to top