Cua：让AI代理在macOS/Linux沙盒中安全执行应用

综合介绍

Cua 是一个开源项目，全称“Computer-Use Agent”（计算机使用代理），读作“koo-ah”。它专为 Apple Silicon 设备设计，能创建并运行高性能的 macOS 和 Linux 虚拟机，速度接近原生设备的 90%。Cua 使用 Apple 的 Virtualization.Framework 技术，同时支持 AI 代理在虚拟环境中执行浏览网页、编写代码等任务。项目强调安全隔离，保护用户主系统。它以 MIT 许可证在 GitHub 上发布，适合开发者、技术爱好者和 AI 研究者使用。

功能列表

• 在 Apple Silicon 上创建并运行 macOS 和 Linux 虚拟机。
• 提供高达 90% 原生速度的高性能虚拟化。
• 支持 AI 代理控制虚拟机，完成浏览、编码等复杂操作。
• 确保虚拟机与主系统完全隔离，保障安全性。
• 提供命令行工具（Lume CLI）和 Python 库，方便管理虚拟机和 AI 代理。
• 支持多种语言模型（LLM）集成，如 OpenAI、Anthropic。
• 开源框架，允许用户自定义虚拟机镜像和功能。

使用帮助

Cua 的安装和使用分为两部分：虚拟机管理（Lume CLI）和完整 AI 代理功能。以下是详细步骤。

系统要求

• 设备：带 Apple Silicon（M1/M2/M3/M4）的 Mac。
• 系统：macOS 14（Sonoma）或更高版本。
• Python：3.10 或更高版本（仅限 AI 代理功能）。
• 磁盘空间：建议 40GB 以上，用于存储虚拟机镜像。

安装流程

选项 1：仅安装 Lume CLI（虚拟机管理）

1. 打开终端，确保网络畅通。
2. 输入命令安装 Lume：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

3. 安装完成后，输入 lume --version 检查版本，确认安装成功。

选项 2：安装完整 AI 代理功能

1. 先安装 Lume CLI（如上步骤）。
2. 安装 Python 库：

pip install cua-computer cua-agent

3. 如果需要更多功能，可以安装其他库，如：

pip install cua-core cua-computer-server cua-som pylume

主要功能操作

创建和运行虚拟机

1. 在终端输入：

lume run macos-sequoia-vanilla:latest

这会下载并启动 macOS Sequoia 虚拟机。
2. 虚拟机启动后，你会看到一个独立桌面。
3. 按 Ctrl+C 停止虚拟机。

使用 AI 代理

1. 配置环境
   安装 AI 代理库后，创建 .env 文件，添加模型密钥。例如：

OPENAI_API_KEY=你的密钥

2. 运行示例
   在 GitHub 的 notebooks 文件夹中找到示例代码，如：

• 打开终端，运行：

  python -m cua_agent.examples.basic_agent
  

• AI 代理会通过屏幕截图识别虚拟机界面并执行任务。

3. 自定义任务
   编辑 Python 脚本，定义代理的具体操作，如浏览网页或点击按钮。

管理虚拟机

• 列出镜像：

lume images

• 删除镜像：

lume rm macos-sequoia-vanilla:latest

特色功能操作

高性能虚拟化

Cua 使用 Apple 的 Virtualization.Framework，无需额外配置即可实现接近原生性能。运行 Geekbench 测试，结果显示虚拟机性能可达原生的 90%。

安全隔离

每个虚拟机运行在独立沙盒中。AI 代理的操作不会影响主系统，适合测试不安全代码或应用。

LLM 集成

Cua 支持连接多种语言模型。用户只需安装对应库并配置密钥即可。例如：

• 使用 Anthropic：

pip install "cua-agent[anthropic]"
export ANTHROPIC_API_KEY=你的密钥

进阶使用

1. 查看文档
   访问 GitHub 的 docs/Getting-Started.md 或 libs/*/README.md，了解详细用法。
2. 运行 Notebook 示例
   下载 notebooks 文件夹中的 Jupyter Notebook，体验 AI 代理修复 GitHub 问题或克隆应用的演示。
3. 贡献代码
   参考 CONTRIBUTING.md，提交新功能或修复问题。

注意事项

• 仅支持 Apple Silicon，不兼容 Intel Mac。
• 虚拟机镜像较大（如 macOS 需 20-30GB），确保磁盘空间充足。
• AI 代理需要稳定的网络和有效的 API 密钥。

应用场景

1. 软件开发与测试
   开发者用 Cua 创建多个虚拟机，测试应用在 macOS 和 Linux 上的运行情况。
2. AI 自动化工作
   配置 AI 代理，自动完成网页数据抓取或文件整理任务。
3. 教育与实验
   学生或研究者在隔离环境中运行代码，学习虚拟化或 AI 技术。

QA

1. Cua 支持哪些操作系统？
   支持 macOS 和 Linux，不支持 Windows。
2. 虚拟机运行速度如何？
   接近原生设备的 90%，由 Apple Silicon 和 Virtualization.Framework 保证。
3. 如何加入社区？
   访问 Discord（https://discord.com/invite/mVnXXpdE85），分享想法或寻求帮助。