Claude Code有7种指令机制,官方警告:大部分人只用了一种
Claude Code 提供了七种行为定制机制,分别是 CLAUDE.md 文件、Rules、Skills、Subagents、Hooks、Output Styles 以及 append-system-prompt 命令行参数。这七种机制在加载时机、压缩行为和上下文成本三个维度上存在本质差异,构成了一个完整的指令治理体系。
Anthropic 官方在 2026 年 6 月发布的指南中指出,大多数开发者仅使用了 CLAUDE.md 这一种方式,而剩余六种机制由于缺乏清晰的认知而被闲置。事实上,指令放在哪里比指令本身写得多好更重要——错误的放置位置会导致上下文窗口被无关信息填满,稀释真正重要指令的遵循效果,同时造成不必要的 Token 消耗。123
Anthropic 官方在 2026 年 6 月发布的指南中指出,大多数开发者仅使用了 CLAUDE.md 这一种方式,而剩余六种机制由于缺乏清晰的认知而被闲置。事实上,指令放在哪里比指令本身写得多好更重要——错误的放置位置会导致上下文窗口被无关信息填满,稀释真正重要指令的遵循效果,同时造成不必要的 Token 消耗。123
01七种机制核心差异对比
| 机制 | 加载时机 | 压缩行为 | 上下文成本 | 适用场景 | |
|---|---|---|---|---|---|
| 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 |
02CLAUDE.md 文件使用规范
03Rules 与 Skills 的分工
04Subagents 与 Hooks 的隔离执行
Hooks 则是基于用户定义的事件触发机制,在 Claude 生命周期的特定时刻执行,配置在主上下文之外,完全绕过会话压缩。Hooks 支持三种类型:command 执行 Shell 脚本,适合确定性检查;HTTP 发送网络请求;prompt 让另一个 Claude 实例做语义判断。常见事件包括 PreToolUse(工具调用前)、PostToolUse(工具调用后)、SessionStart(会话开始)、PreCompact(压缩前)等。例如 PostToolUse 后自动运行 ESLint 检查代码格式,PreToolUse 时拦截危险命令,PreCompact 之前备份对话记录。5126
05Output Styles 与 System Prompt
06Token 消耗与成本控制
07决策框架总结
指令放置决策
CLAUDE.md 适合的场景
构建命令和目录结构——每次会话都需要的基础事实
团队通用规范——适用于整个代码库的标准
编码约定——贯穿始终的风格指导


Rules/Skills 更适合的场景
特定文件的约束——如“迁移文件只能追加”
程序化流程——部署清单、发布检查表
跨目录横切关注点——API 路由必须用 Zod 校验
当前文章无评论,是时候发表评论了