Antigravity CLI

Antigravity CLI 是 Google 推出的命令列工具，支援透過 API Key 模式接入相容 Gemini API 的服務。本文件介紹如何設定 Antigravity CLI 以使用自訂 API 端點。

安裝复制锚点链接

依作業系統選擇對應的安裝方式：

macOS / Linux复制锚点链接

curl -fsSL https://antigravity.google/cli/install.sh | bash

Windows (PowerShell)复制锚点链接

irm https://antigravity.google/cli/install.ps1 | iex

Windows (CMD)复制锚点链接

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

驗證安裝复制锚点链接

agy --version

設定复制锚点链接

啟用 API Key 模式复制锚点链接

編輯 ~/.gemini/antigravity-cli/settings.json，在現有 JSON 中加入：

{
  "modelProvider": "gemini"
}

⚠️ 注意：只設定 GEMINI_API_KEY 不會切換驗證方式。modelProvider 必須設為小寫的 "gemini"。

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

export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"

重要說明：

• GOOGLE_GEMINI_BASE_URL 填服務根位址，不要帶具體介面路徑。端點必須相容 Gemini API。
• GEMINI_API_KEY 填你的 API Key。
• 在啟動 agy 的同一個 shell 中執行以上指令。CLI 不讀取 .env 或 GOOGLE_API_KEY。

需要永久生效時，將兩個 export 寫入 ~/.zshrc 或 ~/.bashrc。

啟動與驗證复制锚点链接

agy --model gemini-2.0-flash

頂部顯示 Gemini API key 後，發起一次對話。

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

• 仍要求登入：檢查 "modelProvider": "gemini"，離開並重新啟動 agy。
• 啟動時提示缺少 Key：在目前 shell 中重新設定 GEMINI_API_KEY。
• 請求失敗：檢查 API Key、服務根位址和所選模型的存取權限。

注意事項复制锚点链接

• 必須同時設定 modelProvider 設定項和環境變數才能正常使用 API Key 模式
• 環境變數需要在啟動 CLI 的 shell 工作階段中設定，或寫入 shell 設定檔永久生效
• 服務端點必須相容 Gemini API 規範

相關連結复制锚点链接

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