Economii

PRECC urmărește economiile estimate de tokeni din fiecare interceptare. Folosiți precc savings pentru a vedea cât de mult risipă a prevenit PRECC.

Rezumat rapid

$ precc savings
Session Token Savings
=====================
Total estimated savings: <span data-stat="session_tokens_saved">8,741</span> tokens

Breakdown:
  Pillar 1 (cd prepends):         <span data-stat="session_p1_tokens">3,204</span> tokens  (<span data-stat="session_p1_count">6</span> corrections)
  Pillar 4 (skill activations):   <span data-stat="session_p4_tokens">1,560</span> tokens  (<span data-stat="session_p4_count">4</span> activations)
  RTK rewrites:                   <span data-stat="session_rtk_tokens">2,749</span> tokens  (<span data-stat="session_rtk_count">11</span> rewrites)
  Lean-ctx wraps:                 <span data-stat="session_lean_tokens">1,228</span> tokens  (<span data-stat="session_lean_count">2</span> wraps)

Detaliere completă (Pro)

$ precc savings --all
Session Token Savings (Detailed)
================================
Total estimated savings: <span data-stat="session_tokens_saved">8,741</span> tokens

Command-by-command:
  #  Time   Command                          Saving   Source
  1  09:12  cargo build                      534 tk   cd prepend (cargo-wrong-dir)
  2  09:14  cargo test                       534 tk   cd prepend (cargo-wrong-dir)
  3  09:15  git status                       412 tk   cd prepend (git-wrong-dir)
  4  09:18  npm install                      824 tk   cd prepend (npm-wrong-dir)
  5  09:22  find . -name "*.rs"              387 tk   RTK rewrite (output truncation)
  6  09:25  cat src/main.rs                  249 tk   RTK rewrite (lean-ctx wrap)
  7  09:31  cargo clippy                     534 tk   cd prepend (cargo-wrong-dir)
  ...

Pillar Breakdown:
  Pillar 1 (context resolution):   <span data-stat="session_p1_tokens">3,204</span> tokens  <span data-stat="session_p1_pct">36.6</span>%
  Pillar 2 (GDB debugging):            0 tokens   0.0%
  Pillar 3 (mined preventions):        0 tokens   0.0%
  Pillar 4 (automation skills):    <span data-stat="session_p4_tokens">1,560</span> tokens  <span data-stat="session_p4_pct">17.8</span>%
  RTK rewrites:                    <span data-stat="session_rtk_tokens">2,749</span> tokens  <span data-stat="session_rtk_pct">31.5</span>%
  Lean-ctx wraps:                  <span data-stat="session_lean_tokens">1,228</span> tokens  <span data-stat="session_lean_pct">14.1</span>%

Cum sunt estimate economiile

Fiecare tip de corecție are un cost estimat în tokeni bazat pe ce s-ar fi întâmplat fără PRECC:

Tip de corecție	Economie estimată	Raționament
cd prepend	~500 tokens	Ieșire eroare + raționament Claude + reîncercare
Activare abilitate	~400 tokens	Ieșire eroare + raționament Claude + reîncercare
RTK rewrite	~250 tokens	Ieșire verbosă pe care Claude ar fi trebuit să o citească
Lean-ctx wrap	~600 tokens	Conținut fișiere mari comprimat
Prevenire învățată	~500 tokens	Tipar de eroare cunoscut evitat

Acestea sunt estimări conservatoare. Economiile reale sunt adesea mai mari deoarece raționamentul Claude despre erori poate fi verbos.

Economii cumulative

Economiile persistă între sesiuni în baza de date PRECC. În timp, puteți urmări impactul total:

$ precc savings
Session Token Savings
=====================
Total estimated savings: <span data-stat="session_tokens_saved">8,741</span> tokens

Lifetime savings: <span data-stat="total_tokens_saved">142,389</span> tokens across <span data-stat="total_sessions">47</span> sessions

Bara de stare

După instalare, PRECC adaugă o intrare statusLine în ~/.claude/settings.json astfel încât bara de stare Claude Code să afișeze metrici de sesiune în timp real:

$0.42 spent | 1.2M in/out | 📊 last cmd: −1.2K | PRECC: 7 fixes | 5.8ms avg | this session: 320 saved over 7 cmds (~$0.05) | lifetime: 8.9K saved over 217 cmds (~$2.85)

Setați PRECC_LANG pentru a afișa etichetele în limba dvs. — vedeți capitolul Localizare.

Fiecare segment:

Segment	Sursă	Semnificație	Se resetează la repornirea sesiunii?
`$0.42 spent`	`cost.total_cost_usd`	Costul cumulativ al sesiunii raportat de Claude Code	Da
`1.2M in/out`	`total_input_tokens + total_output_tokens`	Tokeni de intrare (necachetați) + ieșire pe durata sesiunii	Da
`📊 last cmd: −1.2K`	Măsurarea PRECC a celei mai recente comenzi Bash	Economisire reală măsurată prin reexecutarea comenzii originale	Nu (persistă între sesiuni)
`PRECC: 7 fixes`	`metrics.log`	Numărul de corecții din această sesiune — doar numărul, fără estimare falsă de tokeni	Da
`5.8ms avg`	Latența hook-ului PRECC p50	Timpul petrecut de PRECC procesând fiecare apel de instrument	Da
`bash 18% of total`	`post_observations.log`	Cota de tokeni ai sesiunii proveniți din ieșirea Bash — clarifică de ce economiile PRECC sunt în mod natural o fracțiune din costul total (PRECC optimizează doar ieșirea Bash)	Da
`this session: 320 saved over 7 cmds (~$0.05)`	`.lifetime_summary.json` − baseline	Delta reală per sesiune. Ascunsă când delta este zero (începutul sesiunii)	Da (linia de bază se recapturează)
`lifetime: 8.9K saved over 217 cmds (~$2.85)`	`.lifetime_summary.json`	Tokeni cumulativi economisiți și comenzi remăsurate de la prima instalare a PRECC, plus o valoare estimată în USD la tariful curent per token	Nu

Segmentul lifetime: este plasat ultimul pentru a fi primul trunchiat dacă interfața Claude Code taie bara la marginea dreaptă.

De ce costul și numărul de tokeni nu se împart

1.2M in/out afișat nu este numitorul care a produs $0.42 spent. cost.total_cost_usd al Claude Code este calculat din defalcarea completă a tokenilor API — intrare de bază, ieșire, plus citiri din cache și creări de cache. Numărătoarea cumulativă a tokenilor de cache la nivel de sesiune nu este expusă în schema statusline, așa că PRECC poate afișa doar partea vizibilă (non-cache).

În sesiunile lungi cu multe recitiri de fișiere, citirile din cache pot fi de 10× numărul vizibil de tokeni. De aceea împerecherea lor ca raport ar fi înșelătoare — PRECC le afișează în schimb ca segmente independente.

De ce PRECC nu calculează costul

Numărul costului este autoritar. PRECC citește cost.total_cost_usd textual din JSON-ul pe care Claude Code îl trimite prin stdin către comanda de stare. Este același număr pe care Claude Code îl scade din bugetul tău de abonament/utilizare. Îl poți verifica oricând cu comanda slash încorporată /cost — ambele ar trebui să coincidă.

Ce determină costul

Pentru Claude Opus 4.6:

Token type	Standard (≤200k context)	1M context tier
Input	$15 / MTok	$30 / MTok
Output	$75 / MTok	$150 / MTok
Cache write	$18.75 / MTok	$37.50 / MTok
Cache read	$1.50 / MTok	$3 / MTok

Cei mai mari factori în sesiunile lungi sunt de obicei tokenii de ieșire (cel mai scump tip per token, în special la nivelul de context 1M), citirile repetate din cache (ieftine individual dar acumulându-se rapid peste multe ture) și creările de cache (scrise o dată per citire de fișier la ~1.25× tariful de bază al intrării). PRECC reduce costul tokenilor vizibili prin comprimarea ieșirii Bash (segmentul 📊 last cmd: afișează economia per comandă), dar nu poate reduce citirile din cache ale fișierelor pe care Claude le-a încărcat deja.

Numărători de sesiune stabile

Segmentul “PRECC: N fixes” numără evenimentele de la începutul sesiunii persistat, scris în ~/.local/share/precc/sessions/<session_id>.start la prima reîmprospătare a statusline-ului din fiecare sesiune. Acest lucru face numărătoarea monotonă — nu poate scădea la mijlocul sesiunii chiar dacă cost.total_duration_ms lipsește la o anumită reîmprospătare.

Instantaneu pe durata vieții actualizat automat

Segmentul lifetime: citește ~/.local/share/precc/.lifetime_summary.json, care este rescris la fiecare măsurare PostToolUse și la fiecare invocare precc savings. Segmentul this session: citește același fișier lifetime, dar scade o linie de bază per sesiune persistată la prima reîmprospătare a fiecărei sesiuni. Nu este necesară reîmprospătare manuală — fișierele se actualizează singure.

Suprimarea barei de stare

Dacă preferați să păstrați bara de stare existentă, setați-vă propria comandă statusLine în ~/.claude/settings.json. Programul de instalare al PRECC va detecta valoarea personalizată și o va lăsa neatinsă la actualizările ulterioare.

Pentru a suprima doar linia 📊 PRECC per interacțiune (în additionalContext), setați PRECC_QUIET=1 în mediul shell.

PRECC’s three savings mechanisms each have a counterpart in the recent literature. These are related work — the ideas PRECC’s design draws on. Their reported figures are their measurements, not PRECC’s: PRECC only ever quotes numbers measured on your own machine (see “measured, not estimated”, above).

Output/trajectory trimming (PRECC’s diet + bash-output compression) — Reducing Cost of LLM Agents with Trajectory Reduction (AgentDiet), FSE 2026, arXiv:2509.23586. Removes redundant/expired trajectory content post-hoc; reports −39.9–59.7% input tokens. PRECC applies the same idea pre-execution and deterministically (no extra LLM call).
Skills as programs (PRECC’s mined + builtin rewrite skills) — Harnessing LLM Agents with Skill Programs, arXiv:2605.17734. Frames reusable agent skills as executable program functions — the same analogy behind PRECC’s command-rewrite skills (a pattern → a deterministic rewrite).
Context compression (PRECC’s compress + lean-ctx wrapping) — Compress the Context, Keep the Commitments: A Formal Framework for Verifiable LLM Context Compression, arXiv:2605.17304. Recent work on compressing context without losing required information — the property PRECC’s deterministic, cache-stable rewrites aim to preserve.

Keyboard shortcuts

PRECC User Guide