OpenAI ha pubblicato una spiegazione tecnica della sandbox di Codex, il meccanismo che controlla cosa può fare l'agente quando esegue comandi direttamente sul computer dell'utente. Il punto di partenza è semplice: Codex lavora nell'ambiente già esistente di chi lo usa, e per questo servono confini chiari su file e rete.

Psst!Aggiungi AlexTech.ai comeFonte Preferita su Google

Una sandbox limita ciò che un programma può toccare mentre è in esecuzione. Un esempio concreto: per riordinare le foto si può permettere ai comandi di leggere e modificare la cartella delle immagini, bloccando però la rete per impedire upload. Per una revisione del codice, invece, si può consentire l'accesso alla documentazione online lasciando i sorgenti in sola lettura. Questi vincoli si configurano tramite profili di permesso, che definiscono le restrizioni su file system e rete per ogni sessione.

Le scelte di default

official image of Codex sandbox

Immagine: OpenAI — https://openai.com/codex/

Il profilo predefinito, chiamato :workspace, consente la scrittura solo all'interno della cartella di progetto, mantenendo in sola lettura cartelle sensibili come .git e .codex. In questo modo Codex può modificare il codice senza chiedere conferma per ogni cambiamento, ma non può alterare direttamente la configurazione o gli hook di Git.

Le letture del file system restano invece ampie, perché compilatori, runtime e strumenti di build dipendono da SDK e librerie installati fuori dal progetto. Limitarle alla sola cartella di lavoro romperebbe molti flussi ordinari. Il prezzo di questa scelta è che file sensibili altrove sul computer, come configurazioni con chiavi API, possono restare leggibili.

La rete, invece, è disabilitata. Così si bloccano i tentativi di inviare dati a servizi esterni, ma si impedisce anche il download delle dipendenze, che richiede un'autorizzazione specifica.

OpenAI ammette che questi limiti non eliminano ogni rischio. Un agente potrebbe, per esempio, inserire codice dannoso in un pacchetto già installato nella cartella dei moduli: una modifica che Git potrebbe non segnalare, perché quella cartella è spesso esclusa dal controllo di versione. Se l'editor dell'utente esegue quel pacchetto al salvataggio, il codice malevolo girerebbe fuori dalla sandbox. È il motivo per cui l'azienda affianca alla sandbox l'addestramento e l'allineamento del modello, che devono orientarne l'uso verso l'intenzione dell'utente.

Perché non usare container o macchine virtuali

Le soluzioni più diffuse per isolare un processo sono le macchine virtuali e i container. Codex segue un'altra strada: non sposta il calcolo in un ambiente separato, ma usa gli strumenti di sicurezza nativi di ciascun sistema operativo per vincolare i comandi nell'ambiente dell'utente.

Il motivo è pratico. Molti sviluppatori usano il proprio portatile come ambiente di lavoro personalizzato, e ricrearlo in un container richiede tempo. Il caso di uno sviluppo per iOS su Mac rende l'idea: in Docker, Codex non potrebbe eseguire la toolchain di build né avviare il simulatore dell'iPhone. OpenAI preferisce quindi investire nella sandbox specifica per ciascun sistema, così da far girare Codex nell'ambiente più adatto al compito.

La stessa interfaccia di programmazione viene esposta su macOS, Windows e Linux. Riceve un comando e un profilo di permessi e, se la rete è parzialmente consentita, richiede anche un proxy che applichi i limiti. Ogni processo figlio eredita le restrizioni del genitore, incluse quelle dei discendenti che sopravvivono al processo originale.

Chi può personalizzare i permessi

La configurazione è pensata per utenti singoli e aziende. Chi lavora in un contesto aziendale può definire profili di permesso più stretti e combinarli con altre protezioni. Gli sviluppatori che vogliono riutilizzare la sandbox nei propri strumenti possono farlo tramite la stessa API.

Secondo OpenAI, la scelta di non appoggiarsi a un ambiente virtuale mantiene il lavoro più vicino a quello che l'utente fa ogni giorno, ma sposta una parte della responsabilità sulla correttezza di ciascun meccanismo nativo. Per ora l'azienda documenta i profili disponibili e le loro conseguenze, lasciando a chi usa Codex la decisione su quanta fiducia concedere all'agente.

Il tema non è nuovo per AlexTech. Anthropic ha rilasciato sandbox-runtime, una tecnologia open source che isola i processi su macOS e Linux con un approccio simile, e che in questo articolo abbiamo descritto nei dettagli. Il confronto mostra che la questione dei confini di accesso è diventata centrale per tutti gli strumenti di coding agentico.