引导 Claude Code:何时用 CLAUDE.md / skills / hooks / 子 Agent
🎯 一句话
Claude Code 的七种引导机制按何时加载、怎样保留、上下文成本与执行方式分工。项目事实、可复用流程与确定性检查应各放在合适的位置,不靠一个成本排名解决所有问题。
本页先解决:这条指导应该常驻、按需加载,还是由代码强制执行?
Claude 博客资料库 · ClaudeCode实践
这条指导应该常驻、按需加载,还是由代码强制执行?
先按何时加载、压缩后行为和用途读对照表,不急着给七种机制排高低。
读完可以:按加载时机、持久性与执行方式选机制,而非按一个成本排名选型。
📄 来自 Claude 官方博客
- 原文标题
- Steering Claude Code: When to Use CLAUDE.md, Skills, Hooks, and Subagents(引导 Claude Code:何时用 CLAUDE.md / skills / hooks / 子 Agent)
- 原文链接
- https://claude.com/blog/steering-claude-code-skills-hooks-rules-subagents-and-more
- 作者
- Michael Segner(Anthropic)
- 发布日期
- 2026-06-18
⚠️ 本页是原文的中文结构化整理笔记(保留架构、数据、案例、结论),并非逐字翻译。版本、参数与案例数字属于原文所示条件,不是本资料库的实测结果;产品状态与接口以实施时官方文档为准。
Claude Code 提供七种定制行为的方式,各自在上下文成本、持久性、指令权重上有不同权衡。选型取决于三个问题:指令何时加载、长会话中如何持久、在决策中的权重多大。
先按何时加载、压缩后行为和用途读对照表,不急着给七种机制排高低。
七种方式全对比
| 方式 | 何时加载 | 压缩后行为 | 上下文成本 | 适合什么 |
|---|---|---|---|---|
| CLAUDE.md | 根目录版会话开始时加载并常驻;子目录版在读该目录文件时按需加载 | 每会话重读并缓存,压缩后缓存清除 | 高(每行都吃 token,无论是否相关) | 项目概览、构建命令、目录结构、编码约定、团队规范 |
| Rules(规则) | 路径限定的规则只在读匹配文件时加载;未限定的像 CLAUDE.md 一样会话开始加载 | 压缩时重新注入 | 中 | 具体约束或横切约定(如「所有 API handler 必须用 Zod 校验输入」) |
| Skills | 名称和描述会话开始加载;正文仅在被斜杠命令或自动匹配调用时加载 | 已调用的技能在共享预算内重新注入,超出时最旧的先掉 | 低 | 程序性工作流——部署检查单、代码审查流程、发布流程 |
| 子 Agent | 名称、描述、工具列表会话开始加载;正文仅在通过 Agent 工具调用时加载 | 只有最终摘要和元数据回到主会话,中间结果保持隔离 | 零(调用前对父窗口零成本) | 隔离的支线任务——深度搜索、日志分析、依赖审计 |
| Hooks | 注册在 settings.json、托管策略或 skill/agent frontmatter;在生命周期事件时触发 | 完全绕过压缩 | 低(配置在主上下文之外) | 确定性自动化——编辑后跑 linter、完成时发 Slack、执行前拦截危险命令 |
| Output Styles | 注入系统提示词,会话开始加载 | 从不被压缩 | 高(且指令权重最高) | 重大角色转变(从编码助手变通用助手) |
| append-system-prompt | 通过 CLI 参数在调用时传入 | 从不压缩;首次请求后缓存 | 中(边际收益递减) | 一次性会话的领域知识、编码标准、输出格式 |
反模式说明为什么把内容放错位置会增加负担;与前面的加载条件对照阅读。
关键细节
- CLAUDE.md 要控制在 200 行以内并有明确归属人。在共享仓库中它会随团队不断追加而膨胀,稀释对关键准则的遵守
- Rules 用路径限定(
paths:frontmatter)能避免无关指令在别的工作中白白吃 token - 子 Agent 可嵌套五层,能编排数十个后台 Agent
- Hooks 与其他方式本质不同:它通过代码确定性执行,不依赖 Claude 的判断
- 自定义 Output Styles 默认替换编码角色的部分内置指导(安全准则、范围最佳实践、测试习惯),除非设置
keep-coding-instructions: true。内置样式(Proactive、Explanatory、Learning)已能覆盖大多数需求
四个「反模式 → 更好做法」
| ❌ 反模式 | ✅ 更好做法 |
|---|---|
| CLAUDE.md 里写「每次 X 都要做 Y」 | 用 hook 确定性地执行格式化或通知 |
| 把「绝对不要做某事」当提示词规则写 | 用 PreToolUse hook(退出码 2 拦截调用),或用托管设置做全组织护栏 |
| CLAUDE.md 里塞 30 行的部署手册 | 做成 skill 放 .claude/skills/,正文只在 /deploy 时加载 |
| API 专用规则不做路径限定 | 加 paths: frontmatter 让它只在 src/api/** 下加载 |
把具体指导放回决策框架:项目事实、可复用方法与确定性检查各有归处。
决策框架
选型时问自己三个问题: 1. 这该什么时候加载?(永远 / 按需 / 被调用时 / 事件触发) 2. 它该如何持久?(缓存 / 重新注入 / 绕过压缩 / 只返回摘要) 3. 必须被严格遵守到什么程度?(建议性 / 具体约束 / 确定性保证)
结论
有效的定制应当:把 CLAUDE.md 当索引而非垃圾桶、把流程下放给 skills 和子 Agent、用 hooks 强制硬性护栏、把系统提示词修改留给罕见的刻意角色转变。这种分层方式能在团队规模化时仍保持指令的有效性。
✅ 检查点
- 本文的七种引导方式分别是什么?
- 什么内容常驻,什么内容适合按需加载?
- 需要确定性执行时,该把规则放在哪里?
👀 答案
- CLAUDE.md、Rules、Skills、子 Agent、Hooks、Output Styles,以及 append-system-prompt。它们按加载时机、压缩后的保留方式和上下文成本分工。
- 仓库概览、构建命令等少量事实适合 CLAUDE.md;目录规范用路径限定的 Rules;完整流程和参考材料按需放进 Skills;独立探索可交给子 Agent。
- 用可执行的 Hooks、权限和托管策略约束实际动作,并验证它们确实触发。提示词和规则说明行为期望,不能代替执行层权限边界。
本节回顾
先记住这几件事
- 先判断指导何时加载、怎样保留,再选择七种机制。
- 常驻说明保持精简,流程与资料按需展开。
- 需要确定性执行的动作交给代码与权限机制,并检查执行结果。