注: このドキュメントセットは、Gemini Enterprise の Standard、Plus、従量課金、Frontline エディションを対象としています。Business エディションのドキュメントについては、Gemini Enterprise - Business エディションのヘルプセンターをご覧ください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Antigravity を Enterprise Gateway に接続する

このドキュメントでは、Gemini Enterprise を使用するデベロッパーが、ワークステーション、コンテナ、デベロッパーサンドボックスから Google Antigravity をエンタープライズゲートウェイに接続する方法について説明します。

組織で Google サービスへの直接インターネット接続をブロックする厳格なネットワーク制御を適用している場合、Antigravity Enterprise Gateway は、組織が運用するエンタープライズゲートウェイを介して開発リクエストをルーティングします。この設定により、インタラクティブなブラウザログインを完了せずに Antigravity を使用できます。Antigravity の機能、ツール、ワークフローの詳細については、Antigravity のドキュメントをご覧ください。

サポートされているツールとバージョン

Antigravity Enterprise Gateway は、次の AI デベロッパーツールをサポートしています。

ツール	最小バージョン	対応プラットフォーム
Antigravity アプリ	2.15.0 以降	macOS（Apple シリコン arm64、Intel x86_64）、Windows 10 または 11（64 ビット）、Linux（x86_64）
Antigravity CLI（`agy`）	1.2.15 以降	macOS（arm64）、Linux（x86_64）
IDE 向け Antigravity	Visual Studio Code と Visual Studio: Antigravity CLI 1.2.15 以降。拡張機能によって自動的にダウンロードされ、更新されます。 JetBrains IDE と Zed（ACP サーバーを使用）: 1.3.0 以降	Visual Studio Code、Visual Studio、JetBrains IDE、Zed。IDE 拡張機能の詳細については、Antigravity IDE 拡張機能をご覧ください。

構成方法を選択する

Antigravity の構成方法は、開発環境の管理方法によって異なります。

管理対象の企業ワークステーション: 管理者が Antigravity を構成します。手動構成は必要ありません。
カスタム環境、コンテナ、サンドボックス: 環境変数を使用して Antigravity を構成します。この方法は、リモート SSH ホスト、開発用仮想マシン、コンテナ、CI/CD パイプラインに使用します。

管理対象の企業ワークステーション

会社がモバイルデバイス管理（MDM）ツールを使用してパソコンを管理している場合、管理者は admin_settings.json ファイルをオペレーティングシステムにデプロイします。

Antigravity アプリを開く、Antigravity CLI を実行する、またはサポートされている IDE（Visual Studio Code、Visual Studio、JetBrains IDE、Zed）で Antigravity を使用すると、Antigravity はこれらの設定を自動的に検出し、個別のログインプロンプトを表示せずにリクエストをエンタープライズゲートウェイにルーティングします。手動での構成は必要ありません。

カスタム環境、コンテナ、サンドボックス

リモート開発仮想マシン、Docker コンテナ、自動 CI/CD ランナー、MDM で管理されていないローカル IDE などの非マネージド環境で作業する場合は、環境変数を設定するか、IDE エージェント構成を更新して Antigravity を構成します。

次の表に、ゲートウェイモードの構成に使用される環境変数を示します。

変数	必須	説明
`AGY_LLM_GATEWAY_URL`	○	組織のエンタープライズゲートウェイの HTTPS URL。
`AGY_LLM_GATEWAY_API_KEY`	○	ゲートウェイが発行する API キー。この鍵は管理者から取得してください。
`AGY_LLM_GATEWAY_WIRE_PROTOCOL`	いいえ	API ワイヤプロトコル。Gemini API プロトコルの場合は `genai`（デフォルト）、OpenAI Chat Completions プロトコルの場合は `openai` に設定します。
`AGY_LLM_GATEWAY_CA_CERT`	いいえ	組織のルート CA 証明書バンドルのパス。この変数が設定されていない場合、Antigravity は標準の `SSL_CERT_FILE` 変数を使用します。
`AGY_LLM_GATEWAY_MODELS`	いいえ	許可されたモデルのカンマ区切りのリスト。
`AGY_LLM_GATEWAY_HEADERS`	いいえ	カスタム HTTP ヘッダー。`KEY: VALUE` 形式で、カンマまたは改行で区切ります。これらのヘッダーは、コストセンターのトラッキングに使用します。

設定例

次の例は、さまざまな開発環境で Antigravity Enterprise Gateway 環境変数を構成する方法を示しています。

インタラクティブシェル

次の例は、インタラクティブターミナルセッションと、Antigravity CLI と統合する IDE 拡張機能（Visual Studio Code や Visual Studio など）のシェル起動プロファイル（~/.bashrc や ~/.zshrc など）でゲートウェイ環境変数を構成する方法を示しています。

# Configure Antigravity Enterprise Gateway
export AGY_LLM_GATEWAY_URL="https://gateway.cymbal.com"
export AGY_LLM_GATEWAY_API_KEY="GATEWAY_API_KEY"
export AGY_LLM_GATEWAY_WIRE_PROTOCOL="genai"
export AGY_LLM_GATEWAY_CA_CERT="/etc/ssl/certs/cymbal-root-ca.pem"
export AGY_LLM_GATEWAY_HEADERS="X-Cost-Center: Platform-Engineering"
export AGY_LLM_GATEWAY_MODELS="gemini-3.8-flash,gemini-3.7-flash,gemini-3.1-pro-preview"

この例では、次のようになります。

AGY_LLM_GATEWAY_URL: エンタープライズゲートウェイの HTTPS エンドポイント（https://gateway.cymbal.com）を設定します。
AGY_LLM_GATEWAY_API_KEY: ゲートウェイに必要な API キー（GATEWAY_API_KEY）を設定します。
AGY_LLM_GATEWAY_WIRE_PROTOCOL: API ワイヤプロトコルを、Gemini API プロトコルの場合は genai（デフォルト）、OpenAI Chat Completions プロトコルの場合は openai に設定します。
AGY_LLM_GATEWAY_CA_CERT: Antigravity がゲートウェイの TLS 証明書を信頼するように、企業のルート CA 証明書バンドルのパスを設定します。
AGY_LLM_GATEWAY_HEADERS: ゲートウェイがチームのコストセンターに使用量を関連付けるために使用できるカスタムヘッダーを追加します。
AGY_LLM_GATEWAY_MODELS: 選択可能なモデルを設定します。使用可能なモデルの詳細については、サポートされているモデルの一覧をご覧ください。

変更を適用するには、シェルプロファイルを再読み込みします。

source ~/.bashrc

Docker コンテナ

次の Dockerfile の例では、コンテナ化された開発環境と自動化された CI/CD ランナーのゲートウェイ接続を構成しています。

FROM ubuntu:24.04

# Install prerequisites and Antigravity CLI (v1.2.15 or later)
RUN apt-get update && apt-get install -y curl ca-certificates
RUN curl -fsSL https://antigravity.google/cli/install.sh -o /tmp/install.sh \
    && bash /tmp/install.sh \
    && rm -f /tmp/install.sh

# Copy corporate root CA certificate
COPY certs/cymbal-root-ca.pem /usr/local/share/ca-certificates/cymbal-root-ca.crt
RUN update-ca-certificates

# Configure gateway connection
ENV AGY_LLM_GATEWAY_URL="https://gateway.cymbal.com" \
    AGY_LLM_GATEWAY_WIRE_PROTOCOL="genai" \
    AGY_LLM_GATEWAY_CA_CERT="/etc/ssl/certs/cymbal-root-ca.pem" \
    AGY_LLM_GATEWAY_MODELS="gemini-3.8-flash,gemini-3.1-pro-preview"

# Provide API key securely at runtime using container secrets or runtime env
ENTRYPOINT ["agy"]

この例では、次のようになります。

コンテナイメージは、Antigravity CLI をインストールし、企業のルート CA 証明書をシステム証明書ストアに追加します。
機密性の低い接続設定（AGY_LLM_GATEWAY_URL、AGY_LLM_GATEWAY_WIRE_PROTOCOL、AGY_LLM_GATEWAY_CA_CERT、AGY_LLM_GATEWAY_MODELS）は環境変数として設定されます。
API キー（AGY_LLM_GATEWAY_API_KEY）はイメージに保存されません。代わりに、コンテナシークレットまたは環境引数（docker run -e AGY_LLM_GATEWAY_API_KEY=... など）を使用して、実行時に指定します。

JetBrains IDE

JetBrains IDE は、Antigravity Agent Client Protocol（ACP）サーバーを介して Antigravity と通信します。デスクトップ IDE は ~/.bashrc などのシェル起動プロファイルを読み取らないため、IDE エージェント構成でゲートウェイ設定を構成します。

~/.jetbrains/acp.json で、ゲートウェイ環境変数を使用して Antigravity エージェントサーバーを構成します。

{
  "agent_servers": {
    "Antigravity": {
      "command": "PATH_TO_ACP_SERVER",
      "env": {
        "AGY_LLM_GATEWAY_URL": "https://gateway.cymbal.com",
        "AGY_LLM_GATEWAY_API_KEY": "GATEWAY_API_KEY",
        "AGY_LLM_GATEWAY_CA_CERT": "/etc/ssl/certs/cymbal-root-ca.pem",
        "AGY_LLM_GATEWAY_HEADERS": "X-Cost-Center: Platform-Engineering",
        "AGY_LLM_GATEWAY_MODELS": "gemini-3.8-flash,gemini-3.7-flash,gemini-3.1-pro-preview"
      }
    }
  }
}

PATH_TO_ACP_SERVER は、agy_acp_server バイナリのパスに置き換えます。

~/.gemini/antigravity-acp/settings.json（または GEMINI_HOME が設定されている場合は $GEMINI_HOME/antigravity-acp/settings.json）で、ゲートウェイ認証を有効にします。
```
{
  "auth": {
    "type": "gateway"
  }
}
```
注: Antigravity CLI とは異なり、AGY_LLM_GATEWAY_URL を設定するだけでは ACP サーバーでゲートウェイルーティングは有効になりません。"auth": { "type": "gateway" } の設定が必要です。
JetBrains IDE を再起動します。

Zed

Zed は、Antigravity Agent Client Protocol（ACP）サーバーを介して Antigravity と通信します。デスクトップ IDE は ~/.bashrc などのシェル起動プロファイルを読み取らないため、Zed の設定ファイルでゲートウェイ設定を構成します。

Zed の settings.json ファイルで、agent_servers の下にゲートウェイ環境変数を使用して Antigravity エージェントサーバーを追加します。

{
  "agent_servers": {
    "Antigravity": {
      "command": "PATH_TO_ACP_SERVER",
      "env": {
        "AGY_LLM_GATEWAY_URL": "https://gateway.cymbal.com",
        "AGY_LLM_GATEWAY_API_KEY": "GATEWAY_API_KEY",
        "AGY_LLM_GATEWAY_CA_CERT": "/etc/ssl/certs/cymbal-root-ca.pem",
        "AGY_LLM_GATEWAY_HEADERS": "X-Cost-Center: Platform-Engineering",
        "AGY_LLM_GATEWAY_MODELS": "gemini-3.8-flash,gemini-3.7-flash,gemini-3.1-pro-preview"
      }
    }
  }
}

PATH_TO_ACP_SERVER は、agy_acp_server バイナリのパスに置き換えます。

~/.gemini/antigravity-acp/settings.json（または GEMINI_HOME が設定されている場合は $GEMINI_HOME/antigravity-acp/settings.json）で、ゲートウェイ認証を有効にします。
```
{
  "auth": {
    "type": "gateway"
  }
}
```
注: Antigravity CLI とは異なり、AGY_LLM_GATEWAY_URL を設定するだけでは ACP サーバーでゲートウェイルーティングは有効になりません。"auth": { "type": "gateway" } の設定が必要です。
Zed を再起動します。

接続を確認する

環境を構成したら、Antigravity がエンタープライズゲートウェイに接続することを確認します。

Antigravity アプリを確認する:
- 下部のステータスバーで、接続ステータスに「接続済み: Enterprise Gateway」と表示されていることを確認します。
- [アカウント設定] で、ステータスに [エンタープライズゲートウェイモードが有効] と表示されていることを確認します。
Antigravity CLI をテストする: ターミナルでテストプロンプトを実行します。
```
agy -p "Explain binary search in Go"
```
ブラウザウィンドウを開いたり、 Google アカウントでのログインを求めたりすることなく、レスポンスがターミナルにストリーミングされます。

ワークステーションのセキュリティとローカルサンドボックス

エンタープライズゲートウェイを介してリクエストをルーティングしても、Antigravity がワークステーションを保護する方法は変わりません。

モデルリクエスト: プロンプト、コンテキストファイル、レスポンスは、組織のエンタープライズゲートウェイを介してルーティングされます。ここで、組織はそれらを監査し、ポリシーを適用できます。
ローカルツールの実行: ターミナルコマンド、ファイルの作成、ワークスペースの変更は、引き続き Antigravity のローカルサンドボックス内で実行されます。
人間参加型の制御: Antigravity は、破壊的な可能性のあるターミナルコマンドを実行したり、ディスク上のファイルを変更したりする前に、ユーザーの承認を必要とします。

トラブルシューティング

ゲートウェイへの接続時にエラーが発生した場合は、次の解決策をご覧ください。

エラーメッセージ	原因	修正方法
`x509: certificate signed by unknown authority`	環境がゲートウェイの TLS 証明書を信頼していない。	`AGY_LLM_GATEWAY_CA_CERT` を、企業のルート CA バンドルのパスに設定します。
`401 Unauthorized`	ゲートウェイが API キーを拒否しました。	`AGY_LLM_GATEWAY_API_KEY` が管理者から提供された鍵と一致することを確認します。
`404 Not Found`	リクエストされたモデルがエンタープライズゲートウェイで使用できないか、モデル ID の入力ミスがあります。	`AGY_LLM_GATEWAY_MODELS` のモデル ID が、ゲートウェイで使用可能なサポートされているモデルと一致していることを確認します。
Antigravity が Google ログインを求める	現在のシェルまたは IDE 構成にゲートウェイ URL が設定されていません。	ターミナルセッションと CLI 統合 IDE の場合は、現在の環境に `AGY_LLM_GATEWAY_URL` が設定されていることを確認します。JetBrains IDE または Zed の場合は、`AGY_LLM_GATEWAY_URL` がエージェントの `env` ブロックで渡され、`"auth": { "type": "gateway" }` が `~/.gemini/antigravity-acp/settings.json` で構成されていることを確認します。
JetBrains または Zed で `AGY_LLM_GATEWAY_URL` に関するエラーが発生する	ACP 設定で `auth.type` が `gateway` に設定されていますが、IDE が変数をエージェントサーバーに渡しませんでした。	シェルプロファイルではなく、`~/.jetbrains/acp.json`（JetBrains）または `settings.json`（Zed）のエージェント `env` ブロックに `AGY_LLM_GATEWAY_URL` を追加し、IDE を再起動します。
`gateway.wireProtocol 'openai' is not supported by the ACP server`	`AGY_LLM_GATEWAY_WIRE_PROTOCOL` または管理者設定で、ACP サーバーがサポートしていない `openai` ワイヤプロトコルが指定されている。	環境で `AGY_LLM_GATEWAY_WIRE_PROTOCOL="genai"` を設定するか、JetBrains ユーザーと Zed ユーザー向けに `genai` ワイヤプロトコルを構成するよう管理者に依頼します。

次のステップ

Antigravity の機能、ツール、ワークフローの詳細については、Antigravity のドキュメントをご覧ください。
Gemini Enterprise のデベロッパーツールの機能を確認する: AI デベロッパーツールの概要。
デベロッパーの指標と生産性ダッシュボードを確認する: AI デベロッパーツールの指標を表示する。
カスタム IAM 権限について学習する: アクセスを制限するカスタムロールを作成する。