Codex CLI 0.152.0: limiti di output MCP e sei novità

Codex CLI 0.152.0 è arrivato il 1 settembre 2026 con sei nuove funzionalità, ma il vero tema della release è un controllo più preciso sulle esecuzioni lunghe e ricche di chiamate ai tool. La novità principale permette di limitare l’output destinato al modello per ogni tool MCP, senza applicare ovunque la stessa policy di fallback.

Codex CLI in breve

È una release dedicata al controllo e all’affidabilità: non introduce un nuovo modello e non modifica i prezzi. Per chi usa Codex come semplice agente di coding nel terminale, i miglioramenti più evidenti sono messaggi più utili sui rate limit, un recupero delle credenziali più trasparente e la ricerca Vim nelle bozze lunghe.

Per chi collega Codex a sistemi esterni tramite MCP o sviluppa sull’app server di Codex, le novità sono più sostanziali. MCP, acronimo di Model Context Protocol, è il livello di connessione che consente a Codex di chiamare tool come la ricerca nella documentazione, Figma, GitHub o un servizio interno. Con la versione 0.152.0, ciascuno di questi tool può avere un budget di output dedicato.

Ecco le sei nuove funzionalità della release, organizzate in base a chi ne noterà gli effetti:

La prima riga è quella da capire davvero: cambia la quantità di contenuto prodotto dai tool che Codex porta con sé durante il lavoro.

Come funziona il limite di output MCP

Un tool MCP può restituire molto materiale. Una ricerca nella documentazione può produrre diverse pagine lunghe; una ricerca nei log, moltissime righe. Codex deve inserire quel risultato nel proprio contesto di lavoro, cioè la memoria a breve termine del modello per l’attività in corso.

Senza un’impostazione specifica per il singolo tool, l’output MCP continua a seguire la normale policy di troncamento del modello attivo. Con la versione 0.152.0 è possibile aggiungere la nuova impostazione output_token_limit a un determinato tool di uno specifico server MCP. Codex riduce quindi il risultato destinato al modello fino al budget di token configurato.

Il passaggio decisivo è destinato al modello. Il server MCP non esegue meno lavoro e Code Mode continua a ricevere il risultato grezzo. Il limite interviene quando il risultato entra nel contesto del modello e nella cronologia della conversazione. Codex conserva lo stesso budget effettivo anche nelle sessioni riprese e nelle risposte degli hook successivi alla chiamata del tool: riaprire un thread, quindi, non ripristina silenziosamente un payload più ampio.

Perché questo limite è importante

La domanda non è più «quanto output dei tool può tollerare questo modello?», ma «di quanto output ha bisogno questo specifico tool per svolgere il proprio compito?». Una consultazione di libreria e un dump dei log di produzione non devono più condividere la stessa risposta.

Esistono due protezioni. Il valore deve essere positivo, quindi 0 e i valori negativi vengono rifiutati. Se sia la policy di un plugin sia la configurazione personale definiscono un limite, prevale il valore più basso. L’approvazione dei tool resta separata: ridurre il budget di output non approva un tool e non cambia il momento in cui Codex chiede il permesso di chiamarlo.

Chi può usarlo e in che modo

Uno sviluppatore indipendente con un tool di documentazione troppo prolisso

Chi sviluppa un SaaS in autonomia può impedire che una ricerca estesa nella documentazione occupi il resto del turno di coding. Basta assegnare un budget esplicito al tool che restituisce pagine molto lunghe e lasciare invariati i tool di consultazione più precisi: resterà più contesto di lavoro per il repository, il piano e il diff.

È il caso d’uso più lineare della versione 0.152.0, perché il limite viene applicato proprio alla fonte del rumore. Non serve ridurre il budget di tutti i tool soltanto perché uno di essi restituisce troppo contenuto.

Un platform engineer che esegue job lunghi sull’app server

Il nuovo campo timeoutMs appartiene al metodo thread/shellCommand dell’app server. Non va confuso con l’impostazione MCP tool_timeout_sec.

La distinzione conta. Attualmente i tool MCP hanno un timeout di esecuzione predefinito di 60 secondi, mentre un comando shell dell’app server conserva il valore predefinito di un’ora quando timeoutMs è omesso o null. Ora il client dell’app server può chiedere una scadenza più lunga quando sa che una build, una migrazione o una suite di test richiedono più tempo. Impostando timeoutMs su 0, il timeout è immediato; i valori negativi non validi vengono rifiutati.

Il timeout di quel comando ausiliario non interrompe il turno attivo dell’agente. Spetta al client decidere se il turno debba continuare, ricevere nuove istruzioni o essere interrotto separatamente.

Uno sviluppatore che lavora in Vim e scrive brief lunghi

La modalità Vim ora consente di cercare nella bozza. / cerca in avanti, ? indietro, mentre n o N ripetono la ricerca ricominciando dall’altro estremo quando necessario. La ricerca si combina anche con le operazioni di eliminazione, modifica e copia, senza inserire la query nel testo del prompt.

Sembra una piccola aggiunta finché non si scrivono brief di più paragrafi direttamente nel terminale. A quel punto evita di dover copiare il testo in un editor solo per trovare e modificare un nome ripetuto.

Un team enterprise che usa Bedrock

In passato, credenziali del provider scadute potevano somigliare troppo a un’esecuzione bloccata. Ora Codex emette notifiche stabili di avvio e completamento per il recupero dell’autenticazione del provider e mostra l’avanzamento sia nella TUI interattiva sia in codex exec.

Per un team di ingegneria che instrada le richieste tramite Amazon Bedrock, il vantaggio è una maggiore chiarezza operativa. Un log di CI può distinguere tra «l’agente sta lavorando» e «la sessione del provider si sta riautenticando», senza dover dedurre la causa da una lunga pausa.

Un autore di plugin che mantiene i nomi reali dei package

I nomi dei server MCP ora possono contenere :, @, / e .. Un nome come npm:@modelcontextprotocol/server-sequential.thinking può attraversare i comandi mcp add, get, list e remove, mantenendo poi la stessa identità nei namespace dei tool a runtime e nelle credenziali OAuth.

Scompare così una noiosa fonte di alias: coordinate del package, nome nella configurazione e identità delle credenziali possono restare allineati.

Un team che raggiunge spesso i limiti di utilizzo

Il terminale ora può trasformare un avviso di rate limit in un’azione concreta. I banner supportati possono rimandare a utilizzo, crediti, reset, notifica al proprietario o gestione del piano. Durante il recupero, Codex aggiorna i dati sull’utilizzo, rifiuta le risposte obsolete e sospende l’input in coda finché lo stato non è aggiornato. Un banner del backend può anche indirizzarlo al primo modello di fallback disponibile senza riscrivere impostazioni del thread non pertinenti.

Questo non aumenta la quota disponibile. Rende il limite comprensibile e offre al terminale una destinazione utile verso cui indirizzare l’utente.

Configurazione completa con un server MCP reale

Il modo più rapido per vedere la nuova configurazione in pratica è applicarla a Context7, il server MCP per la documentazione usato nella guida alla configurazione di Codex. Il suo tool query-docs recupera la documentazione relativa all’ID noto di una libreria, quindi è un candidato sensato per un budget di output esplicito.

1. 1

   Installa la release

   Blocca la versione, così la nuova chiave di configurazione sarà disponibile:

   npm install -g @openai/codex@0.152.0

2. 2

   Aggiungi Context7

   Usa il comando esatto riportato nell’attuale guida MCP di Codex:

   codex mcp add context7 -- npx -y @upstash/context7-mcp

3. 3

   Imposta il budget del tool

   Apri ~/.codex/config.toml e aggiungi questa tabella sotto la voce del server Context7:

   [mcp_servers.context7.tools.query-docs]
   output_token_limit = 30000

   Il valore 30,000 proviene dal test di serializzazione di Codex. Dimostra quale formato viene accettato, non rappresenta una raccomandazione universale. Parti dal risultato più piccolo che conservi comunque le evidenze necessarie ai prompt, poi aumenta il limite se gli output reali risultano troncati.

4. 4

   Verifica la connessione

   Esegui codex mcp list per confermare che il server sia configurato. Nell’interfaccia del terminale, /mcp mostra i server attivi disponibili per la sessione.

Il punto da non nascondere

Il troncamento per singolo tool è una protezione, non una compressione gratuita. Se il limite è troppo basso, Codex può perdere proprio la riga di log o la precisazione nella documentazione che spiega il problema. Poiché in caso di sovrapposizione tra policy del plugin e dell’utente prevale il valore più basso, una policy del plugin può anche portare il budget effettivo sotto il numero indicato nel proprio file.

Il budget configurato si applica inoltre prima di un margine standard di serializzazione del 20%, che copre la struttura aggiuntiva necessaria per inserire il risultato nella richiesta al modello. Va quindi considerato un budget operativo, non la promessa che ogni payload serializzato contenga esattamente quel numero di token.

Il resto della versione 0.152.0 consiste in interventi di manutenzione utili. I thread ripresi recuperano la directory di lavoro salvata quando il chiamante non ne specifica una. La revisione automatica delle approvazioni conserva più istruzioni e autorizzazioni valide durante la compattazione della cronologia. I tool MCP resistono meglio agli aggiornamenti della cache e alle modifiche dei plugin remoti. Nessuno di questi cambiamenti modifica le capacità di coding del modello, il prezzo del piano o la quota di utilizzo.

Cosa conviene fare ora

Aggiorna questa settimana se usi diversi tool MCP, integri l’app server, scrivi prompt lunghi in modalità Vim, passi da Bedrock o raggiungi spesso i rate limit. Sono miglioramenti diretti del flusso di lavoro, con un impatto di migrazione limitato.

È meglio aspettare se l’organizzazione centralizza le versioni della CLI. Le pagine pubbliche di configurazione non sono ancora allineate con la chiave di output per singolo tool: chi gestisce il pacchetto di policy avrà così il tempo di validare il nuovo campo e scegliere i limiti sulla base di output reali.

Per chi usa soltanto ChatGPT sul web o da mobile, questa release non cambia il flusso di lavoro. Se invece si sta ancora valutando quanto Codex si adatti al proprio modo di sviluppare, il confronto tra Codex, Claude Code e Cursor è un punto di partenza migliore.

Per ricevere altre analisi operative e accessibili sulle release che cambiano il modo di sviluppare, iscriviti alla newsletter.