什么值得买App下载 App ›
连续签到专享现金活动

Claude Code有7种指令机制,官方警告:大部分人只用了一种

Claude Code 提供了七种行为定制机制,分别是 CLAUDE.md 文件、Rules、Skills、Subagents、Hooks、Output Styles 以及 append-system-prompt 命令行参数。这七种机制在加载时机、压缩行为和上下文成本三个维度上存在本质差异,构成了一个完整的指令治理体系。

Anthropic 官方在 2026 年 6 月发布的指南中指出,大多数开发者仅使用了 CLAUDE.md 这一种方式,而剩余六种机制由于缺乏清晰的认知而被闲置。事实上,指令放在哪里比指令本身写得多好更重要——错误的放置位置会导致上下文窗口被无关信息填满,稀释真正重要指令的遵循效果,同时造成不必要的 Token 消耗。
123
01七种机制核心差异对比
理解七种机制的第一步是掌握它们在三个关键维度上的差异:加载时机决定了指令何时进入 Claude 的上下文;压缩行为决定了长会话过程中指令是否会因上下文压缩而丢失;上下文成本则直接影响 Token 消耗效率。14
机制加载时机压缩行为上下文成本适用场景
CLAUDE.md(根目录)会话启动时全程加载压缩后重新读取高——每行字都占用上下文构建命令、目录结构、编码规范、团队约定212223
CLAUDE.md(子目录)按需加载,访问该目录时触发压缩后丢失低特定子目录的规范(适合 Monorepo 架构)2122
Rules会话启动(全局)或匹配路径时(路径限定)压缩后重新注入中等——路径限定时可极致省钱跨切面的强约束,如“API handler 必须用 Zod 校验”212224
Skills启动时仅加载名称和描述,调用时加载全文已调用者重新注入,有共享预算低——按需加载部署检查表、发布流程等程序化工作流212224
Subagents启动时加载名称描述,通过 Agent 工具调用时加载正文仅最终摘要返回主会话极低——隔离运行深度搜索、日志分析、依赖审计等并行隔离任务212224
Hooks生命周期事件触发时执行完全绕过压缩极低——配置在主上下文外确定性自动化:运行 linter、发送通知、拦截命令212224
Output Styles会话启动时注入系统提示词永不压缩高角色变更(如从编码助手切换为通用聊天助手)2122
append-system-prompt命令行参数,仅当次调用有效永不压缩中等临时指定的编码标准或输出格式偏好2122
从对比表中可以看出,七种机制并非互斥关系,而是一套分工明确的工具箱。官方强调的核心判断维度是:这条指令是否需要在长会话压缩后保留,是否值得为它付常驻上下文的成本,是否需要确定性而非模型自主判断。把这三个问题想清楚,机制的选择基本就能确定。23
02CLAUDE.md 文件使用规范
CLAUDE.md 是项目根目录下的 Markdown 文件,用来告诉 Claude Code 代码库的基本情况。根目录的 CLAUDE.md 在会话启动时加载,全程驻留在上下文中,直到会话结束或被压缩后重新读取。这种始终加载的特性使其适合存放构建命令、目录布局、monorepo 结构、编码约定和团队规范等“每次会话都用得上”的信息。12
子目录 CLAUDE.md 则是另一种模式。例如 app/api/CLAUDE.md 只在 Claude 读取 app/api 下的文件时才会加载,会话启动时不会加载,压缩后会丢失,直到该子目录再次被触碰。这种按需加载机制非常适合 Monorepo 架构,让前后端团队各自维护自己的约定,互不干扰。12
官方建议将根目录 CLAUDE.md 严格控制在 200 行以内,指定一个 owner,并像审代码一样审它的改动。在共享仓库中,CLAUDE.md 容易变成“公共垃圾场”——每个团队往里面追加指令,但没人删除旧内容。成本是累积的:每一行都会加载到每个工程师的每次会话中,不管跟当前任务有没有关系。这既消耗 Token,又会稀释真正重要指令的遵循效果。当文件膨胀时,应将团队级规范推到路径限定的 Rules 里,把流程性内容迁移到 Skills 中。124
03Rules 与 Skills 的分工
Rules 存储在 .claude/rules/ 目录下,用于设定 Claude 的特定约束或规范。没有作用域限制的 Rules 行为与根目录 CLAUDE.md 类似:会话启动时始终加载,压缩后重新注入。关键创新在于 paths 字段的路径限定功能——加了 paths 字段后,只有匹配的文件被触碰时规则才加载。例如一条规则限定 paths: ["src/api/**"],那么在只处理文档的会话中,这条规则就不会进入上下文。12
Skills 存放在 .claude/skills/ 目录下,每个 Skill 是一个文件夹,包含 SKILL.md 说明文件,也可以包含脚本和资源文件。启动时 Claude 仅加载 Skill 的名称和描述(大约 100 个 Token),Skill 的完整内容在被明确触发时才加载。这种按需加载机制使得 Skills 非常适合存放程序化的工作流,如部署清单、发布检查表、代码审查步骤等。与 Rules 不同的是,压缩后已调用的 Skills 会重新注入,但受限于共享预算——最早调用的 Skill 优先被丢弃。12
官方提供了明确的分工建议:Rules 适合“事实类”指令——项目结构、技术约束、API 规范;Skills 适合“动作类”指令——部署流程、检查清单、发布步骤。简单判断方法是问自己:这条指令是“知识”还是“动作”?知识对应 CLAUDE.md 或 Rules,动作对应 Skills。123
04Subagents 与 Hooks 的隔离执行
Subagents 定义于 .claude/agents/ 目录,用于隔离运行的副任务助手。启动时加载名称、描述和工具列表,代理体正文仅在通过 Agent 工具显式调用时加载。最关键的设计是:Subagent 在自己的独立上下文中运行,中间过程永远不会进入主会话上下文,主会话只接收其返回的最终总结消息与元数据。这种机制使其适合执行深度搜索、日志批量分析、依赖项审计等极易污染主上下文的并行隔离任务。12
Hooks 则是基于用户定义的事件触发机制,在 Claude 生命周期的特定时刻执行,配置在主上下文之外,完全绕过会话压缩。Hooks 支持三种类型:command 执行 Shell 脚本,适合确定性检查;HTTP 发送网络请求;prompt 让另一个 Claude 实例做语义判断。常见事件包括 PreToolUse(工具调用前)、PostToolUse(工具调用后)、SessionStart(会话开始)、PreCompact(压缩前)等。例如 PostToolUse 后自动运行 ESLint 检查代码格式,PreToolUse 时拦截危险命令,PreCompact 之前备份对话记录。5126
官方给出了一个清晰的决策原则:“让 AI 做这件事” → Subagent,“让确定性逻辑做这件事” → Hooks。这个判断维度非常重要,因为很多开发者容易混淆两者——试图用 AI 判断来处理本该确定性执行的任务,不仅浪费资源,还降低了可靠性。52
05Output Styles 与 System Prompt
Output Styles 位于 .claude/output-styles/ 目录下,文件内容直接注入到系统提示词中,具有最高的指令遵循权重,同时永不压缩。这意味着 Output Styles 的内容在每次会话中始终可见,不受上下文压缩影响。官方用它来做“基础角色”的切换——默认 Claude Code 是“软件工程师助手”,切换 Output Styles 后可以变成“通用助手”或任何其他角色。12
官方强调,Output Styles 的变更会替换默认系统提示词,因此除非必要不要自定义。Anthropic 已内置三个 Output Styles:Proactive(主动模式)、Explanatory(解释模式)、Learning(学习模式),覆盖 90% 的使用场景。append-system-prompt 则是通过 CLI 标志传入的命令行参数,仅对当次调用有效,具有永不压缩的特性,但追加指令越多遵循度越低。官方建议仅用于临时指定的编码标准、输出格式或语气偏好控制。512
06Token 消耗与成本控制
Claude Code 的 Token 消耗构成中,输入 Token 占据总消耗的 70-85%,其中超过 90% 是缓存读取的消耗。输入部分包括系统提示词、历史对话、上传的代码文档;输出部分是模型返回的代码和分析结果。上下文会随着对话推进越滚越大——这就是为什么长会话中每条消息的成本都在递增。78
实测数据显示不同场景的 Token 消耗差异巨大:轻量级开发如写带鉴权的 FastAPI 接口,单次成本约 ¥0.06;中大型迭代如 8 万行代码项目的 20 轮对话,消耗约 ¥30;重型任务如 97 万 Token 全量代码漏洞扫描,单次成本高达 ¥130。这说明不做上下文截断、每轮对话塞入全部历史的做法会导致 10 轮后 Token 消耗翻 10 倍。79
针对 Token 消耗优化,官方指南中七种机制的设计本身就体现了成本控制的思路:子目录 CLAUDE.md 按需加载避免全量读取;路径限定 Rules 只付匹配部分的成本;Skills 按需调用降低常驻消耗;Subagents 隔离运行防止上下文污染;Hooks 完全绕过压缩不占用主上下文。CodeGraph 等工具则通过预建代码知识图谱来减少文件读取次数,实测可将 Token 消耗降低 57%。102
07决策框架总结
面对七种机制,官方提供了一套决策框架帮助选择。首先问自己三个问题:这条指令是“知识”还是“动作”?知识放 CLAUDE.md 或 Rules,动作放 Skills。其次问是“全局”还是“特定路径”?全局放 CLAUDE.md 或全局 Rules,特定路径放子目录 CLAUDE.md 或路径限定 Rules。第三问是“让 AI 做”还是“让代码做”?AI 判断用 Subagents,确定性逻辑用 Hooks。最后考虑是否需要角色级别的变更,需要则用 Output Styles,仅单次有效则用 append-system-prompt。52311
需要特别注意的是,每次新增配置前应先确认是否真的需要。官方强调“Context 是稀缺资源——每加一条规则都让 AI 注意力稀释一次”。对于 Claude Code 的使用者而言,合理的指令配置不仅能节省资源,还能提高 AI 的工作效率;而错误的放置位置则会导致上下文被无关信息填满,稀释真正重要的指令遵循效果。5211

指令放置决策

CLAUDE.md 适合的场景
  • 构建命令和目录结构——每次会话都需要的基础事实

  • 团队通用规范——适用于整个代码库的标准

  • 编码约定——贯穿始终的风格指导

Rules/Skills 更适合的场景
  • 特定文件的约束——如“迁移文件只能追加”

  • 程序化流程——部署清单、发布检查表

  • 跨目录横切关注点——API 路由必须用 Zod 校验

Claude Code 的七种定制机制构成了一个完整的指令治理体系。CLAUDE.md 作为“宪法”存放基础事实,Rules 实现路径级条件约束,Skills 管理程序化工作流,Subagents 处理隔离并行任务,Hooks 确保确定性自动化,Output Styles 切换角色级别设定,append-system-prompt 处理临时需求。理解每种机制的加载时机、压缩行为和上下文成本,才能将指令放到正确的位置,让 Claude Code 的行为定制真正服务于开发效率的提升。123

评论

评论区空态插画

当前文章无评论,是时候发表评论了