1. 项目概述：Claude Code 与它的“记忆中枢”

如果你在VSCode里用过GitHub Copilot或者Cursor，那你对AI辅助编程肯定不陌生。但Claude Code带来的体验，有点不一样。它不是简单地在你敲代码时蹦出几个补全建议，而是试图成为你项目里一个“有记忆、有理解”的长期伙伴。这个系列课程的第二讲，我们要深入的就是这个伙伴的“大脑”——记忆系统，以及它的核心配置文件CLAUDE.md。

简单来说，Claude Code的记忆系统，就是它用来记住你的项目背景、编码习惯、技术栈偏好以及那些琐碎但重要的项目细节的能力。而CLAUDE.md文件，就是这个记忆系统的“存储介质”和“操作手册”。它不像.cursorrules那样更多是约束性的规则，CLAUDE.md更像是一份写给AI的、关于“如何理解并参与这个项目”的详尽说明书。这解决了AI工具在复杂、长期项目中常见的“健忘症”和“上下文失忆”问题——每次新开一个聊天窗口或处理不同文件时，你不需要再把项目背景、架构图、API密钥格式等重复说一遍。

这套机制特别适合谁呢？首先是独立开发者或小团队，你们可能同时维护多个技术栈迥异、业务逻辑复杂的项目，频繁切换上下文成本极高。其次是参与大型遗留代码库改造的工程师，你需要让AI快速理解那些没有文档的“祖传代码”的潜规则。最后，任何希望将AI编程助手的使用从“一次性问答”提升到“持续性协作”层面的开发者，都会从这套记忆系统中获益。

2. 记忆系统核心原理与架构拆解

要有效利用Claude Code的记忆系统，不能只停留在“创建一个CLAUDE.md文件”的层面，必须理解其背后的工作原理。这套系统并非魔法，其核心是一个基于“文件感知”与“上下文预加载”的混合架构。

2.1 文件感知与上下文预加载机制

当你打开一个项目文件夹时，Claude Code会主动扫描根目录及常见子目录（如src/,docs/）下的特定文件。优先级最高的是CLAUDE.md，其次是像README.md,ARCHITECTURE.md,package.json,requirements.txt等能揭示项目信息的文件。Claude Code会解析这些文件的内容，并将其中的关键信息（如项目描述、技术栈、运行命令、目录结构）提取并结构化，形成一个初始的“项目上下文模型”。

这个模型不是静态的。当你聚焦于某个特定文件进行编辑或向Claude提问时，系统会执行“上下文预加载”。例如，如果你正在编辑src/components/Button.tsx并向Claude询问：“如何给这个按钮添加加载状态？”，Claude Code会自动将以下内容纳入本次交互的上下文：

1. 全局项目上下文：从CLAUDE.md等文件提取的、与UI组件相关的约定（如使用的CSS框架、状态管理库）。
2. 相关文件上下文：自动引入Button.tsx的同目录文件、其父组件可能引用的文件、以及项目内关于“加载状态”的模式定义文件（如果能在CLAUDE.md中定义相关路径模式的话）。
3. 会话历史摘要：对当前聊天会话中已讨论过的要点进行压缩摘要，避免超出模型的上下文窗口限制。

这种机制的关键在于“相关性判断”。Claude Code并非盲目地将整个项目文件都塞给模型，而是试图智能地选取最相关的信息。CLAUDE.md在这里扮演了“相关性定义指南”的角色，你可以通过它明确告诉AI：“当处理前端组件时，请参考src/styles/theme.ts和src/types/index.ts”。

2.2. CLAUDE.md 的文件结构与语义层

CLAUDE.md是一个Markdown文件，但其结构有隐含的最佳实践。它通常包含以下几个语义层：

1. 项目身份层 (Project Identity)：位于文件开头，用最简洁的语言定义项目是什么。例如：# 项目：E-Commerce Backend API (Node.js + TypeScript + Prisma)。这一层帮助AI在最初几秒内建立正确的心智模型。
2. 核心指令层 (Core Directives)：这是文件的“宪法”，规定了AI参与项目时必须遵守的最高原则。使用## 指令或## 核心原则作为标题。内容应是强制性的、无歧义的陈述句。

   ## 核心原则 - **语言**：所有代码、注释、提交信息必须使用英文。 - **风格**：严格遵守项目中的 ESLint (Airbnb) 和 Prettier 配置。 - **安全**：绝对禁止在代码中硬编码任何敏感信息（API密钥、数据库密码）。所有配置必须通过环境变量 `env` 文件管理。 - **异步优先**：所有I/O操作（数据库查询、API调用）必须使用 `async/await`，禁止使用回调函数。

3. 知识库层 (Knowledge Base)：这是记忆系统的“硬盘”，存储了项目特有的、静态的、需要被反复引用的知识。通常用## 项目上下文或## 架构来组织。

   ## 项目架构 - **模式**：基于领域驱动设计（DDD），`src/` 目录按 `domain/`, `application/`, `infrastructure/` 组织。 - **数据库**：使用 PostgreSQL，ORM 是 Prisma。数据模型定义在 `prisma/schema.prisma`。 - **API 设计**：RESTful 风格，响应格式统一为 `{ success: boolean, data: any, message?: string }`。错误处理使用中心化的中间件，定义在 `src/middleware/errorHandler.ts`。 - **身份验证**：使用 JWT，令牌通过 `Authorization: Bearer <token>` 头传递。刷新令牌的逻辑在 `src/auth/refreshToken.service.ts`。

4. 工作流与习惯层 (Workflow & Conventions)：描述动态的、过程性的知识。例如如何运行测试、如何创建新模块、Git分支策略、代码审查要点等。

   ## 开发工作流 1. **启动**：`npm run dev` 启动开发服务器，`npm run db:studio` 打开Prisma数据库管理界面。 2. **创建新API端点**： - 在 `src/application/controllers/` 创建控制器。 - 在 `src/domain/services/` 创建领域服务。 - 在 `src/infrastructure/repositories/` 创建仓储实现。 - 路由定义在 `src/routes/index.ts` 中汇总。 3. **测试**：单元测试放在 `__tests__` 目录，与源文件同级。运行 `npm test` 执行所有测试。

这种分层结构使得CLAUDE.md既包含了“硬性规定”，也包含了“软性知识”，让AI能像一个熟悉项目历史和新手引导流程的资深队友一样与你协作。

注意：CLAUDE.md的内容质量直接决定记忆系统的有效性。模糊、矛盾或过时的信息会导致AI给出错误建议。应将其视为重要的项目文档，随项目演进而更新。

3. CLAUDE.md 的实战编写与高级技巧

知道了结构，我们来动手写一份真正能提升效率的CLAUDE.md。一份优秀的CLAUDE.md应该是精确、可操作且易于维护的。

3.1 从零开始构建一份高效的 CLAUDE.md

我们以一个假设的“全栈待办事项应用（Next.js + FastAPI）”为例，演示构建过程。

第一步：定义项目骨架与绝对规则在项目根目录创建CLAUDE.md，开头立即确立不可动摇的规则。

# 项目：TodoFullStack - 全栈待办事项应用 **技术栈**：Next.js 14 (App Router) 前端，FastAPI 后端，PostgreSQL 数据库，Prisma ORM，部署在 Vercel (前端) 和 Railway (后端)。 ## 🚨 绝对规则 (Non-negotiable Rules) 1. **安全性第一**： - **绝不**在代码、注释或日志中暴露 `DATABASE_URL`、`JWT_SECRET` 等环境变量值。 - 所有API端点，除了登录和注册，都必须有有效的JWT令牌验证（参考 `src/middleware/auth.py`）。 - 用户输入必须经过验证（使用Pydantic模型）和清理。 2. **代码风格一致性**： - **前端**：严格遵守项目中的 `.eslintrc.json` 和 `.prettierrc`。使用函数组件和React Hooks，优先使用 `useState`, `useEffect`。 - **后端**：使用类型注解。遵循PEP 8。异步函数使用 `async/await`。 - **命名**：变量/函数使用 `camelCase`，组件使用 `PascalCase`，常量使用 `UPPER_SNAKE_CASE`。 3. **单一数据源**：前端状态管理 **仅使用** React Context API（定义在 `src/context/TodoContext.jsx`）。禁止引入额外的状态管理库（如Redux, MobX）。

第二步：注入项目专属的“领域知识”这部分是AI理解你项目“业务逻辑”的关键。

## 🧠 项目核心上下文 (Core Context) ### 数据模型 (Prisma Schema) 核心实体关系如下（详见 `prisma/schema.prisma`）： - **User**: `id`, `email`, `hashed_password`, `created_at` - **Todo**: `id`, `title`, `description?`, `completed` (Boolean), `due_date?` (DateTime), `user_id` (关联 User), `category_id?` (关联 Category) - **Category**: `id`, `name`, `color` (Hex String), `user_id` (关联 User) **重要业务规则**： - 用户只能操作（增删改查）自己的待办事项和分类。 - `Todo.due_date` 字段为空表示无截止日期。 - 前端显示待办事项时，按 `completed`（未完成在前）、`due_date`（即将到期在前）排序。 ### API 契约 (Backend-Frontend Contract) - **基础URL**: `https://api.todoapp.example.com` (开发环境为 `http://localhost:8000`) - **认证**：登录成功返回 `{ access_token, token_type: "bearer" }`。后续请求需在Header中设置 `Authorization: Bearer <access_token>`。 - **统一响应格式**： ```json { "status": "success" | "error", "data": { ... }, // 成功时的数据 "message": "..." // 错误时的描述信息（仅当status为error时） }

• 关键端点示例：
  • GET /api/todos：获取当前用户的待办事项列表。
  • POST /api/todos：创建新的待办事项，请求体需包含title。
  • PATCH /api/todos/{id}：更新待办事项（如标记完成）。

**第三步：描述开发习惯与工作流** 让AI知道你们团队是怎么做事的。 ```markdown ## ⚙️ 开发工作流与惯例 (Workflow & Conventions) ### 前端 (Next.js) - **组件创建**：新组件创建在 `src/components/` 下。每个组件应有自己的目录，包含 `index.jsx`（主组件）和 `ComponentName.module.css`（CSS模块）。 - **页面路由**：使用App Router，页面定义在 `src/app/` 下。`page.jsx` 是页面组件，`layout.jsx` 是布局，`loading.jsx` 是加载状态。 - **API调用**：所有对后端API的调用，请使用 `src/lib/apiClient.js` 中封装的 `axios` 实例，它已自动处理Token附加和基础URL。 ### 后端 (FastAPI) - **模块化**：相关路由和模型放在同一模块目录下，如 `src/routers/todos.py`, `src/models/todo.py`。 - **依赖注入**：数据库会话通过FastAPI的 `Depends` 获取，参考 `src/dependencies/database.py`。 - **错误处理**：使用自定义异常类（在 `src/exceptions.py`），并在 `src/main.py` 中用全局异常处理器捕获。 ### 通用流程 1. **启动开发**：分别在前端 (`/frontend`) 和后端 (`/backend`) 目录运行 `npm run dev` 和 `uvicorn src.main:app --reload`。 2. **数据库迁移**：修改 `schema.prisma` 后，运行 `npx prisma migrate dev --name <migration_name>`。 3. **提交信息**：使用Conventional Commits格式，如 `feat: add user authentication endpoint`。

3.2 动态指令与条件上下文

CLAUDE.md的高级用法在于“动态性”。你可以通过注释或特定标记，为不同场景下的AI行为提供微调指令。

场景化指令块：你可以定义一些仅在特定条件下才被激活的指令。

## 🎯 场景化指令 (Contextual Directives) <!-- 当处理或讨论 `src/components/` 下的任何文件时，激活以下指令 --> ### [当上下文涉及：前端UI组件] - **优先考虑**：可访问性（ARIA属性）、响应式设计、CSS模块化。 - **避免**：内联样式、直接操作DOM。 - **检查清单**：组件是否接收了不必要的props？是否提取了可复用的逻辑为自定义Hook？ <!-- 当处理或讨论 `src/routers/` 或 `src/models/` 下的任何文件时，激活以下指令 --> ### [当上下文涉及：后端API与数据] - **首要任务**：验证输入数据（使用Pydantic）、处理数据库事务异常、记录适当的日志（使用 `src/core/logger.py`）。 - **性能提示**：数据库查询是否使用了合适的索引？N+1查询问题是否存在？ - **安全提醒**：检查当前操作是否进行了用户权限验证（`current_user` 依赖项）。

文件路径模式匹配：你可以在指令中暗示AI关注特定文件。

## 📁 关键文件参考 (Key File References) - **数据库配置与模型**：`prisma/schema.prisma`, `src/core/database.py` - **身份验证逻辑**：`src/routers/auth.py`, `src/middleware/auth.py`, `src/core/security.py` (密码哈希) - **前端状态管理**：`src/context/TodoContext.jsx` - **API客户端与配置**：`src/lib/apiClient.js`, `frontend/.env.local.example`

当AI被问到关于“用户登录状态管理”的问题时，它会优先去查看TodoContext.jsx和auth.py这些被“点名”的文件，从而给出更精准的答案。

实操心得：不要试图在CLAUDE.md里写一本百科全书。它的核心价值在于提供“精确的导航”和“关键的约束”。对于极其复杂的业务逻辑，更好的做法是维护一份独立的ARCHITECTURE.md或BUSINESS_RULES.md，然后在CLAUDE.md中引用它。保持CLAUDE.md的简洁和可维护性，它才能随着项目快速演进。

4. 记忆系统的实战应用与效能提升

配置好CLAUDE.md只是开始，如何在实际编码、调试、重构中让记忆系统发挥最大威力，才是关键。

4.1 日常编码与重构中的记忆调用

当你进行日常开发时，Claude Code的记忆系统主要在以下几个场景静默工作：

1. 代码补全与生成：当你在src/components/TodoList.jsx中键入const { todos, loading } = use时，Claude Code不仅会补全useContext(TodoContext)，而且因为它“记得”TodoContext的定义和提供的值结构，它可能会进一步建议你进行错误处理：const { todos, loading, error } = useContext(TodoContext); if (error) return <ErrorDisplay message={error} />;。这种补全超越了语法层面，进入了业务逻辑层面。

2. 跨文件上下文理解：假设你正在编写一个新的后端端点POST /api/todos/{id}/subtasks。你向Claude提问：“需要参考现有的子任务相关模型吗？” 得益于记忆系统，Claude Code会：

• 首先，从CLAUDE.md中知道数据模型定义在prisma/schema.prisma。
• 然后，自动读取该文件，并定位到SubTask模型的定义。
• 同时，它可能发现CLAUDE.md里提到了“用户只能操作自己的数据”，因此会在生成的代码骨架中，自动加入基于current_user的权限验证逻辑。
• 最后，它还可能提示你：“在src/routers/todos.py中有一个类似的嵌套路由POST /api/todos/{id}/tags，你可以参考它的结构。”

3. 大规模重构的辅助：当你决定将前端的CSS从模块化迁移到Tailwind CSS时，这是一个影响广泛的改动。你可以直接向Claude描述任务：“我想将项目中所有.module.css文件替换为Tailwind CSS类名。请先分析Button.jsx和TodoItem.jsx作为示例，并总结一个转换规则。” Claude Code会：

• 理解“所有”指的是src/components/目录下的文件。
• 读取CLAUDE.md，确认当前项目没有禁止使用Tailwind的规则。
• 分析你指定的示例文件，理解原有CSS类名与组件结构的对应关系。
• 生成一份具体的、针对你项目样式的转换建议报告，例如：“.header类可能对应flex justify-between items-center p-4”，而不是给你一个通用的、可能不准确的Tailwind速查表。

4.2 调试与问题排查中的上下文利用

调试是记忆系统大放异彩的场景。传统的AI助手在你贴入一段错误日志时，只能进行通用分析。而拥有记忆的Claude Code，能结合你的项目特异性进行诊断。

场景模拟：前端控制台报错：TypeError: Cannot read properties of undefined (reading 'map')，错误指向TodoList.jsx第25行。

没有记忆的AI：可能会给出泛泛的建议：“检查todos变量是否为数组，可能在数据获取完成前它还是undefined，建议使用可选链todos?.map或条件渲染。”

拥有记忆的Claude Code，其诊断过程会更深入：

1. 定位问题文件：它知道TodoList.jsx位于src/components/。
2. 回忆数据流：从CLAUDE.md和项目文件中，它回忆起todos来源于TodoContext(src/context/TodoContext.jsx)。
3. 检查数据源：它会进一步分析TodoContext的初始化状态和更新逻辑。它发现上下文初始值可能是{ todos: null, loading: false }。
4. 关联API契约：结合CLAUDE.md中“统一响应格式”的描述，它知道后端API成功时返回{ status: “success”, data: [...] }。
5. 给出精准建议：它的回答将不再是通用的，而是高度定制化的：

   “错误源于TodoContext中todos的初始值为null。根据CLAUDE.md中定义的API响应格式，你在apiClient.js中提取数据时，可能直接返回了response.data，而正确的应该是response.data.data（第一个data是Axios响应体，第二个是业务数据）。请检查src/lib/apiClient.js中响应拦截器的逻辑，确保正确解构了data字段。同时，在TodoList.jsx中，建议的修复是：{todos && todos.length > 0 ? todos.map(...) : <EmptyState />}，这符合项目中已有的条件渲染模式。”

这种诊断将项目特定的架构、数据流和API约定都考虑在内，直接指向最可能的根本原因，极大缩短了调试时间。

4.3 与 Cursor Rules 的协同与差异化管理

很多开发者会同时使用多个AI编码工具。常见的问题是：CLAUDE.md和 Cursor 的.cursorrules是什么关系？会不会冲突？

定位差异：

• .cursorrules：更像一份“代码风格宪法”和“即时操作指令集”。它强于定义严格的代码格式（缩进、命名）、在特定操作时自动执行任务（如在创建新组件时自动生成测试文件）、或设置全局禁用项（如“禁止使用any类型”）。它的作用域通常是整个编辑器/工作区，指令更偏向于“强制执行”。
• CLAUDE.md：更像一份“项目背景手册”和“协作伙伴指南”。它强于提供业务上下文、架构知识、团队习惯和动态的工作流指引。它的作用域是单个项目，内容更偏向于“信息提供”和“引导”。

协同策略：最佳实践是让它们各司其职，互补而非重复。

1. 通用规则放.cursorrules：将那些放之四海而皆准的规则放在这里。例如：

   // .cursorrules { “rules”: { “useTypeScriptStrict”: true, “preferConstOverLet”: true, “functionNamingConvention”: “camelCase”, “autoImport”: true // 自动导入 } }

2. 项目特定知识放CLAUDE.md：所有关于这个特定项目的东西——技术栈选型理由、数据库模型关系、业务逻辑细节、团队内部约定的工作流——都写入CLAUDE.md。
3. 避免冲突：如果在.cursorrules中规定了“使用双引号”，而在某个项目的CLAUDE.md里因为历史原因写明了“本项目使用单引号”，那么在该项目内，Claude Code会优先遵循CLAUDE.md的指示，因为它更具体。但更好的做法是在.cursorrules中设置项目覆盖的例外，或者直接在CLAUDE.md中说明“代码格式遵循根目录的.cursorrules，但字符串引号使用单引号是本项目特例”。

这样管理，.cursorrules确保了你在任何项目中的基本编码纪律，而CLAUDE.md则让你在每个项目里都像有一个熟悉内情的老手在旁辅助。

5. 常见问题、优化策略与避坑指南

即使理解了原理，在实际使用中仍会遇到各种问题。下面是一些高频问题的实录与解决方案。

5.1 记忆失效与上下文混淆问题排查

问题1：Claude Code 似乎“忘记”了CLAUDE.md里的内容，给出的建议与项目规范不符。

• 可能原因A：文件未正确加载。
  • 检查：确认CLAUDE.md文件位于项目的根目录。Claude Code通常只扫描根目录下的该文件。
  • 检查：打开VSCode命令面板 (Ctrl+Shift+P)，输入Claude Code: Open Context Files或类似命令（具体命令名可能因版本而异），查看当前哪些文件被加载为上下文。确保你的CLAUDE.md在列表中。
  • 解决：如果不在，尝试重启VSCode或重新加载Claude Code扩展。有时需要手动在Claude Code的侧边栏或设置中“附加”当前文件夹。
• 可能原因B：CLAUDE.md内容过于冗长或结构混乱。
  • 检查：AI模型有上下文长度限制。虽然Claude Code会智能摘要，但一个数万字的、结构松散的CLAUDE.md可能导致关键信息被淹没。
  • 解决：重构你的CLAUDE.md。采用清晰的标题层级（#,##,###）。将最核心、最常用的规则放在文件最前面。将详细的架构图、API文档等移入独立的docs/目录，在CLAUDE.md中仅做链接引用。例如：## 详细架构图请参阅 [docs/architecture.drawio]。
• 可能原因C：会话主题偏离当前项目。
  • 现象：如果你在一个聊天会话中先讨论了项目A，然后又切换到项目B的文件进行提问，AI的上下文可能还残留着项目A的信息。
  • 解决：对于关键任务，最好开启一个新的、干净的聊天会话。或者，在提问时明确重置上下文，例如开头说：“我们现在专注于项目B。根据项目B的CLAUDE.md规则...”

问题2：AI给出的代码建议混合了不同技术栈或风格。

• 可能原因：CLAUDE.md中存在矛盾或过时的指令。
  • 案例：你早期在CLAUDE.md里写“使用Axios进行HTTP请求”，但后来团队迁移到了fetchAPI，却没有更新CLAUDE.md。AI可能会看到旧代码中使用Axios，而新代码中使用fetch，从而产生混淆。
  • 解决：定期（如每个迭代周期）审查和更新CLAUDE.md，使其与代码库现状保持一致。删除过时的指令，更新技术栈描述。这是一个活文档。

5.2 性能调优与最佳实践

1. 保持CLAUDE.md的精炼与模块化

• 原则：它不是项目文档的垃圾桶。只放AI需要主动记忆和频繁引用的内容。
• 做法：
  • 核心规则（必须遵守的）放在最前面。
  • 架构概述用要点列表，而非长篇大论。
  • 详细文档外链：将完整的API文档、部署手册、复杂业务流程图等放在docs/下，在CLAUDE.md中提供精确的Markdown链接。Claude Code有能力在需要时去读取这些链接指向的文件。
  • 按角色/模块拆分：对于超大型项目，可以考虑维护多个CLAUDE-<模块名>.md文件，并在根CLAUDE.md中通过条件指令引导AI读取。例如：<!-- 当处理支付相关代码时，请优先参考CLAUDE-PAYMENT.md-->。

2. 主动引导与精准提问记忆系统是工具，你的提问方式是使用这个工具的“接口”。

• 低效提问：“这个函数怎么写？”（过于宽泛）
• 高效提问：“根据CLAUDE.md中关于API响应的格式和错误处理中间件的描述，请为POST /api/orders端点编写控制器函数。需要验证请求体中的items数组不为空，并调用OrderService.create服务。记得处理数据库异常并记录日志。”
• 技巧：在问题中直接引用CLAUDE.md中的章节或关键词，能有效激活相关的记忆。例如：“按照‘开发工作流’里创建新组件的惯例，帮我生成一个UserProfile组件。”

3. 利用“提及”功能强化记忆在聊天中，当你提到一个特定的文件、函数或变量时，使用反引号或直接提及，可以帮助Claude Code更准确地锁定上下文。

• 例如：“在src/utils/validation.js里有一个validateEmail函数，我现在在src/components/SignupForm.jsx里需要用到它，并且要添加一个密码强度校验，该怎么组织代码？”
• 这样的提问方式，直接为AI指明了需要参考的精确代码位置，结合CLAUDE.md中的项目规则，它能给出高度集成的建议。

5.3 安全与隐私边界注意事项

重要警告：这是使用任何AI编程工具都必须高度警惕的方面。

1. 绝对不要将真实密钥、密码、令牌写入CLAUDE.md或任何会被AI索引的代码注释中。即使你后来删除了，它们也可能留存在AI服务的上下文缓存或日志中。始终使用环境变量或配置文件，并在CLAUDE.md中说明如何设置，例如：“JWT_SECRET必须通过.env文件设置，详见.env.example。”
2. 小心内部业务逻辑：如果项目涉及未公开的商业逻辑、专有算法或敏感数据模型，评估是否有必要将其详细写入CLAUDE.md。你可以进行一定程度的抽象化描述，仅提供AI理解代码所必需的最小信息，而非全部细节。
3. 代码片段的分享：当你将从Claude Code获得的代码建议分享到公共论坛（如GitHub、Stack Overflow）时，务必手动审查，确保没有无意中泄露通过记忆系统带入的、包含内部信息的代码片段。
4. 依赖第三方模型的风险：Claude Code的记忆处理依赖于其背后的AI模型（如Claude）。你需要了解，这些上下文信息会被发送到模型服务提供商进行处理。对于极度敏感的项目，这可能构成风险。对于这类项目，或许仅使用CLAUDE.md来管理公开的、不敏感的开发规范，而避免将核心业务逻辑写入其中。

记忆系统是Claude Code从“工具”迈向“协作者”的关键一步。CLAUDE.md则是你与这位协作者之间的沟通协议。花时间精心编写和维护这份协议，就像为一位新队友进行详尽的入职培训。初期投入的半小时，将在未来数百次的编码、调试和重构中，为你节省无数个小时的重复解释和上下文切换，换来的是高度精准、深度融入项目语境的智能辅助。