安裝 Gemini Cli 筆記

Gemini 是 Google 提供的 AI 服務，主要是透過網頁服務來驅動。最近他針對了一些喜愛使用 命令列 的族群也發布了相關工具，就稱為「Gemini Cli」。

Gemini CLI 從今天開始可供開發者預覽，目前可透過免費的 Gemini Code Assist 授權免費使用，該授權可透過個人 Google 帳戶取得。這為 Gemini CLI 用戶提供了每分鐘 60 個模型請求、每天 1,000 個請求的使用限制，Google 稱這是業界提供的「最大限額」。
– 20260627 Google Blog 資訊

安裝 Gemini Cli 步驟如下：

第一重點：「Gemini Cli」的安裝是要透過 node.js (而且版本要 20 以上)。

目前 python 的開發太受歡迎，百花齊放，所以架構非常混亂，一不小心，就很容易影響到整個系統，造成系統不容易維護。所以我建議且我也使用 NVM 來安裝 Node.js。

1. 安裝 NVM

NVM（Node Version Manager）主要用途是管理多版本的 Node.js ，如果需要在系統中安裝多個版本的 Node.js，建議使用 NVM，安裝如下：

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash

註：

截至目前(2025/07/07) nvm 的版本號為 0.39.3，若想安裝者，可以連到該專案網站，抓取當下最新版本回來安裝。
網址：https://github.com/nvm-sh/nvm

2. 更新環境變數：

安裝完成後，安裝程式會自動幫你寫上環境變數，所以記得更新：
source ~/.bashrc 或是 source ~/.profile

細究其內容，增加環境變數內容如下：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

3. 列出可用版本， Gemini CLI 需要 Node.js 18 或以上版本。

 nvm ls-remote 



4. 安裝並切換到指定版本的 Node.js（例如 22.5.1）

nvm install 22.5.1 #安裝指定版本
nvm use 22.5.1  #切換到指定版本

5. 安裝 Gemini Cli

##單一帳號安裝
npx https://github.com/google-gemini/gemini-cli
或
##全域安裝
npm install -g @google/gemini-cli

6. 安裝完成後，輸入以下指令啟動 Gemini CLI：

gemini

在選擇「樣式」之後，便會出現以下畫面，建議使用第三種身份認證方式。


認證成功便會出現以下對話畫面。（以下為啟用成功畫面）


Gemini API Key vs Vertex AI

特性	Gemini API Key (透過 Google AI Studio)	Vertex AI (透過 Google Cloud)
平台	Google AI for Developers (AI Studio)	Google Cloud Platform (GCP)
目標用戶	個人開發者、學生、愛好者、快速原型製作者	企業、資料科學家、MLOps 工程師、大型應用開發者
認證方式	靜態 API 金鑰 (API Key) 一個長字串，在請求時直接放在 Header 中。	應用程式預設憑證 (ADC) 使用 Google Cloud 的 IAM (身份與存取權管理) 系統，例如： – gcloud CLI 登入 – 服務帳號 (Service Account) 金鑰檔案 – 在 GCP 環境中 (如 VM, Cloud Run) 自動取得權限
安全性	較低 金鑰是靜態的，若洩漏，任何人都能使用。雖然可以設定 IP 位址限制，但控制粒度較粗。	非常高 基於 IAM，可以精確控制「哪個帳號」能存取「哪個資源」，並賦予特定角色 (如只能讀取、不能寫入)。所有操作都有稽核日誌。
整合性	較低 主要就是直接呼叫 Gemini 模型本身。	極高 Vertex AI 是一個完整的 MLOps 平台，除了 Gemini，還包含： – 資料前處理、標記 – 模型訓練 (AutoML, Custom Training) – Vector Search – 與 BigQuery, Cloud Storage 等 GCP 服務深度整合
功能與彈性	有限 提供對 Gemini Pro 和 Gemini Pro Vision 的直接存取。	完整 除了 Gemini，還能存取更多模型 (如 Imagen, Codey)，並可對模型進行微調 (Fine-tuning)，管理模型的版本和部署。
設定複雜度	非常簡單 在 AI Studio 網站上點幾下就能產生一組 API Key。	較複雜 需要先建立一個 Google Cloud 專案，啟用相關 API，並設定好 IAM 權限和憑證。

7. 若想移除

##單一帳號安裝者
rm -rf "$(npm config get cache)/_npx"
或
##全域安裝者
npm uninstall -g @google/gemini-cli

參考資源

1. Gemini cli 專案所在地

https://github.com/google-gemini/gemini-cli/blob/main/README.md

2. Gemini CLI 初探：讓 Gemini 進入你的終端機

https://vocus.cc/article/685dd5edfd897800010b06d3

3. NVM(Node Version Manger) 專案所在地。

https://github.com/nvm-sh/nvm