Claude Codeの頻出エラー10種、9つは既知バグだった

Claude Codeを使っていて「設定が壊れたのか？」と疑い始める瞬間は多い。だが、実は違うかもしれない。ある研究者が自前の97,000件の知見データベースで検証したところ、Claude Codeで報告されている頻出エラー10種のうち9種は既知の不具合だったという。つまり、あなたが今日遭遇したそのエラーは、高い確率で「あなたの環境が壊れた」のではなく「誰かがもう踏んで報告済みのバグ」だということだ。

面白いのは、この検証方法そのものである。GitHub Issues・Reddit・Hacker News・Zenn・Dev.to・Substackから日々自動収集した知見を埋め込みベクトル化し、エラー文を意味検索にかけている—つまり、「エラー診断をAIで自動化する」という当然のことを、実務的にやっている人がいる。そして結果は明快だ。最良ケースは距離0.188（安全分類器の障害）で即ヒット。外した1種も、実は既知クラスタが存在したが検索が及ばなかっただけ。業界の知見は既に十分に溜まっている。問題は「引く労力」である。具体的には、挨拶だけで「Usage Policy違反」が出るバグ、安全分類器の障害で全ツールがブロックされる不具合、Context limit到達後に /compact が失敗する症状、OAuth再認証が死ぬケース、Windowsで claude コマンドが認識されなくなる現象など、実測で回避策が判明している。もう一つの盲点は30日で会話履歴が自動削除される仕様だ。これは警告なしに起きるため、過去セッションを資産として使う運用をしている人は、settings.json で cleanupPeriodDays を増やす必要がある。中小企業がAIツールを実運用に乗せるとき、こうした既知の地雷を事前に知っているだけで、導入の心理的コストが大きく下がる。