Claude Code hooksが動かない・発火しない原因を、公式トラブルシュートとGitHub Issueの実例から全部洗い出した
Claude Codeのhooksを設定したのに動かない・発火しない原因を、公式ドキュメントの診断手順とGitHub Issueの実例をもとに整理。matcher・JSON構文・実行権限から、silentに死ぬ既知の不具合パターンまで症状別にまとめた。
#トラブルシュート
14 articles
Claude CodeのCPU使用率が高い・張り付く問題を、GitHub Issueの実例で整理した
Claude Codeがアイドル時でもCPU使用率100%に張り付き、ファンが回り続ける・バッテリーが減る原因を整理。レンダーバッファの肥大化・孤立サブエージェント・LSPクラッシュループなど5パターンをGitHub Issue実例つきで解説し、診断コマンドと対処法をまとめた。
Claude CodeがWSLで重い・権限プロンプトが消えない——症状別に公式ドキュメントとGitHub Issueで原因を特定した
Claude CodeをWSL2で使うと応答開始まで1〜6分かかる、起動直後にフリーズする、settings.jsonの許可設定が効かない——症状別にGitHub Issueと公式ドキュメントの一次情報で原因を切り分け、対処法とネイティブWindows/WSLの選び方をまとめた。
Claude Codeのサブエージェントが応答しない・固まる問題を、GitHub Issueの実例で切り分けた
Claude Codeのサブエージェント(Task tool)が応答しない・Runningのまま固まる症状を、GitHub Issueの実例から3パターンに分類。公式にタイムアウト機能がない実情と、/tasks・環境変数を使った現実的な対処法を整理した。
Claude Codeが「JavaScript heap out of memory」で落ちる原因を、GitHub Issueの実例で整理した
Claude Codeが「FATAL ERROR: JavaScript heap out of memory」でクラッシュする原因を解説。.claude.json肥大化・長時間セッション・--resume・MCP重処理の4パターンをGitHub Issue実例つきで整理し、NODE_OPTIONSでの即効対処から恒久対策まで手順化した。
Claude Codeの解約方法——Web版Claudeの解約とは別物、API課金は「解約」できない理由
Claude Code解約の実態を整理。Pro/Max個人プランの解約手順、解約後にClaude Code CLIがどうなるか、Console経由(従量課金)には解約ボタンがない理由、Team/Enterpriseの管理者制約、返金ポリシーまで公式ドキュメントで裏取りした。
Claude Codeの429エラー(Rate Limit)、使用量制限との違いを公式ドキュメントで切り分けた
Claude Codeで429エラーが出ても、それはプランの月内制限とは別物。使用量制限・APIレート制限・529オーバーロードの違いを公式ドキュメントで整理し、原因別の対処法とヘッダー活用法をまとめた。
Claude Codeのインストールが「Killed」で落ちる原因、公式ドキュメントで潰した——格安VPSのメモリ不足対処法
Claude CodeをVPSにインストールすると出る「Killed」エラーの正体を解説。Linux OOM Killerの仕組み、スワップ追加の手順、Dockerでインストールがハングする別問題まで、公式ドキュメントベースで整理した。
Claude Code MCPが「接続できない」原因を、公式ドキュメントの症状別対処表で全部洗い出した
Claude CodeでMCPサーバーが「Failed to connect」になる原因を公式ドキュメントとGitHub Issueの実例から整理。/mcp・/doctorでの一次診断から、ENOENT・パス問題・env未伝播・承認待ちまで症状別に対処法をまとめた。
Claude Codeが「process exited with code」で落ちる原因を全部洗い出した
Claude Codeの「process exited with code 1/3/127/137」エラーを原因別に整理。認証競合・Windows特有のクラッシュ・OOM・新設定sandbox.network.strictAllowlistまで、切り分け手順つきで解説する。
Claude Codeが2時間47分止まった日。フリーランスが障害に備えてやるべきこと
2026年7月29日19:49〜22:36 UTC(日本時間30日朝)、Claude全体で529エラーが多発する障害が発生。年初から155件の障害が報告される中、Claude Code依存で仕事してるフリーランスがステータス監視・こまめなコミット・セッション設計で備える具体策を整理する。
Claude CodeのMCP呼び出しが固まらなくなった——2026年7月アップデートで変わった3つのこと
Claude Codeで長時間かかるMCPツール呼び出しが入力欄ごと固まる問題、2026年7月アップデート（v2.1.212〜v2.1.214）で自動バックグラウンド化された。仕組みを一次情報から検証し、EndConversationツール・権限チェック強化の実務影響まで解説する。
Claude Codeが突然バグる本当の理由を、実測データで特定した
Claude Codeがフリーズ・幻聴・生ログ吐き出しを起こす原因を実測データで解剖。空きメモリ103MB・スワップ2700万回の計測結果、コンテキスト自己中毒（self-poisoning）の仕組み、前兆3段階サイン、セッション引き継ぎ手順まで。
Claude Code エラー復旧パターン集——タスク失敗から立ち直る7つのテクニック
Claude Codeで本当に詰まったときの復旧手順を実体験ベースでまとめた。セッションクラッシュ・無限ループ・permission暴走・context overflow・ファイル破壊・bg agent暴走・コスト異常検知まで、7つのシナリオ別に具体的な復旧コマンドと設計を解説。