Claude Code 使用指南:让 Agent 读懂项目上下文
Claude Code 这类代码 Agent 的优势在于理解项目、规划修改和持续迭代,本指南关注如何把任务交代清楚,让输出更稳定
一、先让工具读项目,不要直接催它改
比较稳妥的流程是先让 Agent 说明项目结构、运行命令、关键文件和潜在风险,再进入修改阶段
- 先问“这个项目如何启动和测试”
- 再问“这个功能涉及哪些文件”
- 最后给出明确的修改目标和验收方式
二、任务描述要包含四件事
- 目标:希望最终行为变成什么样
- 范围:允许修改哪些页面、模块或接口
- 限制:不能改动的逻辑、样式或数据
- 验证:运行哪些命令或手动检查哪些路径
三、适合 Claude Code 的任务
它更适合处理中等复杂度、需要跨文件理解的任务
- 重构重复逻辑,保持行为不变
- 补充测试用例或修复测试失败
- 阅读报错并定位影响范围
- 把需求拆成小步骤逐步实现
四、保留人类复核
Agent 可以加快修改,但最终合并前仍要看差异、跑测试、检查边界条件和确认业务语义