Cua：为 AI Agent 提供可操作的计算机（开源驱动、跨系统云桌面与评测基准）
Cua 提供开源桌面自动化驱动、隔离云桌面（Cua Fleets）、Apple Silicon 本地 macOS/Linux 虚拟机（Lume），以及用于训练、评测与数据生成的 computer-use 基准（Cua Bench）。你自带 agent 与模型，Cua 提供计算机与自动化工具，覆盖代码、API 与图形界面之间的同一任务流转。
社区作者 · zZz
它解决什么问题
Cua 的核心主张是“Give AI agents computers they can use”：为 AI agent 提供可实际操作的计算机环境，其中包含开源桌面自动化、隔离云桌面、本地 macOS 虚拟机与评测基准，用于评估 computer-use agent。项目把 Computer-Use 2.0 描述为：agent 在同一任务内于代码、API 和图形界面之间切换。
项目由四块能力组成（配图 1 为 Cua logo）： 1）Cua Fleets（配图 2：isolated cloud desktops for your agents）：在 run.cua.ai 上开通隔离云桌面。Fleet 维护沙箱容量，你的代码从池中认领一台桌面，并通过 Sandbox SDK 在其中执行命令、截图、与应用交互。
2）Cua Driver（配图 3：inspect and operate apps on macOS, Windows, and Linux）：为 agent 提供检查和操作 macOS、Windows、Linux 原生桌面应用与浏览器的工具，可通过 CLI、MCP 或类型化 SDK 连接。在应用与平台支持的前提下，后台投递让 agent 无需移动指针或抢占焦点即可工作，边界见平台支持说明。
页面演示中提到：两个 Cua Driver 会话在 Omarchy 桌面上分别操作 LibreOffice Calc 的单元格与 Inkscape 的对象，同时终端保持在前台（页面提供 50 秒演示视频 recording.mp4 与 Omarchy on Fleet 相关内容）。 3）Lume（配图 4：local macOS and Linux VMs on Apple Silicon）：使用 Apple 的 Virtualization.
Framework，在 Apple Silicon 上创建和管理本地 macOS 与 Linux 虚拟机。 4）Cua Bench（配图 5：create tasks, evaluate agents, and export trajectories）：构建 computer-use 任务、评估 agent，并导出轨迹用于训练；入门可用无需 VM、Docker 或模型 API Key 的模拟任务。
页面给出的“四条上手路径”分别是：Cua Fleets——开通一台 Linux 桌面、运行命令并保存截图；Cua Driver——操作计算器并验证结果；Lume——创建一台 Tahoe 虚拟机并通过 SSH 连接；Cua Bench——创建并验证一个模拟任务。
生态与集成：使用 Claude Code、Codex、Cursor、OpenClaw 或其他 agent 的用户可按页面指引查找对应集成；Cua Driver 的源码文档与架构说明位于仓库 libs/cua-driver/README.md。资源入口包括文档、博客、Discord、GitHub Issues 与安全漏洞私密报告渠道。
引用与贡献：若要引用该软件，页面给出 BibTeX 条目（作者 Cua AI, Inc.，标题 Cua，年份 2025，链接 https://github.com/trycua/cua，许可证 MIT），并建议为可复现性注明实验所用的 Cua release 或 commit；引用元数据也在 CITATION.cff 中。项目欢迎贡献，详见 Contributing Guidelines。页面另列有 GitHub Sponsors 致谢。
商标说明：Apple、macOS、Ubuntu、Canonical 与 Microsoft 为各自所有者的商标，本项目与这些公司无关联、未获其背书。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
以下按 Cua 的四个组件分别给出准备环境、安装命令、先后顺序与首次运行目标；具体细节以页面链接的教程与 CLI 参考为准。
一、Cua Driver（macOS / Windows / Linux 原生应用与浏览器操作）
- 准备环境：准备 macOS、Windows 或 Linux 桌面环境；连接方式可选 CLI、MCP 或类型化 SDK；需要按教程完成平台设置与权限配置；后台投递能力取决于应用与平台支持情况（边界见平台支持说明）。
- 安装命令（按平台二选一）：
/bin/bash -c "$(curl -fsSL https://cua.ai/driver/install.sh)"
- macOS / Linux：
- Windows（PowerShell）：
irm https://cua.ai/driver/install.ps1 | iex- 首次运行（Your first result）：连接你的 agent，让它在 Calculator 中计算 6 × 7，并验证应用显示 42。
- 参考文档：Drive your first app、Installation、CLI Reference；源码文档与架构说明见 libs/cua-driver/README.md。
- 常见问题：平台权限需按教程逐项配置；后台投递并非所有平台/应用都支持，需查阅平台支持边界。
二、Lume（Apple Silicon 上的本地 macOS 与 Linux 虚拟机）
- 准备环境：Apple Silicon 设备；基于 Apple 的 Virtualization.Framework。
/bin/bash -c "$(curl -fsSL https://cua.ai/lume/install.sh)"
- 安装命令：
- 首次运行（Your first result）：从 Apple 恢复镜像创建一台原生 macOS Tahoe 虚拟机，启动它，并通过 SSH 连接；教程直接使用 Lume CLI，并说明无人值守安装的默认值。
- 参考文档：Create your first Lume VM、Installation、CLI reference。
三、Cua Bench（构建任务、评估 agent、导出轨迹）
步骤 1 · 准备环境：
Python 3.12或 3.13，并已安装 uv。入门可用模拟任务，无需 VM、Docker 或模型 API Key。
- 安装命令（按顺序执行）：
uv tool install 'cua-bench[browser]'uv tool run --from 'cua-bench[browser]' playwright install chromium- 首次运行（Your first result）：创建一个小任务，运行其参考解，验证评估器报告的 reward 为 1.0；然后自己再尝试同一个任务。
- 参考文档：Build your first task、What is Cua-Bench?、CLI reference、Partner with us。
四、Cua Fleets（隔离云桌面）
- 开通入口：在 run.cua.ai 开通。Fleet 维护沙箱容量，代码从池中认领桌面，再用 Sandbox SDK 执行命令、截图、与应用交互。
- 首个结果：开通一台 Linux 桌面、运行 uname -a、保存截图，然后删除云资源。教程涵盖 Fleet 凭据、依赖与清理步骤。
- 注意事项（常见问题）：认领结束后池可能仍保留付费容量，必须按教程的清理步骤操作；本地沙箱与 Fleets 共用 Sandbox SDK，但凭据、镜像、操作与运行要求不同，请参考 runtime support 文档选择环境；使用自有硬件时见 Manage local sandbox lifecycle。
- 参考文档：Your first Cloud Fleet、Fleet overview、Sandbox SDK reference。
