使用 Gemini CLI 搭配 CometAPI

使用本指南以 CometAPI 作為 API 端點來執行 Gemini CLI。官方參考資料：

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

先決條件

要求	詳細資訊
Node.js	22+（建議使用 LTS）
OS	macOS、Linux 或 Windows
CometAPI key	來自你的 CometAPI Dashboard（開頭為 `sk-`）

安裝 Gemini CLI

npm install -g @google/gemini-cli

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

brew install gemini-cli

驗證：

gemini --version

設定環境變數

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

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

啟動 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"

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

無效的 API Key 錯誤

請確認 GEMINI_API_KEY 已正確設定。執行 echo $GEMINI_API_KEY 進行檢查。

fetch 失敗

網路限制可能會封鎖連線。請嘗試使用系統層級的代理。

錯誤的 Node.js 版本

Gemini CLI 需要 Node.js 22+。執行 node --version 進行檢查。

解除安裝 Gemini CLI

執行 npm uninstall -g @google/gemini-cli。