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_URL | https://api.hop-base.com |
| 呼び出すエンドポイント | POST /v1beta/models/{model}:streamGenerateContent?alt=sse |
本番環境で agy 1.5.12 を使って検証済みです:ファイルの読み書きと編集、シェルコマンドの実行、並列・連続のツール呼び出し、--continue による会話の再開、長いコンテキスト、画像入力、そしてプロジェクト作成からコード作成・テスト実行までのコーディングタスク全体が動作します。
キーを作成するときに 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 / -high | agy --model gemini-4-argon-medium |
gemini-4-carbon | -low / -medium / -high | agy --model gemini-4-carbon-high |
gemini-4-hydrogen | -low / -medium / -high | agy --model gemini-4-hydrogen-low |
gemini-4-neon | -low / -medium / -high | agy --model gemini-4-neon-medium |
gemini-3.8-flash | -low / -medium / -high | agy --model gemini-3.8-flash-medium |
料金はモデル一覧を参照してください。
agy は各ステップのあとに、gemini-3.1-flash-lite-preview または gemini-3.8-flash で安全性チェックを 1 回行います。これらのリクエストも課金対象で、コンソールの利用履歴に表示されます。
既知の制限
- 回答はまとめて表示:回答はトークン単位でストリーミングされず、生成が終わってから一度に返ります。長い回答や高い思考レベルでは、しばらく待ってから全文が表示されます。止まっているわけではありません。
-xhighレベルは未対応:agy の一覧にある-xhighのモデルではなく-highを使ってください。- 中断しても課金されます:Ctrl+C で中断しても、すでに送信済みのリクエストはサーバー側で最後まで実行され、課金されます。
次のステップ
- Gemini チャット: 自分のコードから同じ Gemini モデルを呼び出す
- エラーコードとリトライ: 429・502・503 への対処
- トラブルシューティング: エラーメッセージから対処法を探す