没有记忆的 AI 有多低效?

每次启动 Claude Code,默认情况下它就像一个刚入职的新同事——聪明但完全失忆。你不得不反复交代基础信息:用什么语言、数据库选型、API 偏好……大量时间浪费在重复沟通上。

对比一下有无 CLAUDE.md 的体验差距:

没有 CLAUDE.md:

你:帮我写一个自动爬取热门推特的功能。
Claude:好的,你打算用什么编程语言?
你:Python。
Claude:用 Tweepy、Selenium 还是官方 API?
你:官方 API。
Claude:你有 API key 了吗?还是要用免费版的?
你:……(10 分钟后还在回答基础问题)

有 CLAUDE.md:

(CLAUDE.md 中已写明:Python + Twitter API v2 + MySQL)
你:帮我写一个自动爬取热门推特的功能。
Claude:好的,我来用 Python 调取官方 Twitter API v2……

CLAUDE.md 本质上是一个特殊的 Markdown 文件,Claude Code 每次启动时会自动读取其内容,并注入到系统提示(System Prompt)中,成为 AI 思考的底层上下文。相当于给 AI 配了一本永久生效的"入职手册"。

三步上手:给 Claude Code 装上记忆

CLAUDE.md 不会自动创建,需要手动配置。但上手非常简单,甚至可以让 Claude 自己来完成。

方式一:自动初始化

在项目根目录下,直接输入 /init 命令。Claude 会自动分析项目结构,生成一个包含基本信息的 CLAUDE.md 文件。

方式二:快速添加记忆

在对话中,输入内容前加上 # 号即可。例如输入 # 记住我的服务器地址是 XXX,然后选择存入 CLAUDE.md。

方式三:直接编辑

输入 /memory 命令,会在编辑器中打开 CLAUDE.md 文件,可以进行更详细的编辑和整理。

进阶:记忆分层与模块化

CLAUDE.md 背后有一套完整的设计哲学,支持三个层级的记忆管理:

  • 用户级~/.claude/CLAUDE.md):存放个人偏好,如"我偏好 Python 而非 Java",在所有项目中全局生效。
  • 项目级<项目根目录>/CLAUDE.md):存放项目专属信息,如技术栈、构建命令。可提交到 Git,团队成员共享一致的上下文,是协作利器。
  • 企业级/Library/Application Support/ClaudeCode/Claude.md):公司层面的安全与合规要求,由管理员统一配置。

加载顺序为"企业 → 项目 → 用户",后加载的覆盖先加载的——个人偏好拥有最高优先级。

用导入语法实现模块化

项目复杂度增长后,CLAUDE.md 不必变得臃肿。通过 @ 导入语法,可以将其他文件的内容引入 CLAUDE.md,实现记忆的模块化管理。主文件保持简洁,同时链接到完整的知识网络。

写在最后

CLAUDE.md 改变的不只是效率,而是人与 AI 的协作模式——它让 Claude 从一次性的问答工具,变成了一个真正理解你项目背景的长期搭档。花 10 分钟完成配置,未来每一次对话都能省去大量重复沟通。对于独立开发者来说,这可能是 Claude Code 中投入产出比最高的一项设置。