Far girare Claude Code in automatico: i controlli prima di lasciarlo solo

Il changelog ufficiale di Claude Code registra la versione 2.1.227 il 10 agosto 2026, e due delle cinque voci riguardano sessioni in cui non c'è nessuno davanti allo schermo. È il dettaglio che interessa chi fa girare Claude Code in automatico. Una sessione non presidiata è una sessione che parte, lavora e termina senza che nessuno legga il terminale mentre succede, e questo cambia completamente il modo in cui un difetto si manifesta.

La voce più concreta della 2.1.227 dice che ogni comando Bash falliva sotto claude-code-action con allowed_non_write_users sui runner ospitati da GitHub. Non un comando ogni tanto in certe condizioni: ogni comando. Chi aveva quella configurazione attiva ha avuto un agente che apriva la sessione, provava a lavorare e non riusciva a eseguire niente.

Cosa corregge la versione 2.1.227

Claude Code 2.1.227, datata 10 agosto 2026 sul changelog ufficiale, corregge tre bug e migliora due comportamenti. Oltre al blocco dei comandi Bash sotto claude-code-action, sistema la valutazione dei feature flag quando una sessione parte con un token di login scaduto: senza il tier di abbonamento dell'utente, agli utenti del piano Max poteva essere chiesto per errore di attivare i crediti a consumo per Fable. Il terzo bug riguarda /tui, che riportava indietro una conversazione riavvolta prima del suo primo messaggio.

Le due voci restanti non sono correzioni ma rifiniture: il menu dei comandi slash ora colora di blu solo la riga selezionata e mette in grassetto i caratteri corrispondenti invece di ricolorarli, e le prestazioni migliorano con meno blocchi dell'event loop sui suggerimenti per file inesistenti e sui controlli di dimensione delle menzioni. La versione 2.1.226, uscita l'8 agosto 2026, porta la sola dicitura generica di correzioni e miglioramenti di affidabilità.

Perché una sessione senza nessuno davanti si rompe in modo diverso

In una sessione interattiva un difetto dura pochi secondi, perché chi guarda il terminale se ne accorge e reagisce. In una sessione automatica lo stesso difetto diventa un codice di uscita, e se il job che lo contiene non è costruito per interpretarlo diventa silenzio. È la ragione per cui i bug che colpiscono l'esecuzione non presidiata restano in giro più a lungo degli altri: non è che siano più rari, è che nessuno li segnala.

Il changelog di Claude Code 2.1.225, dell'8 agosto 2026, è pieno di questa categoria. Un errore 401 momentaneo sostituiva il token di lunga durata CLAUDE_CODE_OAUTH_TOKEN con il token a vita breve di un login salvato, rompendo le sessioni headless fino al riavvio. I messaggi tra sessioni restavano parcheggiati senza avviso e senza scadenza nelle sessioni headless e durante l'avvio. Le sessioni di Claude Code sul web venivano segnalate per errore come bloccate, e a ogni riconnessione rimandavano un arretrato di eventi sempre più grande.

La correzione che spiega meglio il problema è però un'altra, sempre nella 2.1.225: claude self-hosted-runner si registrava e poi falliva ogni sessione quando --base-dir non poteva essere creata o scritta, e ora esce all'avvio con un errore chiaro. Il comportamento nuovo non è "funziona", è "fallisce subito e in modo leggibile". Questa è la differenza che conta davvero quando si costruisce sopra un agente, e vale molto più di una funzionalità in più.

I controlli prima di far girare Claude Code in automatico

Prima di lasciare Claude Code in automatico su un repository che conta, ci sono quattro cose concrete da verificare, e sono tutte a costo zero.

1. Guarda quale versione gira dentro il job, non quella che hai in locale. L'aggiornamento automatico del client sulla tua macchina non dice niente su cosa viene installato dentro un runner effimero, che riparte pulito ogni volta.
2. Se usi claude-code-action con allowed_non_write_users su runner ospitati da GitHub, la 2.1.227 del 10 agosto 2026 è il minimo, perché è la versione che corregge il fallimento di ogni comando Bash in quella configurazione.
3. Se passi CLAUDE_CODE_OAUTH_TOKEN a una sessione headless, la 2.1.225 dell'8 agosto 2026 è il minimo, perché è la versione che impedisce a un 401 momentaneo di sostituirlo con un token a vita breve.
4. Decidi in anticipo la differenza tra "non configurato" e "guasto", e falla dire al job. Sono due stati diversi e vanno trattati diversamente, altrimenti si finisce per ignorare entrambi.

L'ultimo punto è quello che sul mio sito ho dovuto imparare per esclusione. Il controllo giornaliero dell'indice di Google gira in .github/workflows/stato-indice.yml alle 06:40 UTC, e nel file c'è scritto per esteso perché un secret assente fa terminare il job in verde invece di farlo fallire: fallire tutte le mattine per una cosa che si sa già insegna solo a ignorare le notifiche, e il giorno in cui il guasto è vero non lo guarda più nessuno. La stessa logica vale per un agente. Un job che urla ogni giorno diventa rumore, e il rumore è indistinguibile dal silenzio dopo la seconda settimana.

Lo stesso vale per le routine che scrivono su questo blog, documentate in automazione-blog/: girano schedulate, senza nessuno davanti, e il modo in cui sono costruite conta più della loro intelligenza. Il vincolo che le tiene in piedi è che ogni passaggio possa fermarsi da solo e dire perché, invece di proseguire con dati incompleti. Chi lavora con più sessioni di Claude Code che si parlano fra loro incontra lo stesso problema moltiplicato, perché una sessione che aspetta un messaggio che non arriverà mai non è distinguibile da una che sta ancora lavorando.

La cosa più utile che si ricava dal changelog di questa settimana non è quindi l'elenco dei bug. È che Anthropic sta chiudendo una classe precisa di difetti, quelli in cui l'errore c'è ma non arriva a nessuno, e che quella classe esiste perché far girare un agente in automatico è ancora un terreno giovane. Le novità nascoste nei rilasci minori di Claude Code meritano attenzione proprio per questo: le voci che sembrano marginali sono spesso quelle che riguardano il modo in cui lo strumento si comporta quando è solo.

Chi sta valutando di mettere un agente AI dentro un processo aziendale farebbe bene a partire da qui invece che dalle capacità del modello. La domanda giusta non è quanto è bravo l'agente quando funziona, ma cosa succede esattamente il giorno in cui smette, e quanto ci mette qualcuno ad accorgersene. Le note di rilascio complete stanno sul changelog ufficiale di Claude Code, ed è l'unico posto dove i singoli bug corretti sono elencati uno per uno.