Claude Code を使っていて詰まったときの切り分けメモです。GitHub Issues に実際に報告されている症状のうち、複数人が同じことを踏んでいるものを選び、手元で実際にコマンドを叩いて確認した範囲だけを書いています。本文は PaPoo 側に置いてあります。
起動直後に失敗する場合の確認点
ツール設定やモデル指定の不整合で起動直後に失敗するケースを整理。再現条件の見極め方と、まず確認したい設定項目をまとめています。
https://papoo.work/doc/0b2be44f8e4a30db
大きなファイル読み込みで失敗する時
読み込み対象が大きすぎて処理が止まるケースについて、発生時に見えていた挙動をもとに原因を切り分け。分割読み込みの考え方も紹介します。
https://papoo.work/doc/977d6ef37f25f2d6
セッション作成に失敗する時の切り分け
セッション生成の段階で止まるケースを対象に、ログ確認の起点や環境依存の要因を整理。再試行前に見ておきたいポイントを押さえます。
https://papoo.work/doc/5a2323a4f193cb7c
会話が見つからない時に見るところ
会話履歴の参照に失敗するケースを扱い、セッションIDの扱い方や状態不整合を確認。まず疑うべき箇所を短く整理しています。
https://papoo.work/doc/98a3ed4c0dd23ac7
記事本文は日本語。実際に手元で実行した出力と、GitHub Issues の報告内容だけを根拠にしている。
過去の記事はこちら