CursorCursor

模型与开放条件Model & openness

可选多家厂商的模型；个人三档的差别是额度倍数，不是模型能不能用。

官方首页列出的可选范围：

• OpenAI / Anthropic / Gemini / SpaceXAI / Cursor 自研

供应方已明确不止一家：导航含 Grok / Grok Bot，各档另列「Grok 使用额度」。

Auto 模式的候选（2026-10-01 官网示例）：

• Grok 4.7
• GPT-5.6 Sol
• Fable 5.1
• Max Opus 5.5
• Gemini 3.1 Pro
• Composer 2.5

额度按档递增，官方原文：

• Pro = extended
• Pro+ = "3x Pro limits on Agent"
• Ultra = "20x Pro limits on Agent"

三档都写 "Access to frontier models"。 所以差别在额度倍数，不在能不能用前沿模型。 这一条与常见误解相反，值得单独记。

Hobby 档仅可用 Auto 模型。

Cursor Router 按 cost / balance / intelligence 三档在多模型间路由。 官方说明按被路由到的模型标价计费。 Router 先在 Teams / Enterprise 推出，个人档「数月后」跟进。

运行位置Where it runs

两种运行形态：云端，或自托管在你自己的机器上。

这是本分区最独特的架构。

2026-09-02 官方推出自托管支持：

• 代码库、构建产物与密钥都留在你自有基础设施内运行的机器上
• 由智能体在本地处理工具调用

另有 My Machines 形态： 把单台笔记本或 VM 连到账户，用于个人工作流。

Cursor Router 的可用面更宽。 官方文档说明它可以在编辑器 / CLI / Cursor SDK / iOS 应用中使用。

本地文件Local files

编辑器形态读工作区文件；自托管形态下代码与产物不离开你的基础设施。

它由 VS Code 衍生而来，所以文件访问方式与编辑器一致。

索引策略官方写了（2026-10-03 补，取自官方 Search 文档页）。

检索用自研的 Instant Grep。 官方称它在大型代码库上优于 ripgrep，无需配置。

官方原文："runs automatically; no configuration needed"。

一条值得单独记的数据边界：

官方原文："Instant Grep builds and queries its index on your machine. Cursor does not upload file paths or code to build a search index, and it does not store embeddings of your codebase for search"。

也就是说：检索索引完全在本机，官方明说不为检索存 embedding。

⚠ 但同一页紧接着补了一句：

官方原文："When Agent opens a match, that file content can still be included in the model request"。

所以「建索引不出本机」≠「文件内容不出本机」。 命中之后，内容照样进模型请求。

Explore 子智能体是官方给的上下文控制手段：

• 跑在独立上下文窗口
• 用更快的模型
• 执行并行搜索后只回传相关发现

官方原文："returning only the relevant findings"。 官方明说这是为了避免把原始文件内容整段倒进主对话。

⚠ 大仓库的索引性能与规模上限，官方文档未给数字。

关机后的任务Tasks after shutdown

云端 Agent 可以脱离你的电脑继续跑，而且官方有明确表述。

「项目」跑在云端的独立计算机上，合上笔记本电脑也不会中断。

需要本机测试时，协调智能体会启动本地智能体。

官方另称协调智能体还能主动行动：

• 监听 Slack 频道
• 按计划运行
• 跟踪所有 PR

也就是无需等待提示就会动手。

工具与扩展Tools & extensions

MCP、技能（Skills）与钩子（Hooks）从 Pro+ 起可用。

官方在 Pro+ 及以上档列出这三项，另有云端智能体与按用量计费的 Bugbot。 Bugbot 是智能体驱动的代码审查。

Teams 档另有团队应用市场，面向内部规则、技能与插件。

MCP 接入细节（2026-10-03 补，取自官方 MCP 文档页）。

三种传输方式：

• stdio：本地，由 Cursor 启动；可用 shell 命令启动；手动认证
• SSE：可本地或远程部署为服务器；多用户；OAuth 认证
• Streamable HTTP：与 SSE 相同，可本地或远程部署为服务器；多用户；OAuth 认证

协议能力六项全支持：

• Tools / Prompts / Resources / Roots / Elicitation / Apps

配置分两层：

• 项目级 .cursor/mcp.json，可用 ${workspaceFolder}
• 全局 ~/.cursor/mjsson，可用 ${userHome}

变量插值支持四种：

• ${env:NAME}
• ${userHome}
• ${workspaceFolder}
• ${pathSeparator}

还支持 envFile 从 .env 读密钥（仅 stdio）。

⚠ 注意 ~ 是 home 目录，与「Pro+」无关。

工具审批默认开启。

官方原文："Cursor asks for approval before using MCP tools by default"。

工具级 allowlist 可以限制某个服务器上哪些工具能自动运行。

每个 MCP 服务器有独立网络模式：

• Allow all / Allowlist / Deny all / No sandbox

Hooks 事件清单（2026-10-03 补，取自官方 Hooks 与插件参考页）。

agent 钩子 18 个：

• sessionStart sessionEnd preToolUse postToolUse
• postToolUseFailure subagentStart subagentStop
• beforeShellExecution afterShellExecution
• beforeMCPExecution afterMCPExecution
• beforeReadFile afterFileEdit
• beforeSubmitPrompt preCompact stop
• afterAgentResponse afterAgentThought

另有 Tab 钩子：

• beforeTabFileRead
• afterTabFileEdit

应用生命周期钩子：

• workspaceOpen

钩子是命令型，可带 matcher 过滤。

官方原文：{"command": "./hooks/audit.sh"}

官方还给了 TypeScript 变体（由 Bun 驱动），可做结构化 I/O 与 HTTP。

上下文与记忆Context & memory

「项目」的核心设计是长期上下文维持。

官方原文说它能做三件事：

• 在长达数月的工作中持续保持上下文
• 把任务委派给成千上万个子智能体
• 无需提示就自动执行周期性工作

共享上下文会在多个云端与本地机器间同步。 一个智能体摸清某服务怎么测之后，后续智能体可以直接复用。

权限与限制Permissions & limits

安全审查是一个 bot，而且分成两个职责。

Security Review 管可利用的缺陷：

• 结合全库上下文读每个 PR
• 报告可被利用的缺陷
• 每项标明严重级别、攻击路径与修复建议

检查项包括注入、认证绕过、密钥提交、SSRF、不安全反序列化， 以及引入已知漏洞的依赖变更。

代码风格与质量问题仍由 Bugbot 负责。

还可以为仓库添加规则，Security Review 会在每个 PR 强制执行。 例如外部调用必须走哪个客户端、哪些表不能在请求处理程序里查。

草稿 PR 会被跳过。

适合什么任务Best for

适合三类人：

• 需要云端 Agent、希望合上笔记本任务继续跑的人
• 需要长周期（数月级）上下文维持与大规模子智能体编排的人
• 代码不能离开自有基础设施的企业（自托管形态）

Free 档适合想低成本试智能体的人：有限额度 + Composer 访问。

本页由This page is generated from the ai-agent-guide 数据层生成（CC BY 4.0）。data layer (CC BY 4.0). 方法论与坐标系定义见仓库内 METHODOLOGY.md。