Claude Code 三大核心机制:CLAUDE.md / Memory / Skill
1. CLAUDE.md — 项目指令
- 作用:项目级的持久化指令文件,每次对话自动加载
- 内容:项目架构、编码规范、运行命令、工具说明、注意事项等
- 范围:针对当前代码仓库,所有使用该项目的对话都会遵循
- 类比:相当于项目的 "使用说明书",告诉 Claude 怎么在这个项目里工作
2. Memory — 跨对话记忆
- 作用:持久化存储跨对话的上下文信息,未来对话可回忆
- 内容:用户偏好、反馈纠正、项目动态、外部资源引用等
- 范围:绑定到用户+项目维度,跨会话持续累积
- 类比:相当于 Claude 的 "笔记本",记住用户是谁、喜欢什么、之前发生了什么
- 与 CLAUDE.md 区别:CLAUDE.md 是人工编写的静态指令,Memory 是 Claude 自动维护的动态记忆
2.1 Memory 存储位置
Memory 存储在用户目录下,路径结构为:
~/.claude/projects/memory/
2.2 Memory 能否跨项目共用?
不能。Memory 按 用户 + 项目路径 隔离,每个项目有独立的 memory 目录。
如果需要跨项目共享信息,可以使用:
- 全局 CLAUDE.md:放在
~/.claude/CLAUDE.md,所有项目对话都会加载 - 全局 Settings:通过
~/.claude/settings.json配置全局行为
3. Skill — 可复用的技能模板
- 作用:封装复杂的多步操作流程为可复用的技能,通过
/skill-name调用 - 内容:SKILL.md 定义触发条件、执行步骤、工具调用逻辑
- 范围:可跨项目共享和发布
- 类比:相当于 "标准操作手册 (SOP)",定义 Claude 如何完成特定类型的任务
4. 对比总结
| CLAUDE.md | Memory | Skill | |
|---|---|---|---|
| 解决什么 | 项目怎么用 | 用户是谁/历史上下文 | 特定任务怎么做 |
| 谁维护 | 人工编写 | Claude 自动维护 | 人工编写 |
| 生命周期 | 跟随代码仓库 | 跟随用户+项目 | 独立可复用 |
| 加载时机 | 每次对话自动加载 | 按需回忆 | 按触发词/命令调用 |
| 存储位置 | 项目根目录 ./CLAUDE.md | ~/.claude/projects/<path>/memory/ | skills/<name>/SKILL.md |
| 跨项目共享 | 支持(放 ~/.claude/CLAUDE.md) | 不支持(项目隔离) | 支持(可发布复用) |