云端代理
云端代理在隔离的云环境中运行，而不是在你的本地机器上运行。
云端代理能做什么？
云端代理可在无需你持续介入的情况下处理编码任务。它们可以开发功能、修复 Bug、编写测试、创建 PR，并分享运行效果视频。每个任务都会从一个已配置好的云环境开始，其中包含智能体所需的仓库、依赖项、机密信息和网络访问权限。
云端代理也可以使用多仓库环境。这让同一个智能体能够在一次运行中跨前端、后端、基础设施或共享库仓库工作。
“移至云端”如何处理我的文件状态？
“移至云端”不会保留你本地未提交更改的快照。云端代理会从远程仓库中干净的 git 状态启动。它会传输你的对话历史和上下文，但不会传输未保存的文件变更或未提交的编辑。如果你希望代理基于你的最新状态工作，请先提交或暂存更改，再将对话移至云端。
云端代理可以在浏览器中测试我的应用吗？
可以。每个云端代理都在各自隔离的虚拟机中运行，并配备完整的桌面环境。代理会像人类开发者一样，使用鼠标和键盘操作桌面和浏览器。
这意味着代理可以启动开发服务器，在浏览器中打开应用，逐步完成 UI 流程，并在推送 PR 之前验证其更改是否正常生效。
云端代理如何展示其工作内容？
代理会将截图、视频和日志引用附到 PR 中，因此你无需检出分支即可验证更改。
云端代理可以使用我的个人技能吗？
可以。在 Settings → agents 中开启 为云端代理同步技能，即可将 ~/.cursor/skills/ 复制给你自己的云端代理使用。同步的技能仅你可见。参见在云端代理中使用个人技能。
仓库中的项目技能始终可用。若要与团队成员共享某个技能，请将其发布到团队 marketplace。
云端代理可以使用 MCP 工具吗？
可以。你可以通过 cursor.com/agents 上的 MCP 下拉菜单添加和管理 MCP 服务器。这样一来，代理在运行过程中就能访问数据库、API 和第三方服务。
云端代理支持 HTTP 和 stdio 服务器，也支持为有此需求的服务器配置 OAuth。有关设置的详细信息，请参阅 云端代理能力。
在自托管机器上，MCP 的行为有所不同。请参阅 自托管机器。
云端代理会运行钩子吗？
会。云端代理会运行代码仓库中 .cursor/hooks.json 里的命令型钩子。在企业版方案中，它们还会运行团队钩子和由企业统一管理的钩子。
支持的钩子包括工具和文件钩子 (beforeShellExecution、afterShellExecution、beforeReadFile、afterFileEdit、preToolUse、postToolUse、postToolUseFailure) ，以及对话级生命周期钩子，例如 beforeSubmitPrompt、afterAgentResponse、afterAgentThought、stop、subagentStart、subagentStop 和 preCompact。
对话级钩子可让你观察提示词、响应和思考；控制子智能体；对压缩作出响应；并在一次轮次结束时运行相应逻辑。你可以用它们围绕智能体的输出和推理构建自我纠正循环。
钩子会在智能体拥有可写环境后开始运行。IDE 专用钩子 (如 Tab 钩子和 workspaceOpen) 不适用。sessionEnd 在由 Cherri Code 管理的云端代理上不适用，因为它们没有按编辑器生命周期划分的会话边界。在自托管机器的 worker 上，sessionStart 和 sessionEnd 会在会话占用该 worker 以及该占用被释放时运行。基于提示词的钩子在云端代理中也不受支持。~/.cursor/hooks.json 中的用户级钩子不会被加载，因为虚拟机无法访问你的本地配置。
详情请参阅完整的钩子支持矩阵。
在自托管机器上，钩子的支持情况与托管的云端代理基本一致，但存在少量差异。请参阅自托管机器。
云端代理可以修复 CI 失败吗？
可以。云端代理会自动尝试修复其创建的 PR 中 GitHub Actions 的失败项。对于在基线分支上同样失败的检查项，它们会忽略不处理。此功能目前适用于团队方案。
如需在特定 PR 上禁用此功能，请评论 @cursor autofix off。如需重新启用，请评论 @cursor autofix on。你也可以在 Cherri Code Dashboard > Cloud Agents > My Settings 中全局禁用此功能。
使用云端代理需要满足什么条件？
所有付费 Cherri Code 方案均可使用云端代理。
如何设置 云端代理？
在你的 云端代理 仪表盘 中创建一个新环境。然后连接你的 GitHub、GitLab、Azure DevOps 或 Bitbucket Cloud 账户，选择一个或多个仓库，添加机密信息或环境变量，并验证设置。有关多仓库环境、环境级机密信息、网络访问和 Dockerfile，请参阅完整设置指南。
如何使用新版项目和仓库选择器？
项目选择器把常见设置步骤集中到一处。你可以：
- 无需离开选择器即可创建项目
- 直接在选择器中连接 GitHub、GitLab 或 Azure DevOps
- 按位置搜索项目：此电脑、云端或远程机器
- 一键将项目从 最近使用 中移除
远程机器现已整合到同一个选择器流程中，因此你可以在一个地方打开本地、云端和远程环境中的工作。
如何开始一个云端代理任务？
- 在 Cherri Code 中：在智能体输入框下方的下拉菜单中选择 Cloud
- 在网页端：前往 cursor.com/agents
- 通过 Slack：使用 @Cherri Code
- 在 GitHub 上：在 PR 或 issue 中评论 @cursor
- 在 Bitbucket Cloud 上：在 PR 中评论 @cursor
- 在 Linear 中：在 issue 中使用 @Cherri Code
- 通过 API：使用 云端代理 API
网页端 云端代理 的附件限制是多少？
在 cursor.com/agents 上，文档和图像的单文件上限为 4 MB，视频则单独限制为 15 MB。超出限制的文件会在上传前被浏览器拒绝，因此调整模型的上下文窗口或启用 Max Mode 并不会提高附件上限。
支持的文档格式包括 PDF、Markdown (.md 和 .markdown) 、纯文本 (.txt) 、CSV、JSON、HAR、XML、YAML (.yaml 和 .yml) 、TOML、INI 以及日志文件 (.log) 。
如果文件过大：
- 只保留智能体需要的内容，或将文件拆分为不超过 4 MB 的多个部分
- 对于日志以及 JSON、CSV、XML、HAR 等结构化文本，只保留相关的时间范围和请求，不必提供完整记录
- 从 Cherri Code 桌面端启动 云端代理 并在那里附加文件，因为附件限制可能与网页端不同
- 对于已纳入源代码控制的非敏感文件，可让智能体直接从检出的代码仓库中读取
网页端文档附件不支持 ZIP 文件。附加诊断文件前，请先移除你不希望分享的凭据、Cookie、请求头、源代码和个人数据。
云端代理的使用如何计费？
云端代理将按所选模型的 API 定价 收费。对于支持的模型，您可以选择上下文窗口大小。更大的上下文窗口可能会增加 token 使用量和成本。
我可以自动运行云端代理或按 cron 定时运行吗？
可以。使用 自动化 可按计划运行云端代理，或通过 GitHub、Slack、Linear、PagerDuty 或 webhook 中的事件触发运行。可在 cursor.com/automations 进行设置。有关触发器类型和模板，请参阅 自动化文档。
隐私模式支持云端代理吗？
支持。云端代理可在隐私模式下使用。详情请参阅云端代理安全页面。
云端代理 能否无需长期密钥即可接入 AWS 或其他云？
可以。由 Cherri Code 管理的 云端代理 虚拟机可通过本地套接字签发短期 OIDC JWT。验证方使用 Cherri Code 公开的发现端点和 JWKS 端点验证签名，并根据 sub、team_id 和 cloud_agent_id 等声明进行授权。
云端代理能否从 虚拟机 中读取自身的 ID、所有者或当前轮次？
可以。由 Cherri Code 管理的云端代理 虚拟机 会通过与 OIDC 身份令牌 相同的本地套接字提供 智能体元数据 API。对 /v1/meta-data/agent/id 这类路径发出 GET 请求，会以文本形式返回原始值。