CLAUDE.md 文件

它解决的问题

当您在没有 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 保持精简，只包含必要的信息。当您准备好后，运行 /init，让 Claude 为您生成一个。

总结

一次令人沮丧的 Claude Code 会话和一次高效的会话之间的区别，往往取决于上下文——而 CLAUDE.md 文件正是您提供这种上下文的方式。从您的技术栈、偏好和命令开始，然后随着使用逐步完善它。