20 · Cloud Agent 云代理

让 AI 在云端替你跑任务——你关掉电脑，它还在工作。

01 什么是 Cloud Agent

Cloud Agent（云代理）是 Cursor v3.0 引入的核心能力。它让你本地的 Cursor Agent 能够无缝切换到云端执行——你在本地写好提示词，点击”切换到云端”，Cursor 就把整个任务连同项目上下文一起打包发送到 Anysphere 的云服务器上执行。

用一句话概括：Cloud Agent 是一个运行在云端的 Cursor Agent。它可以看到你的代码、能跑命令、能创建文件，而且 24 小时在线。

和本地 Agent 的区别非常直观：

核心心智模型：Cloud Agent = 你雇佣了一个远程工程师，把任务交给他，他去云端干活，你把结果收回来就行。

02 为什么需要 Cloud Agent

在 Cloud Agent 出现之前，Cursor Agent 的工作方式有一个根本性限制：你必须在电脑前守着它。

具体场景暴露的问题：

• 跑长任务：你让它重构整个项目的认证模块，可能需要 20 分钟。这 20 分钟你不敢合上笔记本、不敢让电脑休眠、不敢离开咖啡店。你被”绑定”在了电脑前。
• 跑在睡觉时：有些任务天然适合放在夜间执行——批量迁移数据、大规模的代码重构、跑一遍全量测试并修复失败项。但在没有 Cloud Agent 时，你没法让 Cursor 在你睡着时工作。
• 移动端启动：你在地铁上突然想到一个改造方案，但不能掏出手机打开 Cursor 就开始全量重构——本地 Agent 需要完整的 IDE 环境。
• 团队协作：你的队友在 Slack 里发了一条消息”帮我修一下登录页的样式问题”，你需要在电脑上打开项目、启动 Agent、等待它完成、截图发给对方——每一步都是摩擦。

Cloud Agent 的出现一次性解决了这些问题。它把 Cursor Agent 从一个”你必须在线陪同”的工具，变成了一个”你发号施令，它独立执行”的远程生产力。

03 本地 → 云端的无缝切换

Cloud Agent 最精妙的设计是手感的连续性。你不需要学习两套操作方式——在本地 Agent 写好提示词，点击一个按钮就变成了 Cloud Agent。

切换流程

1. 在 Cursor 中按 Cmd+I（或 Ctrl+I）打开 Composer/Agent
2. 写入提示词，比如”重构 src/auth 目录下的所有模块，改用 React 的新上下文模式”
3. 在提交按钮旁边，你会看到一个云图标（☁️）开关
4. 点击它，提示词显示”此 Agent 将在云端运行”
5. 提交——本地会话结束，任务转移到云端

你看到的就是一个正常的 Agent 会话——同样的消息流、同样的终端输出、同样的文件变更列表。唯一的区别是：你可以关掉 Cursor，甚至关掉电脑。任务在云端继续跑。

对比：本地→云端的过程

本地模式： 写提示词 → AI 在本机执行 → 你盯着看 → 等完成
云模式：   写提示词 → 任务打包上传 → 关电脑 → 醒来收结果

切换后，你会得到一个云会话 ID。这个 ID 是你追踪任务的唯一凭证——在 Cursor 的侧边栏会多出一个”Cloud Runs”面板，所有历史云任务都在这里。

04 从什么地方启动 Cloud Agent

Cloud Agent 的强大之处在于入口无处不在。你不需要打开 Cursor 才能启动一个云任务。

桌面端（Cursor 编辑器）

最直接的启动方式。在 Composer/Agent 中打开云开关提交即可。所有项目上下文自动打包——包括你打开的标签页、Notepads、Rules 配置。

移动端（Cursor Mobile）

Cursor 提供了移动端 App（iOS/Android），你可以在手机上：

• 查看已有的 Cloud Agent 运行状态
• 启动新的任务（输入提示词，选择项目）
• 查看任务输出、截图、文件变更

手机端的提示词输入区和桌面端完全一样，但因为屏幕较小，更适合启动你已经想清楚的任务——不是探索式对话，而是执行明确的指令。

Web 端

通过浏览器访问 cursor.com/cloud-runs，你可以：

• 看到所有云任务的列表和状态
• 启动新任务（需要关联 GitHub 仓库）
• 查看每个任务的输出日志、截图、文件 Diff
• 下载任务产生的文件

Web 端的核心使用场景是：你的主力电脑不在身边，但你需要启动一个任务或查看结果。

Slack

Cursor 的 Slack 集成让你在聊天中启动 Cloud Agent：

1. 在 Slack 工作区安装 Cursor App
2. 在频道中发一条消息，比如 /cursor run "修复 payment 模块的类型错误"
3. Cursor 自动创建 Cloud Agent 任务
4. 任务完成后，结果直接回帖到频道

这对团队协作意义重大——非技术成员也可以在 Slack 里提交 Bug 报告，Cloud Agent 直接处理。

GitHub

Cursor 提供 GitHub App 集成，当你在 PR 中触发特定动作时，Cloud Agent 可以自动执行：

• 你在 PR 评论里写 @cursor fix this → Cloud Agent 根据评论修改代码 → 自动提交新的 commit
• PR 的 CI 检查失败 → Cloud Agent 自动分析失败原因并尝试修复
• 代码审查建议 → Cloud Agent 批量处理审查意见

Linear

Linear 是很多团队的工单管理工具。Cursor 的 Linear 集成让 Cloud Agent 自动接单：

• 一个 Linear Issue 被标记为 cursor:ready → Cloud Agent 自动拉取任务
• 任务完成后，Cloud Agent 自动在 Issue 下评论执行结果
• 如果任务需要人工确认，它会在 Issue 中添加对应的 PR 链接

入口对比矩阵

05 Cloud Agent 能产出什么

Cloud Agent 不仅仅是”在云端跑代码”。它的输出能力比本地 Agent 多出了两个关键维度：Demo 和 截图。

文件变更

最基本的产出——创建文件、修改文件、删除文件。和本地 Agent 一样，云端做的所有代码改动都以 Diff 形式呈现，你可以选择全部接受或逐文件审查。

终端命令与输出

Cloud Agent 可以执行终端命令——编译、测试、格式化、构建。不同于本地 Agent 的是，云端的终端输出不会因为你关闭电脑而丢失。你随时可以回到 Cloud Runs 面板查看完整的日志。

截图（Screenshots）

Cloud Agent 的一个重要能力是自动截图。

当 Cloud Agent 启动了一个 Web 应用（比如 npm run dev 启动了一个前端项目），它可以：

• 自动识别开发服务器启动成功的信号
• 对浏览器页面进行截图
• 把截图回传给 Cursor 的视觉理解模型（claude-sonnet-4 等）
• 根据截图判断 UI 是否符合预期
• 如果需要修改，继续执行代码 → 重新截图 → 直到符合要求

这个能力对UI 开发来说是一个质的飞跃。以前本地 Agent 虽然也能跑应用，但它看不到页面实际长什么样——你需要在本地打开浏览器，手动告诉它”这个按钮位置不对”。现在 Cloud Agent 自己截图、自己看、自己改。

Demo（演示视频）

更进一步的输出是 Demo。Cloud Agent 可以：

1. 启动应用
2. 模拟用户操作（点击、输入、导航）
3. 录制屏幕操作过程
4. 生成一段演示视频或动画 GIF
5. 输出为可分享的链接

这个能力对远程团队协作尤其有用——你不需要跑对方电脑前，Cloud Agent 直接把功能演示录好发给你。

结果聚合

任务完成后，Cloud Agent 会生成一个结果报告，包含：

• 执行摘要：做了什么、改了什么文件
• 截图画廊：过程中的所有截图
• 日志摘要：关键的命令和执行结果
• Demo 链接：如果有录制的演示
• 文件变更列表：每个文件的 Diff 概览

06 长任务与睡眠模式

Cloud Agent 最吸引人的能力之一：让任务在你睡觉时运行。

典型场景

你可以在睡前启动一个 Cloud Agent 任务：

"把整个项目从 JavaScript 迁移到 TypeScript：
 1. 添加 tsconfig.json 配置
 2. 把所有 .js 文件改为 .ts / .tsx
 3. 修复所有类型错误
 4. 确保 `npm run build` 通过
 5. 运行测试，修复失败的用例"

这个任务可能需要几个小时（取决于项目大小和代码复杂度）。你点击提交 → 关掉电脑 → 第二天早上醒来，打开 Cursor，Cloud Runs 面板显示任务完成——所有文件已修改，构建通过，测试通过。

云端运行时说明

• 任务超时：标准版用户任务最长 30 分钟，Pro 用户最长 2 小时，Business 用户最长 4 小时
• 并发限制：不同套餐允许同时运行的 Cloud Agent 数量不同（详见第 09 节）
• 资源规格：云端运行环境有标准化的 CPU/内存配置，不适合极大规模的计算密集型任务
• 网络局限：云环境能访问 npm、PyPI、GitHub 等公共资源，但不能访问你的内网服务

任务状态

Cloud Agent 的任务状态流转：

Pending（排队中）
    ↓
Running（运行中）
    ↓
Completed（完成） / Failed（失败） / Cancelled（取消）

如果任务失败，云端会保留完整的执行日志，你可以查看失败原因，修改提示词后重新提交。

07 云环境与安全性

Cloud Agent 在你的项目上下文上运行，这自然会引发安全问题。理解 Cursor 的安全架构很重要。

项目上下文上传

当你启动 Cloud Agent 时，Cursor 会把以下内容打包上传到云服务器：

• 你当前打开的文件和编辑器状态
• 你项目中被 Agent 需要读取的文件
• Notepads 内容和 Rules 配置
• 你的提示词和历史消息

它不会上传：

• 整个项目仓库（只上传 Agent 实际读取的文件）
• 被 .cursorignore 排除的文件
• 二进制文件（除非 Agent 明确需要）
• 环境变量文件中的敏感信息（如果配置了 .env 排除）

数据存储

• 任务运行结束后，你的项目文件和上下文在云端不会长期存储
• 任务结果（Diff、截图、日志）会保留一段时间供你查阅
• Cursor 的隐私政策承诺不会用你的代码训练模型

最佳安全实践

• 在项目根目录配置 .cursorignore，排除敏感文件和目录
• 不要在代码中硬编码 API Key 和密码——这是通用安全实践，Cloud Agent 也不例外
• 使用 Cursor 的 Secrets 功能管理敏感环境变量（Secrets 会被注入到云端环境，但不会出现在日志中）
• 上传前审查提示词，确保不包含敏感信息

08 云 Agent vs 本地 Agent 深度对比

把两者放在一起做全方位的对比：

什么时候用本地 Agent

• 快速修改：改几行代码、修一个小 Bug
• 探索式对话：还不太确定怎么做，需要和 AI 讨论方案
• 需要访问本地环境：调试本地特有的问题、访问内网服务
• 简单的代码生成：写个函数、加个组件

什么时候用 Cloud Agent

• 大规模重构：涉及多个文件、需要长时间执行
• 你不在电脑前：通勤中、睡觉时、外出时
• 团队协作：通过 Slack/Linear 提交任务
• UI 开发：需要 Agent 看页面截图
• 自动化流程：绑定到 PR 检查、CI 流水线

09 定价与限制

Cloud Agent 的功能在不同套餐中有不同的使用额度。

注意：以下数据基于 Cursor 现行定价方案，具体额度可能随版本更新而变化。请以官方定价页面为准。

额外限制

• 上下文大小：上传到云端的项目上下文有大小限制（目前约 200MB 压缩后）。超大项目可能需要排除不必要的文件。
• 网络出口：云环境不能访问你的内网（localhost 之外的私有 IP 段），不能连接自建的 API 服务。
• 预装工具：云端预装了常见的开发工具（Node.js、Python、Git 等），但如果你需要特定的系统级依赖，需要在提示词中包含安装命令（Cloud Agent 默认有 sudo 权限安装软件包）。
• 存储空间：每个 Cloud Agent 实例的临时存储空间有限（约 10GB），不适合处理大型数据集。

提示词消耗

每次 Cloud Agent 运行消耗的 Token 量由你的 Cursor 账户统一计算（包括 Premium Model 的使用额度）。如果你是 Pro 或 Ultra 用户，Cloud Agent 使用大户需要留意月度 Premium 额度——一个长任务可能消耗几千到几万次快速 Premium 请求。

10 实战案例

案例一：跨时区协作

场景：你是北京的一个独立开发者，甲方在美国。你睡觉时甲方案例提了一个 UI 修改需求。

流程：

1. 甲方在 Slack 频道发送 @cursor "把仪表盘的图表颜色改成品牌蓝色 #2563EB，并在右上角添加一个导出按钮"
2. Cloud Agent 自动启动，从 GitHub 拉取最新代码
3. 修改组件代码、启动开发服务器、截图验证、录制 Demo
4. 任务完成，结果显示在 Slack 回帖中——包含修改后的截图和 Demo 链接
5. 你醒来时看到 Slack 通知，审查 Diff，确认无误后合并

时间线：从甲方发消息到 Cloud Agent 完成，大约 15 分钟。你的睡眠时间零占用。

案例二：夜间重构

场景：你的项目有 200 个测试文件，其中 30 个使用了已经废弃的 API。你需要逐个修复。

流程：

1. 睡前打开 Cursor，写提示词：“扫描所有测试文件，找出使用 oldApi 的用例，逐个替换为 newApi 的等价调用，然后运行测试确认通过”
2. 开启 Cloud 开关，提交
3. 关电脑，睡觉
4. 早上醒来，打开 Cloud Runs 面板
5. 30 个文件修改完成，26 个测试通过，4 个需要人工调整——Agent 已经在 Issue 中标记出来

结果：原本需要 2 小时手动完成的工作，在你睡觉时自动完成了 80%。

案例三：PR 自动化审查

场景：你维护的开源项目收到了一个 PR，你想让 AI 自动检查并修改。

流程：

1. 在 PR 评论中输入 @cursor review and fix any issues
2. Cloud Agent 拉取 PR 分支
3. 运行代码审查、执行测试、修复发现的问题
4. 自动 push 修复 commit 到 PR 分支
5. 在 PR 中回复审查结果摘要

11 总结

Cloud Agent 把 Cursor 从一个”你必须在电脑前陪伴的 AI 编程助手”，变成了一个”你发号施令、它独立执行的远程工程师”。

你要记住的关键点

1. 无缝切换：本地和云端的操作体验完全一致，只需要一个开关切换
2. 入口无处不在：桌面端、移动端、Web、Slack、GitHub、Linear——你可以在任何地方启动和追踪任务
3. 长任务友好：任务跑在你关电脑之后，醒来就收结果
4. 截图与 Demo：这是 Cloud Agent 相比本地 Agent 的核心增量——它能看页面、录操作
5. 入口选对：探索式开发用本地 Agent，确定式任务用 Cloud Agent
6. 注意额度：Cloud Agent 有月度和并发限制，长任务注意 Token 消耗

适合用 Cloud Agent 的 Checklist

• 任务需要超过 15 分钟才能完成？→ 用云
• 任务涉及 UI 修改，需要视觉验证？→ 用云
• 你不在电脑前，但想让任务跑起来？→ 用云
• 任务来自团队工单或 PR？→ 用云
• 你还在探索方案、不确定具体怎么做？→ 先本地
• 任务需要访问内网或本地数据库？→ 只能本地

下一篇

当你掌握了本地 Agent 和 Cloud Agent 的能力，下一步就是理解它们之间的智能调度机制——Cursor 如何自动判断任务应该在哪里执行？如何利用 Mix Mode 混合模式在不同规模的任务之间灵活切换？

[预告] 21 · Mix Mode 混合模式

混合模式是 Cursor 在本地 Agent 和 Cloud Agent 之间架设的”智能调度层”。它根据任务的复杂度、文件范围、执行时间自动决定是在本地还是云端执行——甚至同一个任务的不同步骤可以分布在不同的环境中。敬请期待。