从 Cursor 迁到 Claude Code 时如何保留规则作用域
教程建议将常驻规则迁入 `CLAUDE.md`,将按文件匹配的规则放入 `.claude/rules/` 并设置 `paths`,将按描述触发和手动调用的规则分别改成对应的技能。文章还提醒留意配置头和通配符的差异。
AI 深度解读
从 Cursor 换到 Claude Code,规则迁移最容易漏掉的是触发时机。Claude Code 不读 .cursor/rules,把整个目录塞进根目录的 CLAUDE.md,会让原先只在改 API、跑测试或发版时才用到的说明,每次开会话都进上下文。
作者用一个有 7 条规则的 TypeScript 项目算了笔账。整份复制约占 740 tokens,按触发时机迁移后,启动时约占 100 tokens。这套拆法更值得看的地方,是怎么确认该生效的规则确实生效了。
先按触发时机给四类规则找位置
全局规则放进项目根目录的 CLAUDE.md。只有跨任务都要遵守的约定才搬进这里。按文件匹配的规则放进 .claude/rules/,用 YAML 文件头里的 paths: 限定范围。下面这条就把输入校验和日志约定限定在 API handler 上。
---
paths:
- "src/api/**/*.ts"
---
- Every handler validates its input with the zod schema in `src/api/schemas/`.
- Log with `logger` from `src/lib/logger.ts`, never `console.log`.
迁移时盯住 paths: 那一行。Cursor 原文件 .cursor/rules/api-handlers.mdc 用的是 globs: src/api/**/*.ts 和 alwaysApply: false。Claude Code 的规则文件只识别 paths:,会静默忽略这两个字段。目标文件可以叫 .claude/rules/api-handlers.md,放在该目录的子目录里也能被发现。Cursor 的 .cursor/rules 则要求用 .mdc。
靠描述触发的规则适合做成 skill。Claude Code 启动时能看到 skill 的描述,判断任务相关时再加载正文。下面的 .claude/skills/testing/SKILL.md 把仓库的测试约定交给 testing skill。
---
name: testing
description: How to write and run unit and integration tests in this repo
---
- Unit tests live next to the file as `*.test.ts` and run with `pnpm test`.
- ...
这里要看 description: 那一行,它给 Claude 提供判断何时加载测试说明的线索。手动规则也做成 skill,比如把发布清单做成 release,在文件头加上 disable-model-invocation: true,只在输入 /release 时加载。
为什么搬完还要实测加载范围
同一个 glob 在两个工具里可能圈中不同的文件。原文举例,Cursor 的 *.ts 只匹配根目录的 TypeScript 文件,Claude Code 中 *.md 会匹配基准目录下任意层级的 Markdown 文件,写成 /*.md 才限定在根目录。多个模式在 Cursor 里用逗号分隔,Claude Code 接受 YAML 列表或逗号分隔的字符串。
还有两种会悄悄增加上下文的情况。Cursor 规则里的 @migration-template.sql 是给 agent 的文件指引,放进 CLAUDE.md 后,@path 会把文件内容随 CLAUDE.md 一起载入。想保留路径提示,可以用反引号包住它。另一种是 YAML 写坏了,Claude Code 会按缺少 paths: 处理,让规则变成每次启动都加载。可以用 claude --debug 找解析错误。
作者拿来计数的 7 条规则里,有 1 条全局规则、3 条文件规则、2 条描述规则和 1 条手动发布清单。整份复制有 53 行,约 740 tokens。分类后,启动时加载的是 84 tokens 的 CLAUDE.md 和约 20 tokens 的两条 skill 描述。每条文件规则约 85–119 tokens,匹配到文件才加进来。作者用 o200k_base 算的是相对体量,Claude 自己的分词结果会不同。原文还提到,Anthropic 建议每份 CLAUDE.md 控制在 200 行以内。
两个工具都在用,哪些规则能共用?
全局规则可以集中在根目录的 AGENTS.md。按作者 2026 年 11 月 18 日查阅的文档,Claude Code 从 v2.1.277 起能直接读取 AGENTS.md,默认条件是启动目录及其上级没有 CLAUDE.md、.claude/CLAUDE.md 或 CLAUDE.local.md。如果需要保留 Claude 专用说明,可以在 CLAUDE.md 开头写 @AGENTS.md,再往下加专用内容。按 Anthropic 的说明,这样导入只会读一次共享文件。
文件规则可以指定一边为源,生成另一边所需的 .mdc 和 .md。如果规则恰好按目录划分,也可以用子目录里的 AGENTS.md。Cursor 在对应目录工作时加载它,Claude Code 则要先满足直接读取 AGENTS.md 的条件,而且该子目录也得没有 CLAUDE.md。从仓库子目录启动会影响读取条件,团队最好用平时的启动位置验证一次。
我的判断
作者给出的数字能说明,规则分类可以腾出启动上下文。至于响应会不会更快、改代码会不会更准,原文没有给对照数据。规则很多、范围分得清的仓库更容易从拆分里获益。只有几条全局约定的小项目,集中写在 CLAUDE.md 里也容易维护。
我会把文件规则用于可以由路径准确识别的约定,比如 API handler 的日志方式。测试说明更适合 skill,因为「补测试」是任务意图,测试文件还没建时就可能需要它。靠描述自动触发是否稳定,原文没测。发布清单有明确的使用时点,手动 /release 更容易核对。至于「先搬全局规则,再根据出错的地方补」,这是讨论串里的经验,适合愿意让两个工具并行一段时间的团队。
能拿来做什么
- 先挑一条 API 或组件规则试迁。新开会话跑
/context all,看Memory files列表。让 Claude 修改src/api/下的匹配文件后再跑一次,检查规则是否出现。需要打开具体规则时用/memory。 - 把仓库里的
*.test.ts位置和pnpm test写进testingskill,把发布清单放进只能手动调用的releaseskill。用/skills检查两条 skill 是否被发现,以及 Claude 能否自行调用它们。 - 双工具并用时,让共享全局约定只维护在一份
AGENTS.md里。范围规则可以先迁最常用的一组,再用同一计数口径比较迁移前后的启动负担,并检查两边有没有重复或冲突的约定。