本文へスキップ

Antigravity CLI

Gemini API キーとカスタム Base URL で、Google Antigravity CLI(agy)を HopBase の Gemini ネイティブ API に接続します。

Antigravity CLI(コマンド agy)は Google のターミナル向けコーディングエージェントです。Gemini API キーでのサインインと Base URL の変更に対応しており、Gemini ネイティブプロトコルをそのまま使うため、Base URL を HopBase に向けるだけで接続できます。変換は一切挟みません。

設定値
modelProvider(settings.json)gemini
GEMINI_API_KEYコンソールで作成したキー
GOOGLE_GEMINI_BASE_URLhttps://api.hop-base.com
呼び出すエンドポイントPOST /v1beta/models/{model}:streamGenerateContent?alt=sse

本番環境で agy 1.5.12 を使って検証済みです:ファイルの読み書きと編集、シェルコマンドの実行、並列・連続のツール呼び出し、--continue による会話の再開、長いコンテキスト、画像入力、そしてプロジェクト作成からコード作成・テスト実行までのコーディングタスク全体が動作します。

キーに Gemini のプランを含める:

キーを作成するときに Gemini 公式ダイレクト(エンタープライズ) を選んでください。agy で選ぶモデルも、agy がバックグラウンドで自動的に呼び出す補助モデルも、このプランに含まれています。このプランを含まないキーでは 404 が返ります。

Antigravity CLI を設定する

インストール

macOS では Homebrew でインストールします:

brew install --cask antigravity-cli
agy --version

ほかの OS では Antigravity CLI の公式ページの手順に従ってください。API キーとカスタム Base URL を使うにはバージョン 1.1.13 以降が必要です。

サインイン方法を Gemini API キーに切り替える

ホームディレクトリの ~/.gemini/antigravity-cli/settings.json を編集します(なければ作成します):

{
  "modelProvider": "gemini"
}

値は小文字の gemini にしてください。環境変数だけを設定してこの項目を変えないと、agy は引き続き Google アカウントでサインインしようとします。

キーと Base URL を設定する

export GEMINI_API_KEY=sk-your-key
export GOOGLE_GEMINI_BASE_URL=https://api.hop-base.com

常に有効にするには、この 2 行を ~/.zshrc または ~/.bashrc に追記します。

GOOGLE_GEMINI_BASE_URL にはルート URL だけを指定し、/v1beta などのパスは付けないでください。agy が読むのは起動したターミナルの環境変数だけで、.env ファイルや GOOGLE_API_KEY は読みません。

起動してモデルを選ぶ

agy --model gemini-4-argon-medium
# 1 回だけ実行する場合
agy -p "Explain this repository" --model gemini-4-hydrogen-low

モデルを選ぶ

agy のモデル名は「HopBase のモデル ID + 思考レベルの接尾辞」です。接尾辞はリクエストの thinkingLevel に対応し、レベルが高いほど長く考え、トークンも多く使います。agy models が表示するのは agy の組み込み一覧なので、次の表を基準にしてください:

HopBase のモデル使える接尾辞例
gemini-4-argon-low / -medium / -highagy --model gemini-4-argon-medium
gemini-4-carbon-low / -medium / -highagy --model gemini-4-carbon-high
gemini-4-hydrogen-low / -medium / -highagy --model gemini-4-hydrogen-low
gemini-4-neon-low / -medium / -highagy --model gemini-4-neon-medium
gemini-3.8-flash-low / -medium / -highagy --model gemini-3.8-flash-medium

料金はモデル一覧を参照してください。

agy はバックグラウンドで補助モデルを呼び出します:

agy は各ステップのあとに、gemini-3.1-flash-lite-preview または gemini-3.8-flash で安全性チェックを 1 回行います。これらのリクエストも課金対象で、コンソールの利用履歴に表示されます。

既知の制限

  • 回答はまとめて表示:回答はトークン単位でストリーミングされず、生成が終わってから一度に返ります。長い回答や高い思考レベルでは、しばらく待ってから全文が表示されます。止まっているわけではありません。
  • -xhigh レベルは未対応:agy の一覧にある -xhigh のモデルではなく -high を使ってください。
  • 中断しても課金されます:Ctrl+C で中断しても、すでに送信済みのリクエストはサーバー側で最後まで実行され、課金されます。

次のステップ