Claude Code を使っていて詰まったときの切り分けメモです。GitHub Issues に実際に報告されている症状のうち、複数人が同じことを踏んでいるものを選び、手元で実際にコマンドを叩いて確認した範囲だけを書いています。本文は PaPoo 側に置いてあります。
Claude Code で 502 が出るときに確認したい点
Claude Code 利用時に 502 系の応答が返る場合の切り分けをまとめています。接続先の状態、認証、再試行の前に見ておきたい観点を整理します。
https://papoo.work/doc/18366d11d8077db6
プラグイン更新が反映されないときの確認事項
新しいファイルが所定の場所へコピーされず、更新内容が反映されないケースを扱います。実行中プロセスや配置先の確認ポイントをまとめています。
https://papoo.work/doc/c9cf2fad556f5d0e
認証ヘッダー不足で失敗するときの見方
登録時に認証情報が不足して失敗するケースを対象に、原因の切り分け方を解説します。トークン設定や送信内容の確認に役立つ内容です。
https://papoo.work/doc/399523c48bf192df
接続エラーが出るときの切り分け
通信先へつながらず、クライアント側で接続失敗となる場合の確認事項をまとめています。ネットワーク、起動状態、設定ミスの見直しに役立ちます。
https://papoo.work/doc/a19f894146a24dab
メッセージ不整合で止まるときの確認点
一覧データの件数がずれて処理が止まるケースを扱います。キャッシュやデータ破損、途中更新による不整合を疑う際の見方を整理しています。
https://papoo.work/doc/0b02df1533fe2fb4
ポート競合が起きるときの疑うこと
同じポートを別プロセスが使っていて起動できない場合の対処をまとめています。原因の特定と、再起動前に確認したいポイントを紹介します。
https://papoo.work/doc/10b910d7c46f8a74
記事本文は日本語。実際に手元で実行した出力と、GitHub Issues の報告内容だけを根拠にしている。
過去の記事はこちら