在 Claude CLI 工具中，.claude/ 文件夹是整个 AI 开发环境的“神经中枢”。它不仅存储项目级指令，还管理会话历史、工作流程配置等核心数据。对于希望深度定制 Claude 交互体验的开发者而言，理解这个隐藏目录的结构与功能，是从“基础使用”迈向“高效协作”的关键一步。本文将系统拆解 .claude/ 文件夹的组成，帮助你全面掌控 AI 开发环境。

一、.claude/ 文件夹概述与核心作用

当你首次在项目中运行 Claude CLI 命令时，工具会自动创建 .claude/ 目录。这个文件夹采用标准化结构，类似于 Git 的 .git/ 目录——它保存了 Claude 理解并执行任务所需的所有上下文信息。不同于手动输入的临时指令，存放在这里的配置具有持久性和项目共享性，团队成员克隆仓库后即可继承统一的工作规范。.claude/ 文件夹的核心价值在于：将人类意图从对话窗口迁移到文件系统，使 AI 的行为更加可预测、可复用、可版本控制。

二、目录结构详解：每个文件都有独特使命

.claude/ 文件夹通常包含以下几个关键组件：

**CLAUDE.md** 是最核心的文件，它允许你在项目根目录定义项目级指令。这些指令会被 Claude 自动加载，类似于为 AI 编写的一份“项目手册”。你可以在这里描述代码架构、编码规范、常用命令、项目背景等。例如：

CLAUDE.md 示例内容
项目概述
本项目是一个 RESTful API 服务，使用 Python FastAPI 框架。
编码规范
- 使用 Type hints 声明所有函数参数和返回值类型
- 异步函数使用 async def 关键字
- 遵循 PEP 8 规范
常用命令
- make dev 启动开发服务器
- make test 运行单元测试

**.clauderc.json** 是本地配置文件，采用 JSON 格式。它允许你覆盖全局设置，针对当前项目定制 Claude 的行为。典型配置项包括模型选择、输出格式、工具权限等：

{
  "permissions": {
    "allow": ["Read", "Write", "Bash"],
    "deny": ["Sql"]
  },
  "model": "claude-opus-4-5",
  "maxTokens": 8192
}

**instructions/** 文件夹用于存放更细粒度的指令文件。你可以根据功能模块或工作流程创建独立的指令文件，Claude 支持动态加载这些指令。例如，frontend-instructions.md 可能包含前端开发规范，review-instructions.md 定义代码审查流程。

**projects/** 目录存储会话历史和工作状态。当你需要中断并恢复工作时，Claude 会将上下文