安装并设置

为您的编码智能体安装 uip CLI 和 UiPath 技能，然后对您的 UiPath 组织进行身份验证。

本指南将使您从干净计算机到正常设置： uip CLI、编码智能体的 UiPath 技能，以及与 UiPath 组织的经过身份验证的连接。

备注：

在让编码智能体处理您的 UiPath 组织之前，请查看建议指南，以确保合规和负责任的使用。

先决条件

• 有权访问组织和租户的 UiPath 帐户。
• 已安装受支持的编码智能体：Claude Code、Cursor、Codex CLI 或 GoogleAnti Gravility。
• 您的计算机上的管理员权限，因此安装程序可以添加运行时。

受限网络和内部 npm 注册表

UiPath 包发布到 npm 上的公共 @uipath 作用域下。www.npmjs.com 上的包页面仅供参考； npm 客户端和存储库代理从 https://registry.npmjs.org/ 检索包元数据和存档。

如果您的组织限制 npm 访问：

• 允许或镜像 @uipath/* 中完整的公共 https://registry.npmjs.org/ 作用域。

• 不允许仅 @uipath/cli。CLI 还检索 @uipath/skills、功能特定的工具、更新元数据和特定于平台的支持包。

• 如果您使用内部 npm 代理，请配置 @uipath 作用域以使用该代理。将以下示例 URL 替换为您的内部注册表 URL：

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

在运行安装程序之前，请验证 CLI 和技能包是否可通过配置的注册表使用：

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

支持包集会随着功能的添加而不断变化。首选允许 @uipath/* 作用域，而不是维护单独的包列表。

安装

最快的路径是单引号安装程序。可以安全地重新运行 — 每个步骤都会跳过已存在的内容。

1. 运行适用于您操作系统的安装程序。

   # 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. 打开新终端，以便更新的PATH生效，然后运行uip --help 。

结果：已安装uip CLI 和 UiPath 技能，并且 CLI 在终端中做出响应。

安装程序执行的操作

该脚本按顺序执行六个步骤，并跳过任何已满足的步骤：

• 确保curl可用，用于下载剩余的安装程序。
• 确保安装 Node.js 20 或更高版本。
• 使用npm install -g @uipath/cli从 npm 安装 UiPath CLI。
• 运行uip skills install ，这会为其在您的计算机上检测到的编码智能体添加 UiPath 技能。
• 安装.NET SDK 8.0。
• 安装 Python 3.11 到 3.14。

备注：

CLI 发布在公共 npm 注册表上，因此安装不需要令牌。

身份验证

使用uip login登录 UiPath系统将打开浏览器并指导您登录。

根据您的环境和租户调整命令：

• 要使用cloud.uipath.com以外的环境，请传递权限： uip login --authority "https://alpha.uipath.com" 。
• 要选择租户，请运行uip login -it以以交互方式选择，如果您知道名称，请运行uip login -t TenantName 。

结果： CLI 已登录到您的组织，并且系统已选择默认租户。

验证您的设置

1. 运行uip --help以确认 CLI 响应。
2. 打开您的编码智能体，向其询问一个简单的 UiPath 问题，以确认技能可用，例如：“您已安装哪些 UiPath 技能？”

结果： CLI 响应，您的编码智能体可以列出已安装的 UiPath 技能。

安装选项

跳过您不想要的部分。在 macOS/Linux 上，使用bash -s --将标志传递给脚本（或使用匹配的环境变量）；在 Windows 上，请使用 PowerShell 开关。

标记 ( .sh )	开关 ( .ps1 )	环境变量	跳过
--skip-node	-SkipNode	UIP_SKIP_NODE	安装 Node.js
--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	不运行任何内容；打印计划

设置后，继续进行第一个构建。