4月30日消息,Cursor推出Cursor SDK公开Beta,通过@cursor/sdk包将原本运行在Cursor桌面端、CLI和Web App里的编程代理开放为TypeScript接口,开发者可在自己的脚本、CI/CD流水线、内部产品里以几行代码调用同一套agent runtime。SDK已在npm开放安装,按token消耗计费,与Cursor IDE共享相同的harness、工具链与模型选择。 SDK核心:Agent.create加几行TypeScript
Cursor SDK的最小调用形态是Agent.create({ apiKey, model: { id: "composer-2" }, local: { cwd: process.cwd() } }),然后用agent.prompt或run.stream触发执行。运行时可在三种模式间切换:本地(在开发者机器上跑,适合快速迭代)、self-hosted workers(代码与工具执行保留在企业网络内)、Cursor Cloud(在专用VM上跑,具备沙箱、repo克隆、预配置开发环境,代理可以在笔记本休眠或断网后继续运行,完成后可直接开PR、推分支或附上截图)。
模型层面默认使用Composer 2(Cursor自研编码模型),也支持任意frontier model——这意味着同一段SDK调用可以无缝切换到Claude Sonnet 4.6、GPT-5、Gemini 2.5 Pro等模型,只需修改model.id。 代理可以使用的能力对齐Cursor IDE:代码库索引和语义搜索做上下文管理,通过.cursor/mcp.json接入MCP servers连接外部工具,从.cursor/skills/目录自动加载Skills,通过.cursor/hooks.json定义hooks观察和扩展agent loop,并支持subagents并行执行子任务。
把Cursor SDK放进当前编程代理赛道看,这是一次清晰的产品化转向——从"开发者交互式工具"走向"组织级programmatic infrastructure"。Anthropic的Claude Code SDK提供类似形态,允许在CI/CD里跑Claude Code agent;OpenAI的Codex CLI/SDK去年就开放了非交互模式;Cognition的Devin直接以"自主软件工程师"形态做云端SaaS;Replit Agents和Vercel v0则各自从托管平台切入。
四家路径不同。Claude Code的优势是模型(Claude Sonnet/Opus)+ Anthropic的agent设计经验,Codex绑定OpenAI模型生态,Devin主打全自主流程,Cursor的差异化在两点:一是已有的Cursor IDE装机量带来的工程师认知度,SDK里跑的代理与开发者每天在IDE里使用的是同一个agent;二是Composer 2作为自研模型,在编码任务上做过专门优化,搭配MCP+Skills+Hooks+Subagents的组合,把IDE里的工程化能力直接搬到代码外。
早期用例:CI/CD自动化与嵌入式代理
Cursor官方博客里给出的早期用例方向有三类:CI/CD流水线集成(总结代码变更、定位CI失败根因、自动更新PR修复)、内部代理平台(让GTM团队不写代码就能查询产品数据)、嵌入C端产品(把代理体验直接放进面向终端用户的应用里)。
GitHub上的cursor/cookbook仓库提供starter projects——Node.js quickstart、Web原型工具、kanban board(代理驱动的工作流)、命令行接口。Cursor Plugins市场里也已经出现cursor-sdk skill,引导用户处理Agent.create、Agent.prompt、Agent.resume、run.stream等API,以及在local和cloud runtime间选择、配置MCP servers、处理streaming与cancellation的具体场景。
局限与未明数据
Cursor SDK目前是public beta,生产环境可用性、SLA、长时运行稳定性等关键工程指标未公布。计费模式是token-consumption,但具体费率(Composer 2每百万token多少钱、Cloud VM额外费用如何计算)在SDK发布博客中未给出。
语言生态方面,SDK仅TypeScript,Python、Go等其他语言开发者需要等待后续版本或通过REST API调用。这与Claude Code SDK同时支持TypeScript和Python的覆盖面有差距。
模型透明度是另一个观察点。Composer 2的训练数据、benchmark成绩、上下文窗口、最大输出长度等核心参数Cursor未单独披露。SDK中可以切换到frontier models,但默认体验由Composer 2承载,模型本身的能力黑盒会影响开发者评估。
数据隐私方面,Cloud模式将代码和工具执行交给Cursor基础设施,self-hosted和local模式可以缓解部分顾虑,但企业接入时仍需评估Cursor的数据保留策略、合规认证(SOC 2、ISO 27001等)是否到位。Cursor对Composer 2的训练数据来源(是否使用用户代码)在Beta阶段也尚未给出明确条款。
把Cursor SDK放进更长的时间线看,IDE从交互工具过渡到代理后端、再到programmatic infrastructure,是2025-2026年编程代理赛道的主线。Cursor、Anthropic、OpenAI、Cognition四家手里都有相对完整的"模型+harness+SDK"栈,Cursor这次发布把竞争从IDE功能层面拉到infrastructure层面——下一阶段的胜负手会落在生产稳定性、模型迭代速度,以及谁能率先把代理服务的成本曲线压到企业大规模采购的临界点。