Claude Code を使っていて詰まったときの切り分けメモです。GitHub Issues に実際に報告されている症状のうち、複数人が同じことを踏んでいるものを選び、手元で実際にコマンドを叩いて確認した範囲だけを書いています。本文は PaPoo 側に置いてあります。
利用プランと機能制限の確認
契約プランにより使えない機能がある場合の確認ポイントを整理。設定や権限、プラン内容の見直しで原因を絞り込みます。
https://papoo.work/doc/018c7ea0199aee44
認証に失敗するときの確認項目
ログイン情報やトークン、接続先の設定など、認証エラーで最初に確認したい点をまとめています。再発防止の見直しにも役立ちます。
https://papoo.work/doc/b2a8af72c4adcd56
画像送信時の400エラー確認
画像付きリクエストで400系エラーが出る場合に、サイズや形式、データの渡し方をどう点検するかを整理した記事です。
https://papoo.work/doc/49b974013878af38
JSON Schema不備で出る400エラー
ツール定義のスキーマ不整合で返る400エラーについて、定義の書き方や検証手順、修正時の注意点をまとめています。
https://papoo.work/doc/dd8de747a160b29f
再試行停止時の確認ポイント
失敗の連続で機能が止まったように見える場面で、原因の切り分けと復帰までの確認事項を整理しています。
https://papoo.work/doc/540e59963dd69210
メッセージ一覧の不整合を調べる
メッセージ数と内部キーのずれが起きたときに、どこを見れば状況を把握できるかをまとめた切り分けメモです。
https://papoo.work/doc/d891b6ef46d777d9
接続タイムアウト時の確認項目
リモート接続がつながらない、時間切れになるときに、ネットワークや起動状態、設定面で確認したい点を整理します。
https://papoo.work/doc/05cdc9ddf7bf7007
メッセージ不整合の切り分けメモ
メッセージ一覧の件数ずれが起きた際に、再現条件や環境差をどう追うかを実践的にまとめた切り分け用の記事です。
https://papoo.work/doc/41db91644bf88ae9
一覧ずれ発生時に見るポイント
メッセージ件数の不一致に気づいたとき、原因候補を順番に確認していくためのチェックポイントを簡潔に整理しています。
https://papoo.work/doc/7849c836dca68cba
記事本文は日本語。実際に手元で実行した出力と、GitHub Issues の報告内容だけを根拠にしている。
過去の記事はこちら