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.

Restricted networks and internal npm registries

UiPath packages are published under the public @uipath scope on npm. The package pages on www.npmjs.com are informational; npm clients and repository proxies retrieve package metadata and archives from https://registry.npmjs.org/.

If your organization restricts npm access:

• Allow or mirror the complete public @uipath/* scope from https://registry.npmjs.org/.

• Do not allow only @uipath/cli. The CLI also retrieves @uipath/skills, capability-specific tools, update metadata, and platform-specific supporting packages.

• If you use an internal npm proxy, configure the @uipath scope to use it. Replace the example URL with your internal registry URL:

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

Verify that the CLI and skills packages are available through the configured registry before running the installer:

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

The supporting package set evolves as capabilities are added. Prefer allowing the @uipath/* scope instead of maintaining an individual package list.

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.