Claude Code / 核心概念
.claude 目录
.claude 目录适合放项目级配置、命令、技能和团队共享的 Claude Code 工作流。
.claude 目录负责什么
.claude 目录是项目内 Claude Code 配置和能力的集中位置。它可以包含项目说明、设置、Hooks、Skills、Commands、Subagents、Workflows、Rules 和自动记忆。
官方页面用一个“目录探索”展示每类文件的作用。学习者需要掌握的是：哪些内容适合提交到仓库共享，哪些内容应该留在本地或全局用户目录。
常见文件和目录
不同文件作用不同，不能全部塞进 CLAUDE.md。
| 位置 | 用途 | 是否适合提交 |
|---|---|---|
| CLAUDE.md | 项目背景、命令、架构、团队约定。 | 适合提交。 |
| settings.json | 权限、Hooks、环境变量、默认行为。 | 项目共享设置可提交，敏感值不要提交。 |
| settings.local.json | 个人或本机覆盖。 | 不要提交。 |
| rules/*.md | 按路径自动加载的规则。 | 适合提交。 |
| skills/*/SKILL.md | 可复用任务能力。 | 团队技能可提交。 |
| agents/*.md | 专门 subagent 定义。 | 团队共享代理可提交。 |
选对位置
把信息放错位置会浪费上下文或泄露私有配置。项目稳定约定放仓库，个人偏好放用户目录，秘密和机器相关设置放本地文件或环境变量。
- 让 Claude 记住项目命令：CLAUDE.md。
- 允许或拒绝工具：settings.json permissions 或 Hooks。
- 运行前后脚本：settings.json hooks。
- 个人临时偏好：settings.local.json 或用户级配置。
- 复杂工作流：Skills、Commands、Subagents。
调试目录是否生效
如果 Claude 没按预期加载规则，使用 /context、/doctor、/hooks、/mcp 等命令确认实际加载了什么，而不是猜。
/context
/doctor
/hooks
/mcp完整使用要点
补充官方文档中容易被压缩遗漏的核心概念、操作顺序、权限边界和验证要求，方便中文学习者按页面完整学习。
.claude 目录实践
.claude 目录用于组织 Claude Code 项目级能力。它可以放 settings、rules、commands、skills、agents、workflows 等文件。团队共享内容可以提交，个人或敏感配置应留在本地。
- 项目 CLAUDE.md：项目背景、命令、架构、约定。
- settings.json：团队共享权限、hooks、默认行为。
- settings.local.json：本机个人覆盖，不提交。
- rules：按路径自动加载的短规则。
- skills：可复用任务工作流。
- agents：专门子代理定义。
调试时使用 /context、/doctor、/hooks、/mcp 查看实际加载情况。不要靠猜测判断某条规则是否生效。
学习检查清单
把本页内容落到真实任务中，用入口、上下文、权限、验证和团队规则五个维度检查是否真正掌握。
学习检查清单
读完本页后，不要只记住概念名。你应该能把“.claude 目录”放回 Claude Code 的真实工程流程里：任务从哪里发起，系统会加载什么上下文，哪些动作需要审批，结果如何验证，失败时如何回退。
如果这是概念页面，要特别确认它如何影响真实任务：它改变上下文、权限、执行路径、验证方式，还是改变团队协作流程。
- 能用自己的话说明本页解决的具体问题，而不是只复述标题。
- 能写出一个最小示例任务，并标明目标、范围、禁止事项和验收标准。
- 能判断哪些信息应该放进当前提示，哪些应该沉淀到项目规则或配置里。
- 能说明哪些长期规则应该写进 CLAUDE.md，哪些运行行为应该交给 settings、permissions、Hooks、Skills 和 MCP。
- 能在任务完成后检查 diff、命令输出、测试结果、截图或 PR 说明，而不是只相信自然语言总结。
如果要把本页用于团队培训，可以让学员用 Claude Code 完成一个小任务：先只读解释，再提交计划，再执行最小改动，最后用真实验证命令和人工 diff 审查收尾。