aicentosAntigravity
Google Antigravity は現在カスタム Base URL に対応していません —— 制限の内容と利用できる代替手段を説明します
最終更新:
Antigravity は Google が提供するエージェント型 IDE です。まず前提を説明しておきます：公式版の Antigravity デスクトップ IDE はカスタム API エンドポイントに対応しておらず、BYOK（持ち込みキー）も提供されていません。モデルセレクターは Google が管理する固定リストで、現時点では aicentos に向けることができません。
本記事では、この制限の根拠、検証方法、そして利用できる 3 つの代替パスを説明します。
直接接続できない理由
Google のアカウントプランに関するドキュメントには、Antigravity は現時点で持ち込みモデルや持ち込みエンドポイントに対応していないと明記されています。コミュニティで出回っているいくつかの設定項目（例：~/.antigravity/settings.json に antigravity.ai.provider、antigravity.openai-compatible.endpoint を書く）は公式にサポートされたキーではなく、実際に試すとリクエストがカスタムエンドポイントにルーティングされないか、黙ってデフォルトモデルにフォールバックし、モデルセレクターにカスタム項目も表示されません。
つまりこの問題は「設定の書き間違い」ではなく、現行バージョンがこの機能を公開していないことにあります。IDE の Settings → Models にも Base URL を入力する欄はありません。
設定値
| 項目 | 値 |
|---|---|
| API Key | コンソールで作成したキー |
| Base URL | https://aicentos.com/v1 |
| モデル | コンソール「モデル広場」のモデル名 |
上の表は aicentos 側の共通パラメーターで、以下のいずれかの代替手段で使用します。
代替手段
方法 1：Antigravity CLI を使う（推奨、Gemini プロトコルのみ）
同名のコマンドラインツール agy はエンドポイントの上書きに対応しており、GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY で接続できます。ただし Gemini プロトコルのみを受け付け、Gemini 系列のモデルしか呼び出せません。具体的な手順は Antigravity CLI への接続 をご覧ください。
「ターミナルで Antigravity の対話方式を使いたい」というニーズであれば、これが最も手軽です。
方法 2：ローカルモデルやサードパーティサービスを MCP ツールにラップする
Antigravity の Customizations パネルでは MCP Server を登録できます。ローカルサービスを MCP ツールとしてラップして組み込めば、呼び出し可能なツールとして使えます。ただしこれは IDE の推論モデルを置き換えるものではなく、エージェントにツールが 1 つ増えるだけである点に注意してください。
方法 3：コミュニティフォークまたはローカルプロキシ
- コミュニティフォークの
open-antigravityは任意の OpenAI 互換エンドポイントとカスタムモデルに対応しており、公式版以外では最もクリーンなパスです。 - ローカルのインターセプトプロキシで IDE のアウトバウンドトラフィックを書き換える方法もあります。この道は公式サポートがなく、設定が壊れやすく、アップグレードすると即座に無効になるため、本番環境での使用は推奨しません。
テスト
どのパスを選ぶ場合でも、まず簡単なプロンプト 1 つで接続を確認してから本番投入してください。Agent 系のタスクは、まず小さなリポジトリで試すのがおすすめです。
注意事項
- 「設定項目が存在するように見える」ことを「機能が使える」ことと同一視しないでください。IDE の
antigravity.*キーは多くがコミュニティによる推測で、書き込んでもエラーにはなりませんが、効果もありません。 - OpenAI 互換プロトコルが必要な場合や、Claude / GPT 系列のモデルを呼び出したい場合は、現時点の Antigravity デスクトップ版では実現できません。カスタム Base URL に対応した Cursor、Windsurf などのクライアントを優先的に検討してください。
- Antigravity CLI とデスクトップ IDE は別々の設定であり、CLI のエンドポイント上書きは IDE には影響しません。
- サードパーティのフォークやプロキシを使う前に、そのセキュリティと今後のメンテナンス状況を必ずご自身で評価してください。