让 Claude Code 输出质量翻倍的 5 个提示词技巧【含实例】

前言

Claude Code 的输出质量与你编写提示词的方式直接相关。运用正确的技巧，同一个任务可以从产出”不可用的代码”变为”生产级代码”。

本文将通过 Before/After 对比示例，详细讲解五个你可以立即上手的实用提示词技巧。如果你还没使用过 Claude Code，建议先阅读入门指南。

1. 提供具体的上下文

最有效的技巧是清晰传达任务的背景和目的。Claude Code 可以读取你的项目文件，但无法猜测你的意图。不仅要告诉它”做什么”，还要说明”为什么这样做”，输出的准确性会大幅提升。

Before（不推荐）：

做一个登录功能

After（推荐）：

给这个 Next.js 14 App Router 项目添加邮箱/密码认证的登录功能。
API 路由已在 src/app/api/ 中，用户表通过 Prisma + PostgreSQL 已定义。
认证库使用 NextAuth.js v5。

Before（不推荐）：

修一下 bug

After（推荐）：

修复 src/components/UserList.tsx 中的 bug：
在 useEffect 获取用户列表时，组件卸载后仍调用 setState 导致警告。
请使用 AbortController 添加清理逻辑。

2. 分步下达指令

一次性把大量任务丢给 Claude Code，它容易失去全局视角。把复杂工作有意识地拆分为多个阶段，确认每一步完成后再进行下一步。

Before（不推荐）：

做一个完整的商品管理系统。要列表、详情、创建、编辑、删除、
图片上传、分类管理、库存管理和搜索筛选，全部都要。

After（推荐）：

我们分阶段构建商品管理功能。第一步，请创建商品 CRUD API：

- POST /api/products（创建）
- GET /api/products（列表，支持分页）
- GET /api/products/:id（详情）
- PUT /api/products/:id（更新）
- DELETE /api/products/:id（删除）

验证使用 zod，数据库使用 src/lib/db.ts 中现有的 Prisma 客户端。

Before（不推荐）：

把测试全写了

After（推荐）：

为 src/utils/calculatePrice.ts 编写单元测试。
先从正常场景的测试用例开始，覆盖以下内容：
- 基础价格计算
- 折扣率应用（10%、20%、50%）
- 含税计算（税率 10%）
使用 Vitest，遵循 tests/ 目录中的现有模式。

3. 明确指定输出格式

明确说明编程语言、框架、编码风格和其他格式要求，可以显著减少返工。特别要注意明确 TypeScript 类型定义和错误处理模式。

Before（不推荐）：

创建一个 API 客户端

After（推荐）：

在 src/lib/api-client.ts 中创建一个外部支付 API 的客户端类。

要求：
- TypeScript strict mode 兼容的类型定义
- 基于 fetch（不使用 axios）
- 自定义错误类（PaymentApiError）用于错误处理
- 重试逻辑（最多 3 次，指数退避）
- 使用泛型定义响应类型
- 为所有 public 方法添加 JSDoc 注释

Before（不推荐）：

做个 React 组件

After（推荐）：

在 src/components/DataTable.tsx 中创建一个可复用的表格组件。

- 客户端组件（"use client"），非 React Server Component
- Props 使用泛型接收列定义
- 支持排序和分页
- 使用 Tailwind CSS 样式，匹配 src/components/Button.tsx 中的设计 Token
- 无障碍：正确设置 WAI-ARIA table role

4. 引用现有代码库

Claude Code 最大的优势之一是能理解你的整个项目。通过明确指示它遵循现有代码来最大化利用这一能力。指出具体的文件路径会更加有效。

Before（不推荐）：

添加新的 API 端点

After（推荐）：

参照 src/app/api/users/route.ts 的模式，
在 src/app/api/orders/route.ts 创建订单管理 API 端点。

沿用现有 users API 的以下模式：
- Zod schema 验证
- try-catch 错误处理
- NextResponse 返回方式
- Prisma 查询写法

Before（不推荐）：

做个设置页面

After（推荐）：

以 src/app/dashboard/profile/page.tsx 为参考，
新建 src/app/dashboard/settings/page.tsx。

保持相同的布局结构（DashboardLayout 组件、Breadcrumb、
PageHeader 的用法），同时添加通知设置和安全设置的表单。
表单管理使用与 profile 页面相同的 react-hook-form + zod 组合。

5. 通过反馈循环迭代改进

不要期望一次就得到完美结果。通过与 Claude Code 的对话逐步提高质量。把初始输出当作基础，提供具体的、可操作的反馈。

Before（不推荐）：

不对，重做

After（推荐）：

谢谢。请修改两处：
1. handleSubmit 函数中，区分网络错误和验证错误，
   分别向用户显示不同的提示信息
2. 将简单的 spinner 加载状态替换为
   src/components/Skeleton.tsx 中的骨架屏 UI

Before（不推荐）：

做得更好一点

After（推荐）：

请从性能角度优化。具体来说：
1. 对商品列表渲染应用 React.memo 防止不必要的重新渲染
2. 为搜索输入添加 debounce（300ms）
3. 实现图片懒加载
请在每个修改处添加注释，方便我评估对 Lighthouse 分数的影响。

总结

回顾五个技巧：

提供具体上下文，让 Claude Code 准确理解你的意图
分步拆解任务，控制每次交互的范围
明确输出格式，最大限度减少返工
引用现有代码，保持项目一致性
迭代反馈，逐步提高质量

每个技巧单独使用都很有效，但组合运用才能真正发挥威力。在 CLAUDE.md 文件中编写项目规则可以减少每次提示中需要包含的信息量，进一步提升效率。

更多高级用法请参阅Claude Code 生产力最大化技巧集。

关于提示词工程的基础理念，推荐阅读 Anthropic 官方提示词工程指南。