Claude Code /heapdump: AIが遅くなったときメモリを診断する

作業を長く続けていると、Claude Codeが最初より鈍くなる瞬間が訪れます。入力の反応が遅くなり、ファンが回り、何かが詰まった感じがします。こんなとき「なぜ遅くなったのか」を勘で推測せず、実際のメモリ状態を取り出して見られるコマンドが/heapdumpです。

定義（何かというと）

/heapdumpは、Claude Codeが今メモリをどう使っているか、その瞬間の状態をファイルに保存するコマンドです。

ここでヒープ（heap）とは、プログラムが実行中にデータを積み上げておくメモリ空間のことです。ダンプ（dump）は、その空間の中身をまるごと取り出してファイルに書き出すことを意味します。だからヒープダンプ（heapdump）は「今この瞬間、メモリに何がどれだけ積まれているかを撮ったスナップショット」だと考えればよいです。

写真を撮っておけば後でゆっくり見られるように、メモリのスナップショットを取っておけば、何がメモリを食っているのかを分析できます。

使い方（難易度別）

基礎 — スナップショットを一度取る

Claude Codeが重くなったと感じたら、そのまま入力します。

/heapdump

こうすると現在のメモリ状態がスナップショットファイルとして保存されます。特別なオプションなしで一行で終わりです。

応用 — 取ったファイルを分析する

スナップショットを保存すること自体は簡単ですが、そのファイルを読むには別のツールが必要です。ヒープスナップショットは通常、Chrome開発者ツール（Chrome DevTools）のMemoryタブで開ける形式で保存されます。

分析の流れはこうです。

1. 遅くなった時点で/heapdumpを実行してスナップショットを保存します。
2. 保存されたファイルのパスを確認します（実行後に画面にパスが表示されます）。
3. Chromeブラウザを開き、開発者ツール（F12）→ Memoryタブでそのファイルを読み込みます。
4. どのデータがメモリを多く占めているかをリストで確認します。

発展 — 時点を分けて比較する

メモリリーク（memory leak、使っていないデータが溜まり続けてメモリが漏れる現象）を疑うなら、スナップショットを2回取って比較するのが効果的です。

/heapdump

作業を始めた直後に一度、そしてしばらく作業して遅くなった後にもう一度取っておきます。2つのスナップショットを比較すると、時間が経つにつれ異常に膨らんだデータが何かが見えてきます。正常なら一定の水準で保たれるはずなので、増え続ける項目があれば、それが犯人である可能性が高いです。

よくある落とし穴

• スナップショットファイルは思ったより大きいです。数十MBから数百MBになることもあるので、分析が終わったら消すのがよいです。
• /heapdumpは診断ツールにすぎず、メモリを減らしたり問題を直したりはしません。原因を見つける最初の段階だと考えてください。
• スナップショットを取る瞬間、少しだけ止まることがあります。メモリをまるごと読んでファイルに書く作業だからです。正常なので慌てないでください。

実践事例

ある初心者開発者が大きなプロジェクトでClaude Codeを数時間動かしていたところ、入力が目に見えて遅くなりました。再起動すると一瞬よくなるものの、また遅くなるパターンが繰り返されました。このとき作業の序盤と遅くなった後の2回/heapdumpを取って比較すると、特定のデータが溜まり続けているのを発見しました。重い作業を細かく分けてセッションを新しく始める習慣に変えると、問題は消えました。

こう使うともっといい

メモリ診断が必要なほどなら、その前後で一緒に使うとよいコマンドがあります。環境自体に異常がないか点検するには/doctorでClaude Codeのインストール状態を確認し、デバッグ情報をもっと見たいなら/debug系のコマンドを一緒に見てみてください。/heapdumpで「メモリが問題だ」と確認できたら、次は作業のやり方をどう軽くするかを考える段階に進めばよいです。

まとめ

/heapdumpは、Claude Codeが重くなったときにメモリ状態を写真のように取っておく診断コマンドです。一度取れば現在の状態を、2回取って比較すればメモリが漏れているかどうかがわかります。勘で推測せず、実際のデータを見て判断したいときに使ってください。

基準：Claude Code v2.1.154（2026.05）