CLAUDE.md 文件
Claude Code 中最有用的功能之一就是 CLAUDE.md 文件。它为 Claude Code 提供了关于您项目的持久记忆。
它解决的问题
当您在没有 CLAUDE.md 文件的情况下打开 Claude Code 时,它每次都会从头开始。它必须重新探索您的代码库,弄清楚需要哪些依赖项,并理解哪些功能已经实现。有时它会做出假设,这使得引导 Claude 朝正确方向发展变得更加困难。
CLAUDE.md 解决了这个问题。它是一个您添加到项目根目录的 Markdown 文件,Claude Code 每次启动会话时都会自动读取它。可以把它想象成您代码库的入职说明脚本。CLAUDE.md 文件的内容会被附加到您的提示中。
示例
以下是一个典型的 CLAUDE.md 文件示例:
# Project
This is a Next.js 15 app using the App Router, Tailwind, and Drizzle ORM.
# Commands
- Dev server: `pnpm dev`
- Run tests: `pnpm test`
- Lint: `pnpm lint`
# Code Style
- Use 2-space indentation
- Prefer named exports
- All API routes go in app/api/
- Use server actions instead of API routes where possible非常简单。现在,如果您要求 Claude Code 创建一个 React 组件,它已经知道要使用 Tailwind 进行样式设计,并遵循您的代码约定。

CLAUDE.md 适用于团队
您可以(也应该)将 CLAUDE.md 提交到版本控制中,这样您的团队也能从中受益。实际上,根据适用对象的不同,存在一个内存文件的层级结构:
-
项目级 CLAUDE.md 位于项目的根目录中。与团队共享。
-
用户级 CLAUDE.md 位于您的配置文件夹中。这个文件只针对您本人,适用于您的所有项目。在这里放置您的个人偏好设置。
技巧
将纠正内容保存到记忆中。 如果您发现自己反复纠正 Claude——比如告诉它始终使用服务器操作(server actions)而不是 API 路由——请明确要求 Claude 将该规则保存到记忆中。下次您打开项目时,它就会知道了。

引用项目文档。 如果您的项目中有希望 Claude 参考的文档,请使用 @ 符号加上文件路径:
## README.md
Please read if you need more info: @README.md从没有 CLAUDE.md 开始。 我们建议您在开始一个项目时不要使用 CLAUDE.md 文件,这样您可以观察自己经常需要纠正模型的地方。这能让您的 CLAUDE.md 保持简洁,只包含必要的信息。当您准备好后,运行 /init 让 Claude 为您生成一个。
立即尝试
选择一个没有 CLAUDE.md 的项目,运行 /init。阅读 Claude 写的内容,删掉任何您不会费心告诉新队友的行。添加一条您发现自己反复纠正的内容,然后开始一个新会话,提出该纠正内容所涉及的请求。Claude 遵循了吗?
总结
一个令人沮丧的 Claude Code 会话与一个富有成效的会话之间的区别,往往归结于上下文——而 CLAUDE.md 文件正是您提供这种上下文的方式。从您的技术栈、偏好设置和常用命令开始,然后随着使用逐步完善它。