探索 .claude 目录
一句话
了解 Claude Code 如何从 .claude 目录和 ~/.claude 目录读取配置和扩展功能。
什么时候翻这页
- 需要了解 Claude Code 的配置文件结构时
- 想要自定义 Claude Code 行为或添加新功能时
- 需要排查配置问题或理解配置优先级时
- 想要了解如何与团队共享配置时
核心概念
- .claude 目录：项目级别的配置目录，包含 CLAUDE.md、settings.json、skills、rules 等
- ~/.claude 目录：全局配置目录，包含个人设置、插件、历史记录等
- 配置文件类型：包括指令文件、设置文件、技能（skills）、代理（subagents）、工作流（workflows）等
- 配置优先级：全局配置 < 项目配置 < 本地配置 < CLI 标志
怎么做
- 在项目根目录创建 .claude 文件夹
- 添加 CLAUDE.md 文件定义项目上下文和约定
- 创建 settings.json 配置权限、钩子（hooks）和环境变量
- 根据需要添加 skills、rules、agents 等扩展
- 将共享配置提交到 git，个人配置保留在 settings.local.json
命令 / 配置速查
| 文件/目录 | 用途 | 位置 |
|---|---|---|
| CLAUDE.md | 项目指令和约定 | 项目根目录或 .claude/ |
| settings.json | 权限、钩子、环境变量 | .claude/ 或 ~/.claude/ |
| settings.local.json | 个人覆盖设置 | .claude/ (自动 gitignored) |
| skills/ | 可重用提示 | .claude/ 或 ~/.claude/ |
| agents/ | 专门代理 | .claude/ 或 ~/.claude/ |
| workflows/ | 动态工作流 | .claude/ 或 ~/.claude/ |
| rules/ | 主题范围指令 | .claude/ 或 ~/.claude/ |
| .mcp.json | 项目范围 MCP 服务器 | 项目根目录 |
| .worktreeinclude | 要复制到工作树的文件 | 项目根目录 |
初学者易错点
- 混淆 CLAUDE.md 和 settings.json 的用途：前者是指令，后者是强制执行的配置
- 忘记将 settings.local.json 添加到 .gitignore
- 技能（skills）和命令（commands）的区别：技能可以捆绑支持文件，命令是单文件
- 配置优先级：全局配置 < 项目配置 < 本地配置 < CLI 标志
- 忘记 Windows 上 ~/.claude 解析为 %USERPROFILE%.claude
相关词条
claude-memory管理 Claude 的记忆claude-settings配置设置和权限claude-skills创建可重用提示claude-subagents定义专门代理claude-workflows编排多个代理claude-hooks运行自定义脚本