添加上下文
在编程项目中与 Claude 合作时,上下文管理至关重要。你的项目可能有数十个或数百个文件,但 Claude 只需要正确的信息来有效地帮助你。太多不相关的上下文实际上会降低 Claude 的性能,因此学会引导它关注相关文件和文档是必不可少的。
/init 命令
当你第一次在新项目中启动 Claude 时,请运行 /init命令。这告诉 Claude 分析你的整个代码库并了解:
-
• 项目的目的和架构 -
• 重要命令和关键文件 -
• 编码模式和结构
在分析你的代码后,Claude 创建一个摘要并将其写入 CLAUDE.md文件。当 Claude 请求创建此文件的权限时,你可以按 Enter 来批准每个写操作,或者按 Shift+Tab 让 Claude 在整个会话中自由写入文件。
CLAUDE.md 文件
CLAUDE.md文件有两个主要目的:
-
• 引导 Claude 了解你的代码库,指出重要的命令、架构和编码风格 -
• 允许你给 Claude 特定或自定义的指令
这个文件被包含在你向 Claude 发出的每个请求中,所以它就像为你的项目提供了一个持久的系统提示。
CLAUDE.md 文件位置
Claude 在三个常见位置识别三个不同的 CLAUDE.md文件:
-
• CLAUDE.md- 通过 /init 生成,提交到源代码控制,与其他工程师共享 -
• CLAUDE.local.md- 不与其他工程师共享,包含个人指令和对 Claude 的定制 -
• ~/.claude/CLAUDE.md- 用于你机器上的所有项目,包含你希望 Claude 在所有项目中遵循的指令
添加自定义指令
你可以通过向 CLAUDE.md文件添加指令来自定义 Claude 的行为方式。例如,如果 Claude 在代码中添加了太多注释,你可以通过更新文件来解决这个问题。
使用 #命令进入"记忆模式"——这让你能够智能地编辑你的 CLAUDE.md文件。只需输入类似这样的内容:
# 谨慎使用注释。只注释复杂的代码。
Claude 会自动将此指令合并到你的 CLAUDE.md文件中。
使用 '@' 提及文件
当你需要 Claude 查看特定文件时,使用 @符号后跟文件路径。这会自动将该文件的内容包含在你对 Claude 的请求中。
例如,如果你想询问你的身份验证系统,并且你知道相关文件,你可以输入:
身份验证系统是如何工作的?@auth
Claude 会显示一个与 auth 相关的文件列表供你选择,然后将选定的文件包含在你的对话中。
在 CLAUDE.md 中引用文件
你也可以使用相同的 @语法在你的 CLAUDE.md文件中直接提及文件。这对于与你项目的许多方面相关的文件特别有用。
例如,如果你有一个定义数据结构的数据库模式文件,你可能会在你的 CLAUDE.md中添加:
数据库模式定义在 @prisma/schema.prisma 文件中。任何时候你需要了解数据库中存储的数据结构时都要参考它。
当你以这种方式提及文件时,其内容会自动包含在每个请求中,所以 Claude 可以立即回答关于你的数据结构的问题,而无需每次都搜索和读取模式文件。

