13 · 项目目录与配置文件详解

项目中的 .claude 目录、CLAUDE.md、settings、commands、agents、skills 和 hooks 分别放什么，看懂配置层级与作用范围。

Claude Code 在项目里会用到一组目录和文件，搞清它们各自干嘛，是「进阶配置」的地基。这一篇把它们梳理一遍。

「.claude 目录」是项目的配置根目录，里面可以放各种 Claude Code 的专属配置。它不是强制的，但用了之后配置会更集中、更有条理。

「CLAUDE.md」是「项目说明书」，告诉 Claude 这个项目的规矩、结构、约定。上一篇已经讲过它的生成和维护。

「settings」是「配置项」，可以设权限、环境变量、模型偏好等。它分几个层级——用户级、项目级、本地级——越贴近具体项目的越优先。

「commands」是「自定义命令」，你可以定义一些专属命令，让 Claude 执行特定的动作。

「agents」是「子代理配置」，定义不同角色的子代理。

「skills」是「技能」，把可复用的流程打包成能力。

「hooks」是「钩子」，在特定事件节点自动执行脚本。

「配置层级与作用范围」是关键概念：有些配置是全局的（影响所有项目），有些是项目级的（只影响这个项目），有些是本地级的（只影响你这台机器）。理解这个层级，你才知道「改这里」会影响到哪。

这一篇不用逐字背，把它当成一张「地图」，后面遇到具体功能时，知道「它大概住在哪」就够了。

动手试一下：比起看十遍，不如立刻打开 Codex 跑一个小任务验证你理解的概念。比如这一篇讲的概念，你可以找一个一分钟能完成的小需求，让它跑一遍，看实际行为是不是和你理解的一致。

五分钟练习：① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来，你对这一篇的理解会深 3 倍。

延伸阅读：学完这一篇，你可以看本组里的下一篇，把相邻的概念连起来读；也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的，多跳几篇会理解更深。

一页速览：如果只能记三件事，① {一}。② {二}。③ {三}。其他细节以后需要再翻这一篇查。