Gemini CLI

Gemini CLI 是 Google 官方推出的命令列工具，支援透過環境變數設定自訂閘道來接入 Codex Proxy 服務，在終端機中與 Gemini 模型進行互動對話。

準備工作复制锚点链接

Gemini CLI 透過 npm 全域安裝，需要先準備好 Node.js 18+ 和 npm 環境。

安裝 Node.js复制锚点链接

• 前往 Node.js 官網下載頁面：https://nodejs.org/en/download
• macOS/Windows：下載並安裝 LTS 版本
• Linux：依頁面提供的發行版方式安裝
• macOS（Homebrew 使用者）：執行 brew install node

驗證安裝复制锚点链接

node -v
npm -v

安裝 Gemini CLI复制锚点链接

使用 npm 全域安裝 Gemini CLI：

npm install -g @google/gemini-cli

驗證安裝：

gemini --version

設定環境變數复制锚点链接

Gemini CLI 支援透過以下三個環境變數接入自訂閘道：

設定範例复制锚点链接

export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"
export GEMINI_MODEL="gemini-2.0-flash"

注意事項复制锚点链接

• GOOGLE_GEMINI_BASE_URL 填寫服務根位址，不需要帶具體介面路徑
• 臨時測試：直接在目前 shell 工作階段中執行上述 export 指令
• 永久生效：將 export 語句加入 ~/.zshrc 或 ~/.bashrc，然後執行 source ~/.zshrc 使其生效

啟動 Gemini CLI复制锚点链接

設定完成後，直接執行以下指令啟動：

gemini

啟動後即可在終端機中與 Gemini 模型進行互動對話。

驗證接入复制锚点链接

在 Gemini CLI 中發起一次對話，如果能正常收到回覆，表示接入成功。

常見問題排查复制锚点链接

• 如果遇到驗證錯誤，請確認 GEMINI_API_KEY 是否正確
• 檢查 GOOGLE_GEMINI_BASE_URL 是否指向正確的服務位址

注意事項复制锚点链接

• 目前服務已支援 Gemini 相容介面，可直接用於 Gemini CLI
• 環境變數設定建議加入 shell 設定檔以實現永久生效
• Gemini CLI 會自動串接 API 路徑，無需在 BASE_URL 中加入具體介面路徑

相關連結复制锚点链接

• 官方文件：https://docs.aicentos.com/clients/gemini-cli.html