ClaudeCode实战(04)-添加上下文

本文已收录在Github，关注我，紧跟本系列专栏文章，咱们下篇再续！

• 🚀 魔都架构师 | 全网30W技术追随者
• 🔧 大厂分布式系统/数据中台实战专家
• 🏆 主导交易系统百万级流量调优 & 车联网平台架构
• 🧠 AIGC应用开发先行者 | 区块链落地实践者
• 🌍 以技术驱动创新，我们的征途是改变世界！
• 👉 实战干货：编程严选网

0 前言

在和 Claude 一起做开发项目时，上下文管理非常关键。你的项目里可能有几十甚至上百个文件，但 Claude 真正需要的是“对的问题 + 对的信息”。如果塞给它太多不相关上下文，反而会影响表现。所以，学会把它引导到相关文件和文档上，是高效使用 Claude 的核心能力。

1 /init 命令

当你第一次在一个新项目里启动 Claude 时，先运行/init命令，会让 Claude 分析整个代码库，并理解：

• 项目的目标和架构
• 重要命令与关键文件
• 代码模式和组织结构

完成分析后，Claude 会生成一份摘要并写入CLAUDE.md文件。当 Claude 请求创建这个文件时：

• 可按 Enter 逐次批准每次写入
• 也可按 Shift+Tab，让 Claude 在当前会话中自由写文件

2 CLAUDE.md 文件

主要有两个作用：

• 给 Claude 提供你的代码库导览，告诉它关键命令、架构和代码风格
• 让你向 Claude 提供具体或自定义的指令

这个文件会被自动带入你发给 Claude 的每一次请求，所以它很像你项目里的“长期系统提示”。

3 CLAUDE.md 文件位置

Claude 会识别 3 个常见位置的CLAUDE.md文件：

1. CLAUDE.md（项目级配置文件）

• 生成方式：通过/init命令生成。
• 版本控制：提交至源代码控制系统（如 Git），便于团队协作。
• 共享范围：与其他工程师共享，确保团队成员使用一致的配置和指令。

2. CLAUDE.local.md（本地个性化配置文件）

• 共享范围：不与其他工程师共享，仅限本地使用。
• 内容用途：包含个人指令和针对 Claude 的定制化设置，适用于个人工作流或特定偏好。

3. ~/.claude/CLAUDE.md（全局配置文件）

• 适用范围：适用于机器上所有项目，具有全局作用域。
• 内容用途：包含希望 Claude 在所有项目中遵循的通用指令，如全局编码规范、安全策略或常用工具配置。

4 添加自定义指令

可在CLAUDE.md里添加指令，来自定义 Claude 的行为。

如果 Claude 总是给代码加太多注释，就可以通过更新这个文件来约束它。

使用#命令可以进入“memory mode (记忆模式)”，从而更智能地编辑CLAUDE.md文件。你只要输入类似：

# Use comments sparingly. Only comment complex code.

Claude 就会自动把这条指令合并进你的CLAUDE.md文件。

5 @引用文件

当你希望 Claude 查看某个具体文件时，可用@+ 文件路径。这样会自动把该文件内容加入这次请求。

如想问认证系统的实现，并且知道相关文件，可以这样输入：

How does the auth system work? @auth

Claude 会先给你一个和 auth 相关的文件列表供你选择，然后把你选中的文件加入对话上下文。

6 CLAUDE.md 引用文件

也可在CLAUDE.md中用同样的@语法直接引用文件。这个方法特别适合那些在项目多个模块里都会用到的关键文件。

如你有一个定义数据结构的数据库模式 (schema) 文件，可以在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.

这样引用后，该文件内容会自动加入每次请求。Claude 就能立刻回答与你的数据结构相关的问题，而不必每次都重新搜索并读取 schema 文件。