保姆級教程！谷歌Gemini CLI 詳細安裝全攻略

Gemini CLI 簡介#

谷歌正式推出了 Gemini CLI，將 Gemini 大模型的強大能力直接融入到開發者日常離不開的命令行界面之中。不僅如此，它還擁有業界最大的免費使用配額！登錄個人谷歌帳號，即可享受每分鐘 60 次、每天 1000 次的模型請求機會，還能解鎖 100 萬 token 的超大上下文窗口。如此慷慨的配置，極大降低了開發門檻，讓更多人能盡情探索 AI 輔助開發的無限可能。

Gemini CLI 到底還藏著哪些超乎想像的 “大招”？它又將如何重塑我們的開發工作流？別急，接下來就為你一一揭曉。

Gemini CLI 主要特性#

免費使用個人 Google 帳號（每分鐘最多 60 次請求，每天最多 1,000 次請求）
支持多種認證方式
可自定義顏色主題
支持高級 API 密鑰配置

系統要求#

操作系統#

Windows 10 或更高版本
macOS 10.15 或更高版本
Linux（支持主流發行版）

軟件要求#

Node.js 18.0.0 或更高版本
npm（通常隨 Node.js 一起安裝）
穩定的網絡連接

前置準備#

1. 檢查 Node.js 版本#

首先，打開終端（Windows 用戶請使用 PowerShell 或 Command Prompt）並運行以下命令檢查是否已安裝 Node.js：

node --version

如果顯示的版本號低於 18.0.0 或顯示 "command not found"，您需要安裝或更新 Node.js。

2. 安裝 Node.js（如果需要）#

Windows 用戶：#

訪問 Node.js 官網
下載 LTS 版本（推薦）
運行安裝程序，按照提示完成安裝
重啟終端並再次運行 node --version 確認安裝成功

macOS 用戶：#

使用 Homebrew 安裝（推薦）：

# 如果沒有 Homebrew，先安裝 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安裝 Node.js
brew install node

或者從 Node.js 官網下載安裝包。

Linux 用戶：#

使用包管理器安裝：

Ubuntu/Debian：

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS/RHEL/Fedora：

curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install nodejs

3. 驗證 npm 安裝#

npm 通常會隨 Node.js 一起安裝。運行以下命令確認：

npm --version

安裝步驟#

方法一：直接運行（推薦初次使用）#

這種方法無需全局安裝，適合快速嘗試：

npx https://github.com/google-gemini/gemini-cli

注意事項：

首次運行時會自動下載必要的文件
可能需要等待幾秒鐘
確保網絡連接穩定

方法二：全局安裝（推薦頻繁使用）#

如果您計劃經常使用 Gemini CLI，建議全局安裝：

npm install -g @google/gemini-cli

安裝過程說明：

-g 參數表示全局安裝
安裝完成後，您可以在任何目錄下使用 gemini 命令
可能需要管理員權限（Windows 用戶可能需要以管理員身份運行終端）

解決權限問題#

如果遇到權限錯誤，嘗試以下方法：

macOS/Linux：sudo npm install -g @google/gemini-cli
Windows：以管理員身份運行 PowerShell，然後執行安裝命令。

配置與認證#

1. 首次運行#

安裝完成後，運行 Gemini CLI：

# 如果使用 npx
npx https://github.com/google-gemini/gemini-cli

# 如果已全局安裝
gemini

2. 選擇顏色主題#

首次運行時，系統會提示您選擇顏色主題。使用方向鍵選擇您喜歡的主題，然後按 Enter 確認。

3. Google 帳號認證步驟說明：#

CLI 會顯示一個 URL 或自動打開瀏覽器
在瀏覽器中登錄您的個人 Google 帳號
授權 Gemini CLI 訪問必要的權限
複製顯示的授權碼
返回終端，粘貼授權碼並按 Enter

重要提示：

使用個人 Google 帳號可獲得每分鐘 60 次請求和每天 1,000 次請求的配額
認證信息會安全地存儲在本地
如需切換帳號，可以重新運行認證流程

高級配置#

使用 API 密鑰（可選）#

如果您需要更高的請求限制或使用特定模型，可以配置 API 密鑰：

1. 獲取 API 密鑰#

訪問 Google AI Studio
登錄您的 Google 帳號
點擊 "Create API Key" 或 "創建 API 密鑰"
複製生成的密鑰（請妥善保管，不要分享給他人）

2. 設置環境變量#

Windows (PowerShell)：

$env:GEMINI_API_KEY="YOUR_API_KEY"

Windows (Command Prompt)：

set GEMINI_API_KEY=YOUR_API_KEY

macOS/Linux：

export GEMINI_API_KEY="YOUR_API_KEY"

3. 永久設置環境變量#

為了避免每次都需要設置，可以將環境變量永久添加：

macOS/Linux：編輯 ~/.bashrc、~/.zshrc 或 ~/.profile 文件：

echo 'export GEMINI_API_KEY="YOUR_API_KEY"' >> ~/.bashrc
source ~/.bashrc

Windows：
1. 搜索 "環境變量" 打開系統設置
2. 點擊 "新建" 添加用戶變量
3. 變量名：GEMINI_API_KEY
4. 變量值：您的 API 密鑰
5. 確定保存並重啟終端

其他認證方式#

對於 Google Workspace 帳號或其他高級認證需求，請參考官方認證指南。

常見問題解決#

"command not found" 錯誤
- 問題原因：Node.js 或 npm 未正確安裝或未添加到系統 PATH。
- 解決方案：
  - 重新安裝 Node.js
  - 重啟終端
  - 檢查系統 PATH 設置
網絡連接錯誤
- 問題原因：防火牆或代理設置阻止了連接。
- 解決方案：
  - 檢查網絡連接
  - 配置代理（如果使用）：
```
npm config set proxy http://proxy.example.com:8080
npm config set https-proxy http://proxy.example.com:8080
```
權限錯誤
- 問題原因：沒有足夠的權限進行全局安裝。
- 解決方案：
  - 使用管理員權限運行
  - 或者使用 npx 方式運行，無需全局安裝
API 配額超限
- 問題原因：超過了免費配額限制。
- 解決方案：
  - 等待配額重置（每天重置）
  - 使用 API 密鑰獲得更高配額
  - 優化請求頻率

驗證安裝#

基本功能測試#

運行以下命令測試 Gemini CLI 是否正常工作：

# 如果全局安裝
gemini "Hello, can you introduce yourself?"

# 如果使用 npx
npx https://github.com/google-gemini/gemini-cli "Hello, can you introduce yourself?"

檢查版本信息#

gemini --version

查看幫助信息#

gemini --help

下一步#

恭喜！您已成功安裝並配置了 Gemini CLI。現在您可以：

探索基本功能：嘗試不同的提示詞和命令
查看文檔：了解更多高級功能和選項
集成到工作流：將 Gemini CLI 集成到您的開發或創作流程中
自定義配置：根據需求調整設置和參數