Claude 与 Skill
别急着往 CLAUDE.md 加规则:用日志分析把 Claude Code 的锅和自己的锅分开
作者写脚本统计了自己机器上 Claude Code 的全部中断和失败调用,再让 LLM 逐条归因。结果发现:按失败次数算最大的是 Claude Code 的 bug,但按值得修的发现算,约 90% 出在自己加的 hooks、规则和权限设置上。文章给出了归因方法和四类典型自建机制问题。
今天就能做
- 先跑一遍失败统计再决定加不加规则:让脚本列出被中断和重复失败的调用,按原因归属分类,很可能大部分问题出在自己写的 hooks 和权限设置上。
- 检查你所有 hook 的报错信息,确保每条都说清是哪个路径/哪个字符串/哪条规则触发的,以及下一步该怎么改——否则模型只会原样重试。
- 遇到 subagent 报 File has not been read yet 且刚被 resume 过,先怀疑是 Claude Code 的已知 bug,别急着改自己的配置。
两阶段分析方法:脚本计数 + LLM 归因
- 第一阶段用脚本读取全部会话记录,列出被 hooks 等机制中断的调用,以及在两个以上会话中重复出现的失败,附上次数、会话数、日期和紧随其后的重试次数。
- 第二阶段让 LLM 逐条打开原始记录判断原因,输出值得修的发现;有意的中断和已修复的项被排除。
- 2026-11-14 全量分析得到 42 条发现、457 条排除;四天后复跑,41 条仍然存在,说明结果可复现。
- 与官方 /insights 不同:/insights 的建议多是往 CLAUDE.md 加提示词,而这套方法把修复范围限定在 hooks、settings 和脚本层面。
按失败次数算和按发现算,结论完全相反
- 按失败次数:Edit 的 File has not been read yet 报错占 3450 次失败中的 854 次,横跨 96 个会话,看起来全是 Claude Code 的锅。
- 按值得修的发现算:41 条里 37 条出在自己加的机制上——hooks/规则/权限 17 条、仓库检查和开发脚本 14 条、自己的 VS Code 扩展 6 条;Claude Code 本身只有 4 条(3 种)。
- 那 854 次失败其实混合了 Claude Code 的 bug 和作者自己的配置错误,只看计数会得出错误结论。
- 作者还顺藤摸瓜找到一个不在 41 条之列的 bug:python 替换操作中断,根因是反斜杠被 Claude Code 吞掉。
Claude Code 本身的三个 bug
- subagent 被恢复(resume)后,它之前读过的文件会被当成没读过,导致 Edit 被拒,这是失败次数最大的一项。
- subagent 想写出被要求交付的 .md 文件时,被 do not write report files 拒绝。
- 打开 file:// URL 返回的错误信息与真实原因无关,误导排查。
自己机制上的失败分四类
- 报错不说下一步怎么办:拦错误路径的 hook 每次打印同一段固定文字,不说哪个路径有问题;拦过长命令的 hook 不说临时文件夹在哪;文档检查失败不说违反了哪条规则哪一款。
- 误伤无害操作:保护文件位置的检查连只读配置的 git 命令也拦;拦截发布的 hook 对整条命令做匹配,连路径里的用户名都会触发。
- 机制互相矛盾:给 subagent 的指令说别写遗漏说明那一行,检查回复的机制却要求必须写;使用说明里的命令形式和权限设置里注册的不一致,照文档输入就卡在权限提示。
- 没人教就反复摔跤:临时文件夹里的研究脚本每次都因模块加载失败,正确写法在规则里但没传到现场写脚本的 subagent;subagent 只用 cat 读文件就去编辑,被拒。
重试的浪费比想象中大
- 出现在两个以上会话的失败共 2704 次。
- 其中 751 次在失败后立刻原样重试,468 次连一个字符都没改就重发。
- 被拦的一方在不知道正确做法的情况下盲目重试,是浪费的主要来源。
修复思路:先改报错信息,再考虑加规则
- 把拦截消息改成说清发生了什么、该怎么写、有什么替代方案。例如路径 hook 现在会说明 Windows 的 python/node 会把 Git Bash 路径读成 C:\tmp...,建议用 C:/... 形式(cygpath -m 可转换)或改用命令行参数传递。
- CLAUDE.md 越长越没用的根源:每次失败就加一句 don't do this,Claude 自己也热衷于往里加行,规则越堆越多但问题没解决。
- 作者把这套流程做成了 Claude Code 插件发布,可以复用同样的计数加归因流程。
原文:I Built a Way to Analyze Claude Code's Logs. It Separated Problems in My Own Hooks from Two Bugs in Claude Code Itself
来源:DEV Community · 2026-11-20
查看原文本文由 AI 阅读原文后整理,未经人工逐字核对,内容以原文为准。
登录后可以点赞、查看和发表评论