小白也能搞懂：.claude/ 文件夹里到底应该放什么¶

Ch01.1133 小白也能搞懂：.claude/ 文件夹里到底应该放什么¶

📊 Level ⭐⭐ | 5.4KB | entities/小白也能搞懂claude-文件夹里到底应该放什么.md

来源: 架构师

发布日期: 2026-04-23

原文链接: https://mp.weixin.qq.com/s/v6iBuqep2ZCZ9wAwhnHLDA

架构师（JiaGouX）

我们都是架构师！

架构未来，你来不来？

今天来聊一个大家可能天天见，但不一定真正用好的东西：

CLAUDE.md 和 .claude/ 。

如果你已经用过 Claude Code，大概率见过它们。可能是 /init 自动生成过一个 CLAUDE.md ，也可能是在项目根目录下看到过 .claude/settings.json 、 .claude/commands/ 、 .claude/agents/ 这些东西。

但很多人对它们的用法，仍然停在一个很模糊的印象里：

"这不就是 Claude 的配置吗？"

我以前也差不多这么看。最近连着梳理 Agent 最小闭环、 Harness 、上下文管理、 Prompt Caching ，回头再看这堆文件，才慢慢觉得它们没那么简单。

这些文件不是给 Claude "加魔法"的。

它们更像是在回答一个很朴素的工程问题：

项目里有没有一套东西，能让 Agent 少靠猜。

少猜这个项目怎么跑。少猜哪些目录不能碰。少猜团队代码风格是什么。少猜出了错该怎么验证。少猜什么动作是危险动作。

把前面几篇连起来看会更清楚： Agent 最小闭环讲的是模型怎么动起来； Harness 讲的是模型外面的运行系统；上下文管理讲的是什么该留、什么该丢； Prompt Caching 讲的是稳定前缀和动态尾部怎么分层。

那今天这篇，就把这些东西落回一个最具体的问题：

一个普通项目里， .claude/ 文件夹到底应该放什么？

先说我自己的理解：

它不该是第二个文档站，也不该是提示词垃圾桶。

它更像一张给 Agent 的项目工作台——左边放稳定规则，中间放权限和工具边界，右边放可复用流程。

CLAUDE.md 、导入和 /memory 视图。写生产配置时，以当前版本实际加载结果为准。

放权限边界：哪些命令能跑，哪些文件不能读，哪些动作必须先拦住。