第六节

上下文管理

掌握 Claude Code 的核心技能：提供恰到好处的信息

在使用 Claude Code 进行编程工作时，上下文管理至关重要。 你的项目可能有数十甚至数百个文件，但 Claude 只需要正确的信息就能有效地帮助你。

重要提示：过多无关的上下文实际上会降低 Claude 的表现。学会引导它找到相关文件和文档是必不可少的技能。

/init 命令

当你在新项目中首次启动 Claude 时，建议先运行 /init 命令。 这会让 Claude 分析你的整个代码库并理解：

1
项目的目的和架构
2
重要的命令和关键文件
3
代码模式和结构
4
开发约定和风格
终端
$ claude
# Claude Code 启动后
> /init

当 Claude 请求创建文件的权限时，你可以按 Enter 批准每个写操作， 或按 Shift+Tab 允许 Claude 在整个会话中自由写入文件。

CLAUDE.md 文件

分析完成后，Claude 会创建一个 CLAUDE.md 文件。 这个文件有两个主要作用：

引导 Claude 理解代码库

指出重要的命令、架构和编码风格，帮助 Claude 更快找到相关代码

自定义指令

允许你给 Claude 特定的或自定义的指示

关键点：这个文件会包含在你对 Claude 发出的每个请求中，就像为你的项目设置了一个持久的系统提示词。

CLAUDE.md 文件位置

Claude 识别三个不同位置的 CLAUDE.md 文件：

1
CLAUDE.md项目级
  • • 通过 /init 命令生成
  • • 提交到源代码管理（如 Git）
  • • 与其他工程师共享
  • • 包含项目特定的指示
2
CLAUDE.local.md本地级
  • • 不与其他工程师共享
  • • 包含个人指令和定制
  • • 仅适用于你自己
3
~/.claude/CLAUDE.md全局级
  • • 适用于你机器上的所有项目
  • • 包含你希望 Claude 在所有项目中遵循的指令

# 记忆模式

你可以通过添加指令来定制 Claude 的行为。使用 # 命令进入"记忆模式"—— 这让你可以智能地编辑 CLAUDE.md 文件。

示例：减少代码注释
> # Use comments sparingly. Only comment complex code.

Claude 会自动将这条指令合并到你的 CLAUDE.md 文件中。例如，如果你觉得 Claude 在代码中添加了太多注释， 你可以用这种方式来调整它的行为。

@ 文件引用

当你需要 Claude 查看特定文件时，使用 @ 符号后跟文件路径。 这会自动将该文件的内容包含在你对 Claude 的请求中。

示例：询问认证系统
> How does the auth system work? @auth

Claude 会显示与 auth 相关的文件列表供你选择，然后将选定的文件包含在对话中。 这是一种将 Claude 指向特定方向的绝佳技巧。

在 CLAUDE.md 中引用文件

你也可以在 CLAUDE.md 文件中使用相同的 @ 语法直接引用文件。当你这样引用文件时， 其内容会自动包含在每个请求中，因此 Claude 可以立即回答相关问题，而无需每次都搜索和读取该文件。

CLAUDE.md 中的示例
The database schema is defined in the @prisma/schema.prisma file.
Reference it anytime you need to understand the structure of
data stored in the database.

本节要点总结

/init 命令

首次使用时运行，让 Claude 理解项目结构

CLAUDE.md 文件

项目级、本地级、全局级三种配置文件

# 记忆模式

快速添加自定义指令到配置文件

@ 文件引用

精确指向特定文件，提供恰当的上下文