Claude Code を使っていて詰まったときの切り分けメモです。GitHub Issues に実際に報告されている症状のうち、複数人が同じことを踏んでいるものを選び、手元で実際にコマンドを叩いて確認した範囲だけを書いています。本文は PaPoo 側に置いてあります。
起動直後に落ちる原因の切り分け
Claude Code が起動直後に異常終了する場合に、環境要因と実行条件を順に確認して原因を絞り込む手順をまとめています。
https://papoo.work/doc/ba55065e7dcddbfe
OAuth 認証が接続失敗する時の確認点
認証途中で接続できなくなるケースを対象に、プロキシやネットワーク設定、遷移先の確認ポイントを整理しています。
https://papoo.work/doc/601b98650a637531
bash が見つからない時の対処
実行時に bash を呼び出せない問題について、PATH やシェル設定、起動環境の違いを確認して復旧する流れを解説します。
https://papoo.work/doc/cd4ffa0f8f0947f0
メッセージ一覧の不整合を追う
メッセージ数とキー数がずれる不整合エラーについて、表示状態や履歴の扱いを見直しながら発生箇所を探る内容です。
https://papoo.work/doc/50057022d4db8f74
履歴件数のずれを調べるポイント
メッセージ一覧の件数差で起きるエラーを題材に、再現条件の確認やデータ更新のタイミングを中心に切り分けます。
https://papoo.work/doc/f4be2207823543cb
記事本文は日本語。実際に手元で実行した出力と、GitHub Issues の報告内容だけを根拠にしている。
過去の記事はこちら