返回文档中心

Claude Code 使用指南:让 Agent 读懂项目上下文

Claude Code 这类代码 Agent 的优势在于理解项目、规划修改和持续迭代,本指南关注如何把任务交代清楚,让输出更稳定

Claude Code 约 7 分钟阅读 代码协作

一、先让工具读项目,不要直接催它改

比较稳妥的流程是先让 Agent 说明项目结构、运行命令、关键文件和潜在风险,再进入修改阶段

  • 先问“这个项目如何启动和测试”
  • 再问“这个功能涉及哪些文件”
  • 最后给出明确的修改目标和验收方式

二、任务描述要包含四件事

  • 目标:希望最终行为变成什么样
  • 范围:允许修改哪些页面、模块或接口
  • 限制:不能改动的逻辑、样式或数据
  • 验证:运行哪些命令或手动检查哪些路径

三、适合 Claude Code 的任务

它更适合处理中等复杂度、需要跨文件理解的任务

  • 重构重复逻辑,保持行为不变
  • 补充测试用例或修复测试失败
  • 阅读报错并定位影响范围
  • 把需求拆成小步骤逐步实现

四、保留人类复核

Agent 可以加快修改,但最终合并前仍要看差异、跑测试、检查边界条件和确认业务语义