跳到教程内容
CloudPilot
English打开面板
02 / CLOUDPILOT GUIDE

云端 AI Agent：Codex、Claude Code 与云桌面

在云端 Linux 工作区里与 Codex、Claude Code 对话，让它们直接编写和运行代码；或者打开内置 Chrome 和 DeepSeek Harness 的 Ubuntu 云桌面。不需要 AWS 凭据，目前免费使用。

更新于 2026-10-24

  1. 创建工作区

    从左侧「云端 Agent」进入，填写名称后点击「创建工作区」，再点击「打开」。每个工作区是一台独立的云端 Linux 容器，预装 Codex、Claude Code、Git、Node.js 和 Python，带 20 GB 磁盘。默认每个账号最多 3 个工作区、同时运行 1 个；规格可选「基础」（1 vCPU、4 GiB 内存）或「标准」（2 vCPU、8 GiB），需要在休眠时修改。

  2. 桌面工作区

    创建时把类型选为「桌面」，会得到一台 Ubuntu 云桌面，内置 Google Chrome 和 DeepSeek Harness，固定使用高性能规格（4 vCPU、12 GiB）。打开后在「桌面」标签里以 RDP 方式连接：点击桌面后即可用键盘，也可以直接用本机输入法输入中文；桌面分辨率跟随窗口大小；⌘V / Ctrl+V 会把本机剪贴板粘贴进去（终端里同样适用），桌面里复制的文字也会同步到本机；工具栏里还有剪贴板、全屏和重新连接。DeepSeek Harness 通过 Workers AI 使用 DeepSeek V4.1 Flash，不需要 API Key，桌面登录后会自动在 Chrome 中打开，选择工作目录时进入主目录里的 workspace；它的「插件」页已开启自定义插件市场，可以在「发现」里添加索引源安装社区插件。浏览器登录状态、桌面设置和 Harness 的会话都保存在 /workspace 中，休眠后依然保留；下载的文件在 /workspace/Downloads。桌面工作区没有对话和账号页面，文件、Git、终端和运行状态与 AI 编程工作区相同。

  3. 登录 AI 账号或使用 API Key

    在「账号与密钥」中登录 ChatGPT（供 Codex 使用）或 Claude（供 Claude Code 使用）账号：打开登录页面，按提示输入或粘贴代码。也可以填写 OpenAI、Anthropic API Key，或兼容服务（如 DeepSeek、Kimi、OpenRouter）的 Base URL 和模型名。Codex 还没登录也没填写 Key 时默认使用 Workers AI，可以直接开始对话。这里还能登录 GitHub（推送代码、创建 Pull Request）和 Cloudflare（用 cf 部署 Workers、Pages）。官方账号登录需要工作区运行中，API Key 在休眠时也能管理。

  4. 在对话里布置任务

    在「对话」中选择 Codex 或 Claude Code 并描述任务，它们会在工作区里修改文件、运行命令。输入 / 使用命令和技能，用 @ 引用工作区文件，可以附带图片、文档等附件，每个最大 100 MB。计划模式会先给出计划，确认后再动手；执行命令或修改文件前默认会请你批准，也可以在对话设置中改为完全访问。

  5. 文件、Git 与终端

    「文件」中可以上传、下载（文件夹下载为 zip）、预览和编辑文件；「Git」中可以创建仓库、查看改动、提交和创建分支，登录 GitHub 后还能推送。「终端」最多开 8 个标签页，切换时保持连接；手机上有 Esc、Tab、Ctrl 和方向键快捷栏，也可以通过输入框输入中文和多行文本。

  6. 工具、插件与 MCP

    在对话中打开「工具、插件与 MCP」，可以安装插件市场里的插件、添加插件市场，添加本地命令（stdio）或远程 URL 的 MCP 服务器，并查看 Codex 的技能、连接器和 Claude Code 的命令与子代理。MCP 服务器对这个工作区的所有对话生效，其中的密钥随登录信息加密保存。

  7. 休眠、备份和恢复

    工作区默认空闲 30 分钟后自动保存并休眠，可在「工作区设置」改为 10 分钟到 4 小时，或不自动休眠；也可以随时点击「保存并休眠」，需要时再「唤醒」。休眠后保留 /workspace 中的文件、对话和登录信息，装在 /workspace 以外的软件和运行中的程序不会保留。每次休眠都会备份 /workspace，只上传有变化的部分，保留最近 5 份；可以把整个工作区恢复到某份备份，或在运行时从备份取回单个文件或文件夹。

  8. 共享和通知

    在「工作区设置」中按邮箱邀请其他 CloudPilot 用户，邀请 7 天内有效，每个工作区最多 10 位成员，成员唤醒工作区时计入你的同时运行数量。「仅自己使用」时成员只能查看状态；「共享终端和文件」（切换前需要先休眠）时成员可以使用终端、文件和 Git，但包括你在内都不能使用 AI 对话，工作区会删除 AI 登录信息、API Key 和对话；「全部共享」时成员也能用你的 AI 账号对话并看到所有对话。为当前设备开启通知后，AI 回复完成、需要批准或提问时会收到推送。

休眠会停止正在进行的回复、终端命令和后台程序。容器意外停止时，上次保存之后的改动会丢失；重要改动请及时提交到 Git 或点击「立即备份」。

打开云端 Agent（新标签页）

相关问题

云端 AI Agent 收费吗？

目前免费使用，不需要专业版授权码，也不需要 AWS 凭据。登录自己的 ChatGPT、Claude 账号或填写 API Key 时，模型用量按这些服务各自的订阅或 Key 计费；Workers AI 可能有月度用量上限。

工作区休眠后，哪些内容会保留？

/workspace 里的文件、对话、AI 登录信息和 API Key 会保留；装在 /workspace 以外的软件、终端里运行的命令和后台服务不会保留。开启实验性的「快速唤醒」后，休眠时会额外保存整个容器的快照，已安装的软件也在，但快照不含登录信息和 .env 文件。

AI 账号登录信息和 API Key 安全吗？

登录信息和 API Key 加密保存，只用于对应的工作区。切换为「共享终端和文件」或删除工作区时，这些信息会被删除。.env 文件不进入普通备份，而是单独加密保存。

共享工作区后，为什么不能用 AI 对话了？

选择「共享终端和文件」时，成员能在终端里读到工作区里的内容，所以工作区不保存 AI 登录信息、API Key 和对话，所有人都不能使用 AI。需要 AI 时，在「工作区设置」改为「仅自己使用」或「全部共享」，再重新登录或填写 API Key。

为什么不能创建或唤醒工作区？

默认每个账号最多 3 个工作区、同时运行 1 个，成员唤醒你共享的工作区也计入你的数量。提示数量已达上限时，先删除不用的工作区，或让另一个工作区休眠。服务繁忙时唤醒会自动重试，最长约 15 分钟。