一周备稿 · 2026-08-11 · 21:00
上篇：articles/drafts/w2-human-in-loop.md
相关阅读：Cursor vs Claude Code vs Copilot · Skills 与 MCP 怎么选
下篇预告：JSON Schema 约束 LLM 输出

很多人桌面开着 Cursor，终端里又跑着 Claude Code，结果 两个 Agent 改同一仓库、互相覆盖。
问题不在工具不够强，而在 没有分工协议。

先给结论：Cursor 管「编辑器内的读-改-审 diff」；Claude Code 管「终端长任务、跨命令验收」；同一时刻只让一个 Agent 写同一分支，用 Git 作仲裁。

你将学到

• Claude Code 适合 / 不适合的任务类型
• 与 Cursor 的四象限分工表
• 可复制的日常切换工作流
• CLAUDE.md、Hooks 与 Cursor Rules 怎么不打架
• 踩坑：双 Agent 改仓、无验收闭环、权限过大
• 何时两者都不用，回到 Copilot 补全

一、先结论：按「工作单元」选工具

工作单元	更推荐	原因
单文件补全、小改	Copilot / Cursor Tab	延迟低
多文件重构、边聊边看 diff	Cursor Agent	IDE 上下文 + 可视化审阅
跑测试 / 构建 / 日志排查长链路	Claude Code	终端原生，命令串联顺
跨目录脚手架、批量脚本	Claude Code	少依赖 GUI
接 MCP 发布、浏览器验证	Cursor	Host 生态成熟
企业只批一个 IDE	看采购	别硬双开

一句话：Cursor 是 AI 工作台，Claude Code 是 AI 运维 + 交付员。

二、Claude Code 适合什么时候上

适合

- 克隆仓库 → 装依赖 → 跑 test → 修失败用例 → 再跑（循环直到绿）
- 根据 CI 日志定位 flaky test
- 批量改 40 个文件的重复模式（带 git checkpoint）
- README / CHANGELOG / 发布说明从 git log 生成
- 在 Docker / k8s 环境里查配置（只读先，再改）

不适合

场景	为什么	替代
精细 UI 调像素	终端看不到组件	Cursor + 浏览器
边改边看 AST 结构	IDE 弱	Cursor
实时结对「这一行怎么写」	交互粒度太粗	Copilot
无 Git 的散文件	难回滚	先 init repo

三、与 Cursor 的分工协议（推荐）

规则 1：同一分支，单写入者

开任务前：
  git checkout -b feat/xxx
  约定：本轮只有 Claude Code 写  OR  只有 Cursor 写

切换时：
  git status 必须 clean
  在 Issue / 笔记里写「交给 Cursor 做 UI」

规则 2：按阶段切换，不是按心情

阶段	工具	产出
探索	Cursor Ask	理解模块、画改动面
实现	Cursor Agent 或 Claude Code（二选一）	代码 + 测试
验收	Claude Code	npm test / curl 证据
抛光	Cursor	小 diff、类型、格式

规则 3：共享「真相源」文件

文件	作用
.cursor/rules/*.mdc	Cursor 行为边界
CLAUDE.md	Claude Code 项目约定
AGENTS.md	两者共读的极简总则（可选）

CLAUDE.md 最小示例：

# 项目约定
- 包管理：uv / pnpm（二选一写清）
- 测试：pytest -q / pnpm test
- 禁止：未授权 force push、改 .env
- 完成定义：测试绿 + 无未解释 TODO

别让 Cursor Rules 写「用 npm」，CLAUDE.md 写「用 pnpm」—— Agent 会一起疯。

四、Claude Code 日常工作流（可复制）

1. cd project && git pull && git checkout -b fix/issue-42
2. claude  （或 claude -p "读 failing test，只分析不改"）
3. 下指令：「先只读定位根因，列出假设，我确认后再改」
4. 改完：「跑 pytest tests/foo.py -q，贴输出」
5. git add -p → commit → 交给 Cursor 做 UI 微调（可选）
6. push → PR

权限与沙箱

• 默认 先只读（读文件、跑 test），确认后再 --allowedTools 放开写
• 生产密钥、.env 进 deny list
• 高危命令（rm -rf、DROP）要求人工复制执行

五、Cursor 侧怎么配合

Cursor 强项	与 Claude Code 衔接
MCP 调发布 / 查 Notion	Claude 改完代码，Cursor 调 MCP 发草稿
Composer 多文件	大改前让 Claude 先出改动清单
Bugbot / Review	Claude 交付分支后，Cursor 开 Review

本仓库典型组合：

Claude Code：改 csdn-publish-mcp 源码 + 跑 uv run pytest
Cursor + MCP：list_siyuan_publish_queue → publish_csdn_article
Skill：csdn-article-quality 规定 5 Pass 写稿流程

Skill 定 SOP，MCP 执行发布——Claude 写 Python，Cursor 按 Skill 审稿发稿，各管一层。

六、成本与效率

维度	Claude Code	Cursor Agent
计费	常按 API / 订阅套餐	Cursor 订阅 + 模型用量
上下文	终端摘要，易丢 GUI 细节	仓库索引强
并行	适合后台长跑	适合人机共改
学习曲线	要会写任务 + 验收	要会审 diff

别双开对轰：两个 Agent 各烧一份 Token，还 merge 冲突。

七、踩坑清单

1. Cursor 和 Claude Code 同时改同一目录 —— 无 Git 仲裁必翻车
2. Claude Code 无「完成定义」 —— 改一半宣称 done
3. CLAUDE.md 与 Cursor Rules 矛盾 —— 行为随机
4. 终端 Agent 给生产库写权限 —— 一条 SQL 事故
5. 不让 Agent 贴 test 输出 —— 空口完成
6. 所有任务都上 Claude Code —— 补全反而更慢
7. 不做 git checkpoint —— 回滚不能

相关阅读

主题	链接
三工具横评	162931757
Skills vs MCP	articles/drafts/bonus-skills-vs-mcp.md
Cursor Rules	articles/drafts/bonus-cursor-rules-engineering.md
下篇 · JSON Schema	articles/drafts/w2-json-schema-llm.md

小结

Claude Code 与 Cursor 不是二选一，是 分阶段、分分支、分职责。
终端长链路与测试验收交给 Claude Code；多文件 diff 与 MCP 集成留在 Cursor。
写清 CLAUDE.md 与 Rules，Git 保持 clean 再切换——比争论「谁更强」省太多时间。

标签：Claude Code · Cursor · AI 编程 · 工作流