Claude Code 开箱即用效果不错，但一旦它了解你的项目约定并养成一些提示词习惯，效果会明显提升。本指南涵盖两方面内容。
第 1 部分 — CLAUDE.md：你的项目记忆
它是什么
CLAUDE.md 是一个纯 Markdown 文件，Claude 在该目录中的每个会话开始时会自动读取。把它想象成你会给一位能干的新队友在他们第一个早上所做的简报：团队如何做事、要避免什么，以及重要部分在哪里。
你不需要在提示词中引用它或手动附加它。如果文件存在，Claude 已经读过了。
它在哪里
Claude 在几个地方查找并合并发现的内容，从广泛到具体：
位置 | 范围 | 适用于 |
| 你机器上的每个项目 | 个人偏好（例如，"我使用 pnpm，不用 npm" 或 "总是建议测试"）。 |
| 这个项目 | 架构、约定和命令。这是主要的。 |
| 那个子目录 | 模块特定规则（例如， |
大多数团队只需要项目根目录文件。将其提交到 git，这样整个团队都能受益。
它如何加载（以及成本如何）
CLAUDE.md 在会话开始时读取一次，并逐字放入 Claude 的系统提示中。没有摘要或截断，也不会在每个回合从磁盘重新读取；相同的内容在整个对话中保持在上下文中。如果你在会话中途编辑文件，更改不会生效，直到你开始新会话。
对于 Claude for Enterprise 客户，成本情况比"在每个请求上加载"听起来要好。Claude Code 对系统提示应用 Anthropic 的提示缓存，其中包括 CLAUDE.md。会话中的第一个请求支付文件的完整输入令牌价格；大约五分钟内的后续请求会命中缓存，按低得多的缓存读取率计费。缓存是内容寻址的，所以对 CLAUDE.md 的任何更改都会使其失效，下一个请求再次支付全价。
实际上，这意味着一个相当大的 CLAUDE.md 每个会话支付一次完整令牌，加上任何足够长的空闲间隙后支付一次（足以让缓存过期），而不是每条消息一次。保持文件精简以节省上下文窗口空间和信噪比仍然值得，但你不需要仅为了控制每条消息的支出而限制行数。在 Enterprise 使用仪表板中，文件的占用空间几乎完全显示为缓存读取令牌，而不是标准输入令牌。
入门：运行 /init
在任何项目中，输入 /init。Claude 将探索代码库并为你起草一个 CLAUDE.md，涵盖构建命令、测试命令、结构概览和它检测到的任何约定。审查草稿，删除任何不准确的内容，并提交。这大约需要五分钟，但会永久获得回报。
实际上应该包含什么
目标是一个简短且信息密集的文件——最多几百行。每一行都在每个请求上加载到上下文中，所以每一行都应该值得其成本。
值得包含：
命令 — 如何构建、测试、lint 和本地运行。Claude 会执行这些，所以准确性很重要。
约定 — 命名、错误处理、文件布局和"我们使用 X，不用 Y"的决定。
三句话的架构 — 主要部分是什么以及它们如何通信。
硬约束 — 例如，"永远不要从测试中写入生产数据库，"
已知陷阱 — 每个新工程师都会遇到的问题。
不值得包含：
完整的 API 文档（Claude 可以直接读取代码）。
更新日志或历史记录。
文件树中已经很明显的任何内容。
团队实际上不遵循的理想规则。
多久更新一次
把它当作一个活的入职文档，而不是规范。
在
/init之后 — 审查一次以清理生成的草稿。当 Claude 两次出错时 — 这是一个信号，表示缺少一条规则。添加一行来解决它。
当约定改变时 — 例如，新框架、测试运行器或一组新的 lint 规则。
季度浏览 — 删除任何过时的内容，因为过时的说明比没有更糟。
你也可以在会话中途添加：输入 # 后跟一条指令（例如 # 总是使用 async/await，永远不要 .then()），Claude 会为你提供将其附加到正确 CLAUDE.md 的选项。
第 2 部分 — 在 Claude Code 中值得养成的提示词习惯
这些不是通用的提示词工程技巧；它们是当 Claude 读取和编辑真实代码库时最重要的习惯。
1. 陈述结果，而不是步骤
Claude 可以自己探索代码库。告诉它你想要什么和为什么，让它自己找出在哪里。
❌ "打开 userService.ts，找到 validate 函数，在第 42 行添加空值检查。"
✅ "没有电子邮件的用户在验证步骤中崩溃。让它优雅地处理这个问题并添加一个测试。"
2. 给它完整的错误信息
粘贴完整的堆栈跟踪，而不是总结它。确切的文件名、行号和消息是允许 Claude 快速找到正确位置的关键。
3. 用计划模式先确定大任务的范围
对于涉及多个文件的任何事情，按 Shift+Tab 进入计划模式并询问：
计划你如何向公共 API 添加速率限制。暂时不要改变任何东西。
审查计划，在对话中调整它，然后切换模式并说"执行第 1 步。"这会在误解变成十二文件差异之前捕获它。
4. 当你已经知道文件时指向它们
Claude 可以自己搜索代码库，但如果你已经知道相关文件，就说出来 — 这样更快，使用的令牌更少。使用 @ 来引用路径，例如 @src/auth/login.ts。
5. 说出"完成"是什么样子
例如"测试通过，"
6. 一个对话一个任务；在它们之间 /clear
长会话会积累噪音。当你从"修复登录错误"切换到"重构计费模块"时，运行 /clear 并重新开始。你的 CLAUDE.md 会向前传递持久上下文，所以聊天历史不需要。
7. 像对待同事一样纠正它，而不是搜索引擎
如果第一个答案不对，你不需要重新表述整个请求。只需说出什么是错误的 — 例如，"这改变了公共 API；保持签名相同。"Claude 会保留其他所有内容并仅调整该点。
快速参考
想要… | 这样做 |
生成起始 |
|
查看 Claude 正在使用的内存 |
|
在会话中途添加规则 | 输入 |
重新开始但保留项目记忆 |
|
在提示词中引用特定文件 |
|