我写这篇 Claude Code 提示技巧长文核心是把 Anthropic 工程师在实践中常用的提示词方式拆开来讲。文章会围绕 Claude Code 是什么、提示技巧为什么重要、如何在工作流中真正用起来展开包含 CLAUDE.md、MCP、CLI 命令、错误排查和最佳实践尽量做到新手能读懂老手可以直接抄配置。1. 背景Claude Code 是什么为什么提示技巧成了关键Claude Code 是 Anthropic 推出的命令行 AI 编程工具它不是一个普通的“聊天窗口”而是直接跑在终端里的代理式编码助手。你可以把它理解成一个能阅读项目代码、执行命令、读写文件、运行测试并且基于你给的指令完成编程任务的 AI 工程师。很多开发者第一次接触 Claude Code 时会下意识地把它当成一个“更聪明的 Copilot”。但用过一段时间后会明显感觉到两者的使用方式是有本质差异的。传统 AI 编程工具更多是“补全”和“对话”而 Claude Code 属于“代理式”执行它会自己去翻目录、找相关文件、读报错信息再决定下一步做什么。这一变化带来了一个非常实际的问题你的指令质量直接决定了 Claude Code 的执行效果。为什么提示技巧成了核心话题先说一个很容易被忽略的事实Claude Code 的能力边界和你的提示质量基本成正比。网上常见的“为什么我的 Claude Code 表现一般”这类问题有很大概率不是模型能力不够而是使用者没有用好提示词。Anthropic 工程师在日常开发中会频繁使用 Claude Code他们总结出来的提示技巧往往非常具体比如在CLAUDE.md里写清项目背景和约定。通过 Slash Command 把常用操作固化成模板。用输出格式化指令控制返回内容的结构。利用 MCP 协议接入外部数据库或 API。把复杂任务拆分成阶段性子任务分轮次执行。这些技巧并不玄学也不依赖什么“魔法词”核心都是让模型对你的项目环境、任务目标和输出预期有更明确的理解。本文会围绕这些技巧展开内容涵盖环境搭建、基本提示结构、高级用法、错误排查和工程化建议。如果你已经把 Claude Code 跑起来了可以直接跳到第 3 节看提示技巧如果你是第一次听说这个工具建议从头开始阅读。2. 环境准备安装 Claude Code 与基础配置在聊提示技巧之前先把环境准备好。Claude Code 的安装并不复杂但要注意几个关键细节。2.1 安装前提你需要准备Node.js 18 或更高版本安装 Claude Code 的依赖环境。一个可以访问 Anthropic 服务的账号。终端工具推荐 Windows Terminal、iTerm2 或 VS Code 内置终端。如果使用 VS Code可以在插件市场搜索 Claude Code 相关插件体验会更接近 IDE 原生操作。如果你的 Node.js 还没装推荐使用 nvm 或 fnm 管理版本避免系统级 Node 环境污染。# 查看 Node 版本 node -v # 使用 nvm 安装 Node 18 以上版本以 nvm 为例 nvm install 18 nvm use 182.2 安装 Claude Code安装方式主要有两种一种是通过 npm 全局安装另一种是直接使用 Anthropic 提供的安装脚本。# 方式一npm 全局安装 npm install -g anthropic-ai/claude-code # 方式二使用官方安装脚本 curl -fsSL https://claude.ai/install.sh | bash安装完成后在终端输入claude即可启动。如果遇到安装报错先不要急着重装常见的几个问题包括npm 权限问题全局安装时大概率会遇到 EACCES 错误可以尝试用sudo或者配置 npm 全局路径。PowerShell 执行策略问题Windows 用户在执行脚本时可能报错需要以管理员身份运行 PowerShell 并调整执行策略但要注意这不是绕过任何安全限制而是正常的环境配置。网络连接问题如果出现unable to connect to anthropic services或status 403相关提示优先检查网络代理、账号状态和 API 密钥配置。2.3 启动与登录启动 Claude Code 后通常需要完成一次登录认证。认证方式有两种浏览器 OAuth 登录适合个人使用。API Key 登录适合企业或脚本化使用。# 启动 Claude Code claude # 直接使用 API Key 启动 claude --api-key sk-ant-xxxx注意sk-ant-开头的 Key 属于敏感凭证不要提交到 Git 仓库。建议放到环境变量或用 Secret 管理工具。2.4 确认安装结果启动成功后你会进入一个交互式终端界面。可以试着输入一个简单的任务比如请帮我查看当前目录的文件结构并列出前 5 个最重要的文件。如果能正常返回结果说明 Claude Code 已经可以正常使用了。3. 核心提示技巧拆解Anthropic 工程师都在用的几种方式这一部分是本文的核心。我根据技术社区里公开分享的信息以及 Claude Code 实际使用经验整理了几类高频提示技巧。3.1 用 CLAUDE.md 固化项目上下文这是我认为最重要的一条技巧甚至比任何“提示模板”都关键。Claude Code 支持项目级记忆文件默认命名是CLAUDE.md。这个文件通常放在项目根目录作用类似于“给 AI 看的 README”。模型会在每次对话中加载这个文件从而理解项目的背景、技术栈、目录结构、代码规范和常见注意事项。一个典型的CLAUDE.md长这样# 项目名称订单管理系统 ## 技术栈 - 后端Java 17 Spring Boot 3.2 - 数据库MySQL 8.0使用 MyBatis-Plus - 前端Vue 3 TypeScript ## 项目结构 - /src/main/java/com/example/order后端主代码 - /src/main/resources/mapperMyBatis XML 文件 - /frontend前端工程 ## 编码约定 1. Controller 层只做参数校验和结果封装不写业务逻辑。 2. 数据库表统一使用 t_ 前缀。 3. 所有对外接口返回统一结构 ResultT。 4. 禁止在循环中查询数据库需要批量查询时使用 listByIds。 ## 常用命令 - 启动后端mvn spring-boot:run - 运行测试mvn test - 前端构建npm run build ## 注意事项 - 修改数据库表结构时必须先更新 schema.sql 和对应 mapper XML。 - 新增接口时必须补充 Swagger 注解。为什么这个文件有效因为 Claude Code 每次处理任务时都会面对大量文件如果没有任何背景信息它只能通过猜测来理解项目。而CLAUDE.md直接把这些信息塞给了模型减少了大量无效探索。补充一个细节CLAUDE.md可以放在多个层级。项目根目录放全局约定子目录里也可以放局部约定。例如src/main/java/com/example/order/CLAUDE.md可以描述这个模块的特殊逻辑。Claude Code 会在进入相关目录时自动加载对应文件。实际操作建议每个正式项目都写一个CLAUDE.md哪怕只有 5 行。内容要具体避免“代码要写得好”这类空话。任务结束后如果发现 Claude 频繁误解某个约定可以补充进CLAUDE.md。3.2 Slash Command把常用指令固化成模板如果你经常让 Claude Code 执行某个固定的任务比如“写单元测试”“修复 lint 报错”“生成数据库迁移脚本”那每次手打一大段提示词会非常低效。Claude Code 支持 Slash Command可以把提示词保存成命令用/直接触发。自定义 Slash Command 的配置位置是项目根目录下的.claude/commands/文件夹每一个 Markdown 文件对应一个命令。例如创建一个.claude/commands/unit-test.md请为 {file_path} 编写单元测试。 要求 1. 使用 JUnit 5。 2. 测试类命名规范{FileName}Test。 3. 覆盖核心业务逻辑不写无意义的 getter/setter 测试。 4. 测试需要包含正常分支、异常分支和边界条件。 5. 生成后先编译再运行测试确保测试通过。然后在 Claude Code 对话框中输入/unit-test src/main/java/com/example/order/service/OrderService.javaClaude Code 会自动解析{file_path}参数并按照模板执行任务。这相当于把“高手的提示词”沉淀成了团队可复用的资产。对于带团队的人来说这才是真正的工程效率提升。常用的 Slash Command 建议/review指定文件代码审查。/test为当前改动补充单元测试。/fix分析并修复当前报错。/explain解释某段复杂逻辑。/refactor重构指定模块。3.3 任务拆解从“一步到位”到“分步执行”很多使用者的第一个误区是试图一次性让 Claude Code 完成一个超大任务比如“帮我实现一个完整的秒杀系统”。这种提示在概念上可行但在工程实践上效果并不好。任务越复杂模型在中间步骤上的不确定性就越高最后产出的代码质量也越难保证。Anthropic 工程师更推荐的方式是任务拆解。把一个大型需求拆成若干个小任务每个任务都有明确的目标、输入和验收标准。举个例子假设你要开发一个用户注册接口第一种写法不推荐帮我实现用户注册功能。第二种写法推荐第 1 步分析当前项目中已有的用户实体类确认字段和数据库表结构。 第 2 步编写注册接口要求手机号 验证码方式注册验证码校验通过后创建用户。 第 3 步注册成功后返回用户 ID 和 token。 第 4 步补充单元测试覆盖验证码错误、用户已存在、参数缺失三个场景。 第 5 步完成后运行相关测试并告诉我测试结果。第二种写法的优势很明显给模型一个明确的执行路径。每个步骤都便于检查。如果某一步出问题可以精准定位。如果任务涉及修改多个文件还可以要求 Claude Code 先给出修改计划确认后再动手。先不要改代码。请阅读以下需求分析需要修改哪些文件给出实现步骤和潜在风险等我确认后再执行。这种“先计划后执行”的模式在大型重构中非常有用。3.4 输出格式控制让返回结果更适合人读Claude Code 默认会以自然语言返回结果。但在工程场景中你往往希望结果更结构化便于复制、保存或交接。可以通过提示词显式控制输出格式。示例一要求返回表格请对比以下三种缓存方案的优劣用表格输出 1. Redis 2. Caffeine 3. Redis Caffeine 两级缓存 表格列方案 | 优点 | 缺点 | 适用场景示例二要求返回 JSON请解析这个日志文件找出所有 ERROR 级别的记录。 输出格式为 JSON [ { timestamp: 时间, module: 模块, message: 错误信息 } ]示例三要求给出修改前后对比请帮我优化以下方法的性能。 输出内容包含 1. 修改前代码 2. 修改后代码 3. 优化点说明 4. 性能提升预估这里要提醒一点不要迷信“格式化词”。Claude Code 本身能理解自然语言你只需要清晰说明你期望的返回结构它就能执行。真正重要的不是“魔法咒语”而是你给出了足够明确的输出预期。3.5 让 Claude Code 使用项目中的既有代码风格一个常见的痛点是Claude Code 生成的代码风格常常与项目现有代码不一致。比如项目里用的是 Lombok但 Claude 生成了大量 getter/setter项目里统一使用ResultT包装返回但 Claude 直接返回了裸数据。解决思路有三个第一把代码风格写进CLAUDE.md这个前面已经介绍过。第二在任务开始时给一个“风格锚点”示例。请参考 src/main/java/com/example/order/controller/UserController.java 中现有的编码风格编写新的 OrderController。第三让 Claude Code 先阅读几个同类文件再开始编码。在开始编码之前先阅读 src/main/java/com/example/order/service/ 目录下的所有 Service 实现类总结它们的命名规范、异常处理方式和事务使用方式再按照相同风格实现新的 InventoryService。这种方式特别适合中大型项目因为项目里积累的大量代码本身就是最好的风格规范。3.6 善用 MCP 扩展能力MCP全称 Model Context Protocol是 Anthropic 主导的一种开放协议目的是让 AI 编程工具能够连接外部数据源和工具。之前 Claude Code 只能读取本地文件和执行终端命令如果想读取数据库、调用内部接口、查询监控系统就必须借助额外能力。MCP 把这种能力标准化了。举个例子假设你希望 Claude Code 能直接查询本地 MySQL 数据库可以通过配置 MCP 服务实现。安装 MCP 服务后Claude Code 会自动发现可用的工具。你可以在对话中直接要求请查询 order 表中最近 7 天的订单数量按天分组返回结果。MCP 服务会负责建立数据库连接并执行 SQLClaude Code 只需要理解和分析结果。常用 MCP 场景包括数据库查询与分析。调用内部 API 获取配置。读取监控指标。操作 Git 仓库。跟 Jira、飞书等协作平台联动。需要注意MCP 配置涉及权限和安全边界。生产环境的数据库账号应该使用只读权限或最小权限账号不要给 AI 工具开放 DDL 权限。禁止让 MCP 在生产环境执行 DELETE、UPDATE、DROP 等危险操作。所有写操作必须在测试环境验证。这是工程底线务必提前约定。3.7 使用--print模式实现脚本化调用Claude Code 不只是交互式工具也支持非交互式调用。通过-p或--print参数可以直接把任务作为命令行参数传入适合写脚本或接入 CI 流程。claude -p 请总结 src/main/java 目录下所有 Controller 的接口路径输出为 Markdown 列表输出结果会直接打印到终端不会进入交互页面。这个模式在自动化场景中非常有用比如提交代码前让 Claude 做一轮快速审查。在 CI 中让 Claude 分析编译日志。批量生成代码注释。更加实用的组合是cat管道cat error.log | claude -p 请读取这份日志找出最频繁出现的 5 个错误并给出修复建议这种使用方式让 Claude Code 从“聊天工具”变成“命令行工具”可以无缝嵌入到日常开发流程中。3.8 利用 Git 历史信息和 Diff 做精准上下文当 Claude Code 参与代码修改时如果不加任何约束它有可能会把不相关的内容也改掉。一个很有效的技巧是让 Claude Code 专注于当前 diff。claude -p 请 review 当前 git diff 的改动检查是否存在 1. 潜在的 NPE 风险 2. 事务边界错误 3. SQL 注入 4. 并发安全问题 只关注 diff 中涉及的内容不要提无关问题。另外一种用法是让 Claude Code 根据 git log 理解某个文件的演进历史请查看 src/main/java/com/example/order/service/OrderService.java 的 git log总结这个文件最近 10 次提交的主要变更逻辑以及可能的业务意图变化。这种提示方式充分利用了版本控制信息比单纯让模型“读代码”更接近工程师的真实工作方式。4. 实战案例从零到一用 Claude Code 完成一个功能模块这一节我们通过一个完整案例演示如何综合运用前面的提示技巧。4.1 场景描述假设你现在有一个 Spring Boot 项目需要新增一个“优惠券核销”功能。业务规则如下用户下单时可以使用一张优惠券。优惠券有状态未使用、已使用、已过期。核销时需要校验优惠券归属、有效时间和订单金额门槛。核销操作需要保证并发安全同一个优惠券不能被重复使用。4.2 第一步初始化项目上下文在项目根目录创建或完善CLAUDE.md把技术栈和约定写清楚。这一步不需要太长但要有效。# 优惠券系统 ## 技术栈 - Java 17 Spring Boot 3.2 - MyBatis-Plus MySQL 8.0 ## 项目结构 - controller接口层负责请求转发与参数校验 - service业务层负责核心逻辑 - mapper数据访问层 - entity数据库实体 ## 开发约定 1. 所有接口返回 ResultT。 2. 业务异常使用 BizException。 3. 优惠券状态变更使用乐观锁。 4. 涉及的 SQL 操作必须使用 Prepared Statement 方式。4.3 第二步让 Claude Code 先出方案不要直接让它写代码先让它分析需求。请阅读项目结构理解优惠券相关代码。 现有功能中已经有 Coupon 实体和 CouponMapper请分析当前实现。 然后根据以下需求输出一个实现计划 1. 核销接口POST /api/coupon/consume 2. 核销参数userId、couponId、orderId、orderAmount 3. 校验规则归属校验、状态校验、有效期校验、金额门槛校验 4. 并发安全避免同一张券被并发核销 输出内容 - 需要新建哪些文件 - 需要修改哪些文件 - 核心流程伪代码 - 潜在风险点4.4 第三步确认方案后分步实现方案确认后可以按顺序下发子任务第一步创建 CouponConsumeRequest 和 CouponConsumeResult 类字段如下...第二步在 CouponService 中新增 consume 方法实现核销逻辑注意加上事务和乐观锁。第三步新建 CouponController 中的 consume 接口补充参数校验和异常处理。第四步为核销逻辑编写单元测试覆盖正常核销、重复核销、优惠券不属于该用户、订单金额不满足门槛、优惠券过期。每一步执行完成后检查结果有问题及时反馈给 Claude Code 修正。4.5 第四步整体审查所有功能完成之后建议让 Claude Code 做一轮代码审查请审查本次核销功能涉及的代码变更。重点检查 1. 事务是否生效 2. 乐观锁版本号更新是否正确 3. 是否存在 SQL 注入风险 4. 异常信息是否足够明确 5. 接口参数校验是否完整 输出审查结果指出问题并给出修改建议。这个流程总结下来就是上下文准备 → 方案先行 → 分步实现 → 测试补齐 → 综合审查。这套流程比“一句话让 Claude 写完整个功能”要可靠得多。5. 常见问题与排查思路Claude Code 使用过程中会遇到不少问题这里整理几个高频场景。5.1 安装或启动失败问题现象常见原因解决思路EACCES: permission deniednpm 全局目录无权限配置 npm 全局路径到用户目录或使用 sudo不推荐长期使用PowerShell 执行 policy 报错Windows 执行策略限制管理员身份修改执行策略注意只调整当前用户作用域unable to connect to anthropic services网络无法访问 Anthropic 服务检查网络环境、代理设置确认账号状态正常status 403账号权限或 API Key 无权限检查是否选择了正确的账号确认 API Key 是否有效且具备 Claude Code 权限安装后claude命令未找到npm 全局 bin 目录未加入 PATH配置 PATH 环境变量指向 npm 全局 bin 目录5.2 登录和认证问题如果使用过程中频繁掉线或提示认证失败可以尝试重新登录claude --logout claude重新登录一般能解决大部分 token 过期导致的认证问题。5.3 输出中文乱码问题部分终端在 Windows 下会遇到中文乱码。这通常是终端编码问题解决方案是确保终端使用 UTF-8 编码。在 VS Code 中可以设置files.encoding: utf8同时建议终端代码页切换到 UTF-8。Windows 下可以在终端执行chcp 650015.4 生成的代码和项目风格不一致这个问题的根源是上下文不足前面的 3.5 小节已经给出了解决思路。核心做法是在CLAUDE.md中明确风格约定。在任务中指定参考文件。让 Claude 先阅读同模块代码再动手。5.5 任务执行到一半偏离方向如果 Claude Code 执行任务时“跑偏”了不要直接说“不对”而是重新给出明确的约束或者使用 CtrlC 中断当前任务重新描述需求。推荐重新开始一轮新的对话同时补充更多上下文因为长对话中模型可能被之前的错误判断影响。6. 最佳实践与工程建议这一节讲的是如何把 Claude Code 真正用于开发团队而不是仅仅作为个人玩具。6.1 提示词即代码建议进版本库CLAUDE.md、.claude/commands/下的模板本质上是团队开发规范的延伸。建议把它们纳入 Git 版本管理。这样做的好处是新成员 clone 项目后打开 Claude Code 就自动拥有完整上下文。提示词模板可以随着项目演进持续优化。代码风格统一减少 AI 生成代码的“违和感”。一个推荐的项目目录结构project-root/ ├── .claude/ │ ├── commands/ │ │ ├── review.md │ │ ├── test.md │ │ └── fix.md │ └── settings.json ├── CLAUDE.md ├── src/ └── README.md6.2 关于安全和权限这部分是工程红线必须认真对待。Claude Code 的能力是“代理式”的这意味着它能够执行命令、修改文件、运行测试。能力越大风险边界越要清晰。以下是几个必须遵守的底线不要把生产环境的数据库账号直接配给 Claude Code尤其是具备写权限的账号。不要让它执行rm -rf、DROP TABLE、TRUNCATE等危险操作。涉及数据库变更时要求 Claude 先输出 SQL 脚本人工确认后再执行。API Key 是敏感信息绝不能写入代码库。MCP 服务接入第三方平台时遵循最小权限原则。在 CI 环境中使用 Claude Code 时确保工作目录是源码副本而不是直接操作生产服务器。6.3 日志和结果检查Claude Code 在交互过程中会保存会话记录默认会存在本地配置目录中。如果你需要追溯某次任务的具体执行过程可以通过以下方式查看# 查看历史会话 claude --resume如果想要导出某次会话的完整内容可以在交互界面中使用对应的导出功能或者复制终端的输出内容进行保存。6.4 省 Token 的实践经验Claude Code 的 token 消耗速度比普通聊天工具更快因为它需要在上下文里加载项目文件。节省 token 的核心思路是减少无意义的信息摄入。推荐做法在CLAUDE.md里写清楚项目全貌避免 Claude 反复读取无关文件。明确指定要处理的文件而不是让它扫描整个仓库。使用.claudeignore文件排除node_modules、target、dist等目录减少无效文件读取。简单的单文件改动可以直接把文件内容粘贴到提示里避免文件系统扫描。.claudeignore文件示例node_modules/ dist/ target/ build/ .git/6.5 如何评估 Claude Code 的输出质量不能盲目相信 AI 生成的代码。建立一套评估机制比追求“一次成功”更重要。推荐做法代码生成后必须运行编译和测试。要求 Claude Code 提供“修改了什么、为什么修改”的说明。关键业务逻辑需要人工 review。定期把 AI 生成的代码和人类工程师的实现做对比更新提示词优化方向。7. 总结与下一步方向这篇文章围绕 Claude Code 提示技巧展开重点介绍了几个实用方向用CLAUDE.md固化项目上下文、用 Slash Command 沉淀模板、通过分步拆解控制复杂任务、用输出格式控制结果结构、借助 MCP 扩展外部能力以及在工程实践中如何控制安全边界和 token 成本。这些技巧的共同点是让 AI 更清楚地理解你的项目和目标而不是期待它凭空猜出最优解。Claude Code 的提示技巧本质上和带新人是一个道理背景交代得越清晰反馈越及时任务拆得越合理最终效果就越好。下一步你可以继续探索的方向包括团队内建设一套CLAUDE.md模板库覆盖 Java、前端、Python 等常用技术栈。让 Claude Code 在 CI 中执行代码审查形成质量门禁。通过 MCP 接入公司内部的测试平台、接口文档平台构建更自动化的研发链路。把 Claude Code 和 Codex 等工具做横向对比找到各自最适用的场景。如果你在实战中遇到了有意思的问题也欢迎在评论区分享互相学习。本文提到的配置代码均可直接复制使用记得根据实际项目调整路径和参数。