群发资讯网

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

0 前言在和 Claude 一起做开发项目时,上下文管理非常关键。你的项目里可能有几十甚至上百个文件,但 Claude
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? @authClaude 会先给你一个和 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 文件。 本文已收录在Github,关注我,紧跟本系列专栏文章,咱们下篇再续! 魔都架构师 | 全网30W技术追随者 大厂分布式系统/数据中台实战专家 主导交易系统百万级流量调优 & 车联网平台架构 AIGC应用开发先行者 | 区块链落地实践者 以技术驱动创新,我们的征途是改变世界! 实战干货:编程严选网