Codex CLI 0.152.0: o que mudou nos limites de saída MCP

O Codex CLI 0.152.0 chegou em 1 de setembro de 2026 com seis novos recursos, mas, na prática, esta versão trata de limites mais bem definidos para execuções longas e com uso intenso de ferramentas. A principal mudança permite limitar a saída de cada ferramenta MCP que chega ao modelo, em vez de aplicar a mesma política padrão a todas elas.

Em poucas palavras

Esta é uma atualização de controle e confiabilidade — não um modelo novo nem uma mudança de preço. Para quem usa o Codex simplesmente como agente de programação no terminal, as melhorias mais visíveis são mensagens de limite de uso mais úteis, recuperação de credenciais mais clara e busca do Vim dentro de rascunhos longos.

Para quem conecta o Codex a sistemas externos via MCP ou desenvolve sobre o app server do Codex, há mais novidades. MCP, sigla de Model Context Protocol, é a camada de conexão que permite ao Codex chamar ferramentas como busca em documentação, Figma, GitHub ou um serviço interno. Na versão 0.152.0, cada uma dessas ferramentas passa a ter seu próprio orçamento de saída.

Veja os seis novos recursos da versão, organizados por quem sentirá cada mudança:

A primeira linha é a que merece mais atenção. Ela muda quanto conteúdo das ferramentas o Codex mantém disponível enquanto trabalha.

Como funciona o limite de saída do MCP no Codex CLI

Uma ferramenta MCP pode devolver muito conteúdo. Uma consulta de documentação pode trazer várias páginas extensas; uma busca em logs, muitas linhas. O Codex precisa inserir esse resultado no contexto de trabalho, que funciona como a memória de curto prazo do modelo para a tarefa atual.

Sem uma configuração específica por ferramenta, a saída MCP continua seguindo a política normal de truncamento do modelo ativo. A partir da versão 0.152.0, é possível adicionar a nova configuração output_token_limit a uma ferramenta específica, dentro de um servidor MCP específico. O Codex então reduz o resultado que chega ao modelo até o orçamento de tokens configurado.

A expressão importante aqui é que chega ao modelo. O servidor MCP não executa menos trabalho, e o Code Mode continua recebendo o resultado bruto. O Codex também mantém o mesmo orçamento efetivo em sessões retomadas e nas respostas de hooks posteriores ao uso da ferramenta. Assim, reabrir uma thread não restaura silenciosamente um volume maior de conteúdo.

Por que esse limite importa

Com isso, a pergunta deixa de ser “quanta saída de ferramentas este modelo deve tolerar?” e passa a ser “quanto esta ferramenta específica precisa para cumprir sua função?”. Uma consulta a uma biblioteca e um despejo de logs de produção já não precisam seguir a mesma regra.

Há duas proteções. O valor precisa ser positivo, portanto 0 e números negativos são rejeitados. Quando uma política de plugin e a configuração do usuário definem limites ao mesmo tempo, prevalece o menor valor. A aprovação da ferramenta é independente: reduzir o orçamento de saída não aprova uma ferramenta nem altera o momento em que o Codex pede autorização para chamá-la.

Quem pode usar o recurso — e como

Quem desenvolve sozinho e usa uma ferramenta de documentação ruidosa

Quem cria um SaaS por conta própria pode impedir que uma busca ampla em documentação ocupe o restante de uma rodada de programação. Basta definir um orçamento explícito para a ferramenta que devolve páginas longas e deixar as consultas precisas sem alteração. O ganho é mais contexto de trabalho para o repositório, o plano e o diff.

Este é o caso de uso mais direto da versão 0.152.0, porque o limite acompanha a origem do ruído. Não é preciso reduzir todas as ferramentas só porque uma delas devolve conteúdo demais.

Um engenheiro de plataforma executando tarefas longas no app server

O novo campo timeoutMs pertence ao método thread/shellCommand do app server. Ele não é a configuração MCP tool_timeout_sec.

Essa diferença importa. Hoje, as ferramentas MCP têm timeout de execução padrão de 60 segundos, enquanto um comando shell do app server mantém o padrão de uma hora quando timeoutMs é omitido ou nulo. Agora, um cliente do app server pode solicitar um prazo maior quando sabe que um build, uma migração ou uma suíte de testes precisa de mais tempo. Definir timeoutMs como 0 provoca timeout imediato, e valores negativos inválidos são rejeitados.

O timeout desse comando auxiliar não encerra a rodada ativa do agente. O cliente precisa decidir separadamente se a rodada deve continuar trabalhando, receber novas instruções ou ser interrompida.

Um desenvolvedor que trabalha no Vim e escreve instruções longas

O modo Vim agora faz buscas no próprio rascunho. / busca para a frente, ? busca para trás, e n ou N repete a busca com retorno ao início ou ao fim. A busca também funciona em conjunto com as operações de excluir, alterar e copiar, sem inserir a consulta no texto do prompt.

Parece uma mudança pequena até o momento em que é preciso escrever instruções de vários parágrafos no terminal. A novidade elimina a necessidade incômoda de copiar o conteúdo para um editor apenas para localizar e alterar um nome repetido.

Uma equipe corporativa que usa Bedrock

Credenciais expiradas de um provedor podiam se parecer demais com uma execução travada. Agora, o Codex emite notificações estáveis de início e conclusão durante a recuperação da autenticação do provedor e exibe o progresso tanto na TUI interativa quanto no codex exec.

Para uma equipe de engenharia que encaminha as solicitações pelo Amazon Bedrock, o ganho é clareza operacional. Um log de CI consegue diferenciar “o agente está trabalhando” de “a sessão do provedor está sendo reautenticada”, sem depender de suposições durante uma pausa longa.

Um autor de plugin que quer preservar nomes reais de pacotes

Os nomes de servidores MCP agora aceitam :, @, / e .. Um nome como npm:@modelcontextprotocol/server-sequential.thinking pode passar por mcp add, get, list e remove e, depois, manter a mesma identidade nos namespaces de ferramentas em execução e nas credenciais OAuth.

Isso elimina uma fonte tediosa de aliases. A coordenada do pacote, o nome na configuração e a identidade da credencial podem permanecer alinhados.

Uma equipe que atinge os limites de uso com frequência

Agora, o terminal consegue transformar um aviso de limite de uso em uma próxima ação. Os banners compatíveis podem levar a páginas de uso, créditos, redefinições, aviso ao proprietário ou gerenciamento do plano. Durante a recuperação, o Codex atualiza o uso, rejeita respostas desatualizadas e pausa as entradas na fila até que o estado esteja atualizado. Um banner do backend também pode encaminhá-lo ao primeiro modelo alternativo disponível sem reescrever outras configurações da thread.

Isso não aumenta a franquia. Apenas deixa o limite compreensível e oferece um destino útil no terminal.

Como configurar MCP no Codex com um servidor real

A forma mais rápida de entender a nova configuração é aplicá-la ao Context7, o servidor MCP de documentação usado no guia de configuração do Codex. A ferramenta query-docs recupera documentação a partir do ID conhecido de uma biblioteca, por isso faz sentido definir para ela um orçamento de saída explícito.

1. 1

   Instale a versão

   Fixe esta versão para disponibilizar a nova chave de configuração:

   npm install -g @openai/codex@0.152.0

2. 2

   Adicione o Context7

   Use o comando exato do guia atual de MCP do Codex:

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

3. 3

   Defina o orçamento da ferramenta

   Abra ~/.codex/config.toml e adicione esta tabela abaixo da entrada do servidor Context7:

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

   O valor 30,000 vem do próprio teste de serialização do Codex. Ele mostra um formato aceito, não uma recomendação universal. Comece com o menor resultado que ainda preserve as evidências necessárias aos seus prompts e aumente o limite quando resultados reais chegarem truncados.

4. 4

   Verifique a conexão

   Execute codex mcp list para confirmar que o servidor está configurado. Na interface do terminal, /mcp mostra os servidores ativos disponíveis para a sessão.

A parte sem rodeios

O truncamento por ferramenta é uma proteção, não uma compressão gratuita. Se o limite for baixo demais, o Codex pode perder justamente a linha do log ou a ressalva da documentação que explica o problema. Como o menor valor prevalece quando as políticas do plugin e do usuário se sobrepõem, uma política do plugin também pode tornar o orçamento efetivo menor do que o número definido no seu próprio arquivo.

O orçamento configurado também é aplicado antes de uma margem padrão de 20% para serialização, que cobre a estrutura adicional necessária para inserir o resultado na solicitação ao modelo. Considere-o um orçamento prático, não uma promessa de que cada payload serializado conterá exatamente essa quantidade de tokens.

O restante da versão 0.152.0 reúne melhorias úteis de manutenção. Threads retomadas recuperam o diretório de trabalho salvo quando o cliente não fornece outro. A revisão automática de aprovações preserva mais instruções e autorizações válidas durante a compactação do histórico. As ferramentas MCP continuam disponíveis com mais confiabilidade após atualizações de cache e mudanças em plugins remotos. Nada disso altera a capacidade de programação do modelo, o preço do plano ou a franquia de uso.

O que fazer agora

Atualize ainda esta semana se você executa várias ferramentas MCP, incorpora o app server, escreve prompts longos no modo Vim, usa o Bedrock ou atinge limites de uso com frequência. São melhorias diretas no fluxo de trabalho, com uma superfície de migração pequena.

Espere se a sua organização fixa as versões da CLI de forma centralizada. As páginas públicas de configuração ainda não incluem a chave de saída por ferramenta, então dê a quem gerencia o pacote de políticas tempo para validar o novo campo e escolher limites com base em resultados reais.

Se você usa apenas o ChatGPT na web ou no celular, esta versão não muda o seu fluxo de trabalho. Se ainda está avaliando se o Codex combina com a sua forma de entregar software, a comparação entre Codex, Claude Code e Cursor é o melhor ponto de partida.

Para receber mais análises práticas e diretas sobre versões que mudam a forma de desenvolver, assine a newsletter.