Che cosa è Claude Code cloud

Claude Code è l’agente di programmazione sviluppato da Anthropic, la società californiana dietro il modello Claude. Funziona accanto allo sviluppatore, sia dal terminale, dall’app desktop, dal browser o dall’app mobile, collaborando sulla base di un repository GitHub. La versione cloud esegue il codice su macchine virtuali gestite da Anthropic, consentendo di mantenere attiva la sessione anche con il portatile chiuso.

L’account @ClaudeDevs è dedicato agli sviluppatori e comunica aggiornamenti e nuove funzionalità. Il più recente annuncio, pubblicato il 6 novembre 2026, introduce il setup automatico di dipendenze, accessi di rete e chiavi API per gli abbonati ai piani Pro, Max e Ultra.

Perché il setup automatico è importante

Il primo avvio di un repository su una macchina pulita è spesso problematico: mancano librerie, gli host di rete sono bloccati e le chiavi API non sono presenti. Fino a poco tempo fa l’utente doveva scoprire manualmente i problemi, installare ciò che mancava e riprovare. Il nuovo meccanismo elimina questo “giro a vuoto”, consentendo al repository di funzionare al primo avvio.

Il processo copre tre aree principali:

    • dipendenze (librerie, pacchetti, SDK);
    • accessi di rete (host e domini autorizzati);
    • chiavi API (token e segreti).

Come avviare una sessione cloud

Le sessioni cloud possono essere avviate da claude.ai/code, dall’app desktop, dall’app mobile o direttamente dal terminale con il comando claude --cloud. È necessario un account Pro, Max o Ultra, tipicamente collegato a un repository GitHub.

Il nuovo modello di ambiente

Prima dell’annuncio, le sessioni cloud partivano da un ambiente predefinito chiamato Default. Secondo la documentazione ufficiale (consultata il 7 novembre 2026), Default non conteneva configurazioni personalizzate: la rete era in modalità Trusted, senza variabili d’ambiente né script di setup. Qualsiasi esigenza particolare richiedeva la creazione manuale di un nuovo ambiente.

Ora Claude, analizzando il repository, determina autonomamente:

    • quali dipendenze installare;
    • a quali host di rete collegarsi;
    • quali chiavi API sono necessarie.

Una volta creato l’ambiente, questo viene salvato così com’è. Alla successiva sessione sul medesimo repository, il lavoro non deve essere ripetuto. Le chiavi API sono salvate in modo sicuro e Claude non le visualizza mai.

Citazione ufficiale

— ClaudeDevs (@ClaudeDevs)
November 6, 2026
“Claude figures out what dependencies, network access, and API keys it needs, then saves the environment for next time. API keys are saved securely, so Claude never sees them.”

I quattro componenti di un ambiente cloud

Per comprendere cosa Claude compila al posto dell’utente, è utile osservare i campi esposti dalla documentazione sugli ambienti:

    • Livello di accesso alla rete: quattro valori (None, Trusted, Full, Custom). Trusted è il predefinito e consente l’accesso a registri di pacchetti e a domini dei principali cloud provider, incluso GitHub. Custom permette di definire una lista personalizzata di domini.
    • Variabili d’ambiente: file .env con coppie chiave=valore, leggibili da qualsiasi comando lanciato da Claude.
    • Script di setup: file Bash eseguito prima dell’avvio, utile per installare pacchetti mancanti.
    • Network secret: chiavi API o token salvati fuori dalla VM; il proxy di Anthropic aggiunge la chiave alle richieste verso gli host autorizzati dopo che la richiesta ha lasciato la macchina virtuale.

Changelog recente

Il changelog di Claude Code segnala che le sessioni lanciate dalle app e dal web ora partono anche se lo script di setup termina con errore, anziché bloccare l’avvio. Tuttavia, le richieste dello script non possono utilizzare i network secret, poiché il proxy si attiva solo dopo il completamento dello script.

Le chiavi API e la sicurezza

Una chiave API autorizza un programma ad accedere a servizi esterni (database, provider di pagamento, modelli di IA). Inserirla direttamente nelle variabili d’ambiente è rischioso, perché chiunque abbia accesso all’ambiente può leggerla. Con i network secret, la chiave rimane fuori dalla VM: le richieste HTTP vengono arricchite dal proxy con il token, ma il valore non è presente né nelle variabili né in file.

Questa scelta è motivata da un incidente di sicurezza: la falla SOCKS5 nella sandbox di rete di Claude Code, attiva dal 20 ottobre 2025 al 1 aprile 2026, permetteva a un attaccante di estrarre credenziali e codice sorgente. Tenere le chiavi fuori dalla VM elimina il vettore di furto in quel contesto.

Meccanismo non esplicitato

L’annuncio dichiara che le chiavi sono “salvate in modo sicuro, mai visibili a Claude”, ma non specifica che si tratta dei network secret né spiega come l’utente fornisca il valore della chiave quando Claude la identifica come necessaria.

Limiti e considerazioni operative

Al momento, la documentazione ufficiale non menziona il rilevamento automatico, quindi non è chiaro quali file Claude legga per individuare dipendenze o chiavi. Inoltre, il post di @ClaudeDevs non specifica se l’utente debba approvare gli host di rete o le chiavi rilevate. È consigliabile aprire l’ambiente salvato e verificare manualmente il contenuto prima di affidare credenziali di produzione.

Il setup automatico è dichiarato disponibile solo per i piani Pro, Max e Ultra. Per i piani Team ed Enterprise, la documentazione indica un modulo da compilare manualmente, salvo che un Owner attivi la configurazione rapida. Pertanto, le organizzazioni dovrebbero verificare con l’Owner interno la disponibilità della funzione.

Dettagli sui piani

Ultra è il nuovo nome del vecchio Max 20x (circa 200 USD al mese, senza limite di cinque ore per gli account verificati). Max, ora da 100 USD, e Pro hanno anch’essi accesso al setup automatico. L’ambiente Default viene creato automaticamente al momento dell’onboarding web per questi tre piani.

Collocazione nella roadmap di Claude Code

La novità arriva dopo una serie di rilasci intensi per le sessioni cloud:

    • 17 settembre 2026: presentazione di Claude Code Projects, thread paralleli nel cloud.
    • 23 settembre 2026: le sessioni cloud sono state rese disponibili fuori dall’anteprima.
    • 17 settembre‑23 settembre: miglioramenti di performance e stabilità.

Il setup automatico rappresenta il prossimo passo verso un’esperienza “plug‑and‑play” per gli sviluppatori, riducendo il lavoro manuale di configurazione e aumentando la sicurezza delle credenziali.

Conclusioni e consigli pratici

Il nuovo setup automatico di Claude Code cloud promette di semplificare il primo avvio di un repository, gestendo in modo autonomo dipendenze, rete e chiavi API. Tuttavia, gli sviluppatori dovrebbero:

    • Verificare l’ambiente salvato la prima volta, controllando host e variabili.
    • Assicurarsi che le chiavi API siano fornite tramite network secret e non inserite direttamente in .env.
    • Confermare con l’Owner dell’organizzazione se la funzionalità è attiva per i piani Team o Enterprise.
    • Tenere d’occhio gli aggiornamenti della documentazione, che potrebbe includere dettagli sul meccanismo di rilevamento automatico.

In sintesi, la funzionalità segna un miglioramento significativo per gli utenti Pro, Max e Ultra, ma richiede ancora una verifica attenta per garantire che le configurazioni automatiche siano conformi alle policy di sicurezza interne.