这是我日常使用 Claude Code 积累下来的 50 个提示词，按开发场景分类。每个都经过多次实战验证，直接复制修改就能用。
核心原则：好的提示词不是写得长，而是写得准。告诉 Claude Code「做什么」「怎么做」「不做什么」三个要素就够了。
帮我创建一个 [技术栈] 项目，要求：
- 项目名：[名称]
- 包管理器：[pnpm/npm/yarn]
- 需要的依赖：[列出关键依赖]
- 目录结构按照 [约定] 组织
创建完成后，确保能正常运行 dev 命令阅读当前项目的所有配置文件（package.json、tsconfig 等）和目录结构，
生成一份 CLAUDE.md，包含：
- 项目概述（一句话）
- 技术栈清单
- 目录结构说明
- 代码规范（从现有代码中推断）
- 常用命令为当前项目配置 Git 规范：
- 添加 .gitignore（根据技术栈）
- 配置 commitlint（Conventional Commits）
- 添加 husky pre-commit hook 运行 lint
- 创建 .github/pull_request_template.md为这个项目创建 GitHub Actions CI 配置：
- 在 PR 和 push to main 时触发
- 步骤：安装依赖 -> lint -> 类型检查 -> 测试 -> 构建
- Node.js 版本：[22]
- 包管理器：[pnpm]检查当前项目，帮我把开发环境跑起来：
- 安装依赖
- 检查是否有需要的环境变量（创建 .env.example）
- 初始化数据库（如果有）
- 运行开发服务器
- 告诉我访问地址在 [目录] 下创建 [资源名] 的完整 CRUD 接口：
- GET /api/[资源] - 列表（支持分页、搜索）
- GET /api/[资源]/:id - 详情
- POST /api/[资源] - 创建
- PUT /api/[资源]/:id - 更新
- DELETE /api/[资源]/:id - 删除
数据模型字段：[列出字段]
使用项目现有的 [ORM/数据库] 和错误处理规范创建一个 [组件名] 组件：
- 功能：[描述]
- Props：[列出]
- 使用 TypeScript 定义类型
- 使用项目现有的 UI 组件库和样式方案
- 不需要测试文件实现 [表单名称] 页面：
- 字段：[列出所有字段、类型、是否必填]
- 验证规则：[列出]
- 提交到：[API 地址]
- 提交成功后：[跳转/提示]
- 使用项目现有的表单方案为这个项目添加用户登录注册功能：
- 注册：邮箱 + 密码
- 登录：返回 JWT
- 密码加密：bcrypt
- Token 过期时间：7 天
- 添加认证中间件，保护需要登录的路由
不要用第三方认证服务实现文件上传功能：
- 支持的格式：[图片/文档/等]
- 大小限制：[X MB]
- 存储方式：[本地/S3/OSS]
- 返回文件 URL
- 需要认证才能上传给 [页面/模块] 添加搜索功能：
- 搜索字段：[列出可搜索的字段]
- 实现方式：[全文搜索/模糊匹配/精确匹配]
- 需要防抖，延迟 300ms
- 搜索结果高亮匹配文字
- 无结果时显示空状态实现 [数据名称] 导出功能：
- 格式：[Excel/CSV/PDF]
- 包含字段：[列出]
- 支持按条件筛选后导出
- 大数据量使用流式处理
- 文件名格式：[数据名]_[日期].xlsx实现站内通知系统：
- 通知类型：[系统通知/消息通知/等]
- 存储在数据库
- 支持标记已读/全部已读
- 前端用小红点显示未读数
- 不需要实时推送，刷新获取即可为现有路由添加 RBAC 权限控制：
- 角色：[admin/editor/viewer]
- 权限定义：[列出每个角色能做什么]
- 后端：中间件检查权限
- 前端：根据角色隐藏/禁用按钮
- 权限配置集中管理，不要散落在各处创建一个定时任务：
- 执行频率：[每天/每小时/cron 表达式]
- 任务内容：[描述要做什么]
- 失败处理：记录日志，[重试/告警]
- 使用 [node-cron/bull/agenda]这个功能有 Bug：[描述现象]
预期行为是：[描述预期]
实际行为是：[描述实际]
相关代码在 [文件路径]
请先定位原因，解释为什么会出现这个问题，然后修复运行 tsc --noEmit 有类型错误，帮我修复。
要求：
- 不要用 any 绕过
- 不要用 @ts-ignore
- 如果是第三方库类型问题，可以加类型声明文件[页面/组件] 的样式有问题：
- 现象：[描述，比如"在手机上文字溢出"]
- 预期：[描述预期效果]
- 浏览器：[Chrome/Safari/全部]
只改 CSS，不要改 HTML 结构调用 [接口地址] 报错 [错误码/错误信息]。
请求参数是：[列出]
帮我检查：
1. 参数是否正确
2. 后端逻辑是否有问题
3. 数据库查询是否正确
找到问题后修复[页面/功能] 很卡，帮我优化：
- 现象：[列表滚动卡顿/页面加载慢/接口响应慢]
- 数据量：[大概多少条数据]
先分析原因，再给出优化方案，方案要具体可执行应用运行一段时间后内存持续上升。
帮我检查代码中可能的内存泄漏点：
- 未清理的定时器
- 未取消的事件监听
- 未关闭的数据库连接
- 循环引用
重点检查 [可疑文件/模块][功能描述] 在并发请求时出现数据不一致。
帮我分析竞态条件，并通过 [加锁/事务/乐观锁] 解决。
不要用 setTimeout 这种 hack 方式前端 [地址] 调用后端 [地址] 报 CORS 错误。
帮我在后端正确配置 CORS：
- 允许的源：[列出]
- 允许的方法：GET, POST, PUT, DELETE
- 允许 credentials
不要设置 Access-Control-Allow-Origin: *[文件路径] 太大了（[X] 行），帮我合理拆分：
- 按职责拆分成多个文件
- 保持导入关系清晰
- 拆分后确保功能不变
- 更新所有引用这个文件的地方以下几个文件有重复逻辑：
- [文件1]：[描述重复部分]
- [文件2]：[描述重复部分]
- [文件3]：[描述重复部分]
帮我提取到公共模块，然后让原来的地方调用公共模块把 [目录/模块] 下的命名统一规范化：
- 文件名：[kebab-case/PascalCase]
- 变量名：[camelCase]
- 类型名：[PascalCase + 后缀]
- 更新所有引用项目中用了过时的 [API/库/模式]，帮我升级：
- 旧方式：[描述]
- 新方式：[描述]
- 全局搜索所有用到旧方式的地方，逐一替换
- 替换后运行测试确保没问题[功能] 的数据库查询太慢，帮我优化：
- 当前查询：[描述或贴代码]
- 数据量：[大概规模]
- 优化方向：[加索引/减少查询次数/优化 JOIN]
修改后解释为什么新方案更快[功能] 目前是同步的，耗时太长，改为异步：
- 把耗时操作放到后台队列
- 前端改为：提交后显示"处理中"，轮询或回调获取结果
- 使用 [bull/agenda/自建队列]当前 [页面/模块] 的状态管理很混乱，帮我重构：
- 把组件内部状态和全局状态分开
- 服务端数据使用 [React Query/SWR]
- 客户端状态使用 [Zustand/Pinia]
- 删除不再需要的状态给 [文件路径] 写单元测试：
- 覆盖所有公开函数
- 包含正常情况和边界情况
- Mock 外部依赖（数据库、网络请求）
- 使用 [Jest/Vitest]
- 文件放在 [路径]给 [路由文件] 的所有接口写集成测试：
- 测试正常请求和异常请求
- 测试认证（有 token / 无 token / 过期 token）
- 测试参数验证
- 使用 supertest
- 每个测试用独立的测试数据给 [组件] 写测试：
- 测试渲染是否正确
- 测试用户交互（点击、输入、提交）
- 测试条件渲染
- 测试 Props 变化后的行为
- 使用 Testing Library，不要测试实现细节用 [Playwright/Cypress] 给 [功能] 写端到端测试：
- 场景：[描述用户操作流程]
- 验证：[列出需要验证的结果]
- 处理异步等待，不要用固定 sleep运行 [覆盖率命令] 查看当前测试覆盖率。
找出覆盖率最低的文件，优先补充以下场景的测试：
- 未覆盖的分支
- 边界条件
- 错误处理路径
目标覆盖率：[X%]审查 [文件/目录] 的代码：
- 有没有 Bug 或潜在问题
- 有没有安全漏洞（注入、XSS 等）
- 有没有性能问题
- 命名和结构是否清晰
列出问题，按严重程度排序，每个问题给出修复建议对 [文件/模块] 做安全审查：
- 检查 SQL 注入、XSS、CSRF 风险
- 检查敏感信息是否暴露
- 检查认证和授权是否正确
- 检查输入验证是否完整
找到问题后直接修复审查以下代码变更（列出改动文件或贴 diff）：
- 逻辑是否正确
- 是否有遗漏的场景
- 是否符合项目规范
- 给出改进建议检查 package.json 中的依赖：
- 有没有已知安全漏洞
- 有没有可以移除的未使用依赖
- 有没有可以升级的大版本
- 有没有更好的替代方案审查 [页面/组件] 的可访问性：
- 图片是否有 alt
- 表单是否有 label
- 颜色对比度是否足够
- 键盘能否正常操作
- 是否有正确的 ARIA 属性
找到问题后直接修复阅读 [路由目录] 下的所有接口，生成 API 文档：
- 按模块分组
- 每个接口包含：方法、路径、参数、响应示例、错误码
- 格式：Markdown
- 输出到 docs/api.md给 [组件目录] 下的所有公共组件写使用文档：
- 组件功能说明
- Props 表格（名称、类型、默认值、说明）
- 使用示例代码
- 注意事项根据项目配置，生成部署文档：
- 环境要求
- 环境变量清单
- 构建步骤
- 部署命令
- 健康检查
- 回滚方案阅读最近 [N] 个 commit，生成 CHANGELOG：
- 按版本分组
- 分类：新功能 / 修复 / 改进 / 破坏性变更
- 每条简短描述，不要贴 commit hash给 [文件] 中复杂的函数添加注释：
- 只给难以理解的逻辑加注释
- 说明"为什么"而不是"做了什么"
- 不要给 get/set 这种一目了然的方法加注释
- 使用 JSDoc 格式我是新接手这个项目，帮我快速了解：
- 这个项目是做什么的
- 核心目录结构
- 数据怎么流动的
- 从哪个文件开始看
用 3 分钟能读完的篇幅回答线上报了这个错误：
[贴错误日志]
帮我分析：
1. 错误原因
2. 影响范围
3. 修复方案
4. 如何避免再次发生帮我写一个 [数据库迁移/种子数据/查询脚本]：
- 目的：[描述]
- 表/集合：[名称]
- 操作：[描述具体操作]
- 用项目的 ORM 写，不要写原生 SQL项目跑不起来，报错：
[贴错误信息]
帮我排查：
- 依赖是否安装完整
- 环境变量是否配置
- 端口是否被占用
- Node/Python 版本是否匹配需要在整个项目中做以下批量修改：
- 把所有 [旧写法] 改成 [新写法]
- 涉及的文件可能很多，请全局搜索
- 修改后确保没有遗漏
- 不要改 node_modules 和 dist 目录给上下文：不要说”写一个组件”，说”在 src/components/ 下，用项目现有的 Tailwind 方案写一个组件”
给约束：不要说”优化性能”，说”首屏加载时间从 3s 降到 1s 以内，不要改变现有的技术栈”
给反例：不要说”写好代码”，说”不要用 any、不要用 @ts-ignore、不要把所有逻辑塞在一个函数里”
分步骤：复杂任务拆成多步，每步确认后再继续。不要一次性扔一大段需求
验证结果：改完后让 Claude Code 跑测试或构建，确保改动没有引入新问题
一个好的提示词通常包含这几个部分：
[做什么] - 明确的任务描述
[在哪做] - 文件路径或模块
[怎么做] - 技术方案或约束
[不做什么] - 禁止事项
[验证方式] - 怎么确认做完了不是每次都需要写全，简单任务两三行就够。关键是信息明确，不让 Claude Code 猜。
每周更新 Claude Code 实战技巧、工具对比、行业动态。回复「模板」获取 CLAUDE.md 模板合集。