Vibe Coding
返回 Claude Code

Claude Code / 核心概念

Claude Code 记忆

记忆用于保留稳定偏好和项目规则，但事实来源仍应是仓库、配置和命令输出。

查看官方来源文档目录
Claude Code 记忆 核心概念信息图
Claude Code 记忆 核心概念信息图

Claude 如何记住项目

Claude Code 的记忆主要来自 CLAUDE.md 文件和自动记忆。CLAUDE.md 适合稳定项目上下文，自动记忆适合从历史会话沉淀出的经验。

记忆不是数据库事实源。项目事实、命令和团队约定应优先写进仓库里的 CLAUDE.md 或规则文件；个人偏好可以放在用户级 CLAUDE.md；临时敏感信息不要写入记忆。

放在哪里

不同范围有不同文件位置。范围越大，内容越应该稳定、短小、可执行。

位置范围适合内容
~/.claude/CLAUDE.md全局个人个人工作偏好、常用输出格式。
项目 CLAUDE.md当前项目/团队项目命令、架构、测试、协作约定。
CLAUDE.local.md本机私有不该提交的个人项目偏好。
.claude/rules路径匹配只在相关文件触发的短规则。

怎么写有效记忆

有效记忆应该像给新同事的项目手册：短、明确、可验证。不要写 Claude 通过读代码就能知道的内容。

  • 写真实命令，而不是“运行测试”。
  • 写非默认代码风格和项目特有坑。
  • 写重要边界，例如不要改支付、不要直接 deploy。
  • 把长教程和 API 文档改成链接或技能引用。

完整使用要点

补充官方文档中容易被压缩遗漏的核心概念、操作顺序、权限边界和验证要求，方便中文学习者按页面完整学习。

记忆系统补充

Claude Code 的记忆来自多个层级：用户级 CLAUDE.md、项目 CLAUDE.md、路径规则、自动记忆和当前会话上下文。不同层级服务不同范围，写错位置会造成上下文污染或敏感信息泄露。

项目长期事实写进项目 CLAUDE.md；个人偏好写进用户级文件；机器相关或敏感配置写进 local 文件或环境变量；路径特定约定写进 rules；一次性任务状态留在会话总结里。

有效记忆应该短、稳定、可执行。不要写长教程、密钥、cookie、客户数据、过时部署步骤。Claude 能通过读代码获得的信息，不需要全部写进记忆。

学习检查清单

把本页内容落到真实任务中，用入口、上下文、权限、验证和团队规则五个维度检查是否真正掌握。

学习检查清单

读完本页后，不要只记住概念名。你应该能把“Claude Code 记忆”放回 Claude Code 的真实工程流程里：任务从哪里发起，系统会加载什么上下文，哪些动作需要审批，结果如何验证，失败时如何回退。

如果这是概念页面，要特别确认它如何影响真实任务：它改变上下文、权限、执行路径、验证方式，还是改变团队协作流程。

  • 能用自己的话说明本页解决的具体问题，而不是只复述标题。
  • 能写出一个最小示例任务，并标明目标、范围、禁止事项和验收标准。
  • 能判断哪些信息应该放进当前提示，哪些应该沉淀到项目规则或配置里。
  • 能说明哪些长期规则应该写进 CLAUDE.md，哪些运行行为应该交给 settings、permissions、Hooks、Skills 和 MCP。
  • 能在任务完成后检查 diff、命令输出、测试结果、截图或 PR 说明，而不是只相信自然语言总结。

如果要把本页用于团队培训，可以让学员用 Claude Code 完成一个小任务：先只读解释，再提交计划，再执行最小改动，最后用真实验证命令和人工 diff 审查收尾。