环境已设置

安装 UiPath CLI 并登录您的 UiPath Cloud 帐户，使用 UiPath 技能配置编码智能体，并安装 UiPath VS 代码扩展程序。

概述

本入门开发者指南中的教程结合使用以下方法：

• UiPath Automation Cloud
• UiPath 命令行接口 (CLI)
• UiPath CLI 工具（插件）
• 适用于Visual Studio Code或Open VSX 注册表的UiPath Maestro 扩展程序
• 面向编码智能体的 UiPath 技能

此页面集中了上述列表所需的安装步骤，以及用于确认安装成功的验证步骤。

步骤 1 - 安装 UiPath CLI 和工具

UiPath CLI (uip) 是一个跨平台工具，用于 UiPath 身份验证、项目框架和部署。它使用插件系统：基本 CLI 处理身份验证，您可以为所构建的项目类型安装工具。首次使用时，请参阅自动安装的工具的允许列表。每个教程都包含需要手动安装的说明。

1. 全局安装基本 CLI：

   npm install -g @uipath/cli
   

2. 验证安装：

   uip --version
   

   您应该会看到1.200.0或更高版本。

3. 验证已安装的工具：

   uip tools list
   

   确认您看到的是已安装版本的工具列表。

   {
      "Result": "Success",
      "Code": "ToolList",
      "Data": [
         {
            "Name": "solution-tool",
            "Version": "1.200.0",
            "Description": "Create, pack, publish, and deploy UiPath Automation Solutions.",
            "CommandPrefix": "solution"
         },
         {
            "Name": "agent-tool",
            "Version": "1.200.0",
            "Description": "cli plugin for creating and managing UiPath low-code agents",
            "CommandPrefix": "agent"
         },
         {
            "Name": "codedagent-tool",
            "Version": "1.200.0",
            "Description": "Build, run, deploy, and manage AI Agents.",
            "CommandPrefix": "codedagent"
         },
         {
            "Name": "rpa-tool",
            "Version": "1.200.1",
            "Description": "Tool for creating and managing UiPath RPA projects",
            "CommandPrefix": "rpa"
         },
         {
            "Name": "maestro-tool",
            "Version": "1.200.0",
            "Description": "Create, debug, and run Maestro projects and jobs.",
            "CommandPrefix": "maestro"
         }
      ]
   }
   

步骤 2 - 为您的编码智能体安装 UiPath 技能（可选）

如果您在使用 CLI 的同时使用编码智能体（Claude Code、Cursor、Copilot、Gemini 或 Codex），则安装 UiPath 技能可使智能体了解智能体项目结构、CLI 命令和最佳实践。在运行命令为您的首选编码智能体安装技能之前，请首先确保您已安装智能体。以下示例安装 Claude Code 的技能：

uip skills install --agent claude

如果您使用的是其他智能体，则将 claude 替换为您的智能体。您可以运行 uip skills install --help 并查看 --agent <agent> 选项，以获取支持的编码智能体列表。

技能会全局安装到您的主目录 (~/.uipath/.skills/)，并且之后在每个项目中都可以使用。

步骤 3 - 安装适用于 VS Code 的 UiPath Maestro 扩展程序（可选）

在构建 Maestro Flow、BPMN 图表或案例计划的教程中，此扩展程序使用此扩展程序在可视化画布上打开这些文件，而不是作为原始文本打开。它还可以登录您的租户，并从本地工作区打包和部署。

1. 从 VS 代码 Marketplace 或 开放式 VSX 注册表 安装 UiPath Maestro 。

   此扩展程序需要 VS Code 1.110.0 或更高版本。在“Code” > “关于 Visual Studio Code”中查看您的版本，或运行code --version 。

2. 在系统提示时重新加载 VS Code。

3. 选择活动栏中的UiPath图标，以打开 UiPath 视图。

4. 在“连接”部分中，选择“ 登录 ” 。

5. 在打开的浏览器窗口中完成登录。

   如果尚未安装 CLI，请接受提示，扩展程序将使用 npm 为您安装。登录使用 OAuth 浏览器流程，并在 localhost 端口 8104 上回调；如果失败，则表示该端口可能被过时的流程占用。

6. 运行UiPath：从“命令面板”( Ctrl/Cmd+Shift+P ) 中选择“环境”并确认您的环境。默认为Cloud 。

7. 运行UiPath：选择“租户” ，然后选择要构建的租户。

该扩展程序现在将使用该租户的文件夹和 Orchestrator 资源填充“资源”部分。

扩展程序管理自己的 CLI 副本。安装的版本不必与您在步骤 1 中安装的版本相符。登录后运行 uip --version，如果位置后移，则 npm install -g @uipath/cli 会将您返回到当前版本。

提示：

在远程工作区中工作？在适用于 Linux 的 Windows 子系统 (WSL)、安全 Shell (SSH)、CodeSpaces 和开发容器工作区中，扩展程序在远程主机上运行，因此 UiPath CLI 必须安装在远程主机上，而不是安装在本地计算机上。

步骤 4 - 向 UiPath 进行身份验证

安装 CLI 后，请使用以下步骤对其进行身份验证，然后选择要使用的租户。

1. 对您的 UiPath 帐户的 CLI 进行身份验证：

   uip login
   

   这将打开一个浏览器窗口，您可以在其中登录并选择租户。完成后，终端确认您已登录。

2. 运行以下命令，以确认您可以看到 "Status": "Logged in"，以验证您的登录状态：

   uip login status
   

您现在可以开始学习教程。