哈，咱们今天聊聊怎么把 .claude 文件夹搞得高效又不乱，别kan它名字挺高级，根本不是要你上天入地的技术大佬才Neng玩。咱这边就像跟老友坐在咖啡桌前，随便扯扯代码里的小秘密。

.claude 本质上就是 Claude Code 的“隐藏工具箱”，里面存着你和团队的指令、规则、钩子、命令以及角色化脚本。想想它就像一辆车的底盘——Ru果底盘打得好，再跑多快dou稳。

常见结构是：

your-project/
├── CLAUDE.md
├── CLAUDE.local.md
└── .claude/
    ├── settings.json
    ├── settings.local.json
    ├── rules/
    ├── hooks/
    ├── commands/
    ├── skills/
    └── agents/

别急着一次性把所有东西塞进去，那样以后改起来会像挖土豆泥一样痛苦。

1️⃣ CLAUDE.md项目级指令集，告诉 Claude 在这个仓库里该怎么Zuo事。比如说：跑单测、生成文档、代码评审……全部写进这里让团队统一口径。

2️⃣ settings.json权限与行为控制层。决定谁Neng跑哪些命令，哪些钩子Neng生效，以及全局的配置信息。

3️⃣ .claude/local/.json个人覆盖层，只在本机有效。想实验新的 Hook 或临时关闭某个规则？就在这里改，不会污染团队代码。

## 权限与行为控制层
## 关于我。我用 Claude Code Zuo  和 。
## 思维原则
所有决策从问题本质出发，不因惯例照搬。
给我真实判断：方案有问题直接指出，
发现geng好路径直接说。
## 约束先行
新项目先写 CLAUDE.md，新目录先定结构约定。
Yi有规范先遵守；要改规范，先改文档再改实践。
## 沟通方式
默认中文，代码/命令/变量名用英文。
结论先行，再给理由。
遇到模糊需求，先给Zui合理方案，再问是否调整。
## 自主边界
删除文件/目录或
 git 历史、
修改 .env、密钥、token、CI/CD 配置、
数据库 schema 变geng或数据迁移、
git push / rebase / reset --hard / 强制推送、
安装新的全局依赖或修改系统配置、
公开发布。
## 通用工程纪律
改完主动跑验证。
不通过“注释报错/绕过校验”来伪修复。
密钥、token、密码不进代码、不进 commit、不进日志。
大改动先给方案，确认后实施。

.rules/ 用来拆分业务规则，如前端组件规范、后端 API 验证等。

.rules/
├── frontend.md          # UI 组件规范、状态管理原则
├── backend-api.md       # API 端点规则、验证要求、分页约定
├── testing.md           # 测试编写与运行规范
└── data-pipelines.md   # 批处理任务与定时任务约定

.hooks/ 是自动化脚本，用于防护和质量保障。比如格式化代码前自动跑 ruff：

#!/usr/bin/env bash
# 从 hook 事件输入中读取文件路径并执行格式化
jq -r '.tool_input.file_path' | xargs ruff format

.commands/ 并不是自动执行，而是高频任务模板。例如：

review-pr.md – 自动评审 PR 的逻辑和输出格式。

fix-bug.md – 快速定位并修复常见 bug。

write-tests.md – 给新功Neng生成测试骨架。

prepare-release-notes.md – 自动整理发行说明。

这些dou是可复用的片段，你Ke以直接调用，也Ke以在需要时Zuo小改动。

.skills/ 用来封装多步操作，比如发布前准备流程：

.skills/release-prep/
├── SKILL.md            # 步骤说明与触发方式
└── release-template.md # Zui终生成的发行说明模板

记住一句话：Neng用 commands 就别上 skills，否则维护成本高得离谱。

.agents/ 为那些需要固定视角完成的任务准备。例如：

.agents/
├─ code-reviewer/
│   └─ config.json     # 审查智Neng体配置
├─ security-auditor/
│   └─ config.json     # 安全审计智Neng体配置
└─ docs-writer/
    └─ config.json      # 文档撰写智Neng体配置

当你需要让 Claude 按固定角色行动时这个目录就派上用场了。

不要担心冲突，这里默认被 .gitignore 忽略，你Ke以自由玩耍而不会影响团队同步。例如临时关闭某个 Hook，只需在 settings.local.json 中添加一行即可：

// 临时禁用格式化 Hook，以免影响调试速度
{
  "hooks": {
    "format-edits": false,
    "run-tests-before-stop": true
  }
}

记住：只要不提交，这些修改永远只对你可见！

想回到默认状态？删掉 local 文件即可。

不过千万别把 token 写进去啊！

"为什么百度不收录"? 哈，说实话这跟我们配置 .claude 并没有直接关系，但你懂的，Ru果你想让自己的网站被搜索引擎抓到，可得注意 robots.txt 和 sitemap.xml 。百度通常不会抓取没有被授权或者内容太少的网站。Ru果你自己的项目只在 GitHub 上展示，没有公开域名，那自然就不会被收录。所以Ru果你想让外部kan到这些配置文档，Ke以把 README 放到 GitHub Pages 或者部署一个小博客，然后geng新 robots.txt，让搜索引擎知道该站点可抓取。否则……你懂吧，大概就是没办法啦！