Claude Code を使っていて詰まったときの切り分けメモです。GitHub Issues に実際に報告されている症状のうち、複数人が同じことを踏んでいるものを選び、手元で実際にコマンドを叩いて確認した範囲だけを書いています。本文は PaPoo 側に置いてあります。
接続切断の原因を切り分ける
fetch 実行時に接続が途中で切れる場合の確認ポイントを整理。verbose の有無や周辺の通信状況から、再現条件を絞り込む手順を紹介します。
https://papoo.work/doc/0f704d6dd4662c2f
認証失敗で止まるときの確認点
認証まわりの失敗で処理が進まない場合に、まず見直したい項目をまとめました。API キーや設定値の確認順もあわせて解説します。
https://papoo.work/doc/f76e402ecf8a0714
中断エラーが出たら最初に見ること
処理が突然中断されるケースについて、まず確認すべき 2 つの観点を整理。実行環境や入力条件を手早く切り分けるのに役立ちます。
https://papoo.work/doc/bb77699df280e6e3
表示リストの不整合を見つける
メッセージ一覧の件数ずれで起きる不整合について、発生時に確認したい箇所を解説。データ更新の流れを追って原因を絞り込みます。
https://papoo.work/doc/e4dfa807a0405060
JSON 判定がずれるときの注意
JSON らしさの判定に外部ツールが関わる場面で、想定外の扱いになるケースを解説。環境差や依存ツールの有無を確認するヒントをまとめます。
https://papoo.work/doc/877291b834310574
Bash の安全判定ができない時
自動判定が保留になって Bash 実行の安全性を判断できない場面を整理。見えている状態と、確認しておきたい前提条件をわかりやすくまとめます。
https://papoo.work/doc/e74026e5270fdd48
記事本文は日本語。実際に手元で実行した出力と、GitHub Issues の報告内容だけを根拠にしている。
過去の記事はこちら