写在前面

最近在看 Claude Code 的文档，被它的“记忆机制”吸引了。

一个 AI 编码工具，怎么记住你的项目习惯？

看完才发现，这套设计相当优雅。

两套记忆系统

Claude Code 用了两套记忆机制。

第一套是 CLAUDE.md 文件，你写给它的规则。

第二套是 Auto Memory，它自己记的笔记。

就像老师傅带徒弟。师傅口传心授的是 CLAUDE.md，徒弟自己领悟的是 Auto Memory。

两者配合，刚刚好。

作用域就像 CSS 的层叠

CLAUDE.md 可以放在不同位置，作用域不同。

组织级别：/Library/Application Support/ClaudeCode/CLAUDE.md（macOS），IT 部门推送的公司规范。

项目级别：./CLAUDE.md，团队共享，提交到 Git。

用户级别：~/.claude/CLAUDE.md，你个人的偏好。

本地级别：./CLAUDE.local.md，不提交，放敏感信息。

优先级从窄到宽递减。越具体，越优先。

跟 CSS 一模一样的思路。

写好指令的三个要点

Claude 把指令当上下文，不是强制配置。

所以写法直接影响效果。

第一，控制长度。每个文件建议 200 行以内。文件越长，Claude 越容易走神。

第二，结构化。用 Markdown 标题和列表归组。组织良好的章节比大段文字好理解。

第三，要具体。

别写“代码格式要规范”，写“使用 2 空格缩进”。

别写“提交前测试”，写“提交前运行 npm test”。

别写“保持文件组织”，写“API 处理器放在 src/api/handlers/”。

模糊的指令等于没说。

还有一点：避免冲突。多个文件的规则如果矛盾，Claude 会随机选一个执行。定期审查，清理过时规则。

模块化有两招

大项目不能把所有规则塞一个文件。

第一招，导入语法。

复制

参考 @README 了解项目,查看 @package.json 了解 npm 命令。

# 补充说明
- Git 工作流 @docs/git-instructions.md

• 1.
• 2.
• 3.
• 4.

用 @ 引用其他文件，可以嵌套，最多 5 层。

第二招，rules 目录。

复制

.claude/
├── CLAUDE.md
└── rules/
    ├── code-style.md
    ├── testing.md
    └── security.md

按主题拆文件。

更强大的是路径范围

---
paths:
  - "src/api/**/*.ts"
---

# API 开发规则
- 所有端点必须包含输入验证

只有处理匹配文件时，规则才加载。

省 token，减噪音。

加载顺序的巧妙设计

Claude Code 从当前目录向上爬，检查每一层的 CLAUDE.md。

在 foo/bar/ 启动，会加载 foo/bar/CLAUDE.md 和 foo/CLAUDE.md。

同时向下看子目录，但不立即加载，而是按需加载。

处理子目录文件时，才加载对应的 CLAUDE.md。

既保证继承，又保证性能。

团队协作的技巧

符号链接是个好办法。

.claude/rules/ 支持 symlink，你可以维护一套共享规则，链接到多个项目。

ln -s ~/shared-claude-rules .claude/rules/shared
ln -s ~/company-standards/security.md .claude/rules/security.md

一处修改，处处生效。

用户级规则放在 ~/.claude/rules/，对所有项目生效。

适合放个人编码偏好，不适合项目特定的东西。

/init 命令很聪明

Claude Code 提供了 /init 命令。

它会分析你的代码库，自动生成 CLAUDE.md。

包括构建命令、测试指令、项目规范，都是它自己发现的。

如果 CLAUDE.md 已存在，/init 会建议改进，不会覆盖。

这个设计很人性化。

给你个起点，你再补充 Claude 发现不了的东西。

组织级部署

大公司可以集中管理 CLAUDE.md。

放在 /Library/Application Support/ClaudeCode/CLAUDE.md（macOS）或 /etc/claude-code/CLAUDE.md（Linux）。

用 MDM、Group Policy、Ansible 之类的工具分发。

这个文件无法被用户排除，优先级最高。

适合推送公司的编码规范、安全策略、合规要求。

排除无关的 CLAUDE.md

大型 monorepo 里，其他团队的 CLAUDE.md 可能被意外加载。

用 claudeMdExcludes 配置跳过它们。

支持路径或 glob 模式。

{
  "claudeMdExcludes": [
    "/top-level/CLAUDE.md",
    "other-team/rules/**"
  ]
}

保持配置干净，避免噪音。

上下文窗口的限制

每次对话开始，Claude 的上下文窗口是全新的。

CLAUDE.md 和 Auto Memory 都会加载进去，占用 token。

Auto Memory 只加载前 200 行。

所以 Claude 会自己控制笔记长度，把最重要的放前面。

我们写 CLAUDE.md 也要注意长度。

太长的文件不仅占 token，还会降低 Claude 的遵守率。

短而精，是王道。

与 Skills 的区别

文档提到，rules 和 skills 是不同的东西。

rules 每次都加载到上下文，或者在打开匹配文件时加载。

skills 只在你调用时，或 Claude 判断需要时才加载。

rules 是常驻的知识，skills 是按需的工具。

任务特定的指令，用 skills 更合适。

总结

Claude Code 的记忆机制设计得很周到。

两套系统互补，作用域分层，加载按需，规则模块化。

写好 CLAUDE.md 的关键是：具体、简短、结构化。

模糊的指令没用，冗长的文件有害。

把它当成跟人沟通。你说得越清

 学习资源推荐

如果你想更深入地学习大模型，以下是一些非常有价值的学习资源，这些资源将帮助你从不同角度学习大模型，提升你的实践能力。

一、全套AGI大模型学习路线

AI大模型时代的学习之旅：从基础到前沿，掌握人工智能的核心技能！​

因篇幅有限，仅展示部分资料，需要点击文章最下方名片即可前往获取

二、640套AI大模型报告合集

这套包含640份报告的合集，涵盖了AI大模型的理论研究、技术实现、行业应用等多个方面。无论您是科研人员、工程师，还是对AI大模型感兴趣的爱好者，这套报告合集都将为您提供宝贵的信息和启示

​因篇幅有限，仅展示部分资料，需要点击文章最下方名片即可前往获取

三、AI大模型经典PDF籍

随着人工智能技术的飞速发展，AI大模型已经成为了当今科技领域的一大热点。这些大型预训练模型，如GPT-3、BERT、XLNet等，以其强大的语言理解和生成能力，正在改变我们对人工智能的认识。 那以下这些PDF籍就是非常不错的学习资源。

因篇幅有限，仅展示部分资料，需要点击文章最下方名片即可前往获取

四、AI大模型商业化落地方案

作为普通人，入局大模型时代需要持续学习和实践，不断提高自己的技能和认知水平，同时也需要有责任感和伦理意识，为人工智能的健康发展贡献力量。