开始前准备什么
准备一个能在本机启动的项目,确认代码有版本记录,并知道如何运行已有检查。Claude Code 的安装、登录与支持平台以官方快速开始为准。已经安装但无法启动,可先看安装排错指南。
打开终端进入项目目录后启动 claude。第一次对话先交代项目用途、出现问题的页面和预期行为。不要只发一张报错图片:出错步骤、完整错误文字和最近修改的文件往往更有用。
第一轮只读:建立共同理解
可以先发送下面的要求,确认它找到的文件确实属于你的项目:
请阅读这个项目,告诉我启动命令、表单提交入口和已有校验逻辑。先不要修改文件。每个结论注明相关文件;找不到的部分直接说明。
检查回答中的路径与启动方式。若它认为项目使用另一种框架,先纠正这一点再继续。读错项目结构后直接修改,后面再多解释也很难补救。
第二轮修改:给出验收条件
把任务缩小到能观察的行为,例如:
注册表单的邮箱留空时仍会发请求。请让空邮箱和格式明显错误的邮箱显示字段提示,合法邮箱保持原提交行为。修改前说明涉及哪些文件,修改后运行已有相关检查,并列出我应当手动验证的步骤。
这里有三个关键元素:触发条件、期望结果和验证方法。它们比“代码要优雅”更容易让你判断工作是否完成。如果同一轮还要改登录、支付和导航,先拆成独立任务。
如何验收 AI 写的代码
至少检查空输入、正常输入和服务端报错三个分支。打开变更对比,看是否修改了无关配置;启动页面,确认错误提示在手机宽度也能看清。自动检查通过只表示对应检查没有发现问题,不代表所有业务场景都正确。
把验证过程中遇到的问题继续交给同一任务,保留原来的验收条件。不要只反馈“还是不行”,而要说清输入了什么、点击哪个按钮、实际出现了什么。
CLAUDE.md、Skills 和 MCP 怎么区分
项目长期约定可放进 CLAUDE.md;经常重复的检查步骤适合做成 Skill;连接外部数据和工具通常涉及 MCP。它们解决的问题不同,初学阶段先让一个小任务跑通,再按需要添加。官方功能概览解释了这些扩展方式。
费用和连接问题怎么处理
先确认使用的是订阅登录还是 API 计费,再查看对应账户的使用记录。遇到第三方兼容接口问题,可以使用模型一致性检测和API 测速保留线索;这些测试不能证明 Claude Code 所有功能都兼容。额度与账单的区别见Claude Code 费用指南。