科技人人都是产品经理·枝酒··AI 生成
别再什么都塞进 CLAUDE.md 了——Anthropic 官方发布的七种自定义方式决策框架
本文深度拆解了 Anthropic 官方关于 Claude Code 七种自定义指令机制的博文,核心观点是指令的放置位置比指令内容更重要。作者详细对比了 CLAUDE.md、Rules、Skills、Subagents、Hooks 等机制在加载时机、上下文成本和适用场景上的本质差异,并给出了具体的决策框架和反模式识别。对于使用 Claude Code 的开发者而言,本文提供了一套从混乱到有序的配置路线图,能够显著优化 Token 使用效率并提升 AI 助手表现。原文 ↗原文 ↗
核心观点
- ▍Claude Code 提供了七种自定义行为的方式,但大多数人只用 CLAUDE.md 一种;指令放在哪里(加载时机、上下文成本)比指令本身写得多好更重要。
- ▍上下文窗口是 Claude 最贵的资源,根据不同机制的加载策略分配指令,是从混乱配置到高效系统的关键。
- 01Anthropic 在 2025 年 6 月 18 日发布的官方博文《Steering Claude Code》中对比了七种机制,指出了它们在加载时机(启动时/按需)、压缩后行为(重新读取/丢弃)和上下文成本上的关键差异。
- 02CLAUDE.md(根目录)会话启动就加载,全程不释放,适合放构建命令、目录结构等“每次都用得上”的事实;建议控制在 200 行以内,并指定负责人审阅变更。
- 03Rules 是核心创新点:通过 `paths:` 字段实现路径过滤,只在匹配文件被触碰时才加载,将上下文成本精确分配到有用时;适合跨模块的横切关注点。
- 04Skills 启动仅加载名字和描述(约 100 Token),技能体在调用时才加载,适合流程类指令(如部署清单);但描述写得太模糊会导致技能无法被触发。
- 05Subagents 在独立的上下文中运行,只有最终结果返回主会话,中间过程的噪音完全隔离;支持最多五层嵌套,可用于编排上百个后台代理。
- 06Hooks 是通过 PreToolUse/PostToolUse 事件触发的确定性代码(不是指令),可以执行 shell 命令或阻断危险操作,比在 CLAUDE.md 中写“不要做 X”更可靠。
反方 / 局限
- — Output Styles 会覆盖默认系统提示词,导致 Claude 从一个编程助手退化为通用助手,Anthropic 建议优先使用内置的三种样式,作者也强调其使用场景最狭窄。
- — 追加系统提示词虽然比 Output Styles 安全,但存在递减效应:加的指令越多,每条指令被遵守的程度越低,尤其当指令之间存在矛盾时。
AnthropicClaude CodeCLAUDE.mdRulesSkillsSubagentsHooksSteering Claude Code
14 分钟 · 5 卡片 · 14 资料
读原文 →前置背景
技术原理
平行视角
未来推演
延伸追问