Unity Gateway CLI
Команда ug запускает Codex, Claude Code, Gemini CLI и другие кодовые агенты через Databricks AI Gateway и подключает MCP.
Расширенный доступ
Почему такой уровень
- Инструмент меняет глобальные настройки агентов, может требовать sudo и пропускает запросы через корпоративный шлюз.
Установка
- Работает в
Ручная установка
uv tool install git+https://github.com/databricks/unity-gatewayПервая команда Install из README. Затем проверьте `ug --version` и `ug --help`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструмент меняет глобальные настройки агентов, может требовать sudo и пропускает запросы через корпоративный шлюз.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Unity Gateway ставит команду `ug`, которая настраивает кодовые агенты на работу через Databricks AI Gateway. Поддержаны Codex, Claude Code, Gemini CLI, OpenCode, GitHub Copilot CLI, Pi и Google Antigravity CLI, а для Cursor Agent регистрируются только MCP-серверы Databricks. При первом запуске `ug` просит выбрать рабочее пространство Databricks, проходит вход и записывает локальную настройку агента. Команда `ug configure` задает агентов и источник моделей, `ug mcp add` добавляет MCP-серверы из каталога Unity. Для Claude Code есть серверный веб-поиск через MCP `web_search`, а локальный прокси обновляет токен Databricks в течение сессии.
Для кого. Команды на Databricks, которым нужно гнать вызовы кодовых агентов через корпоративный шлюз с единой авторизацией и учетом, а не через личные ключи.
Подходит, если
- Компания держит модели в Databricks, и разработчикам нужен один вход для Codex и Claude Code.
- Администратор раздает настройки агентов централизованно через управляемую конфигурацию рабочего пространства.
- Агентам нужны MCP-серверы Databricks, например `system.ai.github`.
- Сессия длится дольше срока токена, и нужно обновление без перезапуска.
Не подходит, если
- Нет рабочего пространства Databricks с настроенным AI Gateway.
- Агентов хотят подключить к своим личным ключам напрямую.
- Нужен общий шлюз над любыми провайдерами вне Databricks.
Пример запроса к агенту
Настрой Codex и Claude Code через Unity Gateway для нашего рабочего пространства и добавь MCP-сервер `system.ai.github`.Ограничения
Нужны Python 3.12 или новее и `uv`, а для автоустановки агентов `npm`. `ug configure` по умолчанию пишет пользовательские и общесистемные настройки Claude Code и Codex, для управляемых файлов может потребоваться `sudo`. Пакет Python по-прежнему называется `ucode`, старые команды `ucode` работают. Часть режимов зависит от версий агентов, например умная маршрутизация Codex требует 0.164.0. Последний коммит 6 ноября 2026.
Как отключить. Удалите инструмент командой `uv tool uninstall unity-gateway`, затем уберите записанные им настройки агентов в `~/.claude` и `~/.codex` и MCP-регистрации.
Частые вопросы
Какие агенты запускает ug?
`ug codex`, `ug claude`, `ug gemini`, `ug opencode`, `ug copilot`, `ug pi` и `ug antigravity`. Для Cursor Agent доступны только MCP через `ug cursor`.
Как добавить MCP-серверы Databricks?
Командой `ug mcp add`. Параметры `--names` и `--location` выбирают серверы, `--agents` указывает, каким агентам их зарегистрировать.
Что с командами ucode?
Они остаются рабочими. Для перехода переустановите пакет под новым именем `unity-gateway` и проверьте `ug --version`.
Записывается ли токен Databricks на диск?
Для Antigravity по описанию локальный прокси добавляет свежий токен к каждому запросу, и токен на диск не пишется.
Что нужно для установки?
Python 3.12 или новее и `uv`. Для автоматической установки самих агентов нужен еще `npm`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер, встроенный в агент Netdata: метрики, логи, алерты и живые данные о процессах, сервисах и контейнерах для AI-ассистента
dive показывает состав слоев Docker и OCI-образов, отмечает изменения файлов и оценивает лишнее место в образе для проверки в CI.
PM2, менеджер процессов, сохраняет список фоновых приложений для запуска после перезагрузки и показывает их состояние в терминале.
Официальный MCP-сервер GitHub: код, issues, пул-реквесты, Actions и алерты безопасности прямо из агента
Скилл Vercel для монорепозиториев на Turborepo: настройка turbo.json, кеш, фильтры и CI по документации, которая лежит в установленном пакете
Nx CLI подключается к скриптам npm, pnpm или yarn: команда вводит общие проверки монорепозитория постепенно, сохраняя команды.
Коротко о README
Инструмент настраивает агентов на Databricks AI Gateway, но выбор моделей, провайдеров и управляемую конфигурацию определяет рабочее пространство.