点击上方卡片关注我设置星标 学习更多AI出海知识装完 Claude Code 跑第一个项目的时候根目录会多出一个.claude/文件夹。大部分人看到了没点开过也没想过里面有什么。这就错过了 Claude Code 最值得折腾的部分。.claude/不是缓存目录不是日志文件夹它是 Claude Code 的控制中心你的指令、你的自定义命令、权限规则、跨会话记忆、甚至可以自动触发的工作流全在这里面。这篇文章把它拆开一个文件一个文件讲清楚。先搞清楚其实有两个 .claude/一个在项目根目录一个在你的 Home 目录~/.claude/。项目级./.claude/团队配置提交到 git所有人共享。规则、命令、权限策略都放这里。全局级~/.claude/个人偏好只对你生效。会话记录、自动记忆、个人命令都在这里。两个目录结构类似但职责不同。CLAUDE.md最重要的一个文件Claude Code 启动时第一件事就是读 CLAUDE.md把内容加到系统提示里整个会话都保持在上下文中。简单说你写什么Claude 就照做什么。你说所有函数都要写单元测试再实现它就会这么做。你说错误处理只用自定义 Logger不准用 console.log它每次都会遵守。三个位置可以放 CLAUDE.md项目根目录./CLAUDE.md最常用全局目录~/.claude/CLAUDE.md跨所有项目生效子目录里只在 Claude 操作该目录的文件时加载Claude 会读取所有层级的 CLAUDE.md 并合并。写多少合适控制在200 行以内。超过 200 行上下文占用过多Claude 对指令的遵守度反而会下降。该写的构建、测试、lint 命令npm run test、make build关键架构决策我们用 Turborepo 管理 monorepo不明显的坑TypeScript strict mode 开着未使用变量会报错导入规范、命名风格、错误处理模式不该写的linter 或 formatter 已经定义了的规则可以链接到的完整文档长篇理论解释20 行就够覆盖一个中型项目的核心规范了。CLAUDE.local.md个人偏好如果你有些习惯是你自己的不想影响团队。比如你习惯用另一个测试框架或者希望 Claude 总是用某种方式打开文件。在项目根目录创建CLAUDE.local.md。Claude 会和主 CLAUDE.md 一起读取但这个文件自动 gitignore不会提交到仓库。.claude/rules/当 CLAUDE.md 塞不下了项目大了之后CLAUDE.md 很容易膨胀到 300 行。没人愿意维护一个巨型文件。.claude/rules/文件夹解决这个问题。里面每个 markdown 文件都会被自动加载跟 CLAUDE.md 一起生效。按关注点拆分.claude/rules/ ├── api-conventions.md # API 相关的规范 ├── testing.md # 测试标准 ├── security.md # 安全要求 └── frontend.md # 前端组件规范负责 API 的人改 api-conventions.md负责测试的人改 testing.md互不干扰。更强大的是路径作用域。在规则文件顶部加 YAML frontmatter就可以让它只在操作特定路径时生效--- paths: - src/api/** - src/handlers/** ---Claude 编辑 React 组件时不会加载这个文件只有操作src/api/下的代码时才会加载。没有 paths 字段的规则文件每次都会加载。.claude/commands/自定义斜杠命令Claude Code 自带/help、/compact这些命令。你可以在.claude/commands/里加自己的。文件名就是命令名。创建一个review.md就多了一个/project:review命令Review the current git diff for bugs, performance issues, and style problems. Focus on: 1. Logic errors 2. Missing error handling 3. Performance bottlenecks Heres the current diff: ! git diff --staged反引号里的!前缀会执行 shell 命令并把输出嵌入 prompt。这让自定义命令不只是存一段文本而是能动态注入上下文。用$ARGUMENTS接收参数Fix the GitHub issue described below: ! gh issue view $ARGUMENTS跑/project:fix-issue 234就会把第 234 号 issue 的内容喂给 Claude。项目级命令提交到 git 跟团队共享。个人命令放~/.claude/commands/显示为/user:command-name。.claude/skills/Claude 自己判断什么时候用Commands 需要你手动输入斜杠命令触发。Skills 不一样Claude 会根据对话内容自动判断是否需要调用。每个 Skill 是一个子目录里面放一个 SKILL.md.claude/skills/ └── security-review/ ├── SKILL.md └── DETAILED_GUIDE.mdSKILL.md 用 YAML frontmatter 描述什么情况下使用--- description: Review code for security vulnerabilities ---当你说帮我看看这个 PR 有没有安全问题Claude 读到 description 匹配就会自动调用这个 Skill。跟 Commands 的关键区别Skill 可以打包多个文件。上面的 DETAILED_GUIDE.md 会被一起引用。Commands 是单个文件Skills 是一个包。.claude/agents/定义专职子代理复杂任务可以拆给专门的子代理。在.claude/agents/里定义--- name: Code Reviewer model: haiku tools: - Read - Grep - Glob --- You are a code reviewer. Focus on: - Logic errors and edge cases - Missing test coverage - Performance implicationsClaude 需要做代码审查时会启动这个子代理。子代理有独立的上下文窗口做完工作后把结论压缩返回主会话不会把主会话撑满。tools字段限制子代理能做什么。一个只读的安全审计代理没必要有写文件的权限。model字段让你用便宜的模型跑简单任务。只读的代码浏览用 Haiku 就够了把 Sonnet 和 Opus 留给真正需要推理的工作。.claude/settings.json权限控制控制 Claude 能做什么、不能做什么{ $schema: https://code.claude.com/schema/settings.json, permissions: { allow: [ Bash(npm run *), Bash(git *), Read, Write, Edit, Glob, Grep ], deny: [ Bash(rm -rf *), Bash(curl *), Read(.env), Read(secrets/*) ] } }allow 列表里的操作不需要确认直接执行。deny 列表里的操作完全禁止。两个列表都不在的Claude 会先问你。同样有一个settings.local.json用于个人覆盖自动 gitignore。~/.claude/projects/自动记忆Claude Code 在工作过程中会自动记录笔记它发现的命令、观察到的模式、架构细节。这些存在~/.claude/projects/里下次打开同一个项目时自动加载。你可以用/memory命令查看和编辑这些笔记。如果 Claude 突然记住了你没告诉过它的东西大概率是自动记忆在起作用。想重来可以清空对应项目的记忆文件。从零开始的推荐顺序第一步在 Claude Code 里跑/init。它会自动分析项目生成一份 CLAUDE.md你在上面删改就行。第二步创建.claude/settings.json至少把常用的 run 命令加到 allow把.env加到 deny。第三步为最常做的工作创建一两个自定义命令。代码审查和修 issue 是最好的起点。第四步CLAUDE.md 超过 200 行了开始拆到.claude/rules/里按路径设作用域。第五步在~/.claude/CLAUDE.md写上你的个人偏好比如总是先写类型定义再写实现。95% 的项目做到这五步就够了。Skills 和 Agents 等你有了固定的复杂工作流再加。写在最后很多人用 Claude Code 的感觉是有时候很聪明有时候又犯傻其实大部分犯傻不是模型的问题是它不知道你的项目规矩。你没告诉它用哪个测试框架它就猜一个你没说命名用 camelCase它可能给你写 snake_case你没定义错误处理模式每次写出来的都不一样。.claude/就是解决这个问题的。花半小时把 CLAUDE.md 写好后面每次对话都省几分钟纠正时间一个项目用下来省的时间远超投入。我们出海社区终于有自己的网站了欢迎关注这个账号还会持续分享更多AI编程、出海工具、实战经验、踩坑记录。想了解更多可以加我 vx: 257735 聊。出海赚钱案例一个人做了个开源UI库不融资不投广告45天30万美元出海建站必备一小时搞定自建邮件免费OpenClaw 真香我让它每天帮我干这些活出海赚钱案例一个人用 PHP 做到月入 17 万美金利润率 99%2026年最新Codex CLI 国内使用全攻略终端 VSCode Cursor Opencode 四种姿势全搞定从海外公司注册到 Stripe 收款跑通了出海收付款全流程实操分享玩转 Claude Code Hooks让自动化渗透到每个环节