Empieza con los agentes de codificación

Unity Gateway conecta agentes de programación como Claude Code, Codex y OpenCode con modelos de múltiples proveedores, herramientas MCP y habilidades compartidas. Elige un modelo para la tarea, da a tu agente acceso a los datos de la empresa y utiliza los flujos de trabajo de tu equipo.

Puedes conectar de dos maneras:

  • Usa ug (recomendado): Instala la CLI de Unity Gateway, inicia sesión y lanza tu agente preferido. ug gestiona la configuración de conexión específica del agente y aplica la configuración de tu organización, así que puedes empezar a programar sin editar archivos de configuración ni escribir scripts de configuración.
  • Configura la conexión tú mismo: Introduce el endpoint del gateway y la configuración de autenticación en tu agente. Consulta Agentes de programación y de trabajo compatibles para elegir tu agente y abrir su guía.

Utiliza Codex CLI, Claude Code, GitHub Copilot y ChatGPT Desktop con modelos de código abierto compatibles a través de Unity Gateway.

Esta guía te explica cómo usar ug.

Note

Si tu administrador ya ha instalado ug y configurado tu dispositivo, ve directamente a lanzar tu agente.

Prerequisites

Necesitas:

  • La URL de tu espacio de trabajo de Azure Databricks y el acceso a los modelos que quieres usar. Pregunta a tu administrador si no tienes esto.
  • Python 3.12 o posterior y uv.
  • Un derecho del área de trabajo: acceso al área de trabajo o acceso de consumidor. Consulte Administración de derechos.

Configura y ejecuta tu agente

Instalar ug

En el terminal, ejecute:

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

Para comprobar la instalación, ejecuta:

ug --version

Debería ver el número de la versión instalada.

Configura tus agentes

En un terminal interactivo, ejecute:

ug configure

Selecciona tu espacio de trabajo, inicia sesión y elige los agentes a configurar. Para Claude y Codex, ug configure configura la CLI y la aplicación de escritorio correspondiente, Claude de escritorio o ChatGPT de escritorio, si está instalada. Para configurar agentes específicos sin el selector, enuméralos con --agents, por ejemplo ug configure --agents claude,codex. Consulta la referencia a la CLI de ug.

Iniciar su agente

Abre un terminal en el directorio de tu proyecto. Ejecuta el comando para el agente que quieres usar:

Claude Code

ug claude

Codex

ug codex

Gemini CLI

ug gemini

OpenCode

ug opencode

CLI de GitHub Copilot

ug copilot

Pi

ug pi

ug gestiona la conexión a Unity Gateway y luego abre el agente elegido con la misma interfaz y flujo de trabajo que ya conoces.

Para usar Claude en escritorio o ChatGPT en escritorio, abre o reinicia la aplicación cuando ug configure termine.

Para cambiar de modelo durante una sesión, utiliza /model la opción de elegir entre los disponibles en tu organización.

Adición de herramientas y aptitudes

En el terminal, ejecute:

ug mcp add
ug skills add

Elige los servidores MCP y las habilidades que quieres añadir de entre los que tienes acceso. Las herramientas MCP conectan a tu agente con datos y servicios; las habilidades proporcionan instrucciones para tareas específicas.

Luego lanza o reinicia tu agente para usar lo que has añadido:

Comando dentro del agente Qué puede hacer
/mcp Consulta los servidores MCP que has añadido y su estado de conexión.
/skills Explora las habilidades que has añadido y selecciona una para tu tarea.

Los comandos de corte varían según el agente. Consulta su menú de ayuda para comandos de modelo, MCP y habilidades. Consulta Añadir herramientas y habilidades para más opciones de configuración.

Comprobar su uso

Revisa el uso presupuestario de tu Unity Gateway desde tu terminal:

ug usage

El resultado muestra tus límites personales y compartidos de gasto y el porcentaje utilizado para cada uno. Muestra hasta cinco límites, ordenados de mayor a menor porcentaje utilizado. Ejecuta ug usage --all para ver todos los límites aplicables.

Para más información, consulta la referencia de ug CLI.

Pasos siguientes