Cloudroom：AI 编程 Agent 桌面平台

项目简介

Cloudroom 是一个面向 AI 编程 Agent 的开源桌面应用。你可以让 Agent 直接跑在自己的 Mac 上，也可以给每个 Agent 分配一台云端电脑；合上笔记本，它们仍然继续工作。项目采用 Apache-2.0 许可，桌面端基于 BB 构建，云端引擎用 Rust 编写。

主要功能

• 本地与云端并存：每个 Cloud 线程拥有独立的沙箱和 Git 分支。
• 使用自己的订阅：Agent 使用你已有的 Claude 和 ChatGPT 登录，没有额外加价。
• 访问 Mac：云端 Agent 可以访问你的 Mac，权限可选 Off、Read-only、Ask first 或 Full。
• Teleport：把运行中的线程在本地和云端之间来回迁移，保持相同的对话、模型和 effort 设置。
• 自建云端：在自己的 Linux 机器上运行 core，无需 Cloudroom 账号。

支持 Apple Silicon Mac（macOS 13+）、Linux x64 和 Windows 11。

安装与使用

使用应用：从官网下载安装包，应用会自动更新。

自建 core（以 Ubuntu 24.04 为例）：

curl -fsSL https://cloudroom.dev/install.sh -o install.sh
sudo bash install.sh

然后用服务器的 URL 和 token 在桌面应用中连接。完整步骤见 setup 文档。

从源码构建：core 需要 Rust 1.89+：

cd core
cargo build --locked --release
cargo test --locked --all-targets

仓库结构：gui/ 是桌面应用；core/ 是运行云端 Agent 并保存其历史的 Rust 服务；skills/ 是每个 Cloudroom Agent 自带的技能。

注意事项

• Agent 以独立的 Linux 用户身份运行，没有管理员权限。
• 每个 API 请求都需要 secret token；除非放在 HTTPS 后面，API 只监听 localhost。
• 历史记录保存在自己机器的磁盘上。
• Agent 运行时不会弹出审批提示，建议为每个受信任的用户分配独立机器。

---

本作品整理自 GitHub 开源项目 davidondrej/cloudroom，原作者 @davidondrej，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。