给 Claude Code 错误信息

最有效的调试方式：把错误日志直接丢进去。

# 方式一：直接在对话里粘贴
> 我跑 npm run build 报了这个错：
> TypeError: Cannot read properties of undefined (reading 'map')
> at UserList (src/components/UserList.tsx:23:18)

# 方式二：管道输入（适合长日志）
npm run build 2>&1 | claude -p "分析这个构建错误的原因，给出修复方案"

# 方式三：从日志文件读取
> 帮我看一下 @logs/error.log 最近的报错，找到根因

Claude Code 拿到错误信息后会自动定位到源文件，分析调用链，找到 root cause。

实战：排查运行时错误

> 用户反馈说点击"提交订单"按钮没反应，帮我查一下 OrderForm 组件

Claude Code 的排查路径：

1. 读取 OrderForm.tsx，找到 submit handler
2. 追踪整个调用链：组件 → service → API endpoint
3. 检查每一层的错误处理是否有遗漏
4. 定位问题（比如 await 缺失导致 Promise 未处理）
5. 修复并验证

用 Extended Thinking 处理复杂 Bug

碰到逻辑复杂、涉及多个模块的 bug，开启 extended thinking 让 Claude 深度分析：

# 在 Claude Code 里按 Option+T (macOS) 或 Alt+T 开启 thinking mode
# 或者启动时指定
claude --permission-mode plan

在 thinking mode 下，Claude 会先做完整的代码分析，画出依赖关系，然后再给出修复方案。按 Ctrl+O 能看到它的推理过程。

适合用 thinking mode 的场景：

• 竞态条件（race condition）
• 内存泄漏
• 跨服务的数据不一致
• 性能瓶颈定位

把 Claude Code 集成到测试流程

用管道把测试输出直接给 Claude 分析：

# 跑测试，失败的话自动分析原因
npm test 2>&1 | claude -p "分析失败的测试，找到 root cause 并修复"

# 只看特定测试文件的失败
npx vitest run src/services/auth.test.ts 2>&1 | claude -p "这个测试为什么失败了？"

更自动化的做法——写个脚本循环修复：

#!/bin/bash
MAX_ATTEMPTS=3
for i in $(seq 1 $MAX_ATTEMPTS); do
  npm test && echo "测试通过" && exit 0
  npm test 2>&1 | claude -p "测试失败了，读取相关源码，修复 bug。只改源码，不改测试。"
done
echo "修复 $MAX_ATTEMPTS 次仍然失败，需要人工介入"

调试 API 接口

后端接口出问题时，可以结合 MCP 工具一起调试：

> 帮我查一下 /api/orders 接口为什么返回 500
> 用 PostgreSQL MCP 看一下 orders 表最近 10 条记录的状态
> 再对比一下代码里的查询逻辑

如果接了数据库 MCP Server，Claude Code 能直接执行 SQL 验证数据，比手动切换终端、数据库客户端效率高得多。

常见调试模式