Claude Code记忆系统拆解：CLAUDE.md如何让AI编程助手记住你的项目约定

Claude Code记忆系统拆解CLAUDE.md如何让AI编程助手记住你的项目约定【免费下载链接】claude-codeClaude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.项目地址: https://gitcode.com/gh_mirrors/claudecode5/claude-codeClaude Code 是一款运行在终端里的 AI 编程助手它能执行日常编码任务、解释复杂代码并处理 Git 工作流。而真正让它越用越懂你的正是其记忆系统——由多层次的 CLAUDE.md 记忆文件与自动记忆目录组成。本文带你快速搞懂如何让 AI 记住你项目的测试命令、代码风格和团队约定避免每次对话都从头交代。为什么 AI 编程助手需要记忆每次打开新的会话AI 其实都不认识你的项目不知道测试该用bun test还是npm test不知道 API 路由要用 kebab-case。记忆系统解决的就是这个问题——把项目约定持久化到文件里在每次对话开始时自动注入上下文。Claude Code 的记忆分两套机制机制谁维护典型内容CLAUDE.md 记忆文件你手动编写项目约定、团队规范自动记忆目录auto memoryAI 自动记录你的偏好、纠正反馈、项目背景两套机制互补前者是员工手册后者是 AI 的工作笔记。CLAUDE.md四层记忆文件的加载顺序Claude Code 启动时会按固定顺序扫描并加载多份记忆文件核心逻辑在 src/utils/claudemd.ts 中有完整说明层级文件位置作用范围托管记忆/etc/claude-code/CLAUDE.md全员统一指令企业级用户记忆~/.claude/CLAUDE.md你个人的跨项目偏好项目记忆项目根目录CLAUDE.md、.claude/CLAUDE.md、.claude/rules/*.md提交进代码库团队共享本地记忆项目根目录CLAUDE.local.md个人私有不提交到仓库 几个关键设计优先级由后加载者决定离当前目录越近的文件优先级越高模型会更重视它们逐级向上扫描从当前目录一路向上遍历到根目录每层目录的CLAUDE.md都会被加载支持包含指令可以用path语法把其他文件引入记忆文件如./docs/style-guide.md避免单个文件过于臃肿系统会自动防止循环引用不存在的文件则静默忽略体积建议单个记忆文件建议不超过 4 万字符见 src/utils/claudemd.ts 中的MAX_MEMORY_CHARACTER_COUNT 经验法则团队共享的约定写进CLAUDE.md个人口味写进CLAUDE.local.md。自动记忆目录让 AI 自己记笔记除了手动维护的 CLAUDE.mdClaude Code 还内置了一套自动记忆系统auto memory默认开启。AI 会在对话中主动把值得记住的事情写成 Markdown 文件核心实现位于 src/memdir/ 目录。MEMORY.md 入口与 200 行上限自动记忆存放在~/.claude/projects/项目路径/memory/下路径解析逻辑见 src/memdir/paths.ts。其中MEMORY.md是索引文件每次会话自动加载进上下文上限 200 行 / 25KB超出会被截断并给出警告见 src/memdir/memdir.ts每条索引只需一行- 标题 — 一句话说明详细内容放在独立的主题文件里这种索引 主题文件的分层结构既控制了上下文开销又保留了按需检索的空间。记忆的四种类型自动记忆被限定为四种类型定义在 src/memdir/memoryTypes.ts而且明确不存任何能从代码或 git 历史里推导出来的东西类型记什么举例user你的角色、背景、知识水平用户是数据科学家熟悉 Go第一次碰 Reactfeedback你对工作方式的纠正与认可测试不要 mock 数据库——上个季度出过事故project代码里看不到的项目背景谁在做什么、为什么做、截止日期reference外部系统指针仪表盘、项目管理、Slack 频道地址如何管理你的记忆三个实用命令手动编辑/memory 命令在终端输入/memory可以直接打开记忆文件编辑器快速修改CLAUDE.md或CLAUDE.local.md命令入口见 src/commands/memory/index.ts。审查与晋升/remember 技能自动记忆用久了会积累杂项。/remember技能会审查所有记忆层输出一份结构化报告哪些条目该晋升到CLAUDE.md或CLAUDE.local.md、哪些是重复/过时/冲突的条目需要清理实现见 src/skills/bundled/remember.ts。比如用 bun 别用 npm这类条目它属于项目级约定会被建议晋升到CLAUDE.md让团队所有人都受益。一键生成项目记忆/init 命令新项目里直接运行/initAI 会自动分析代码库并生成一份CLAUDE.md初稿见 src/commands/init.ts——包括构建命令、测试方式、代码风格等省去从零手写的麻烦。CLAUDE.md 写什么最有用根据记忆晋升规则src/skills/bundled/remember.ts以下内容最适合写进项目记忆环境约定包管理器、运行/测试命令用 bun不用 npm代码规范命名风格、目录结构约定API 路由用 kebab-case工作流PR 规范、分支命名、合并策略踩坑记录为什么某些设计不能改、历史事故的原因不写能从代码本身推导的内容——架构说明、文件结构等AI 可以自己去探索更多记忆子系统细节可参考项目自带的 docs/subsystems.md。总结Claude Code 的记忆系统 CLAUDE.md 多层文件你写的规则自动记忆目录AI 记的笔记。前者决定团队怎么干活后者记住你和项目有什么故事。把约定写进CLAUDE.md定期用/remember清理晋升你的 AI 编程助手就能真正做到记住你的项目约定协作效率立竿见影。【免费下载链接】claude-codeClaude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.项目地址: https://gitcode.com/gh_mirrors/claudecode5/claude-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考