Cursor Live Apps 怎么用?Cloud Agent 一键建站、配库、过安全检查并分享链接

据 @cursor_ai 与 Cursor 官方文档,Cursor Live Apps 让你用 Cloud Agent 按描述建 Web App(仪表盘、门户、落地页),托管、Postgres、鉴权和 Secrets 一起配好;发布时先预览,再选 URL,确定性检查和 agentic 安全检查都通过后才会给出可分享的 live link。本文按官方文档与官方演示视频拆开步骤,并记录我们打开官方示例链接时看到的登录门页。适合要做 Cursor Apps 部署、用 Cursor Cloud Agent 分享链接、或一键发布应用的人。

9 分钟阅读
Cursor Live Apps 怎么用?Cloud Agent 一键建站、配库、过安全检查并分享链接

先说结论:Cursor Live Apps(文档里称 Apps)是 Cursor Cloud Agent 的能力,不是本地 Agent 的能力。你明确说出要 build an app 之后,Cloud Agent 会搭 Web App、按需开 Postgres、配鉴权与 Secrets;准备好后出现预览托盘,你点 Publish、选 URL,通过确定性与 agentic 安全检查,才会拿到可分享的 live link。官方文档写明:该功能面向「所有带 Cloud Agents 的付费计划」,本地不支持。

创建 API Key,给 Live App 用 Secrets 接本站 API →

发生了什么

  • 据 @cursor_ai 官方账号(北京时间 2026 年 11 月 6 日 05:41 发布):现在可以在 Cursor 里 build live apps,并用一条链接分享。帖文写到,Agent 让写代码更容易了,但多数应用仍停在 localhost;描述你想要的工具后,Cursor 会构建、建库、跑确定性和 agentic 安全检查,再部署。
  • 据 [Cursor changelog「Build Live Apps in Cursor」](https://cursor.com/changelog>(2026 年 11 月 5 日):从零或已有仓库出发,Cloud Agent 会搭 Web App,需要时开 Postgres,把鉴权接到 Cursor SSO,并提供托管;发布时你选一个唯一域名,通过检查后得到 live link。可以从新仓库或已有仓库部署,来源支持 Cursor Origin 和 GitHub;changelog 写明其他 git 提供方(如 GitLab)随后支持。
  • 据 官方 Apps 文档:Cloud Agent 能按描述建仪表盘、门户或落地页一类 Web App,并处理托管、数据库、鉴权和 Secrets。文档强调必须使用 cloud agent,本地不支持。

官方演示视频(随上述 @cursor_ai 帖发出,时长 24.3 秒)把流程收成五步:Scaffolding the web app、Setting up a database、Configuring auth and SSO、Provisioning hosting、Running security checks。

谁能用,必须先满足什么

据 官方 Apps 文档的 Availability:Apps 面向所有带 Cloud Agents 的付费计划。

据 Cloud Agents 文档的 Troubleshooting:能跑 Cloud Agents 的计划是 Premium 及以上、Teams、Enterprise,或旧的付费计划;Free 和 Plus 不包含 Cloud Agents。没有 Cloud Agents,就没有这条 Live Apps 发布路径。

启动入口据 Cloud Agents 文档 包括:Cursor 桌面端在 Agent 输入框下拉中选 Cloud、在 cursor.com/agents 启动、iOS、Slack、GitHub / Bitbucket 评论里的 @cursor、Linear,以及 API。文档也写了:从仓库启动 Cloud Agent 前,账号管理员需要先接好源码托管;若不想从已有仓库开始,可以用 Start from scratch。

官方说它会帮你做什么

据 官方 Apps 文档:

部分官方说明
托管每个应用部署在为你的团队(或个人计划下的你)单独创建的托管账号里,与其他团队和用户隔离
数据库应用需要数据库时,Cursor 会自动提供 Postgres
鉴权私有应用和团队应用走 Cursor 登录,只有你分享的人能打开;个人计划可以把应用公开,公开后不要求 Cursor 登录
Secrets应用要接你自己的资源或外部系统时,Cursor 会向你要所需 Secrets;Agent 看不到这些值。多数情况下由团队管理员在 Apps dashboard 创建团队 Secrets;若你有权限,也可以创建个人 Secrets

文档给出的示例提示包括:

  • "Build an app that shows our weekly signups as a dashboard, with a chart and a table I can filter by plan."
  • "Build an internal app where my team can submit bug reports and track their status."
  • "Build a microsite for our product launch with a sign-up form that collects emails."
  • "Deploy this repo as an app."

可以从零开始(文档写明会在 Cursor Origin 建新仓库),也可以让 Cursor 把已有 GitHub 仓库部署成应用。

按官方文档发布:从提示词到 live link

记住一句话:官方写明必须用 cloud agent。本地 Agent 编完代码,不会走这套预览托盘和 Publish 检查。

  1. 启动 Cloud Agent。 在桌面端把 Agent 输入框的模式切到 Cloud,或打开 cursor.com/agents。
  2. 说清楚你要 build an app。 文档要求把这句话写明确,不要只说「帮我写个页面」。
  3. 等预览托盘出现。 据官方文档:应用准备好后,会看到一个托盘,用来预览和发布。官方演示视频里,示例会话的提示是 “Build a seat map app to assign desks to new hires”;画面显示 Environment ready 8s、Worked for 3m 21s,并出现名为 Seat Map、状态为 Unpublished 的卡片,以及 Preview 与 Publish。
  4. 点 Publish,选 URL,并决定谁可以打开。 据官方文档:发布时你挑选应用的 URL(之后可以改)。官方演示视频里的 Publish App 对话框包含 App URL(示例子域 office-seat-map,后缀显示为 .apps.grok.bot)、Who can access(所有者与被邀请的 Viewer),以及 General access(示例选了 Everyone at AnySphere)。
  5. 等安全检查通过,再拿到 live link。 据官方文档:Cursor 会跑一系列确定性和 agentic 安全检查。全部通过后返回 live link;否则列出发布前必须修复的问题。让 Agent 修好后再发布。在你选择 Publish 之前,什么都不会上线。

官方演示视频结尾给出的示例链接是 https://office-seat-map.apps.grok.bot。域名后缀以你发布时对话框里实际显示的为准,官方文档只写「挑选应用的 URL」,没有把某个后缀写成唯一正式域名。

我们对照官方示例链接看到了什么

北京时间 2026 年 11 月 6 日,我们核验了这些公开地址(只记耗时和页面现象,没有登录任何 Cursor 账号,也没有在本环境点 Publish):

地址耗时现象
官方 Apps 文档291 毫秒HTTP 200
Cursor changelog334 毫秒HTTP 200,可见 2026 年 11 月 5 日的 “Build Live Apps in Cursor”
官方演示给出的示例链接502 毫秒HTTP 200;页面标题为 “An app made with Cursor”;正文只有 “Open this app”,链接指向 cursor.com/api/apps-gate/authorize,并带上 apex=apps.grok.bot 与 slug=office-seat-map;响应带头 x-robots-tag: noindex

这与官方文档「私有应用和团队应用走 Cursor 登录」一致:未登录时,示例链接先把人送到授权门页,而不是直接展开座位图。官方演示对话框里 General access 选的是团队范围,和这一现象相符。

本环境没有可用的 Cursor Cloud Agent / Apps 操作入口(官方写明该功能必须用 cloud agent,本地不支持),因此我们没有用自己的仓库走完「选 URL → 过检查 → 生成我们自己的 live link」。下面的发布、分享、Secrets 和检查项,均按官方文档与官方演示整理。

分享范围怎么选

据 官方 Apps 文档的 Sharing:

可见范围谁能打开
你邀请的人只有你,或你指定的、已登录 Cursor 的团队成员和群组
Team你和整个 Cursor 团队,且已登录 Cursor
Public任何有链接的人

官方写明:Team 和 Enterprise 默认关闭公开分享,需要团队管理员在 Apps dashboard 打开。个人计划可以把应用公开,公开后不要求 Cursor 登录。

changelog 还写到:检查通过后,应用部署到你选的 URL,你可以把它分享给特定的人、群组或整个团队,这些都走 Cursor 登录;个人计划也可以公开分享。

应用里要调模型时,把 Key 放进 Secrets

如果你的 Live App 需要在应用内调用大模型(例如给仪表盘加一句总结),不要把 Key 写进代码、提交进仓库,或放进会打进发布包的 .env。据官方文档,发布前的检查会拦截写在应用文件里的 API key 或访问令牌,也不会把 .env 打进发布内容。

正确做法是:在构建过程中按 Cursor 提示填写 Secrets,或到 Apps dashboard 配置。官方写明 Agent 看不到这些值。

接本站 API 时,把接口地址和 Key 都放进 Secrets,例如:

bash
ANTHROPIC_BASE_URL=https://api.aicodewith.ai
ANTHROPIC_AUTH_TOKEN=你的 API Key

如果应用用的是 OpenAI 兼容调用,把对应的 Base URL 和 Key 同样放进 Secrets,不要写进源码。Key 本身只出现在 Secrets 里。

创建 API Key →

注册后的操作见 创建 API Key 文档:点「创建密钥」,起一个好认的名字,比如「Cursor Live Apps」,然后只把值填进 Apps dashboard 或构建时的 Secrets。

测完如果只是在自己环境里试验,删掉这次写入的 Secrets,不要把 Key 留在聊天记录、截图或仓库里。

脚本或自动化怎么访问私有、团队 App

私有应用和团队应用走 Cursor 登录,普通脚本过不去。据官方文档,可以用 Cursor API key,让脚本、CI 或 Grok Bot 像已登录用户那样访问应用。

  • 个人 API key 能打开 key 所有者本人能打开的应用。
  • 团队 API key 只能打开被授予权限的团队应用。
  • 公开应用用两种 key 都能打开,和普通访问者一样。
  • 没有权限的 key 会碰到和没权限用户一样的登录跳转。

文档要求把 key 放在请求头 x-cursor-app-token 里,每次请求都要带;没有查询参数,也没有 cookie:

bash
curl -H "x-cursor-app-token: $CURSOR_API_KEY" https://<your-app-url>

文档还写明:用 key 发出的请求会被标记为自动化,并识别这把 key,而不是某个人。可在 Apps dashboard 查看与应用相关的 API key。changelog 也提到:若希望脚本或 Grok Bot 使用你的应用,可以签发一把 Cursor API key。

这里的 $CURSOR_API_KEY 是 Cursor 为访问 App 签发的 token,不是本站 API Key,也不要和写进 Secrets 的模型调用 Key 混用。

发布前会跑哪些安全检查

据 官方 Apps 文档的 Security and controls,每次发布前都会跑四项检查,即使安全审查被关掉也仍然生效:

  • Block secrets written in app files:文件里如果含 API key 或访问令牌,发布会被拦住。
  • Block credential files:如果包含私钥、服务账号密钥或带鉴权令牌的文件,发布会被拦住。
  • Never publish .env files:发布内容不含 .env。
  • Never publish source maps:去掉 source map,避免访问者读到原始源码。

除此之外还有 AI 安全审查,会阅读应用文件,并在上线前拦住严重问题。团队管理员可以在 Apps dashboard 给审查提示词加自己的规则;自定义规则只能加,不能拿掉 Cursor 内置检查。

团队管理员还可以:为团队打开或关闭 Apps;允许或禁止公开应用(禁止后,已公开的应用会回到团队可见);允许或禁止用 API key 打开应用;批准被审查拦住的发布,但恶意代码、硬编码 Secrets 或暴露的凭据除外。这些设置变更会记入团队审计日志。

更宽的 Cloud Agent 隔离、密钥保存和网络出口说明,见 Cloud Agent security。

常见坑

  1. 用了本地 Agent。 官方文档写明该功能本地不支持。本地编完代码,不会出现这套预览托盘,也不会在 Publish 时跑上述检查并给出 live link。要把模式切到 Cloud,或在 cursor.com/agents 启动。
  2. Team 想公开,但管理员还没打开公开展示。 官方写明 Team / Enterprise 默认关闭公开分享,需要管理员在 Apps dashboard 打开。
  3. 把 Key 写进代码,或把 .env 打进发布包。 官方检查会拦截写在应用文件里的密钥和凭据文件,也不会发布 .env。应用内调模型时,把本站 API Key 放进 Secrets。

和 Claude Code、Codex、本地 Cursor 编写是什么关系

写代码可以在 Claude Code、Codex 或 Cursor 里完成。Cursor Live Apps 解决的是另一截:用 Cloud Agent 把 Web App 托管起来,配好库和鉴权,过检查后用链接分享。

如果你主要在 Claude Code 或 Codex 里写应用,官方文档提供的对应路径是让 Cloud Agent 「Deploy this repo as an app」(changelog 写明目前支持 Cursor Origin 和 GitHub)。本地写完不等于已经发布;要分享可打开的链接,仍需走 Cloud Agent 的 Publish。

验收应用行为时,也可以看我们另一篇用 verification skill 驱动真应用的做法:AI 写的代码怎么验收?用 verification skill 驱动真应用。若你要让 Agent 操作本地桌面应用,而不是发布一个可分享的 Web App,那是另一条能力,见 Vercel agent-desktop 怎么用?让 Claude Code、Codex、Cursor 操作桌面应用。

常见问题

只开本地 Agent 能不能发布 Live App?

不能。据官方文档,必须使用 cloud agent,本地不支持。

Free 或 Plus 计划能用吗?

据 Apps 文档,该能力面向带 Cloud Agents 的付费计划。据 Cloud Agents 文档,Free 和 Plus 不包含 Cloud Agents。以你账号里实际显示的 Cloud Agent 入口为准。

Team 想把应用公开,要谁来开?

据官方文档:Team 和 Enterprise 默认关闭公开分享,由团队管理员在 Apps dashboard 打开。管理员若禁止公开,已公开的应用会回到团队可见。

发布时选的 URL 以后能改吗?

据官方文档:发布时挑选应用的 URL,之后可以更改。

检查没通过会怎样?

据官方文档:Cursor 会列出发布前需要修复的问题。让 Agent 修好后再发布。你点 Publish 之前,应用不会上线。

应用里调用本站 API,Key 应该放哪?

放进 Apps dashboard 或构建时的 Secrets,不要写进代码或 .env。先 创建 API Key,再把值填进 Secrets。

脚本怎样访问未公开的应用?

据官方文档:在每次请求的 header 里带 x-cursor-app-token,不要把它放到查询参数或 cookie 里。

相关阅读

创建 API Key,开始给 Cursor Live Apps 接本站 API →

来源

相关文章

UI SDK 是什么、怎么用?Vercel + shadcn 给 Agent 的行为库,在 Claude Code / Codex / Cursor 里安装与实测(0.1.0-beta.1)

UI SDK 是什么、怎么用?Vercel + shadcn 给 Agent 的行为库,在 Claude Code / Codex / Cursor 里安装与实测(0.1.0-beta.1)

UI SDK 是 Vercel 在 2026 年 11 月 12 日发布的、给 Agent 用的行为(behaviors)库,版本 0.1.0-beta.1。行为写在与框架无关的 @ui-sdk/core 里,再由 React、Vue、Svelte、Solid 和 Web Components 适配器渲染。本文按官方文档整理它是什么、怎么安装、怎么给 Claude Code / Codex / Cursor 装 skill,并记录我们在测试机上的真实命令、耗时和输出。

AWS Emulator 是什么、怎么装?让 Claude Code / Codex 在本地测 AWS 应用(1.0.322 实测)

AWS Emulator 是什么、怎么装?让 Claude Code / Codex 在本地测 AWS 应用(1.0.322 实测)

AWS Emulator 是 AWS 官方 2026 年 11 月 12 日(北京时间)正式发布的本地 AWS 模拟器,没有额外服务费、源码开放,不需要 AWS 账号,覆盖 200 多个服务。本文在 Debian 13 上实测 1.0.322:安装命令、AWS CLI 指向本地 endpoint 建 S3 桶和 DynamoDB 表、常见报错,以及让 Claude Code、Codex、Cursor 对着模拟器写代码跑测试的接法。

T3 Code 是什么、怎么装?接入 Claude Code 和 Codex、配置第三方 API Key 与常见报错(0.1.9 实测)

T3 Code 是什么、怎么装?接入 Claude Code 和 Codex、配置第三方 API Key 与常见报错(0.1.9 实测)

T3 Code 是 pingdotgg 开源的编码 Agent 控制台,本身不带模型,调用你机器上已装好的 Claude Code、Codex、Cursor 等 CLI。本文在 Linux 上实测 T3 Code 0.1.9:讲清安装命令,Claude Code 和 Codex 先各自接上 AICodeWith API Key、再由 T3 Code 调用的配置方法,用 t3 thread 命令行跑通两端的过程,以及我们实际遇到的报错和解法。