Claude Code を使っていて詰まったときの切り分けメモです。GitHub Issues に実際に報告されている症状のうち、複数人が同じことを踏んでいるものを選び、手元で実際にコマンドを叩いて確認した範囲だけを書いています。本文は PaPoo 側に置いてあります。

ツール設定やモデル指定の不整合で起動直後に失敗するケースを整理。再現条件の見極め方と、まず確認したい設定項目をまとめています。

読み込み対象が大きすぎて処理が止まるケースについて、発生時に見えていた挙動をもとに原因を切り分け。分割読み込みの考え方も紹介します。

セッション生成の段階で止まるケースを対象に、ログ確認の起点や環境依存の要因を整理。再試行前に見ておきたいポイントを押さえます。

会話履歴の参照に失敗するケースを扱い、セッションIDの扱い方や状態不整合を確認。まず疑うべき箇所を短く整理しています。

記事本文は日本語。実際に手元で実行した出力と、GitHub Issues の報告内容だけを根拠にしている。

過去の記事はこちら