一、为什么需要选择
CLAUDE.md 建议保持在 200 行以内。超过这个长度，Claude 对指令的遵从度可能下降。
两种应对方式各有代价：
实际项目中，编码规范 30 行、API 设计规则 20 行、测试约定 15 行、Git 工作流 10 行——加起来就超过了建议上限。拆分还是内联，是 CLAUDE.md 维护中最频繁的决策。
二、限制与红线
在做拆分决策前，需要先了解 @引用的硬约束。
递归深度限制
被引用的文件中可以继续使用 @引用嵌套其他文件，最大深度 5 跳。实际使用中 1-2 层就够用。
审批对话框
首次在一个项目中遇到 @引用时，Claude Code 会弹出审批对话框，列出将要导入的文件。
关键行为：
- 这是每个项目一次性的确认，不是每次会话
- 确认后，后续会话自动加载，不再弹出
- 拒绝后不可逆——对话框不会再次出现，被拒绝的 @引用保持禁用状态
路径格式约束
@引用仅支持文件系统路径，三种写法：
不支持 URL、不支持 glob 模式。
代码块和行内代码中的 @path 不会被解析——@anthropic-ai/claude-code 这样的包名不会触发文件导入。