Gemini CLI

使用 CometAPI 設定 Gemini CLI：透過 npm 或 Homebrew 安裝、設定 GEMINI_API_KEY 和 GOOGLE_GEMINI_BASE_URL，並開始在終端機中使用 Gemini 模型。

使用本指南透過 CometAPI 作為 API 端點來執行 Gemini CLI。

官方參考資料：

• Gemini CLI GitHub
• Gemini CLI Authentication

模型可用性會隨時間變動。請查看 CometAPI Models page 以確認目前可用的 Gemini 模型。

​

先決條件

Requirement	Details
Node.js	22+（建議使用 LTS）
OS	macOS、Linux 或 Windows
CometAPI key	來自你的 CometAPI Dashboard（以 sk- 開頭）

​

設定

1. Install Gemini CLI

   npm install -g @google/gemini-cli
   

   或透過 Homebrew 安裝（macOS / Linux）：

   brew install gemini-cli
   

   驗證：

   gemini --version
   
2. Set environment variables

   export GEMINI_API_KEY="sk-your-cometapi-key"
   export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"
   

   將 sk-your-cometapi-key 替換為你實際的 CometAPI key。

3. Start Gemini CLI

   cd your-project
   gemini
   

   首次啟動時，系統會提示你選擇主題、確認安全性提示，並信任目前的工作目錄。

​

持久化環境變數

為了避免每次工作階段都重新匯出，請將以下內容加入你的 shell 設定檔：

# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"

重新啟動終端機以使變更生效。

​

疑難排解

Symptom	Fix
Invalid API Key error	確認 GEMINI_API_KEY 已正確設定。執行 echo $GEMINI_API_KEY 進行檢查
fetch failed	網路限制可能會阻擋連線。請嘗試使用系統層級的代理
Wrong Node.js version	Gemini CLI 需要 Node.js 22+。執行 node --version 進行檢查
Uninstall	npm uninstall -g @google/gemini-cli