🏠 总目录 📚 资料库Claude Code 实践

引导 Claude Code:何时用 CLAUDE.md / skills / hooks / 子 Agent

⏱ 12 分钟 | 🎚️ 从最轻的手段开始

🎯 一句话

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 里写「每次 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 强制硬性护栏、把系统提示词修改留给罕见的刻意角色转变。这种分层方式能在团队规模化时仍保持指令的有效性。


✅ 检查点

  1. 本文的七种引导方式分别是什么?
  2. 什么内容常驻,什么内容适合按需加载?
  3. 需要确定性执行时,该把规则放在哪里?
👀 答案
  1. CLAUDE.md、Rules、Skills、子 Agent、Hooks、Output Styles,以及 append-system-prompt。它们按加载时机、压缩后的保留方式和上下文成本分工。
  2. 仓库概览、构建命令等少量事实适合 CLAUDE.md;目录规范用路径限定的 Rules;完整流程和参考材料按需放进 Skills;独立探索可交给子 Agent。
  3. 用可执行的 Hooks、权限和托管策略约束实际动作,并验证它们确实触发。提示词和规则说明行为期望,不能代替执行层权限边界。

本节回顾

先记住这几件事

  • 先判断指导何时加载、怎样保留,再选择七种机制。
  • 常驻说明保持精简,流程与资料按需展开。
  • 需要确定性执行的动作交给代码与权限机制,并检查执行结果。