Checklist API Claude prima del 1° settembre: come auditare i tuoi job prima del price increase

Checklist API Claude prima del 1° settembre: come auditare i tuoi job prima del price increase

Il 1° settembre 2026, Anthropic aumenta i prezzi di Claude Sonnet 5 del 50%. Input passa da $2 a $3 per milione di token. Output passa da $10 a $15.

Non è un aggiornamento di qualità: il modello resta lo stesso. È solo il prezzo. Ma se hai automazioni che chiamano Claude API, quell'aumento si accumula in silenzio ogni giorno fino al 31 agosto, e poi sale di un gradino fisso.

Ho 35+ automazioni su Claude. Prima di fare qualsiasi cosa, ho voluto sapere dove effettivamente uso Sonnet 5 e dove potrei cambiare senza perdere qualità.

Step 1: trova tutti i riferimenti a Sonnet 5

Il primo check è meccanico. Dal root del tuo progetto:

grep -r "claude-sonnet-5" ./ --include="*.json" --include="*.yaml" --include="*.ts" --include="*.py" --include="*.js"

Cerca anche nelle variabili di ambiente:

grep -r "claude-sonnet-5" ./ --include="*.env" --include="*.env.*"

E nei file di build e deploy:

grep -r "claude-sonnet-5" cloudbuild.yaml .cloudbuild/ 2>/dev/null

Se usi Anthropic SDK senza il parametro model esplicito, aggiungi:

grep -r "messages.create" ./ --include="*.ts" --include="*.py" -l

Apri ogni file trovato e verifica se model è specificato. Se manca: quel job usa il default corrente, che potrebbe essere Sonnet 5.

Step 2: classifica i job per tipo di task

Una volta che hai la lista, classifica ogni job:

1. Analisi, ragionamento complesso, scrittura strutturata: un pipeline che scrive un post da 800 parole, analizza un documento, genera codice non banale. Qui Sonnet 5 è giustificato. Haiku 4.5 perderebbe qualità visibile.
2. Lookup, routing, classificazione, estrazione strutturata: un job che estrae campi da un JSON, classifica un'email, decide quale tool chiamare, valida una condizione. Haiku 4.5 basta. Costa $1/$5 per MTok contro $3/$15. Il rapporto sull'output è 3x.
3. Chain con orchestratore e subagente: il task di coordinamento (decide cosa fare, quale tool) spesso gira bene su Haiku. Il task che genera il contenuto finale può restare su Sonnet 5.

Nella mia infrastruttura, circa metà dei job usa Sonnet 5 per abitudine, non per necessità. Haiku 4.5 nei task di routing non produce differenza di output percepibile.

Step 3: stima l'impatto mensile

Per ogni job che usa Sonnet 5, stima:

1. Token di input medi per chiamata
2. Token di output medi per chiamata
3. Numero di chiamate al mese

Formula:

Costo mensile attuale   = (input_tok / 1M) * 2  + (output_tok / 1M) * 10
Costo mensile da sett.  = (input_tok / 1M) * 3  + (output_tok / 1M) * 15

Esempio: un job genera 500 token di output per chiamata, gira 200 volte al mese.

1. 100.000 token di output / 1M = 0.1 MTok
2. Costo output attuale: $1.00 / mese
3. Costo output da settembre: $1.50 / mese
4. Delta: $0.50 / mese

Non sembra molto. Ma se hai 10 job simili: $5/mese di delta. Se un job genera output lunghi o gira con alta frequenza, l'impatto cresce in proporzione.

Il punto non è il costo assoluto. È sapere dove sei prima di essere sorpreso.

Step 4: testa Haiku 4.5 dove switching è realistico

Per ogni job classificato come routing/lookup nel passo 2:

1. Cambia model a claude-haiku-4-5-20251001 in locale
2. Gira 5-10 esempi reali con input rappresentativi
3. Valuta output: la qualità è accettabile per il task?

Se la risposta è sì: aggiorna il job. Il cambio è una riga.

Se la risposta è incerta: tienilo su Sonnet 5. Un aumento di 50 centesimi al mese su un job da 50 chiamate non giustifica il rischio di degradare la qualità.

Step 5: centralizza il nome del modello

Una cosa da fare adesso, una sola volta:

Non scrivere "claude-sonnet-5-20251022" in ogni file di ogni job. Centralizza in una variabile di ambiente:

CLAUDE_DEFAULT_MODEL=claude-sonnet-5-20251022
CLAUDE_FAST_MODEL=claude-haiku-4-5-20251001

Poi nei job:

model = os.environ.get("CLAUDE_DEFAULT_MODEL", "claude-sonnet-5-20251022")

La prossima volta che Anthropic aggiorna i prezzi o rilascia una versione nuova: cambi una variabile, non 20 file.

Checklist completa

1. grep tutti i riferimenti a claude-sonnet-5 nel codebase, variabili env, file di build
2. elenca ogni job che usa Sonnet 5 esplicitamente o implicitamente (chiamate senza model)
3. classifica: qualità critica vs routing/lookup/classificazione
4. stima impatto mensile per i top 5 job per volume di chiamate
5. testa Haiku 4.5 sui job classificati routing/lookup con esempi reali
6. aggiorna i job dove lo switch è verificato
7. centralizza il model name in una variabile di ambiente
8. deadline: tutto entro il 31 agosto 2026

Il check completo richiede 30-60 minuti se hai meno di 20 job. Molto meno se hai già centralizzato il model name. Se non l'hai fatto, aggiungi 15 minuti per sistemarlo adesso: sono 15 minuti che risparmiano tempo a ogni prossima deprecation.