Installer et configurer

Installez les compétences CLI uip et UiPath pour votre agent de codage, puis authentifiez-vous auprès de votre organisation UiPath.

Ce guide vous mène d'une machine propre à une configuration qui fonctionne: la CLI uip , les compétences UiPath pour votre agent de codage et une connexion authentifiée à votre organisation UiPath.

Remarque :

Avant de laisser un agent de codage agir sur votre organisation UiPath, examinez les directives recommandées pour une utilisation conforme et responsable.

Prérequis

• Un compte UiPath avec accès à une organisation et à un locataire.
• Un agent de codage pris en charge installé: Claude Code, Cursor, Coded CLI ou Google Agents.
• Droits d'administrateur sur votre machine, afin que le programme d'installation puisse ajouter des runtimes.

Réseaux restreints et registres npm internes

Les packages UiPath sont publiés sous l'étendue publique @uipath sur npm. Les pages de package sur www.npmjs.com sont informatives; les clients npm et les proxys du référentiel récupèrent les métadonnées et les archives des packages à partir de https://registry.npmjs.org/.

Si votre organisation restreint l'accès à npm:

• Autoriser ou mettre en miroir l'étendue publique @uipath/* de https://registry.npmjs.org/.

• N’autorisez pas uniquement @uipath/cli. La CLI récupère également @uipath/skills, les outils spécifiques aux capacités, les métadonnées de mise à jour et les packages d'assistance spécifiques à la plateforme.

• Si vous utilisez un proxy npm interne, configurez l’étendue @uipath pour l’utiliser. Remplacez l’exemple d’URL par votre URL de registre interne:

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

Vérifiez que les packages CLI et de compétences sont disponibles via le registre configuré avant d'exécuter le programme d'installation:

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

L’ensemble de packages d’assistance évolue à mesure que des fonctionnalités sont ajoutées. Préférez autoriser l'étendue @uipath/* au lieu de gérer une liste de packages individuelle.

Installer

Le chemin le plus rapide est le programme d'installation en une ligne. Il est sécurisé de se réexécuter - chaque étape ignore ce qui est déjà présent.

1. Exécutez le programme d'installation de votre système d'exploitation.

   # 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. Ouvrez un nouveau terminal pour que le PATH mis à jour prenne effet, puis exécutez uip --help

Résultat: les compétences uip CLI et UiPath sont installées, et la CLI répond dans votre terminal.

Ce que fait le programme d’installation

Le script effectue six étapes dans l'ordre et ignore celles qui sont déjà satisfaites:

• Garantit que curl est disponible, utilisé pour télécharger les programmes d’installation restants.
• Garantit que Node.js 20 ou une version ultérieure est installé.
• Installe la UiPath CLI à partir de npm avec npm install -g @uipath/cli.
• Exécute uip skills install, qui ajoute des compétences UiPath pour les agents de codage détectés sur votre machine.
• Installe le.NET SDK 8.0.
• Installe Python 3.11 à 3.14.

Remarque :

La CLI est publiée sur le registre npm public, donc aucun jeton n’est requis pour l’installer.

Authentifier

Connectez-vous à UiPath avec uip login. Votre navigateur s'ouvre et vous guide tout au long de la connexion.

Ajustez la commande pour votre environnement et votre locataire:

• Pour utiliser un environnement autre que cloud.uipath.com, transmettez une autorité: uip login --authority "https://alpha.uipath.com".
• Pour sélectionner un locataire, exécutez uip login -it pour choisir interactivement, ou exécutez uip login -t TenantName si vous connaissez le nom.

Résultat: la CLI est connectée à votre organisation et le locataire par défaut est sélectionné.

Vérifiez votre configuration

1. Exécutez uip --help pour confirmer que la CLI répond.
2. Ouvrez votre agent de codage et posez-lui une question UiPath simple pour confirmer que les compétences sont disponibles, par exemple: « Quelles compétences UiPath avez-vous installées?»

Résultat: la CLI répond et votre agent de codage peut répertorier les compétences UiPath installées.

Options d'installation

Ignorez les parties que vous ne voulez pas. Sur macOS/Linux, transmettez un indicateur au script avec bash -s -- (ou utilisez la variable d'environnement correspondante); sur Windows, utilisez le commutateur PowerShell.

Indicateur (.sh)	Basculer (.ps1)	Variable d'environnement	Ignorer
--skip-node	-SkipNode	UIP_SKIP_NODE	Installation 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	SDK.NET + Python
--dry-run	-DryRun	UIP_DRY_RUN	N’exécute rien; imprime le plan

Une fois que vous êtes configuré, passez à votre première construction.