← Tutti gli articoli

Features

Deep Scan: scopri dove finiscono davvero i token del tuo Claude Code

Deep Scan legge i transcript di Claude Code e Codex già presenti sulla tua macchina e mostra dove è finito il contesto: gratis, in locale, senza login.

Deep Scan: scopri dove finiscono davvero i token del tuo Claude Code

Di Ted Mavera, Product Manager di HarnessUp

Prima di poter tagliare qualcosa da una sessione con un agente, devi vederlo. È esattamente il compito di Deep Scan: legge le conversazioni già salvate sulla tua macchina e mostra, voce per voce, dove è finito il contesto. Nessuna chiamata al modello, nessuna registrazione, nessuna stima presa in prestito dall'account di qualcun altro. È il livello di misurazione di HarnessUp, la suite per risparmiare token su Claude Code e Codex, ed è gratis.

Questo articolo spiega cosa fa Deep Scan, a chi è rivolto, come eseguirlo e come leggere l'output senza raccontarti frottole.

Cosa fa davvero Deep Scan

Claude Code e Codex scrivono già le conversazioni su disco mentre lavori. Deep Scan apre quei transcript e li trasforma in una mappa della spesa: quali round sono cresciuti, cosa è stato reinviato da un round all'altro e quanta parte di una sessione è andata in lavoro reale rispetto al sovraccarico. Lo fa senza chiamare il modello, così misurare il tuo utilizzo non ti costa nulla in più.

Tre caratteristiche contano più dei grafici:

  • Gira in locale. HarnessUp è 100% locale. I tuoi transcript vengono letti sulla tua macchina e nulla esce da lì.
  • I numeri sono tuoi. Arrivano dalla tua cronologia, calcolati sul tuo schermo, e restano disponibili per una controverifica successiva, anche dopo che hai cambiato un'impostazione e vuoi sapere se è servita.
  • Provarlo non costa nulla. Nessun login, nessuna e-mail, nessuna password. Deep Scan e altri 19 strumenti di misurazione e monitoraggio sono gratuiti, così puoi calcolare lo spreco prima di decidere se un piano a pagamento vale la pena.

Deep Scan non è un report una tantum. È la testa di una catena: la misurazione ti dice quale degli altri strumenti vale la pena attivare, e gli strumenti ti danno qualcosa di nuovo da misurare.

A chi è rivolto

HarnessUp divide il suo pubblico in tre gruppi, e Deep Scan è il punto di partenza comune per tutti.

  • Chi ha un piano a quota fissa e sbatte contro il limite. Se la tua finestra di cinque ore si esaurisce molto prima che finisca la giornata, Deep Scan ti mostra quali round sono costati cari e se la causa era la rilettura, un output lungo o il modello che faceva un lavoro che uno più economico avrebbe potuto fare.
  • Chi paga tramite API. Quando ogni token finisce in fattura, la domanda utile non è "quanti token ho usato" ma "quali token non hanno comprato niente". Ed è esattamente ciò a cui risponde una vista per round.
  • Chi preferisce non vivere nel terminale. I risultati si leggono in un pannello, non analizzando i log. Il lavoro pesante avviene sotto l'harness.

Se da HarnessUp vuoi una sola cosa, la misurazione è una scelta difendibile. Un numero che puoi verificare vale più di una promessa di risparmio che non puoi verificare.

Come eseguirlo

  1. Installa HarnessUp. Il pacchetto è npm install -g harnessup, c'è un download per Windows e macOS e Linux sono supportati. Tutto gira sulla tua macchina. HarnessUp si aggancia tramite gli hook ufficiali di Anthropic e OpenAI, quindi funziona nella CLI, nell'app desktop e nelle estensioni IDE, con il tuo account o via API.
  2. Apri il pannello. Nessun account richiesto. Il pannello è il luogo dove misurazione e controllo convivono fianco a fianco.
  3. Esegui Deep Scan. Legge i transcript già salvati sulla tua macchina. Nulla viene caricato e nessun modello viene chiamato per produrre il report.
  4. Leggi il tuo valore di partenza. Guarda il contesto per round con e senza HarnessUp, e la percentuale di spreco tagliato. Considerali il tuo punto di partenza, non un punteggio.
  5. Attiva qualcosa e misura di nuovo. Nel pannello, i tasti da 1 a 8 attivano e disattivano gli strumenti, e Z annulla tutto. Cambia una cosa, guarda il misuratore e tieni la modifica solo se il numero si muove.

Leggere l'output con onestà

Due abitudini tengono uno strumento di misurazione utile invece che decorativo.

Primo, separa la demo dai tuoi dati. Il pannello arriva con valori dimostrativi illustrativi, così puoi vedere che aspetto ha l'interfaccia prima di avere una cronologia. I tuoi arrivano da Deep Scan, dai tuoi transcript, misurati dall'inizio alla fine. Se un numero è illustrativo, il pannello lo dice.

Secondo, leggi "fino a" come un tetto, non come una previsione. HarnessUp dichiara fino al 78% di token di lavoro risparmiati, fino al 350% in più di resa per token e fino a 3 volte più lavoro sullo stesso piano. Sono i guadagni più alti misurati in finestre reali, non una promessa sui tuoi. Il motivo per cui il prodotto ti mostra accanto il tuo dato è che il confronto onesto è tra il tuo prima e il tuo dopo.

"Fino a" significa: i guadagni più alti misurati in finestre reali. Il tuo numero compare nel pannello, misurato dall'inizio alla fine sulla tua cronologia, e resta disponibile per una controverifica.

Un modo rapido per leggere il pannello:

Cosa vediCosa ti diceCosa fare dopo
Contesto per round, con e senza HarnessUpQuanto si porta avanti ogni turno e con che velocità si gonfia una sessioneSe il divario è piccolo, lo spreco è probabilmente nell'output o nella scelta del modello, non nella rilettura
Percentuale di spreco tagliatoQuanta parte della spesa evitabile hanno rimosso gli strumenti attivi sulla tua cronologiaAttiva i tasti uno alla volta e guarda questo valore muoversi
Spesa per sessione e stato del limiteQuali sessioni sono costate care e se un limite avrebbe fermato una di esseImposta uno Stop Loss, così una sessione fuori controllo finisce invece di andare avanti

Dalla misurazione alla correzione

Deep Scan è diagnostico, non terapeutico. Il risparmio arriva dagli strumenti che attivi dopo, e ognuno punta a un passaggio diverso della fattura.

  • Output. Response Diet chiede all'agente una risposta diretta, blocca la rilettura di file già letti e taglia l'output gigantesco prima che entri nel contesto. Il preambolo ("Certo! Ti aiuto con piacere") viene pagato una volta e poi riletto in ogni round successivo.
  • Lettura. La fase di lettura ha il suo set di tasti, tra cui Delta Read, così l'agente non reingerisce ciò che non è cambiato.
  • Compressione. Smart Compress comprime senza chiamare il modello, il che evita che il risparmio ti costi un'altra richiesta.
  • Scelta del modello. Cheap Swarm decide in millisecondi quale subagent svolge ogni attività, con il modello e lo sforzo giusti, su 26 classi di attività: ricerca e lint su un modello leggero, mentre il modello costoso si limita a decidere.
  • Limiti rigidi. Stop Loss chiude la sessione quando la spesa raggiunge il suo tetto, così un loop andato storto non può consumare in silenzio una finestra.

Niente di tutto questo richiede di cambiare il modo in cui scrivi i prompt. Nell'app ci sono oltre 200 tasti a un clic, e ognuno può essere annullato con un clic: è proprio questo il senso di misurare prima. Non ti si chiede di fidarti di un valore predefinito; ti si chiede di guardare la tua cronologia e tenere ciò che aiuta.

Cosa resta sulla tua macchina

Deep Scan legge i transcript, e i transcript contengono codice, percorsi e a volte segreti. Per questo la garanzia di località è la riga più importante della specifica. HarnessUp esegue i claude e codex ufficiali con il tuo account e dichiara come impegno scritto che non legge, memorizza né trasmette mai il tuo token o la tua chiave. Non intercetta l'API; si aggancia ai punti hook ufficiali, e il livello locale gira con un p95 sotto i 50 ms.

Se la tua organizzazione ha regole sull'invio di dati di sessione a terze parti, quella architettura è la risposta: l'analisi avviene sullo stesso disco su cui i transcript si trovano già.

Parti dal numero, non dal pitch

Il risparmio di token è facile da dichiarare e difficile da percepire. Deep Scan rende la dichiarazione falsificabile sulla tua macchina: eseguilo, leggi i round che si sono gonfiati, attiva uno strumento, eseguilo di nuovo. Se il numero non si muove, disattiva lo strumento: l'annullamento è un tasto.

È questa la parte che mi interessa come product manager. Una suite che fa risparmiare fino al 78% dei token di lavoro è utile solo se puoi vedere quale 78% vale per te. La misurazione è come lo scopri, e guardare non costa nulla.

Questo articolo è stato redatto con l'aiuto dell'IA in HarnessUp Publish e approvato dal team di HarnessUp prima della pubblicazione.