Claude Codeのよくあるエラーと解決法まとめ【大全】——診断コマンドと対処早見表
Claude Code作業中に突然出る「ログインし直せ」「レート制限」「プロンプトが長すぎる」「MCPが繋がらない」——種類が多くて都度ググるのも面倒だ。本記事はClaude Codeでよく出るエラーを、原因と「叩くべきコマンド」付きで一覧化した実務リファレンス(大全)。まず初手の診断3コマンド(claude doctor=総合診断 / status=認証状態 / context=コンテキスト内訳)を押さえ、頻出4系統(使用量・レート制限/コンテキスト超過/認証切れ/MCP接続失敗)を中心に、認証・ログイン系、使用量/レート制限系(Claude Codeはチャットの10〜100倍消費)、コンテキスト/トークン系(Prompt is too long・compaction thrashing)、サーバー/モデル系(500/529/timeout/model not found)、インストール/PATH/更新系、ネットワーク/プロキシ系(ECONNREFUSED・TLS)、MCP系、権限/ツール系(bypassでもdeny優先)、thinking blocks 400・画像/PDF・IDE連携まで、症状→原因→対処コマンドの表で網羅。最後にエラー→対処の早見表とFAQ。公式ドキュメント(2026年時点)準拠で、迷ったら診断3コマンド、直らなければclaude updateが基本型。