.claude 文件夹(.claude directory)
读取配置的文件夹。用图和例子讲清它是什么、怎么运作、怎么用,以及要注意什么。
它是什么
.claude 是 查找配置的地方。它有两个。下的 .claude/ 放这个项目的设置,到 ,让团队共用。你主文件夹里的 ~/.claude/ 放你自己在所有项目里通用的设置。里面可以放设置、规则、技能、等等,但大多数人只改 CLAUDE.md 和 settings.json,其他的需要时再加。~/.claude/ 里还有 Claude Code 在你工作时写下的,比如对话记录、提示历史和日志。
它怎么工作
-
在项目里建 .claude/
-
按需加 settings.json 或规则
-
把共用文件提交到 git
-
个人设置放在 ~/.claude/
怎么使用
-
.claude/settings.json团队共用的、钩子、环境变量和默认。
-
.claude/skills/<name>/SKILL.md可重复使用的,用
/name运行,合适时 也会自己用。 -
.claude/agents/*.md子智能体的定义,每个都有自己的提示词和工具。
-
~/.claude/projects/<project>/memory/自动记忆,Claude 在不同会话之间给自己留的笔记。
注意
并不是所有东西都在这个文件夹里。CLAUDE.md 和 .mcp.json 可以放在项目根目录,managed-settings.json 在系统文件夹里,~/.claude.json 是另一个文件(不是这个文件夹),保存应用状态。在 上 ~/.claude 指的是 %USERPROFILE%\.claude,设置 CLAUDE_CONFIG_DIR 可以把主文件夹里的这份挪到别处。
相关术语
原文和官方文档
本页用简单的话解释这个术语。以原文为准:如果两者不同,请按原文。
- 在原文中查看这个术语Claude Code Docs — Glossary Anthropic · 确认于 2026-10-19
- Anthropic — Claude Code docs: Explore the .claude directory — File reference(在新窗口中打开)
- Anthropic — Claude Code docs: Explore the .claude directory — Choose the right file(在新窗口中打开)
- Anthropic — Claude Code docs: Settings files and precedence — Settings files and who they affect(在新窗口中打开)
- Anthropic — Claude directory(在新窗口中打开)