Antigravity CLI

Antigravity CLI は Google がリリースしたコマンドラインツールで、API Key モードを通じて Gemini API 互換のサービスに接続できます。このドキュメントでは、Antigravity CLI をカスタム API エンドポイントで使うための設定方法を紹介します。

インストールアンカーリンクをコピー

OS に応じて対応するインストール方法を選択します：

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 にはサービスのルートアドレスを入力し、具体的な API パスは付けません。エンドポイントは Gemini API と互換性がある必要があります。
• GEMINI_API_KEY にはあなたの API Key を入力します。
• 上記のコマンドは agy を起動するのと同じ shell 内で実行してください。CLI は .env や GOOGLE_API_KEY を読みません。

永続化したい場合は、2 つの export を ~/.zshrc または ~/.bashrc に書き込みます。

起動と確認アンカーリンクをコピー

agy --model gemini-2.0-flash

上部に Gemini API key と表示されたら、会話を 1 回開始します。

よくある問題のトラブルシューティングアンカーリンクをコピー

• ログインを求められ続ける："modelProvider": "gemini" を確認し、終了してから agy を再起動します。
• 起動時にキー不足と表示される：現在の shell で GEMINI_API_KEY を再設定します。
• リクエストが失敗する：API Key、サービスのルートアドレス、選択したモデルのアクセス権限を確認してください。

注意事項アンカーリンクをコピー

• API Key モードを正常に使うには、modelProvider 設定項目と環境変数を両方設定する必要があります
• 環境変数は CLI を起動する shell セッション内で設定するか、shell 設定ファイルに書き込んで永続化してください
• サービスのエンドポイントは Gemini API の仕様と互換性がある必要があります

関連リンクアンカーリンクをコピー

• 公式ドキュメント：https://docs.aicentos.com/clients/antigravity-cli.html