意图、语境与共鸣:解密 Claude Code 的“读心”艺术

0 阅读3分钟

使用 Claude 进行编码项目时,上下文管理至关重要。您的项目可能包含数十甚至数百个文件,但 Claude 只需要正确的信息就能有效地帮助您。过多的无关上下文实际上会降低 Claude 的性能,因此学习如何引导它找到相关的文件和文档至关重要。

图片

/init 命令

    首次在新项目中启动 Claude 时,请运行该 /init 命令。这将指示 Claude 分析您的整个代码库并了解:

  • 项目的目的和建筑
  • 重要命令和关键文件
  • 编码模式和结构

图片

    Claude 分析完你的代码后,会生成一份摘要并将其写入CLAUDE.md文件。当 Claude 请求创建此文件时,你可以按 Enter 键批准每次写入操作,或者按 Shift+Tab 键允许 Claude 在整个会话期间自由写入文件。

CLAUDE.md 文件

    该CLAUDE.md文件主要有两个用途:

  • 引导 Claude 浏览你的代码库,指出重要的命令、架构和编码风格。
  • 允许您给克劳德提供具体或自定义的指示

这个文件会包含在你向 Claude 发出的每个请求中,所以它就像是你的项目有一个持久的系统提示符。

CLAUDE.md 文件位置

    claude识别出了CLAUDE.md位于三个常见位置的三个不同文件:

图片

  • CLAUDE.md - 使用 /init 生成,已提交到源代码控制系统,并与其他工程师共享
  • CLAUDE.local.md - 未与其他工程师共享,包含 Claude 的个人说明和自定义设置。
  • ~/.claude/CLAUDE.md - 用于计算机上的所有项目,包含您希望 Claude 在所有项目中遵循的指令

添加自定义说明

    您可以通过在文件中添加指令来自定义 Claude 的行为CLAUDE.md。例如,如果 Claude 向代码添加了过多注释,您可以通过更新文件来解决此问题。

    使用#命令进入“内存模式”——这样你就可以CLAUDE.md智能地编辑文件。只需输入类似这样的命令:

# Use comments sparingly. Only comment complex code.

Claude 会自动将此指令合并到您的CLAUDE.md文件中。

文件提及(使用“@”)

    需要 Claude 查看特定文件时,请使用@符号后跟文件路径。这样会自动将该文件的内容包含在发送给 Claude 的请求中。

    例如,如果您想查询身份验证系统,并且知道相关文件,您可以输入:

How does the auth system work? @auth

    Claude 会向您显示一个与身份验证相关的文件列表供您选择,然后将选定的文件包含在您的对话中。

CLAUDE.md 中的文件引用

    您也可以CLAUDE.md使用相同的@语法直接在文件中引用文件。这对于与项目多个方面都相关的文件尤其有用。

    例如,如果您有一个定义数据结构的数据库模式文件,您可以将以下内容添加到您的文件中CLAUDE.md

数据库模式定义在@prisma/schema.prisma文件中。每当需要了解数据库中存储的数据结构时,可随时参考该文件。

    以这种方式提及文件时,其内容会自动包含在每个请求中,因此 Claude 可以立即回答有关您的数据结构的问题,而无需每次都搜索和读取模式文件。