大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



适用于 Claude Code，涵盖项目级和用户级目录的所有官方支持文件和文件夹。

---

 
   
    
     
       / ├── CLAUDE.md # 项目记忆（共享给团队） ├── CLAUDE.local.md # 项目记忆（本地，不提交 Git） ├── .mcp.json # 项目级 MCP 服务器配置（共享） └── .claude/ ├── settings.json # 项目共享设置 ├── settings.local.json # 项目本地设置（gitignored） ├── commands/ # 自定义斜杠命令 │ └── *.md # 每个文件 → /project:xxx ├── rules/ # 模块化规则（按需加载） │ ├── *.md # 通用规则（始终加载） │ └── path-spec/*.md # 路径限定规则 ├── hooks/ # Hook 脚本存放 │ └── *.sh / *.py / *.js # Hook 处理脚本 ├── skills/ # 项目级 Skills └── agents/ # 项目级自定义 Agent 
     

~/.claude/ ├── settings.json # 全局设置（权限、hooks、MCP） ├── settings.local.json # 全局本地覆盖设置 ├── credentials.json # 认证凭据（自动生成） ├── .claudesignature # 内部签名（自动管理） ├── commands/ # 全局自定义命令 → /user:xxx │ └── *.md ├── rules/ # 全局规则 │ └── *.md ├── skills/ # 全局 Skills ├── agents/ # 全局自定义 Agent ├── projects/ # 项目级记忆存储 │ └── 
   
    
     
       / │ └── CLAUDE.md # 个人项目记忆 ├── cache/ # 缓存目录 ├── ide/ # IDE 集成数据 ├── statsig/ # 功能标志/实验配置 └── tempo/ # 会话临时数据 
     

~/.claude.json # MCP 服务器配置（local/user scope） 

---

用途： 项目的"大脑"。存放项目约定、架构说明、编码规范、技术栈信息等。Claude Code 每次启动都会读取。

示例内容：

# 项目：电商平台后端 技术栈 - Java 21 + Spring Boot 3.3 - PostgreSQL 16 + Redis 7 - RocketMQ 5.x 约定 - API 路径统一用 kebab-case - 所有 Service 方法必须有日志 - 禁止在 Controller 写业务逻辑 

用途： 个人项目偏好。比如本地数据库地址、个人调试习惯等。不会影响团队其他人。

用途： 项目级配置，包括权限规则、hooks、MCP 服务器等。团队统一配置。

示例内容：

{ "permissions": { "allow": ["Bash(npm test)", "Bash(npm run lint)"], "deny": ["Bash(rm -rf *)"] }, "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [{ "type": "command", "command": ".claude/hooks/pre-tool-check.sh" }] } ] } } 

用途： 个人覆盖设置。可以覆盖 settings.json 中的配置，但只影响自己。

用途： 全局配置，对所有项目生效。包含权限、hooks、MCP 服务器、模型选择等。

示例内容：

{ "permissions": { "allow": ["Bash(git *)", "Read", "Write"], "deny": [] }, "hooks": ] } ] } } 

用途： 全局设置的本地覆盖，优先级最高。

用途： 创建可复用的提示词模板。文件名即命令名。

示例文件 .claude/commands/review.md：

请对以下代码进行 Code Review： - 检查是否有安全漏洞 - 检查是否符合项目编码规范 - 检查性能问题 - 给出改进建议 文件路径：$ARGUMENTS 

使用方式：/project:review src/main/java/UserService.java

用途： 模块化的指令文件。可以根据文件路径自动匹配加载，也可以始终加载。

文件名约定：

文件名即匹配规则 — Claude Code 根据文件名中的 glob 模式判断何时加载该规则。

示例 .claude/rules/api-rules.md：

# API 开发规范 - 所有 REST API 必须使用 OpenAPI 3.0 规范 - 响应格式统一：{ code, message, data } - 分页参数：page, pageSize - 错误码范围：40000-49999（业务错误），50000-59999（系统错误） 

用途： 存放 Hook 处理脚本。Hook 本身在 settings.json 中声明，脚本文件放在此目录。

支持的 Hook 事件：

Hook 类型：

用途： 定义可复用的技能模块。每个 Skill 是一个独立目录，包含 SKILL.md 和相关脚本/资源文件。

用途： 定义自定义 Agent 配置，可以指定特定的系统提示词、模型、工具权限等。

用途： 存储 Claude Code 的认证信息。不要手动编辑，不要提交到版本控制。

用途： Claude Code 内部使用的签名文件，用于验证完整性。

用途： 存储个人对特定项目的记忆。与项目根目录的 CLAUDE.md 不同，这是用户级私有记忆，不会提交到 Git。

用途： Claude Code 的运行时缓存，包括索引数据、分析结果等。可以安全删除，会自动重建。

用途： 与 IDE（如 VS Code、JetBrains）集成时产生的数据。Claude Code 与 IDE 联动时自动管理。

用途： A/B 测试和功能标志配置。Claude Code 使用 Statsig 控制功能的灰度发布。

用途： 会话运行时的临时数据存储。会话结束后通常可清理。

用途： 项目级 MCP 服务器配置，供团队共享。

示例内容：

{ “mcpServers”: {

"database": { "command": "npx", "args": ["-y", "@bytebase/dbhub"], "env": { "DB_URL": "${DB_URL:-postgresql://localhost:5432/myapp}" } }, "github": { "type": "http", "url": "https://api.githubcopilot.com/mcp/" } 

} }

用途： 存储 local scope 和 user scope 的 MCP 服务器配置。

示例内容：

{ “projects”: {

"/path/to/project": { "mcpServers": { "stripe": { "type": "http", "url": "https://mcp.stripe.com" } } } 

} }

---

从高到低：

1. Managed Policy Settings — 企业管理员配置（最高优先级）
2. /.claude/settings.local.json — 全局本地覆盖
3. /.claude/settings.json — 全局设置
4. /.claude/settings.local.json — 项目本地覆盖
5. /.claude/settings.json — 项目共享设置

---

以下文件名在社区中常见，但 Claude Code 不会自动识别和加载：

⚠️ 注意： 如果要使用上述非官方文件，需要在 CLAUDE.md 中显式引用，例如：

请参阅 .claude/context.md 了解项目背景。 

---

---

• 官方文档：Explore the .claude directory
• 官方文档：Memory
• 官方文档：Settings
• 官方文档：Hooks Reference
• 官方文档：MCP
• DeepWiki: .claude Folder Structure
• Claude Fast: Rules Directory Guide
• ComputingForGeeks: .claude Directory Guide