用 AI agent 调试：系统化排查，而不是瞎猜

最常见的错误

很多人只丢给 agent 一句“把这个 bug 修了”——没有错误信息，没有上下文。于是 agent 只能瞎猜。系统化的调试方式完全不同。

第一步：让错误可复现

把触发错误的命令交给 agent，让它自己把错误跑出来。Claude Code 文档正是这样建议的：告诉 agent 怎么复现问题、怎么拿到 stack trace。一个 agent 能自己触发的错误，也是它在修完之后能自己验证的错误。

第二步：喂给它日志和 stack trace

把完整的错误信息贴进去，而不是用自己的话描述它。也可以用管道：cat error.log | claude -p "解释一下根本原因"。同时说明这个错误是每次都出现，还是偶尔才出现。

第三步：先假设，再修复

先让 agent 列出可能的原因，按可能性排序——然后有针对性地验证其中一个。关键是：要解决根本原因，而不是症状。官方文档把这条写成了一条 prompt 规则：“address the root cause, don't suppress the error”。

诊断工具

如果是 Claude Code 本身出了问题，可以用 /doctor：它会自动检查安装情况、设置、扩展和上下文使用情况。如果 claude 根本启动不了，可以直接在 shell 里运行 claude doctor。