HoRain云小助手个人主页 个人专栏: 《Linux 系列教程》《c语言教程》⛺️生活的理想就是为了理想的生活!⛳️ 推荐前些天发现了一个超棒的服务器购买网站性价比超高大内存超划算忍不住分享一下给大家。点击跳转到网站。专栏介绍专栏名称专栏介绍《C语言》本专栏主要撰写C干货内容和编程技巧让大家从底层了解C把更多的知识由抽象到简单通俗易懂。《网络协议》本专栏主要是注重从底层来给大家一步步剖析网络协议的奥秘一起解密网络协议在运行中协议的基本运行机制《docker容器精解篇》全面深入解析 docker 容器从基础到进阶涵盖原理、操作、实践案例助您精通 docker。《linux系列》本专栏主要撰写Linux干货内容从基础到进阶知识由抽象到简单通俗易懂帮你从新手小白到扫地僧。《python 系列》本专栏着重撰写Python相关的干货内容与编程技巧助力大家从底层去认识Python将更多复杂的知识由抽象转化为简单易懂的内容。《试题库》本专栏主要是发布一些考试和练习题库涵盖软考、HCIE、HRCE、CCNA等目录⛳️ 推荐专栏介绍什么是 Claude Code 的记忆系统记忆文件的层级结构CLAUDE.md 文件详解什么是 CLAUDE.md创建 CLAUDE.md推荐的 CLAUDE.md 结构写好 CLAUDE.md 的黄金法则子目录 CLAUDE.mdAuto Memory自动记忆详解它是如何工作的自动记忆的文件结构触发自动记忆开启 / 关闭 Auto Memory/memory 命令使用指南/memory 命令的功能# 快捷键——快速添加记忆常见问题与调试Claude 忽略了 CLAUDE.md 的指令CLAUDE.md 是上下文不是强制执行实际工作流示例场景一初始化新项目场景二记录调试发现场景三团队协作最佳实践总结参考资源什么是 Claude Code 的记忆系统Claude Code 没有跨会话的自动记忆——每个新会话都从一个全新的上下文窗口开始。记忆系统通过两种互补机制让知识能够跨会话持久保存并在每次对话开始时自动加载机制谁来写适合什么CLAUDE.md 文件你开发者手动编写项目规范、团队约定、构建命令等Auto Memory自动记忆Claude 自动写入从你的纠正和偏好中积累的经验两种机制在每次会话开始时都会被加载到上下文中。Claude 将它们作为参考上下文而非强制配置——指令越具体、越简洁Claude 遵循得越一致。记忆文件的层级结构Claude Code 采用四层记忆层级优先级从高到低1. 企业级配置Enterprise policy ← 最高优先级只读 2. 用户级 CLAUDE.md ← ~/.claude/CLAUDE.md对所有项目生效 3. 项目级 CLAUDE.md ← 项目根目录随 Git 提交共享给团队 4. 子目录级 CLAUDE.md ← src/、api/、tests/ 等子目录按上下文加载最具体的规则优先子目录的 CLAUDE.md 会覆盖上层的同类规则。CLAUDE.md 文件详解什么是 CLAUDE.mdCLAUDE.md是一个放在项目根目录或子目录的 Markdown 文件。Claude Code 在每次新会话启动时会自动将其注入系统提示词。它是你可以配置的长期记忆。创建 CLAUDE.md方式一使用/init命令自动生成# 在 Claude Code 会话中执行 /initClaude 会分析你的目录结构自动生成一份针对你的技术栈的 CLAUDE.md 骨架。例如在一个 Node.js 项目中运行/initClaude 会自动检测框架、测试工具、构建命令等30 秒内生成一份 80% 完整度的初始文件。方式二手动创建touch CLAUDE.md推荐的 CLAUDE.md 结构# 项目约定 ## 技术栈 - 前端Next.js 15、TypeScript 5.7、Tailwind CSS 4 - 后端Node.js 22、Prisma 6 - 测试Vitest 3.2 ## 代码规范 - 始终使用函数式 React 组件 - 文件名使用 kebab-case - 测试文件与源码放在同一目录 ## 常用命令 - 构建pnpm build - 测试pnpm test - 启动开发服务器pnpm dev ## API 约定 - 所有 API 路由以 /api/v1/ 开头 - 错误响应格式{ error: string, code: number }写好 CLAUDE.md 的黄金法则✅ 要这样写使用祈使句和简短列表而非叙述性段落包含具体的版本号和命令加入代码示例5 行示例胜过 50 字说明控制在200 行以内超过部分不会在会话开始时加载❌ 避免这样写模糊指令如遵循最佳实践或写干净的代码过多通用规则只放这个项目独有的约定过时的信息建议每月审查一次子目录 CLAUDE.mdmy-project/ ├── CLAUDE.md # 全局项目规范 ├── src/ │ └── CLAUDE.md # 仅在处理 src/ 文件时加载 ├── api/ │ └── CLAUDE.md # API 特定约定 └── tests/ └── CLAUDE.md # 测试特定规则Claude Code 只在处理对应目录的文件时加载子目录的 CLAUDE.md节省 token 的同时提供更精准的上下文。Auto Memory自动记忆详解它是如何工作的Auto Memory 让 Claude 能够跨会话自我积累知识无需你手动编写任何内容。Claude 会在工作过程中自动保存笔记包括构建命令和调试技巧架构决策笔记代码风格偏好工作流习惯Claude 并不会每次都保存内容它会判断哪些信息在未来会话中有用才写入。自动记忆的文件结构~/.claude/projects/project/memory/ ├── MEMORY.md # 简洁的索引文件每次会话开始时加载前 200 行 ├── debugging.md # 调试模式的详细笔记 ├── api-conventions.md # API 设计决策 └── ... # Claude 创建的其他主题文件MEMORY.md是整个记忆目录的索引Claude 通过它来追踪各文件中存储的内容。触发自动记忆当你告诉 Claude 某些事情时它会自动保存到记忆中你始终使用 pnpm不要用 npm 你记住 API 测试需要本地运行 Redis 实例 你我们的日期格式统一用 ISO 8601想保存到 CLAUDE.md 而不是 Auto Memory明确说明你把这条加到 CLAUDE.md开启 / 关闭 Auto Memory方式一通过/memory命令切换见下节方式二在项目设置中配置// .claude/settings.json { autoMemoryEnabled: false }方式三环境变量export CLAUDE_CODE_DISABLE_AUTO_MEMORY1blockquote注意Auto Memory 是本地机器级别的同一 Git 仓库的所有 worktree 和子目录共享一个记忆目录但不会跨机器或云环境同步。/memory命令使用指南/memory是管理记忆系统的核心命令。/memory命令的功能在 Claude Code 会话中输入/memory可以查看当前会话加载的所有 CLAUDE.md 和规则文件列表切换Auto Memory 的开启/关闭状态打开Auto Memory 文件夹链接选择任意文件在编辑器中打开编辑#快捷键——快速添加记忆这是一个隐藏的效率神器# 始终在函数参数中使用具名参数named parameters按下#键输入你想记住的内容按回车——Claude Code 会自动将其写入对应的 CLAUDE.md 文件。非常适合记录项目约定保存常用 Bash 命令记下代码风格细节常见问题与调试Claude 忽略了 CLAUDE.md 的指令运行/memory确认 CLAUDE.md 文件已被加载确保 Claude Code 在 CLAUDE.md 所在目录或其子目录中运行检查指令是否足够具体——遵循最佳实践太模糊使用具名导入tree-shaking 兼容性则更有效检查文件是否超过 200 行超出部分不加载CLAUDE.md 是上下文不是强制执行Claude读取并尽力遵循 CLAUDE.md但没有严格合规的保证尤其是指令模糊或相互冲突时。将其理解为给 Claude 的工作指南而非不可违反的规则。实际工作流示例场景一初始化新项目# 1. 在项目根目录启动 Claude Code cd my-project claude # 2. 生成记忆文件骨架 /init # 3. 审查并完善生成的 CLAUDE.md /memory # 打开文件编辑 # 4. 开始工作Claude 会自动积累记忆场景二记录调试发现你记住运行集成测试前必须先启动 Docker Compose Claude好的我已将这条记录到 Auto Memory 中。下次会话Claude 会自动知道这个依赖关系。场景三团队协作将项目根目录的CLAUDE.md提交到 Git 仓库——团队中每个人的 Claude 助手都会读取相同的规范实现一致的 AI 辅助体验。git add CLAUDE.md git commit -m feat: add Claude Code memory configuration最佳实践总结场景推荐做法团队共享规范项目根目录的 CLAUDE.md提交到 Git个人偏好~/.claude/CLAUDE.md用户级模块特定规则子目录 CLAUDE.md让 Claude 自学开启 Auto Memory口头告知偏好临时告知上下文docs/filename.md按需引用不要塞进 CLAUDE.md任务跟踪在 Markdown 文件中使用[ ]复选框参考资源官方文档Memory SystemClaude Code 概览Prompt Engineering 指南❤️❤️❤️本人水平有限如有纰漏欢迎各位大佬评论批评指正如果觉得这篇文对你有帮助的话也请给个点赞、收藏下吧非常感谢! Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧