爆肝整理,.claude 文件夹完整解剖指南 👇👇
从 CLAUDE.md 到 hooks、skills、agents、settings.json,每个文件的作用和套路一次讲透:
1.CLAUDE.md:项目级核心指令,每次会话自动加载,告诉 Claude 你的架构、命令、规范。200行以内效果最佳。
2.CLAUDE.local.md:个人覆盖文件,自动 gitignore,不污染团队配置。
3.rules/:模块化指令拆分,支持路径作用域(YAML frontmatter),API规范、测试标准各归其位。
4.hooks/:确定性控制。
PreToolUse 挡危险命令,PostToolUse 自动格式化,Stop 强制测试通过再收工。
关键:exit 0=成功,exit 1=记录但不阻止,exit 2=阻止执行并触发 Claude 自纠错。
Stop hook 必须检查 stop_hook_active,否则会死循环。
5.skills/:可自动触发的可复用工作流,描述匹配时 Claude 自己调用。
6.agents/:子智能体角色,隔离上下文,只给读权限,跑完汇报结果。
7.settings.json:权限总控,allow 放行,deny 封死,中间的会先问你。
8.两个目录:项目级 .claude/(提交 git)+ 全局 ~/.claude/(个人偏好+session历史)
9.hooks 不热重载,改完重启会话才生效。
10.实践起步:/init → settings.json → 建命令 → 拆 rules → 加全局 CLAUDE.md
建议直接把这份指南存下来,建 .claude 的时候对着配一遍。
感谢
@akshay_pachaar 的完整解剖。