将 Antigravity 连接到企业网关

本文档介绍了使用 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)
Antigravity for IDEs
  • 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 取决于您的开发环境的管理方式：

受管理的公司工作站

如果贵公司使用移动设备管理 (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 网址。
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 环境变量：

交互式 shell

以下示例展示了如何在 shell 启动配置文件（例如 ~/.bashrc 或 ~/.zshrc）中为交互式终端会话和与 Antigravity CLI 集成的 IDE 扩展程序（例如 Visual Studio Code 和 Visual Studio）配置网关环境变量：

# 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 传输协议设置为 genai（默认值，适用于 Gemini API 协议）或 openai（适用于 OpenAI Chat Completions 协议）。
  • AGY_LLM_GATEWAY_CA_CERT：设置企业根 CA 证书包的路径，以便 Antigravity 信任网关的 TLS 证书。
  • AGY_LLM_GATEWAY_HEADERS：添加自定义标头，供网关用于将用量归因于团队的成本中心。
  • AGY_LLM_GATEWAY_MODELS：设置您可以选择的模型。如需详细了解可用模型，请参阅支持的模型列表。

如需应用更改，请重新加载 shell 配置文件：

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) 未存储在映像中。而应在运行时使用容器 Secret 或环境参数（例如 docker run -e AGY_LLM_GATEWAY_API_KEY=...）提供。

JetBrains IDE

JetBrains IDE 通过 Antigravity 智能体客户端协议 (ACP) 服务器与 Antigravity 通信。由于桌面 IDE 不会读取 ~/.bashrc 等 shell 启动配置文件，因此请在 IDE 代理配置中配置网关设置：

  1. 在 ~/.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 二进制文件的路径。

  2. 在 ~/.gemini/antigravity-acp/settings.json（或 $GEMINI_HOME/antigravity-acp/settings.json，如果设置了 GEMINI_HOME）中，开启网关身份验证：

    {
  "auth": {
    "type": "gateway"
  }
}

    注意：与 Antigravity CLI 不同，仅设置 AGY_LLM_GATEWAY_URL 不会在 ACP 服务器中开启网关路由；必须设置 "auth": { "type": "gateway" }。

  3. 重启 JetBrains IDE。

Zed

Zed 通过 Antigravity 智能体客户端协议 (ACP) 服务器与 Antigravity 通信。由于桌面 IDE 不会读取 ~/.bashrc 等 shell 启动配置文件，因此请在 Zed 的配置文件中配置网关设置：

  1. 在 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 二进制文件的路径。

  2. 在 ~/.gemini/antigravity-acp/settings.json（或 $GEMINI_HOME/antigravity-acp/settings.json，如果设置了 GEMINI_HOME）中，开启网关身份验证：

    {
  "auth": {
    "type": "gateway"
  }
}

    注意：与 Antigravity CLI 不同，仅设置 AGY_LLM_GATEWAY_URL 不会在 ACP 服务器中开启网关路由；必须设置 "auth": { "type": "gateway" }。

  3. 重启 Zed。

验证连接

配置环境后，验证 Antigravity 是否连接到企业网关：

  1. 检查 Antigravity 应用：
    • 在底部状态栏中，验证连接状态是否显示为已连接：企业网关。
    • 在账号设置中，验证状态是否显示为企业网关模式已启用。

  2. 测试 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 账号登录 当前 shell 或 IDE 配置中未设置网关网址。 对于终端会话和 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 未将该变量传递给代理服务器。 将 AGY_LLM_GATEWAY_URL 添加到 ~/.jetbrains/acp.json (JetBrains) 或 settings.json (Zed) 中的代理 env 代码块（而非 shell 配置文件）中，然后重启 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 传输协议。

后续步骤