AI 编程约 7 分钟
Claude Code 提示词技巧：CLAUDE.md 怎么写、计划模式怎么用（8 个实操方法）
AI 指南··◉ 0 浏览
Claude Code 的提示词不只是聊天框里的那句话。本篇讲清 CLAUDE.md 分层写法、计划模式和 8 个实测有效的 prompt 技巧，让改码一次到位。
很多人把 Claude Code 当普通聊天机器人用——每次从零描述需求，然后在一轮轮返工里怀疑模型不行。其实差距往往不在模型，在提示词的用法。这篇讲两层：常驻的 CLAUDE.md 和 一次性的任务 prompt，各有一套写法。
CLAUDE.md：你真正该写的系统提示词
CLAUDE.md 是 Claude Code 每次会话自动加载的项目说明文件，相当于常驻记忆。它分三层，越靠近代码优先级越高：
| 位置 | 放什么 |
|---|---|
~/CLAUDE.md（用户级） |
个人偏好：中文回复、 commit 信息风格、常用的解释详略度 |
| 项目根目录 | 项目规范：技术栈、目录结构、启动命令、测试命令、代码风格禁区 |
| 子目录 | 该模块的特别说明（比如「这个目录是生成的代码，不要手改」） |
项目根目录的 CLAUDE.md 推荐写四段：
- 一句话项目定位：这是什么项目、给谁用
- 常用命令：启动、构建、跑测试、lint——写全，让 AI 自己验证时用得上
- 规范和禁区：命名约定、错误处理方式、不许引入新依赖、不许改哪些文件
- 已知坑：比如「测试必须带 -w 参数」「mock 数据在 xxx」
写好这一份文件，等于把每次对话里重复交代的背景全部固化，是性价比最高的一次提示词投入。
8 个实测有效的任务 prompt 技巧
- 先复述再动手：复杂任务先说「先复述你理解的需求和改动计划，我确认后再动手」。Claude Code 的计划模式（Plan Mode，Shift+Tab 切换）就是这个逻辑的官方版
- 给可验证的完成标准：不要说「修好这个 bug」，说「修到
npm test全绿，并贴出运行结果」。有验证标准的任务，AI 不会自己糊弄自己 - 限定改动范围：「只改
src/api/user.ts，其他文件不要动」。范围明确的 prompt 能避免顺手重构 - 让它先读再改：用
@文件路径把相关文件带进上下文，或者说「先通读 xx 模块再给方案」。盲改是事故的主要来源 - 大任务拆阶段：「第一步只做数据层，我确认后再做接口层」。每阶段确认一次，比最后一次性验收 2000 行 diff 靠谱
- 主动管理上下文：长会话变笨时用
/compact压缩历史，换任务直接开新会话。上下文塞太满，再好的 prompt 也救不回来 - 报错给全量信息：贴完整报错日志 + 复现命令 + 你已经试过什么。「报错了帮我看看」是最差的提问方式
- 让它留下决策记录：改完让它补一段简短说明（为什么这么改、放弃了什么方案），方便后续接手的人——包括两周后的你自己
一个可直接套用的任务模板
任务：给用户列表接口加分页
范围：只改 src/api/user.ts 和对应测试文件
背景：项目用 MyBatis-Plus，分页插件已配置
要求：
1. 参数 pageNum/pageSize，默认 1/20
2. 返回结构跟现有接口保持一致
3. 补一个边界用例（pageSize 超过 100）
完成标准：mvn test 通过，贴出结果
先复述你的改动计划，我确认后再写代码。
这套结构（任务 → 范围 → 背景 → 要求 → 完成标准 → 先复述）适用于绝大多数改码任务。
相关阅读
常见问题
CLAUDE.md 放在哪里？
三层都可以：用户级 `~/CLAUDE.md` 放个人偏好；项目根目录放项目规范（最常用）；子目录放模块级说明。越靠近代码优先级越高。
CLAUDE.md 怎么写才有效？
写项目定位、常用命令（启动/测试）、规范禁区、已知坑四段。核心是写给 AI 看的「新人入职文档」，不清楚的事它就不用猜了。
Claude Code 上下文太长变笨怎么办？
长会话用 `/compact` 压缩，切换任务直接开新会话；关键规范放 CLAUDE.md，不依赖对话历史传递。
计划模式（Plan Mode）是什么？
让 Claude Code 先输出完整计划、你确认后再执行的交互模式，适合大改动。日常小改可以直接下指令。
京ICP备2024094994号-29