Unity Gateway 通过 Databricks AI Gateway 运行编码代理。它会配置 Codex、Claude Code、Gemini CLI、OpenCode、GitHub Copilot CLI 和 Pi，以及 can 注册Databricks MCP服务器作为光标代理。

命令为 ug。现有的 ucode 命令依然被支持，Python 为了兼容性，软件包仍命名为 ucode。

要求

• Python 3.12+
• uv
• npm，当代理CLI需要自动安装时

安装

[--version 报告已安装的包元数据，但未加载 CLI。使用 ug --help（或称ucode --help）以验证CLI的启动导入是否有效; 单纯的版本输出不是安装健康检查。帮助不会进行验证 工作空间认证或代理运行时行为。

从ucode迁移

重新安装到新发行版名称下：

未来的升级可以使用ug upgrade或uv tool upgrade unity-gateway。

发射特工

运行你想要的工具：

在模型支持代理首次启动时，ug 会提示 Databricks Workspace 认证并编写本地代理配置。之后启动，重用 保存的工作区和凭证。

当Claude代码或Codex比ug支持的最低版本更早时，ug

Unity Gateway (ug)

Unity Gateway runs coding agents through Databricks AI Gateway. It configures Codex, Claude Code, Gemini CLI, OpenCode, GitHub Copilot CLI, Pi, and Google Antigravity CLI, and can register Databricks MCP servers for Cursor Agent.

The command is ug. Existing ucode commands remain supported, and the Python package is still named ucode for compatibility.

Requirements

• Python 3.12+
• uv
• npm, when an agent CLI needs automatic installation

Install

uv tool install git+https://github.com/databricks/unity-gateway
ug --version
ug --help

--version reports installed package metadata without loading the CLI. Use ug --help (or ucode --help) to verify that the CLI’s startup imports work; version output alone is not an installation health check. Help does not validate workspace authentication or agent runtime behavior.

Migrating from ucode

Reinstall under the new distribution name:

uv tool uninstall ucode
uv tool install git+https://github.com/databricks/unity-gateway
ug --version
ucode --version
ug --help
ucode --help

Future upgrades can use ug upgrade or uv tool upgrade unity-gateway.

Launch Agents

Run the tool you want:

ug codex
ug claude
ug gemini
ug opencode
ug copilot
ug pi
ug antigravity   # Google Antigravity CLI; `ug agy` is an alias
ug cursor   # Cursor Agent, MCP-only

On first launch of a model-backed agent, ug prompts for a Databricks workspace, authenticates, and writes local agent config. Later launches reuse the saved workspace and credentials.

When Claude Code or Codex is older than the minimum version ug supports, ug asks before upgrading it in place. Set UG_AUTO_UPGRADE_AGENT=1 to upgrade without asking, for example from a launcher that manages the agent install.

Use ug opencode --model system.ai.glm-5-3 (or -m) to select a configured model for one launch. OpenCode’s provider/model form is also accepted. Unknown Databricks models produce an error; this option does not add models to discovery or change ug’s saved default.

ug antigravity (or ug agy) runs Google’s Antigravity CLI 1.2.15 or later in its Enterprise Gateway mode, so it never asks for Google sign-in. It offers the workspace’s Gemini models under the names Antigravity knows them by (system.ai.gemini-3-8-flash is gemini-3.8-flash) and starts on the newest. A local proxy refreshes the Databricks token for the whole session and maps each name back to its Databricks model. --model accepts either name, or one of Antigravity’s thinking tiers such as gemini-3.8-flash-high. --provider routes through a Gemini Enterprise Model Provider Service, as with ug gemini; choosing External Models in ug configure saves one. When the service declares several models, configure starts on the newest; when it serves any model without declaring