Agent 学习笔记 22：Claude Code 深度解析：Coding Agent 如何理解和修改代码

Coding Agent 的难点从来不是“生成一段代码”，而是在陌生仓库中理解约束、找到正确修改位置、控制变更范围并证明结果可用。Claude Code 代表的终端型 Agent，把这套过程放进了真实开发环境。

先理解仓库，再动手

可靠流程通常从读取项目说明、目录、依赖、测试命令和 Git 状态开始。搜索应围绕符号、调用链和现有模式展开，而不是把整个仓库一次性塞进上下文。已有代码会告诉 Agent 应该采用什么风格。

理解请求 -> 探索仓库 -> 定位所有权边界 -> 制定改动 -> 编辑 -> 测试/检查 -> 汇报

工具循环决定实际能力

读文件、搜索、编辑、执行命令和查看差异构成基本工具集。模型负责决定下一步，Harness 负责限制路径、命令和超时。删除文件、改部署配置等高风险动作需要更严格的确认，测试通过也不能替代代码审查。

修改代码要控制范围

好的 Coding Agent 会复用现有抽象，尽量让改动贴近需求，并保留用户尚未提交的变化。它还应区分“我修改的错误”和“仓库原有失败”，避免为了让测试变绿去重写不相关模块。

团队化使用依赖可验证约定

仓库说明文件、格式化工具、静态检查和测试把团队知识变成机器可执行约束。Agent 的最终报告应说明改了什么、验证了什么、还存在哪些风险，而不是只说“任务完成”。

这章给我的启发

Coding Agent 的上限取决于模型，稳定性却来自仓库结构、工具权限和验证闭环。把开发约定写清、把测试做好，本身就是在为人和 Agent 同时改善工程环境。