/heapdump în Claude Code CLI

Configurare și Securitate Claude Code 2.1+

Scrie un snapshot al heap-ului JavaScript și o defalcare a memoriei, pentru diagnosticarea consumului mare de memorie. Comandă ascunsă din meniu.

Sintaxă & invocare
/heapdump

Ce face /heapdump

/heapdump scrie două fișiere în ~/Desktop (sau în directorul home, pe Linux fără folder Desktop): un snapshot <session-id>.heapsnapshot și o defalcare a memoriei <session-id>-diagnostics.json. Comanda este ascunsă din meniul /, deci trebuie tastată complet.

În conversație apare și un rezumat: memoria totală a procesului, cât este în heap-ul JS și cât în afara lui, plus indicatori de scurgere de memorie, cum ar fi o rată mare de creștere sau un număr neobișnuit de mare de handle-uri deschise. Rezumatul spune dacă majoritatea memoriei este în heap-ul JS, pe care snapshot-ul îl surprinde, sau în memoria nativă, pe care nu o surprinde.

Pentru raportare, deschide un issue pe GitHub și atașează doar fișierul -diagnostics.json, care nu conține conversație sau credențiale. Ca să investighezi singur, deschide .heapsnapshot în Chrome DevTools, la Memory → Load, și sortează după retained size. Înainte de asta, documentația recomandă /compact, repornirea între sarcini mari sau claude --safe-mode, ca să vezi dacă un plugin, un server MCP sau un hook cauzează problema.

Exemple practice de terminal

Exemplul 1: Capturarea memoriei

> /heapdump

Exemplul 2: Eliberarea memoriei fără a pierde conversația

Când heap-ul trece de 2,5 GB apare un avertisment; repornești Claude Code și reiei conversația într-un proces nou.

claude --continue

Greșeli frecvente și bune practici

  • Atașezi fișierul .heapsnapshot la un issue public. El conține toate șirurile din proces, inclusiv conversația completă și credențialele.
  • Cauți /heapdump în meniul de comenzi. Este ascuns; tastează numele complet.

Comenzi înrudite