Instalar y configurar

Esta guía te lleva de una máquina limpia a una configuración funcional: la CLI uip , las habilidades de UiPath para tu agente de codificación y una conexión autenticada a tu organización de UiPath.

Nota:

Antes de permitir que un agente de codificación actúe en tu organización de UiPath, revisa las directrices recomendadas para un uso responsable y compatible.

Requisitos previos

• Una cuenta de UiPath con acceso a una organización y un tenant.
• Un agente de codificación compatible instalado: Claude Code, Cursor, Codex CLI o Google Antigravity.
• Derechos de administrador en tu máquina, para que el instalador pueda añadir tiempos de ejecución.

Instalar

La ruta más rápida es el instalador de una sola línea. Es seguro volver a ejecutarlo: cada paso omite lo que ya está presente.

1. Ejecuta el instalador para tu sistema operativo.

   # macOS / Linux
   curl -fsSL https://download.uipath.com/uipath-cli/install.sh | bash
   

   # Windows (PowerShell)
   irm https://download.uipath.com/uipath-cli/install.ps1 | iex
   

2. Abre un nuevo terminal para que el PATH actualizado surta efecto y, a continuación, ejecuta uip --help.

Resultado: se instalan las habilidades de CLI uip y UiPath, y CLI responde en tu terminal.

Qué hace el instalador

El script realiza seis pasos en orden y omite los que ya están satisfechos:

• Garantiza que curl esté disponible, utilizado para descargar los instaladores restantes.
• Garantiza que esté instalado Node.js 20 o posterior.
• Instala UiPath CLI desde npm con npm install -g @uipath/cli.
• Ejecuta uip skills install, que añade habilidades de UiPath para los agentes de codificación que detecta en tu máquina.
• Instala .NET SDK 8.0.
• Instala Python 3.11 a 3.14.

Nota:

El CLI se publica en el registro público de npm, por lo que no se requiere ningún token para instalarlo.

Autenticar

Inicia sesión en UiPath con uip login. Su navegador se abre y le guía a través del inicio de sesión.

Ajusta el comando para tu entorno y tenant:

• Para utilizar un entorno distinto de cloud.uipath.com, pasa una autoridad: uip login --authority "https://alpha.uipath.com".
• Para seleccionar un tenant, ejecuta uip login -it para elegir de forma interactiva, o ejecuta uip login -t TenantName si conoces el nombre.

Resultado: CLI inicia sesión en tu organización y se selecciona el tenant predeterminado.

Verifique su configuración

1. Ejecuta uip --help para confirmar que CLI responde.
2. Abre tu agente de codificación y hazle una pregunta simple a UiPath para confirmar que las habilidades están disponibles, por ejemplo: "¿Qué habilidades de UiPath tienes instaladas?"

Resultado: la CLI responde y tu agente de codificación puede enumerar las habilidades de UiPath instaladas.

Opciones de instalación

Omita las partes que no desee. En macOS/Linux, pasa un marcador al script con bash -s -- (o utiliza la variable de entorno correspondiente); en Windows, utiliza el conmutador PowerShell.

Marcar (.sh)	Interruptor (.ps1)	Variable de entorno	Saltos
--skip-node	-SkipNode	UIP_SKIP_NODE	Instalación de Node.js
--skip-skills	-SkipSkills	UIP_SKIP_SKILLS	uip skills install
--skip-dotnet	-SkipDotnet	UIP_SKIP_DOTNET	SDK.NET
--skip-python	-SkipPython	UIP_SKIP_PYTHON	Python
--skip-runtimes	-SkipRuntimes	UIP_SKIP_RUNTIMES	.NET SDK + Python
--dry-run	-DryRun	UIP_DRY_RUN	no ejecuta nada; imprime el plan

Una vez que hayas configurado, continúa con Tu primera compilación.