claude purge în Claude Code CLI

claude purge [cale] [--dry-run] [-y] [-i] [--all]

Ce face claude purge

claude purge șterge starea pe care Claude Code o ține pentru un proiect: transcriptele și memoria automată din projects/, intrările per sesiune din tasks/, debug/ și file-history/, prompturile tastate în proiect din history.jsonl și intrarea proiectului din ~/.claude.json. Fără cale, alegi proiectul dintr-o listă interactivă. Înainte de v2.1.288 comanda se numea claude project purge.

Comanda afișează planul complet de ștergere și cere confirmare înainte să șteargă ceva. --dry-run doar arată planul, -y/--yes sare peste confirmare, -i cere confirmare pentru fiecare element, iar --all curăță toate proiectele și șterge history.jsonl complet, în loc să-l filtreze. Dacă nicio stare nu corespunde căii, comanda afișează o eroare și iese cu 1.

Ce nu atinge: imaginile lipite și directorul scratchpad al sesiunilor, care stau în directorul temporar, precum și shell-snapshots/ și backups/, care nu țin de un proiect (planul te avertizează despre ele). Nici fișierele .heapsnapshot scrise de /heapdump nu sunt șterse, deși conțin conversația completă și credențialele din proces.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
[cale]	Directorul proiectului. Fără ea, alegi proiectul dintr-o listă.
--dry-run	Afișează planul fără să șteargă nimic.
-y, --yes	Sare peste confirmare, pentru scripturi.
-i, --interactive	Confirmă fiecare element din plan pe rând.
--all	Curăță toate proiectele; șterge history.jsonl complet.

Exemple practice de terminal

Exemplul 1: Previzualizarea a ce s-ar șterge

Planul listează fiecare element și motivul pentru care e inclus.

claude purge ~/work/my-repo --dry-run

Ieșire în terminal

Purge plan for /home/user/work/my-repo:

  dir:    /home/user/.claude/projects/-home-user-work-my-repo
           project transcripts (.jsonl) and memory/
  config: projects["/home/user/work/my-repo"]
           project entry in ~/.claude.json (trust, history, MCP servers)
  filter: /home/user/.claude/history.jsonl
           12 prompt(s) typed in this project

shell-snapshots/ are not project-scoped and will not be touched
backups/ may still contain this project entry in old .claude.json snapshots (/home/user/.claude/backups); at most 5 are kept and they rotate out automatically
Dry run: 3 item(s) would be deleted.

Exemplul 2: Ștergerea cu o singură confirmare

După plan, comanda întreabă dacă ștergi elementele și avertizează că operația nu poate fi anulată; șterge doar dacă răspunzi y.

claude purge ~/work/my-repo

Exemplul 3: Ștergerea fără confirmare, într-un script

claude purge ~/work/my-repo --yes

Greșeli frecvente și bune practici

• Rulezi purge și apoi încerci să reiei o sesiune veche. Cu transcriptele dispar --resume, --continue, rewind și memoria automată pentru acel proiect.
• Uiți de fișierele .heapsnapshot generate de /heapdump. Conțin conversația și credențialele procesului; șterge-le manual.
• Ștergi de mână ~/.claude.json, ~/.claude/settings.json sau ~/.claude/plugins/ ca să faci curat. Acolo stau contul, preferințele și plugin-urile instalate.

Comenzi înrudite

• claude-resume
• slash-heapdump
• claude-config