Cursor 官方文档：Claude Sonnet 5 模型集成、用量池与 Agent 工具配置

一句话结论

Cursor 将 Claude Sonnet 5 定位为替代 Sonnet 4.6 的主力中档编码模型，支持 1M 上下文、思考模式与完整 Agent 工具套件，且超过 200k 上下文不收取长文本倍率费用。

适用场景

• 适合的任务：Cursor IDE 内的代码补全、Agent 自动编程、多文件重构、终端命令执行、浏览器自动化调试与规则检索。

• 不适合的任务：极端复杂的跨架构理论设计（官方建议此类任务升级至 Opus 5）。

• 适用的模型版本：Claude Sonnet 5（Cursor 托管模型池）。

• 适用的客户端、Agent 或 API：Cursor IDE（Agent 模式、Chat 模式、Composer）。

• 推荐的推理档位和参数：开启思考模式变体（Thinking Variant）；日常任务使用默认 effort，高难度调试可提升 effort。

可直接使用的内容

Cursor 模型与费率配置说明

{
  "model": "claude-sonnet-5",
  "pricing": {
    "input_per_mtok": 2.0,
    "cache_write_per_mtok": 2.5,
    "cache_read_per_mtok": 0.2,
    "output_per_mtok": 10.0
  },
  "context_window": 1000000,
  "long_context_markup": false,
  "usage_pool": "third_party_other",
  "agent_tools": [
    "Search files and folders",
    "Web",
    "Read files (vision-capable)",
    "Edit files",
    "Run shell commands",
    "Browser (screenshots & visual verify)",
    "Image generation",
    "Ask clarifying questions",
    "Fetch rules"
  ]
}

Cursor Rules 推荐配置示例（.cursorrules）

# Claude Sonnet 5 Project Rules
- Execution Mode: Prefer test-driven implementations; write minimal unit tests before modifying core logic.
- Conciseness: Avoid unsolicited boilerplate or helper utilities unless directly required by the user requirement.
- Tool Usage: Inspect files before proposing diffs; verify terminal output after running build or test commands.

测试/工作流步骤

1. 在 Cursor 设置的 Models 列表中勾选启用 Claude Sonnet 5，并设为 Agent 默认模型。

2. 确认个人或团队方案中的第三方模型用量池额度（个人方案每月包含至少 $20 第三方用量）。

3. 在 Agent 窗口中提交任务，Sonnet 5 会自动编排文件搜索、读取、代码编辑与终端命令执行。

4. 超过 200k 上下文的大型代码库无需担心阶梯加价，系统统一按基础每 token 费率计费。

原始证据与数据

• 官方费率：输入 $2/M，缓存写入 $2.5/M，缓存读取 $0.2/M，输出 $10/M。

• 计费特性：所有 Sonnet 5 提示词均按基础费率计费，即使上下文超过 200k 也没有单独的长上下文倍率。

• Tokenizer 变化：更新后的 tokenizer 会将相同输入拆分为更多 token，因此 token 数量较早期 Sonnet 模型略有上升。

适用边界

• 属于第三方用量池，消耗的是每月 $20 的基础额度或额外按量付费，不占用 Cursor 专有快速模型池。

• 在超长会话中由于 Tokenizer 密度调整和思考过程产出，总 token 消耗速率会快于 Sonnet 4.6。

来源摘录或观察（仅做合规短引）

• 官方文档说明：“Claude Sonnet 5 is Anthropic's latest medium-tier model and replaces Sonnet 4.6... ideal default choice for day-to-day coding.”

• 官方计费说明：“All Sonnet 5 prompts are billed at the base per-token rates... even when context exceeds 200k.”