Claude Code 提示词技巧：写出好指令，效果提升10倍

数字彩云 · 工具深度拆解系列 | Claude Code 修炼手册 第5篇（共7篇）

---

你有没有遇到过这种情况——

明明用的是同一个工具，别人写代码像开了挂，你用起来却总觉得 AI 在「猜」你想要什么？

问题不在工具，在你的提示词。

今天这篇文章，就是帮你彻底搞懂：怎样给 Claude Code 下指令，才能让它精准理解、高效执行。

---

一、为什么提示词这么重要？

Claude Code 和网页版 ChatGPT 不一样——它不只是聊天，它会直接操作你的文件。

一句模糊的指令，可能导致：

• 改错了文件
• 漏掉了关键步骤
• 反复修改浪费时间

一句精准的指令，可以：

• 一次性完成复杂任务
• 自动生成完整代码结构
• 无需人工干预，自动测试提交

提示词质量 = 工作效率。

---

二、有效提示词 vs 无效提示词

场景	❌ 无效提示词	✅ 有效提示词
写功能	"帮我写个登录"	"在 src/auth/ 目录下，用 Express + JWT 实现登录接口，需要：1) 手机号+密码登录 2) token 过期时间 24h 3) 错误码规范"
修 Bug	"这段代码有 bug"	"运行 npm test 时，user.test.js 第 23 行报 TypeError: Cannot read property 'name' of undefined，请定位原因并修复"
重构	"优化一下代码"	"把 utils/helpers.js 中重复的日期格式化逻辑提取为独立函数 formatDate()，保持所有调用处不变，添加 JSDoc 注释"
解释	"这段什么意思"	"逐行解释 src/middleware/auth.js 中 verifyToken 函数的逻辑，特别说明过期和签名无效两种情况的处理差异"

看出区别了吗？有效提示词 = 具体上下文 + 明确目标 + 可验收标准。

---

三、3 个场景提示词模板

? 场景一：开发新功能

在 [目录路径] 下实现 [功能名称]，要求：

技术栈：[框架/库]
核心逻辑：
1. [步骤1]
2. [步骤2]
3. [步骤3]

约束条件：
- [约束1，如：兼容 Node 18]
- [约束2，如：不用任何第三方依赖]
- [约束3，如：遵循项目已有的代码风格]

完成后运行 [测试命令] 验证。

实战示例：

在 src/api/ 下实现「短链接生成」接口，要求：

技术栈：Express + nanoid
核心逻辑：
1. 接收长链接，生成 8 位短码
2. 存入 Redis，过期时间 30 天
3. 短码访问时 301 重定向到原链接

约束条件：
- 遵循项目已有的错误码规范
- 接口路径：POST /api/shorten, GET /api/:code
- 添加请求参数校验

完成后运行 npm test 验证。

---

? 场景二：代码审查与修复

审查 [文件路径] 的代码，关注以下问题：

1. [关注点1，如：SQL 注入风险]
2. [关注点2，如：内存泄漏]
3. [关注点3，如：错误处理是否完善]

对每个发现的问题：
- 说明严重程度（高/中/低）
- 给出修复方案
- 直接修改代码

修改后运行 [测试命令] 确认无回归。

实战示例：

审查 src/services/payment.js 的代码，关注以下问题：

1. 金额计算是否有浮点精度问题
2. 并发下单是否有竞态条件
3. 错误处理是否覆盖所有异常路径

对每个发现的问题：
- 说明严重程度（高/中/低）
- 给出修复方案
- 直接修改代码

修改后运行 npm run test:payment 确认无回归。

---

? 场景三：项目初始化与脚手架

创建一个 [项目类型] 项目，项目名 [名称]，要求：

目录结构：
[描述或画出目录树]

技术选型：
- 框架：[xxx]
- 语言：[xxx]
- 包管理：[npm/pnpm/yarn]

必须包含：
1. [如：ESLint + Prettier 配置]
2. [如：Dockerfile]
3. [如：.env.example]
4. [如：README.md 含启动说明]

初始化完成后，运行 [命令] 验证项目可以正常启动。

---

四、写出好提示词的 5 个原则

原则 1：给上下文，别让 AI 猜

❌ "写个接口" ✅ "在 src/api/user.js 中，用 Express Router 写一个 GET /api/user/:id 接口"

Claude Code 会读取你的项目文件，但你得告诉它从哪开始。

原则 2：拆步骤，别一口气说太多

❌ "帮我做一个完整的用户管理系统" ✅ "第一步：设计用户表结构 → 第二步：写注册接口 → 第三步：写登录接口"

复杂任务拆成步骤，Claude Code 会逐步执行，出错了也容易定位。

原则 3：给约束，别让 AI 自由发挥

❌ "优化这段代码" ✅ "把时间复杂度从 O(n²) 降到 O(n)，不能引入新依赖，保持函数签名不变"

约束越多，结果越可控。

原则 4：要验证，别改完就算了

❌ "修一下这个 bug" ✅ "修完运行 npm test 确认全部通过，如果测试失败就继续修"

让 AI 自己验证结果，形成闭环。

原则 5：用 CLAUDE.md 建立长期记忆

在项目根目录创建 CLAUDE.md 文件，写上：

• 项目的技术栈和架构
• 代码规范（缩进、命名、文件组织）
• 常用命令（启动、测试、部署）
• 已知的技术债和注意事项

这样每次 Claude Code 启动都会自动读取，不用每次重复说明。

---

五、常见错误提示词（避坑）

? 过于笼统

"帮我做网站" → AI 不知道做什么网站、用什么技术

? 缺少目标

"看看这个文件" → 看完然后呢？要优化？要修复？要解释？

? 一次性提太多要求

"同时写前端、后端、数据库、测试" → 建议拆成多次对话

? 不给文件路径

"改一下那个配置" → 哪个配置？哪个文件？

? 忽略环境差异

"按最新语法写" → 你的 Node 版本支持吗？先说清楚运行环境

---

六、进阶技巧：多步骤任务怎么描述

当任务超过 3 步时，用这种格式：

任务：[总体目标]

执行步骤：
1. [步骤1 + 预期输出]
2. [步骤2 + 预期输出]
3. [步骤3 + 预期输出]

每步完成后暂停，等我确认再继续。

关键：加上「每步暂停确认」，这样你可以中途调整方向，避免一条路走到黑。

---

小结

原则	一句话
给上下文	告诉 AI 在哪做、用什么做
拆步骤	复杂任务分步执行
给约束	限定范围，结果更可控
要验证	改完跑测试，形成闭环
建记忆	用 CLAUDE.md 省去重复说明

提示词不是「写作文」，是「下指令」——越具体，越精准，越高效。

---

? 本系列共 7 篇，明天第 6 篇：Claude Code 优缺点全面分析，值不值得用？看完你决定

关注「数字彩云」，每天 21:00 准时更新 ?