Installieren und einrichten

Installieren Sie die uip-CLI und die UiPath-Fähigkeiten für Ihren Codierungs-Agent und authentifizieren Sie sich dann bei Ihrer UiPath-Organisation.

Diese Anleitung führt Sie von einer sauberen Maschine zu einer funktionierenden Einrichtung: der uip -CLI, den UiPath-Fähigkeiten für Ihren Codierungs-Agent und einer authentifizierten Verbindung zu Ihrer UiPath-Organisation.

Hinweis:

Bevor Sie einen Codierungs-Agent auf Ihrer UiPath-Organisation handeln lassen, überprüfen Sie die empfohlenen Richtlinien für die konforme und verantwortungsvolle Nutzung.

Voraussetzungen

• Ein UiPath-Konto mit Zugriff auf eine Organisation und einen Mandanten.
• Ein unterstützter installierter Codierungsagent: Claude Code, Cursor, Codex CLI oder Google Antischwerity.
• Administratorrechte auf Ihrer Maschine, damit das Installationsprogramm Runtimes hinzufügen kann.

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.

Installieren

Der schnellste Pfad ist das einzeilige Installationsprogramm. Eine erneute Ausführung ist sicher – bei jedem Schritt wird übersprungen, was bereits vorhanden ist.

1. Führen Sie das Installationsprogramm für Ihr Betriebssystem aus.

   # 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. Öffnen Sie ein neues Terminal, damit die aktualisierte PATH wirksam wird, und führen Sie dann uip --help aus.

Ergebnis: Die uip -CLI- und UiPath-Fähigkeiten werden installiert und die CLI reagiert in Ihrem Terminal.

Was das Installationsprogramm tut

Das Skript führt sechs Schritte der Reihenfolge nach aus und überspringt alle, die bereits zufrieden sind:

• Stellt sicher, dass curl verfügbar ist, und wird zum Herunterladen der verbleibenden Installationsprogramme verwendet.
• Stellt sicher, dass Node.js 20 oder höher installiert ist.
• Installiert die UiPath CLI von npm mit npm install -g @uipath/cli.
• Führt uip skills install aus, wodurch UiPath-Fähigkeiten für die Codierungs-Agents hinzugefügt werden, die es auf Ihrer Maschine erkennt.
• Installiert das.NET SDK 8.0.
• Installiert Python 3.11 bis 3.14.

Hinweis:

Die CLI wird in der öffentlichen npm-Registrierung veröffentlicht, sodass zum Installieren kein Token erforderlich ist.

Authentifizieren

Melden Sie sich mit uip login bei UiPath an. Ihr Browser wird geöffnet und führt Sie durch die Anmeldung.

Passen Sie den Befehl für Ihre Umgebung und Ihren Mandanten an:

• Um eine andere Umgebung als cloud.uipath.com zu verwenden, übergeben Sie eine Autorisierung: uip login --authority "https://alpha.uipath.com".
• Um einen Mandanten auszuwählen, führen Sie uip login -it für die interaktive Auswahl oder uip login -t TenantName aus, wenn Sie den Namen kennen.

Ergebnis: Die CLI ist bei Ihrer Organisation angemeldet und der Standardmandant wird ausgewählt.

Überprüfen Sie Ihr Setup

1. Führen Sie uip --help aus, um zu bestätigen, dass die CLI antwortet.
2. Öffnen Sie Ihren Codierungs-Agent und stellen Sie ihm eine einfache UiPath-Frage, um zu bestätigen, dass die Fähigkeiten verfügbar sind, z. B.: „Welche UiPath-Fähigkeiten haben Sie installiert?“

Ergebnis: Die CLI antwortet und Ihr Codierungs-Agent kann die installierten UiPath-Fähigkeiten auflisten.

Installationsoptionen

Überspringen Sie nicht gewünschte Teile. Übergeben Sie unter macOS/Linux ein Flag an das Skript mit bash -s -- (oder verwenden Sie die passende Umgebungsvariable); verwenden Sie unter Windows den PowerShell-Schalter.

Markieren (.sh)	Umschalten (.ps1)	Umgebungsvariable	Wird übersprungen
--skip-node	-SkipNode	UIP_SKIP_NODE	Node.js installieren
--skip-skills	-SkipSkills	UIP_SKIP_SKILLS	uip skills install
--skip-dotnet	-SkipDotnet	UIP_SKIP_DOTNET	.NET SDK
--skip-python	-SkipPython	UIP_SKIP_PYTHON	Python
--skip-runtimes	-SkipRuntimes	UIP_SKIP_RUNTIMES	.NET SDK + Python
--dry-run	-DryRun	UIP_DRY_RUN	Führt nichts aus; Gibt den Plan aus

Sobald Sie eingerichtet sind, fahren Sie mit Ihrem ersten Build fort.