Codex CLI 0.152.0: límites de salida MCP y seis cambios clave

Codex CLI 0.152.0 se publicó el 1 de septiembre de 2026 con seis funciones nuevas, pero el verdadero eje de esta versión son los límites más precisos para las ejecuciones largas que usan muchas herramientas. La novedad principal permite fijar cuánto puede ocupar, de cara al modelo, la salida de cada herramienta MCP, en lugar de aplicar la misma política predeterminada a todas.

En pocas palabras

Esta versión mejora el control y la fiabilidad; no presenta un modelo nuevo ni modifica los precios. Para quien utiliza Codex como un agente de programación convencional desde la terminal, los cambios más visibles son mensajes más útiles al alcanzar límites de uso, una recuperación de credenciales más clara y la búsqueda de Vim dentro de borradores largos.

Hay más novedades para quienes conectan Codex con sistemas externos mediante MCP o desarrollan sobre el servidor de aplicaciones de Codex. MCP, sigla de Model Context Protocol, es la capa de conexión que permite a Codex invocar herramientas como búsquedas en documentación, Figma, GitHub o un servicio interno. Con la versión 0.152.0, cada herramienta puede tener su propio presupuesto de salida.

Estas son las seis funciones nuevas de la versión, organizadas según a quién afectan:

La primera fila es la que conviene entender bien: cambia la cantidad de contenido procedente de herramientas que Codex conserva mientras trabaja.

Qué hace realmente el límite de salida MCP en Codex CLI

Una herramienta MCP puede devolver una gran cantidad de contenido. Una consulta de documentación podría traer varias páginas extensas; una búsqueda de registros, muchas líneas. Codex debe incorporar ese resultado a su contexto de trabajo, es decir, la memoria a corto plazo del modelo para la tarea actual.

Sin una configuración por herramienta, la salida MCP sigue la política normal de truncamiento del modelo activo. En 0.152.0 se puede añadir el nuevo ajuste output_token_limit a una herramienta concreta dentro de un servidor MCP determinado. Codex recorta entonces el resultado que verá el modelo hasta ajustarlo al presupuesto de tokens configurado.

La expresión clave es de cara al modelo. El servidor MCP no realiza menos trabajo y Code Mode sigue recibiendo el resultado sin procesar. El límite se aplica cuando ese resultado entra en el contexto del modelo y en el historial de la conversación. Codex mantiene el mismo presupuesto efectivo tanto en las sesiones reanudadas como en las respuestas de hooks posteriores al uso de una herramienta, de modo que volver a abrir un hilo no recupera silenciosamente la carga más grande.

Por qué importa

La decisión deja de ser «¿cuánta salida de herramientas puede tolerar este modelo?» y pasa a ser «¿cuánto necesita esta herramienta concreta para cumplir su función?». Una consulta a una biblioteca y un volcado de registros de producción ya no tienen que compartir la misma respuesta.

Hay dos medidas de protección. El valor debe ser positivo, por lo que se rechazan 0 y los números negativos. Si una política de plugin y la configuración propia establecen un límite, prevalece el menor. La aprobación de herramientas se gestiona por separado: reducir el presupuesto de salida no aprueba una herramienta ni cambia cuándo Codex pide permiso antes de invocarla.

Quién puede aprovecharlo y cómo

Un desarrollador independiente con una herramienta de documentación ruidosa

Quien desarrolla un SaaS por su cuenta puede impedir que una búsqueda amplia de documentación consuma el resto de un turno de programación. Basta con asignar un presupuesto explícito a la herramienta que devuelve páginas extensas y dejar intactas las consultas precisas. Así queda más contexto de trabajo para el repositorio, el plan y el diff.

Es el caso de uso más claro de 0.152.0 porque el límite se coloca justo en la fuente del ruido. No hace falta reducir todas las herramientas solo porque una de ellas devuelve demasiado contenido.

Un ingeniero de plataforma con tareas largas en el servidor de aplicaciones

El nuevo campo timeoutMs pertenece al método thread/shellCommand del servidor de aplicaciones. No es el ajuste MCP tool_timeout_sec.

La diferencia es importante. Las herramientas MCP tienen actualmente un tiempo de ejecución predeterminado de 60 segundos, mientras que un comando del shell del servidor de aplicaciones conserva el valor predeterminado de una hora cuando timeoutMs se omite o es nulo. Ahora un cliente del servidor de aplicaciones puede solicitar un plazo mayor si sabe que una compilación, una migración o una suite de pruebas lo necesita. Establecer timeoutMs en 0 provoca un timeout inmediato, y los valores negativos no válidos se rechazan.

El timeout de ese comando auxiliar no detiene el turno activo del agente. El cliente debe decidir por separado si el turno seguirá trabajando, recibirá nuevas instrucciones o será interrumpido.

Un desarrollador que trabaja primero en Vim y redacta instrucciones largas

El modo Vim ahora permite buscar dentro del propio borrador. / busca hacia delante, ? hacia atrás y n o N repite la búsqueda con recorrido circular. La búsqueda también se combina con las operaciones de eliminar, cambiar y copiar, sin insertar la consulta en el texto del prompt.

Parece un detalle menor hasta que se redactan instrucciones de varios párrafos en la terminal. En ese momento evita tener que copiar el texto a un editor solo para encontrar y sustituir un nombre repetido.

Un equipo empresarial que utiliza Bedrock

Cuando las credenciales del proveedor caducaban, una ejecución podía parecer bloqueada. Ahora Codex emite notificaciones estables de inicio y finalización durante la recuperación de autenticación del proveedor y muestra ese progreso tanto en la TUI interactiva como en codex exec.

Para un equipo de ingeniería que trabaja a través de Amazon Bedrock, la ventaja es una mayor claridad operativa. Un registro de CI puede distinguir entre «el agente está trabajando» y «la sesión del proveedor se está reautenticando», sin tener que interpretar una pausa larga.

Un autor de plugins que quiere conservar nombres de paquete reales

Los nombres de servidores MCP ahora pueden incluir :, @, / y .. Un nombre como npm:@modelcontextprotocol/server-sequential.thinking puede pasar por mcp add, get, list y remove, y después conservar la misma identidad en los espacios de nombres de herramientas en tiempo de ejecución y en las credenciales OAuth.

Así desaparece una fuente tediosa de alias. La coordenada del paquete, el nombre de configuración y la identidad de las credenciales pueden mantenerse alineados.

Un equipo que alcanza los límites de uso con frecuencia

La terminal ahora puede convertir un aviso de límite de uso en una acción concreta. Los avisos compatibles pueden enlazar al consumo, los créditos, los restablecimientos, la notificación a un propietario o la gestión del plan. Durante la recuperación, Codex actualiza el consumo, descarta respuestas obsoletas y pone en pausa la entrada en cola hasta que el estado esté al día. Un aviso del backend también puede dirigirlo al primer modelo alternativo disponible sin reescribir otros ajustes del hilo.

Esto no aumenta la cuota. Hace que el límite sea comprensible y ofrece un destino útil desde la terminal.

Configuración completa con un servidor MCP real

La forma más rápida de entender la nueva configuración es aplicarla a Context7, el servidor MCP de documentación utilizado en la guía de configuración de Codex. Su herramienta query-docs recupera documentación a partir del identificador de una biblioteca conocida, por lo que es una candidata razonable para recibir un presupuesto de salida explícito.

1. 1

   Instalar la versión

   Fija esta versión para disponer de la nueva clave de configuración:

   npm install -g @openai/codex@0.152.0

2. 2

   Añadir Context7

   Utiliza el comando exacto de la guía actual de MCP para Codex:

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

3. 3

   Configurar el presupuesto de la herramienta

   Abre ~/.codex/config.toml y añade esta tabla debajo de la entrada del servidor Context7:

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

   El valor 30,000 procede de la propia prueba de serialización de Codex. Demuestra el formato aceptado, pero no es una recomendación universal. Empieza por el resultado más pequeño que conserve las pruebas que necesitan los prompts y auméntalo si los resultados reales llegan truncados.

4. 4

   Comprobar la conexión

   Ejecuta codex mcp list para confirmar que el servidor está configurado. Dentro de la interfaz de terminal, /mcp muestra los servidores activos disponibles para la sesión.

La parte que conviene tener clara

El truncamiento por herramienta es una medida de protección, no una compresión gratuita. Si el límite queda demasiado bajo, Codex podría perder la línea clave de un registro o el matiz de la documentación que explica el problema. Como prevalece el menor valor cuando se superponen las políticas del plugin y del usuario, una política de plugin también puede dejar el presupuesto efectivo por debajo del número indicado en el archivo propio.

El presupuesto configurado también se aplica antes de un margen de serialización estándar del 20%, que cubre la estructura adicional necesaria para introducir el resultado en la solicitud al modelo. Debe entenderse como un presupuesto práctico, no como la promesa de que cada carga serializada contendrá exactamente esa cantidad de tokens.

El resto de 0.152.0 consiste en mejoras útiles de mantenimiento. Los hilos reanudados recuperan su directorio de trabajo guardado cuando quien realiza la llamada no proporciona uno. La revisión automática de aprobaciones conserva más instrucciones y autorizaciones válidas después de compactar el historial. Las herramientas MCP resisten mejor las actualizaciones de caché y los cambios en plugins remotos. Nada de esto altera la capacidad de programación del modelo, el precio del plan ni la cuota de uso.

Qué hacer ahora

Conviene actualizar esta semana si se utilizan varias herramientas MCP, se integra el servidor de aplicaciones, se escriben prompts largos en modo Vim, se trabaja a través de Bedrock o se alcanzan los límites de uso con frecuencia. Son mejoras directas del flujo de trabajo y requieren una migración limitada.

Es mejor esperar si la organización fija de forma centralizada las versiones de la CLI. Las páginas públicas de configuración aún no recogen la clave de salida por herramienta, así que quien administre el paquete de políticas necesitará tiempo para validar el campo nuevo y elegir los límites a partir de resultados reales.

Esta versión no cambia nada para quien solo usa ChatGPT en la web o en el móvil. Si todavía se está evaluando si Codex encaja con la forma de publicar software, el mejor punto de partida es la comparación general entre Codex, Claude Code y Cursor.

Para recibir más notas prácticas y claras sobre versiones que cambian la forma de desarrollar, suscríbete al boletín.