Skip to main content

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

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


 

一、安裝方式

 

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