Claude Code を使っていて詰まったときの切り分けメモです。GitHub Issues に実際に報告されている症状のうち、複数人が同じことを踏んでいるものを選び、手元で実際にコマンドを叩いて確認した範囲だけを書いています。本文は PaPoo 側に置いてあります。
外部サイト参照で 400 エラーになるときの確認点
外部サイトの取得時に 400 系で失敗するケースを整理し、アクセス制限や参照先の扱いを見直す観点をまとめます。
https://papoo.work/doc/21c2af0aedb9cfc8
起動時にモジュールが見つからないときの確認点
ローカル環境の初期化時に必要なファイルを読み込めず止まるケースについて、配置場所や設定のずれを切り分ける手順を紹介します。
https://papoo.work/doc/7237002a967ead2a
メッセージ数不整合で止まるときの確認点
会話ログの件数と内部キーがずれて処理が止まる場合に、発生しやすい状況と確認すべきデータ整合性のポイントを整理します。
https://papoo.work/doc/c430d6d7fc411f32
自動判定で許可されない操作の見分け方
自動モードの判定で操作が拒否される場面を取り上げ、どの操作が弾かれやすいか、事前に切り分ける観点をまとめます。
https://papoo.work/doc/9f934b3e48a4d67a
メッセージ整合性エラーで止まるときの確認点
メッセージ一覧の件数ずれで処理が中断するケースを扱い、表示件数や内部状態の不一致を疑うポイントを整理します。
https://papoo.work/doc/6155b3eb194c1797
記事本文は日本語。実際に手元で実行した出力と、GitHub Issues の報告内容だけを根拠にしている。
過去の記事はこちら