Instalar e configurar

Instale as habilidades UiPath CLI e UiPath para seu agente de codificação e, em seguida, autentique-se para sua organização UiPath.

Este guia leva você de uma máquina limpa a uma configuração de trabalho: a CLI uip , as habilidades da UiPath para seu agente de codificação e uma conexão autenticada com sua organização da UiPath.

Observação:

Antes de permitir que um agente de codificação aja em sua organização UiPath, revise as diretrizes recomendadas para uso compatível e responsável.

Pré-requisitos

• Uma conta da UiPath com acesso a uma organização e a um tenant.
• Um agente de codificação compatível instalado: Claude Code, Cursor, Codex CLI ou Google Antigravity.
• Direitos de administrador na sua máquina, para que o instalador possa adicionar runtimes.

Redes restritas e registros npm internos

Os pacotes da UiPath são publicados sob o escopo público @uipath no npm. As páginas de pacote em www.npmjs.com são informativas; os clientes npm e os proxies de repositório recuperam metadados e arquivos de pacotes de https://registry.npmjs.org/.

Se sua organização restringir o acesso ao npm:

• Permita ou espelhe o escopo público completo @uipath/* de https://registry.npmjs.org/.

• Não permita apenas @uipath/cli. A CLI também recupera @uipath/skills, ferramentas específicas de recursos, metadados de atualização e pacotes de suporte específicos da plataforma.

• Se você usar um proxy interno npm, configure o escopo @uipath para usá-lo. Substitua o URL de exemplo pelo URL do seu registro interno:

  npm config set @uipath:registry https://npm.example.com/
  

Verifique se os pacotes de CLI e habilidades estão disponíveis por meio do registro configurado antes de executar o instalador:

npm view @uipath/cli version
npm view @uipath/skills version

O conjunto de pacotes de suporte evolui à medida que os recursos são adicionados. Prefira permitir o escopo @uipath/* em vez de manter uma lista de pacotes individual.

Instalar

O caminho mais rápido é o instalador de uma linha. É seguro executar novamente — cada etapa ignora o que já está presente.

1. Execute o instalador para seu sistema operacional.

   # 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. Abra um novo terminal para que o PATH atualizado entre em vigor e, em seguida, execute uip --help.

Resultado: as habilidades uip da CLI e da UiPath são instaladas, e a CLI responde no seu terminal.

O que o instalador faz

O script executa seis etapas em ordem e pula qualquer que já esteja satisfeito:

• Garante que curl esteja disponível, usado para baixar os instaladores restantes.
• Garante que o Node.js 20 ou posterior esteja instalado.
• Instala o UiPath CLI a partir do npm com npm install -g @uipath/cli.
• Executa uip skills install, que adiciona habilidades da UiPath para os agentes de codificação que detecta em sua máquina.
• Instala o.NET SDK 8.0.
• Instala o Python 3.11 a 3.14.

Observação:

A CLI é publicada no registro público npm, portanto, nenhum token é necessário para instalá-la.

Autenticar

Faça logon na UiPath com uip login. Seu navegador será aberto e guiará você pelo login.

Ajuste o comando para seu ambiente e tenant:

• Para usar um ambiente diferente de cloud.uipath.com, transmita uma autoridade: uip login --authority "https://alpha.uipath.com".
• Para selecionar um tenant, execute uip login -it para escolher interativamente ou execute uip login -t TenantName se você souber o nome.

Resultado: a CLI é conectada à sua organização, e o tenant padrão é selecionado.

Verifique sua configuração

1. uip --help para confirmar se a CLI responde.
2. Abra seu agente de codificação e faça uma pergunta simples da UiPath para confirmar se as habilidades estão disponíveis, por exemplo: " Quais habilidades da UiPath você tem instaladas?"

Resultado: a CLI responde e seu agente de codificação pode listar as habilidades da UiPath instaladas.

Opções de instalação

Pule partes que não quiser. No macOS/Linux, passe um sinalizador para o script com bash -s -- (ou use a variável de ambiente correspondente); no Windows, use o botão de alternância do PowerShell.

Sinalizador (.sh)	Alternar (.ps1)	Variável de ambiente	Ignora
--skip-node	-SkipNode	UIP_SKIP_NODE	Instalação do 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	SDK.NET + Python
--dry-run	-DryRun	UIP_DRY_RUN	Não executa nada; imprime o plano

Depois de configurar, continue com Sua primeira compilação.