Glosario
📚 Navegación de la serie: El artículo anterior (37 Resolución de problemas comunes) te ayudó a solucionar los errores, bloqueos y comportamientos extraños más comunes al ejecutar Codex. Este capítulo tiene una finalidad distinta: no está diseñado para leerse de principio a fin, sino para consultarse en cualquier momento. Funciona como un diccionario de bolsillo de todos los términos que han aparecido a lo largo de la guía. El próximo artículo (39 Gestión y gobernanza empresarial) abordará cómo administrar Codex a nivel de equipo y de empresa.
Amigos, a estas alturas de nuestro tutorial, ya hemos introducido una gran cantidad de términos técnicos.
Bucle de agente, sandbox, aprobación, esfuerzo de razonamiento, service_tier, MCP, sub-agentes, Skill, Hook... La primera vez que estudié sistemáticamente este tipo de herramientas, lo que más me desanimó fue precisamente esto: no porque los conceptos fueran difíciles de entender, sino porque había demasiados nombres y se solapaban entre sí. Para cuando llegabas al décimo, los primeros cinco ya se habían mezclado en tu mente.
A decir verdad, abrumarse con la terminología es algo común en los principiantes y no tiene nada que ver con la capacidad de uno. La solución es sencilla: no intentes memorizar, solo consulta. Cuando necesites un término, búscalo aquí, léelo y sigue trabajando; después de consultarlo unas cuantas veces, se te quedará grabado en la memoria.
Este capítulo es ese diccionario de bolsillo que hemos preparado para ti. Los términos están agrupados por temas, con una explicación sencilla para cada uno, complementada con su significado específico en Codex o una analogía. No tienes que leerlo desde el principio: usa Ctrl+F para buscar la palabra que necesitas y continúa con lo tuyo.
Al terminar este artículo, obtendrás:
- Un diccionario de términos de Codex agrupados por temas, explicados en un lenguaje sencillo y accesible para principiantes
- Una explicación clara de conceptos básicos (bucle de agente, ventana de contexto, token) que sirven de base para los demás
- Una consulta centralizada de términos específicos de Codex (
AGENTS.md,codex exec, sandbox, aprobación, esfuerzo de razonamiento,service_tier, Chronicle) - Distinciones en una sola frase de las cinco capacidades de extensión (MCP, sub-agentes, Skill, Hook, Plugin) para no confundirlos
- La clasificación y diferencias de la familia de modelos (la serie
gpt-5.5), qué significa "vista previa de investigación" y cuáles son los dos modelos obsoletos que debes evitar
⚠️ Los comandos, las claves de configuración y el comportamiento por defecto de este capítulo se basan en la documentación oficial de Codex; los nombres de los modelos y la cobertura de los planes varían con las versiones, por lo que siempre prevalecerá lo que muestre tu terminal local con
/modelycodex --help.
01 Conceptos básicos: la base de toda la terminología
Este grupo representa conceptos a nivel de "especie": no solo se aplican a Codex, sino a casi cualquier herramienta de programación con IA. Domina primero estos elementos para poder asimilar los términos siguientes.
Agente (Agent, también llamado smart agent)
En una frase: Una IA capaz de desglosar tareas por sí misma, invocar herramientas, analizar resultados y decidir el siguiente paso, en lugar de ser un simple chat de preguntas y respuestas.
Qué significa en Codex: Codex es el "agente de programación" de OpenAI; puede leer código, modificar archivos, ejecutar comandos y realizar pruebas de manera autónoma mientras tú solo observas. Es una especie diferente a los chatbots convencionales: mientras que un chat solo te devuelve texto, un agente completa la tarea entera.
Bucle de agente (Agentic Loop)
En una frase: El ciclo básico de trabajo de un agente: Pensar → Actuar → Evaluar; si no funciona a la primera, repite el proceso.
Analogía: Un fontanero. No se limita a echar un vistazo, dar un presupuesto e irse: primero "piensa" (dónde está la fuga), luego "actúa" (aprieta una tuerca o cambia una junta) y después "evalúa" (abre el grifo para ver si sigue goteando); si sigue fallando, vuelve a apretar. Codex trabaja siguiendo exactamente este ciclo: lee archivos, modifica código y ejecuta comprobaciones; si las pruebas no pasan, inicia otra iteración hasta resolverlo. Este mecanismo es idéntico al de Claude Code, solo que con otro nombre.
Ventana de contexto (Context Window)
En una frase: El volumen total de información que el modelo puede "ver a la vez"; tiene un límite, y cuando se llena, los datos más antiguos se descartan.
Analogía: La superficie de un escritorio. La mesa tiene un tamaño limitado y solo puedes extender un número determinado de papeles. A medida que colocas papeles nuevos, los primeros se van desplazando hacia los lados o incluso caen al suelo; cuando el modelo "olvida" lo que se dijo antes, suele deberse a esto. Por ello, si conversas durante demasiado tiempo o introduces contenido irrelevante, el rendimiento empeorará. Esta es también la razón de ser de los sub-agentes: mover los resultados intermedios fuera del escritorio principal.
token
En una frase: La unidad mínima de procesamiento de texto para el modelo (aproximadamente una palabra o media palabra); tanto tus entradas como las salidas se miden en tokens.
Qué significa en Codex: Dos aspectos clave dependen de ellos: la cuota de uso y el coste. Los planes de suscripción te otorgan una cuota basada en el volumen de tokens, y las claves de API facturan directamente según el consumo de tokens; la tarifa del modelo insignia es varias veces superior a la del modelo ligero. El tamaño de la ventana de contexto también se mide en tokens.
| Término | Cómo recordarlo en una frase |
|---|---|
| Agente | Una IA que actúa por sí misma, no solo te responde |
| Bucle de agente | Pensar → Actuar → Evaluar; si falla, repite el ciclo |
| Ventana de contexto | El volumen total de información que puede procesar a la vez; tiene un límite |
| token | La unidad mínima de medida de texto, asociada a cuotas y facturación |
💡 Resumen en una frase: Estos cuatro son los cimientos: el agente actúa por sí mismo, el bucle es su ritmo de trabajo, la ventana de contexto es el tamaño de su escritorio y el token es la regla de medir costes.
02 Conceptos específicos de Codex: la terminología particular del ecosistema
Este grupo contiene elementos propios de Codex, que suelen ser la causa de que a los principiantes el sistema a veces les funcione y a veces no. Al comprenderlos, el comportamiento de Codex dejará de parecerte aleatorio.
AGENTS.md (Manual de proyecto)
En una frase: Un archivo markdown en el proyecto que define las directrices del mismo; Codex lo consulta antes de comenzar a trabajar.
Analogía: Una nota adhesiva en tu escritorio. No le repetirías a tus compañeros todos los días "aquí usamos pnpm y no npm"; escribes una nota adhesiva y la dejas ahí para que la consulten. AGENTS.md es esa nota adhesiva para Codex: cómo compilar, cómo probar y qué nomenclatura seguir; lo configuras una vez y lo leerá en cada ejecución. Puede ubicarse de forma global (~/.codex/AGENTS.md) o en la raíz del proyecto; el archivo más cercano al directorio de trabajo tendrá prioridad (es equivalente al archivo CLAUDE.md de Claude Code).
codex exec (Comando no interactivo)
En una frase: Ejecución directa sin entrar en la interfaz interactiva: envías una instrucción y obtienes un resultado; diseñado para scripts y automatización.
Analogía: Una máquina expendedora. El modo interactivo común es como hablar con un dependiente: haces una pregunta, te responde y mantenéis varias interacciones. codex exec es como comprar agua: introduces la moneda, pulsas el botón y obtienes el producto de inmediato, sin rodeos. Se utiliza principalmente en sistemas de CI, tareas programadas (cron) y scripts de procesamiento por lotes.
Sandbox (Sandbox)
En una frase: Un límite delimitado para Codex: realiza las tareas dentro de la zona de seguridad y te consulta antes de realizar acciones fuera de ella.
Analogía: La valla de un parque infantil. Los niños pueden jugar en los toboganes dentro de la valla sin que tengas que vigilarlos; si intentan saltar la valla para ir a la carretera, los detienes. El sandbox controla dos cosas: qué archivos puede modificar y si tiene acceso a la red. Cuenta con tres niveles comunes: read-only (solo lectura, no altera nada), workspace-write (escritura en el espacio de trabajo, el valor por defecto; solo modifica los elementos del directorio desde donde iniciaste Codex y bloquea la red por defecto) y danger-full-access (acceso total; el nombre "danger" no es una broma, úsalo con precaución).
Aprobación (Approval, política de aprobación)
En una frase: Define si Codex debe detenerse a preguntarte cuando intenta realizar acciones fuera de su zona de seguridad; funciona en paralelo al sandbox.
Analogía: El carácter del guardia de seguridad de la entrada. El sandbox es la puerta y la aprobación es el nivel de celo del guardia. untrusted solo bloquea comandos desconocidos; on-request permite trabajar dentro de la zona segura y te consulta solo cuando intenta salir (el punto de equilibrio más común); y never ejecuta todo sin interrumpirte. Recuerda: el sandbox define "qué puede hacer" y la aprobación "si debe preguntar"; son dos conceptos independientes.
Esfuerzo de razonamiento (Reasoning Effort, clave model_reasoning_effort)
En una frase: El control que define cuánto tiempo debe reflexionar el modelo antes de actuar; a mayor reflexión, mejores resultados, pero con mayor lentitud.
Analogía: El tiempo concedido en un examen. Si a un alumno brillante le pides responder de un vistazo o le permites hacer borradores y verificar sus cálculos, el resultado será muy diferente, siendo este último mucho más lento. Cuenta con cinco niveles: minimal (apenas reflexiona, respuesta instantánea), low, medium, high y xhigh (el nivel máximo, según la compatibilidad del modelo). Si no estás satisfecho con la respuesta, antes de cambiar de modelo intenta subir un nivel; si te resulta lento, bájalo.
Resumen de razonamiento (clave model_reasoning_summary)
En una frase: El nivel de detalle del proceso de reflexión del modelo que deseas ver en pantalla.
Qué significa en Codex: Acepta los valores auto, concise, detailed o none. Si quieres observar el paso a paso de su razonamiento, selecciona detailed; si prefieres evitar el scroll de pantalla innecesario, desactívalo con none. Es un ajuste visual y no afecta a la calidad del resultado.
Nivel de servicio (service_tier)
En una frase: Establece la prioridad de tus peticiones: si prefieres optimizar costes o velocidad.
Analogía: Envío estándar frente a envío urgente. La opción fast (rápido) consume créditos para acelerar la respuesta del modelo en 1.5x, de forma similar a pagar un extra por prioridad de envío; flex (flexible) es el nivel estándar sin velocidad añadida. Si tienes prisa y no te importa el consumo de créditos, utiliza fast; en caso contrario, mantén el valor predeterminado.
config.toml (Archivo de configuración)
En una frase: El archivo de configuración principal de Codex, ubicado en ~/.codex/config.toml y con formato TOML.
Qué significa en Codex: Si deseas que los ajustes descritos anteriormente (modelo por defecto, esfuerzo de razonamiento, modo sandbox, política de aprobación, servidores MCP) se apliquen de forma persistente en cada inicio de sesión, debes configurarlos en este archivo. Utiliza los comandos de barra para cambios temporales y este archivo para los definitivos.
Chronicle / Memoria (Memory)
En una frase: Permite que Codex recuerde tus preferencias de conversación y directrices de proyectos previas para no tener que explicarlas de nuevo.
Qué significa en Codex: La memoria está desactivada por defecto; debes habilitarla con memories = true en la sección [features] de tu config.toml, y cuenta con restricciones regionales al almacenarse localmente. Chronicle es una característica experimental de vista previa de investigación más avanzada: analiza el contenido de tu pantalla para comprender en qué estás trabajando; actualmente solo está disponible para ChatGPT Pro y en macOS. Un consejo: registra las reglas obligatorias en AGENTS.md y no dependas de la memoria automática.
Cuando empecé a usar Codex, mi primer obstáculo fue el sandbox: le pedí renombrar varios archivos por lotes y los del escritorio permanecieron intactos. Pensé que era un fallo de la herramienta, pero al consultar la documentación comprendí que workspace-write limitaba su alcance a mi directorio de proyecto. Los conceptos que debes memorizar primero en este grupo son el sandbox y la aprobación, que explican el 80% de los casos en los que Codex se niega a realizar cambios.
💡 Resumen en una frase: En los conceptos específicos de Codex: el sandbox y la aprobación regulan los permisos,
AGENTS.mdestablece las directrices, el esfuerzo de razonamiento controla la reflexión ycodex execgestiona la automatización; configúralos enconfig.tomlpara aplicarlos de forma persistente.
03 Capacidades de extensión: expandir las funciones de Codex
Los conceptos básicos y específicos constituyen el núcleo de Codex; este grupo aborda los complementos para ampliar sus capacidades. Son dos términos similares que suelen confundirse, por lo que los definiremos en una frase individual.
MCP (Model Context Protocol, Protocolo de Contexto de Modelos)
En una frase: Un estándar unificado que permite a Codex interactuar con herramientas externas: bases de datos, diseños, navegadores y servicios de terceros.
Analogía: Un puerto USB. Codex solo tiene acceso por defecto a tus archivos y comandos locales; no puede interactuar con Figma, documentación externa ni bases de datos en producción. MCP es esa interfaz de conexión unificada: lo configuras una vez y todas las herramientas externas quedan a su disposición. No requiere programar integraciones individuales para cada herramienta, lo que demuestra la utilidad del estándar.
Sub-agente (Subagent)
En una frase: Agentes secundarios creados de forma temporal por la conversación principal para ejecutar tareas específicas en paralelo y devolver un resumen consolidado.
Analogía: Auxiliares que realizan recados independientes. Si necesitas revisar una modificación desde tres perspectivas (seguridad, rendimiento y pruebas), no necesitas investigarlo todo tú mismo: encargas la tarea a tres auxiliares a la vez y dejas que te traigan sus informes. Un aspecto clave: Codex nunca dividirá la tarea automáticamente; debes indicarle explícitamente en la conversación "crea varios agentes en paralelo, espera a que terminen y consolida el resultado". Su principal ventaja es que mantiene los procesos intermedios fuera de la ventana de contexto de tu conversación principal.
Skill (Skill, habilidad del agente)
En una frase: Una secuencia de pasos predefinidos estructurada como una habilidad específica; la diseñas una vez y Codex podrá ejecutarla cuando la invoques.
Analogía: Una ficha de receta de cocina. Para tareas recurrentes como "resumir los cambios locales sin confirmar y detallar riesgos", en lugar de repetir la instrucción en cada ocasión, puedes estructurarla en una ficha de receta (SKILL.md) detallando name, description y los pasos a seguir. Podrás invocarla por su nombre o dejar que el sistema la asocie automáticamente según tus peticiones. Funciona de manera similar a los atajos de automatización del móvil.
Hook (Hook, gancho)
En una frase: Scripts automáticos asociados a fases específicas del ciclo de vida de Codex que se ejecutan obligatoriamente cuando ocurre el evento.
Analogía: Una luz con sensor de movimiento. No evalúa quién eres ni a dónde vas: si se detecta movimiento, la luz se encenderá obligatoriamente. Los hooks funcionan igual: ejecutan de forma automática los scripts que indiques en fases como "antes de invocar herramientas", "después de invocar herramientas", "al finalizar la respuesta" o "al iniciar la sesión". La diferencia con AGENTS.md es que el manual son directrices generales y el hook es una regla de ejecución garantizada.
Plugin (Plugin, complemento)
En una frase: Un paquete unificado que agrupa múltiples Skills, servidores MCP e integraciones para facilitar su instalación, gestión y desinstalación conjunta.
Analogía: Un piso piloto completamente amueblado. Si compras los muebles por separado, tendrás que buscar referencias, verificar medidas e instalarlos tú mismo; con el paquete completo, obtienes la solución lista para usar con un solo pedido. Para flujos de trabajo individuales basta con diseñar una Skill; si deseas compartirlos entre proyectos, con el equipo o gestionar versiones unificadas, conviene estructurarlos como un plugin.
| Término | Diferencia en una frase | Cuándo utilizarlo |
|---|---|---|
| MCP | Interfaz de conexión unificada para herramientas externas | Cuando necesites acceder a bases de datos, diseños o navegadores |
| Sub-agente | Tareas paralelas especializadas con consolidación de informes | Para evaluar una misma propuesta desde múltiples perspectivas a la vez |
| Skill | Secuencia de pasos empaquetada como habilidad | Para flujos de trabajo repetitivos que realizas de forma constante |
| Hook | Script que se ejecuta obligatoriamente en fases concretas | Para asegurar que se realice una acción automática en cada ejecución |
| Plugin | Conjunto de capacidades empaquetadas para su gestión unificada | Para compartir con el equipo o estructurar configuraciones complejas |
💡 Resumen en una frase: MCP conecta herramientas, el sub-agente distribuye el trabajo, la Skill estructura flujos, el Hook automatiza fases y el Plugin empaqueta conjuntos; asocia cada uno con su propósito y no los confundirás.
04 Modelos: a cuál encargar la tarea
Este último grupo define qué modelo procesa la petición al pulsar intro. Los nombres de los modelos varían con las actualizaciones; este apartado detalla su posicionamiento y conceptos generales. Consulta siempre el panel /model local para verificar la lista real.
gpt-5.5 (Modelo insignia, por defecto)
En una frase: El modelo insignia recomendado actualmente; el más potente y con mayor coste, utilizado por defecto si no se especifica otro.
Qué significa en Codex: Ideal para programación compleja, refactorizaciones de módulos, bugs difíciles de resolver y flujos de investigación. Es la opción preferida por defecto.
gpt-5.4-mini (Modelo ligero, rápido y económico)
En una frase: Modelo ligero orientado a respuestas rápidas y bajo coste; ideal para tareas sencillas y recurrentes, y para sub-agentes.
Qué significa en Codex: Adecuado para corregir bugs menores, aplicar formatos, añadir comentarios o limpiezas automáticas de código; optimiza tiempo y presupuesto frente al modelo insignia.
gpt-5.4 (Versión estándar, diferente de mini)
En una frase: El modelo estándar intermedio entre el insignia y el mini; sigue vigente y pertenece a la misma familia que gpt-5.4-mini (evita confundirlos).
Qué significa en Codex: Mismo nombre pero sin el término "mini". Es más potente que el mini y más económico que el insignia gpt-5.5; es una opción equilibrada de calidad y coste. El modelo gpt-5.4-mini es su versión ligera y son procesos diferentes.
gpt-5.3-codex-spark (Instantáneo, vista previa de investigación)
En una frase: Modelo instantáneo optimizado para respuestas de baja latencia; ideal para iteraciones rápidas e interactivas.
Qué significa en Codex: Al tratarse de una vista previa de investigación, está limitado actualmente a planes de ChatGPT Pro; es normal si no está visible en tu cuenta. Se utiliza para iteraciones de emparejamiento con latencias mínimas.
Vista previa de investigación (Research Preview)
En una frase: Versiones experimentales de acceso anticipado limitadas a grupos reducidos; sus funciones pueden cambiar y su disponibilidad es restringida.
Qué significa en Codex: Los componentes etiquetados bajo esta categoría (como gpt-5.3-codex-spark o Chronicle) comparten la particularidad de estar limitados a determinados planes o sistemas operativos, y pueden retirarse sin previo aviso. Considéralos funciones experimentales y evita depender de ellas para entornos de producción.
Modelos obsoletos (Deprecated)
En una frase: Versiones descatalogadas y no recomendadas oficialmente que debes eliminar de tus configuraciones.
Qué significa en Codex: Los modelos gpt-5.2 y gpt-5.3-codex se consideran obsoletos bajo el inicio de sesión de ChatGPT. Si tus scripts, el archivo config.toml o la directiva codex exec --model los incluyen, actualízalos a las versiones vigentes. El mes pasado experimenté un fallo debido a un script automático programado hace tiempo con un modelo obsoleto que devolvió un error de disponibilidad.
| Modelo | Posicionamiento | Escenario recomendado |
|---|---|---|
gpt-5.5 | Insignia, por defecto | Programación compleja, refactorización, bugs difíciles e investigación |
gpt-5.4 | Versión estándar (nivel intermedio) | Equilibrio de calidad y coste de procesamiento |
gpt-5.4-mini | Ligero, rápido y económico | Automatizaciones sencillas por lotes y sub-agentes |
gpt-5.3-codex-spark | Instantáneo (vista previa de investigación) | Iteraciones interactivas de muy baja latencia |
gpt-5.2 / gpt-5.3-codex | Obsoletos | Evitar su uso y sustituirlos por los modelos vigentes |
💡 Resumen en una frase: Usa
gpt-5.5para tareas complejas,gpt-5.4para opciones equilibradas,gpt-5.4-minipara optimizar costes ygpt-5.3-codex-sparkpara baja latencia; los modelos en "vista previa" son experimentales y los obsoletos deben eliminarse de las configuraciones.
05 Cómo aprovechar al máximo este glosario
Un glosario solo es útil si se consulta de manera activa. Te sugiero tres metodologías prácticas que utilizo personalmente:
- Primero: Si tienes dudas al leer otras guías, búscalas aquí y continúa. Evita atascarte en tecnicismos; este glosario está diseñado para consultas puntuales. A diferencia de los otros capítulos que se leen en orden, este se utiliza con Ctrl+F.
- Segundo: Memoriza las distinciones de los términos que suelen confundirse. A continuación se listan las parejas de conceptos que más suelen elegir a error:
| Conceptos que se confunden | Diferenciación básica |
|---|---|
| Sandbox frente a Aprobación | El sandbox define "qué puede hacer"; la aprobación "si debe preguntar" |
| Esfuerzo de razonamiento frente a Modelo | El esfuerzo regula el tiempo de reflexión; el modelo define la gama del procesador |
AGENTS.md frente a Memoria | El manual son directrices de obligado cumplimiento; la memoria son asociaciones automáticas probables |
| Skill frente a Plugin | La Skill es una automatización específica; el Plugin es un paquete completo de capacidades |
| Sub-agente frente a Hook | El sub-agente se crea bajo petición; el Hook se ejecuta obligatoriamente en la fase configurada |
- Tercero: Realiza pruebas prácticas para consolidar el conocimiento. Toma el concepto que más te cueste recordar y realiza la práctica correspondiente en su capítulo de origen: si tienes dudas sobre el funcionamiento del sandbox, realiza el experimento de bloqueo de creación de archivos en 02 Conceptos clave. He guiado a personas que desconocían la línea de comandos en el uso de Codex: aquellos que experimentaron el bloqueo del sandbox de forma práctica no volvieron a dudar sobre por qué no modificaba archivos. Una comprobación real es más ilustrativa que cualquier explicación teórica.
💡 Resumen en una frase: Este glosario está diseñado para consultas rápidas: busca los términos cuando dudes, memoriza las parejas que suelen confundirse y realiza pruebas prácticas para fijar los conceptos complejos.
Resumen
Este capítulo recopila la terminología técnica abordada en cuatro grupos principales:
- Conceptos básicos: Agente, bucle de agente, ventana de contexto y tokens; los cimientos de la tecnología.
- Conceptos específicos:
AGENTS.md,codex exec, sandbox, aprobación, esfuerzo de razonamiento,service_tiery Chronicle; la terminología del ecosistema que suele registrar a error. - Capacidades de extensión: MCP, sub-agentes, Skill, Hook y Plugins; cinco complementos con propósitos delimitados.
- Gama de modelos: Posicionamiento de la serie
gpt-5.5, significado de las versiones en "vista previa" e identificación de modelos obsoletos.
Ahora deberías ser capaz de: Localizar los términos que te generen dudas en sus respectivos grupos de consulta, distinguir con claridad las parejas de conceptos conflictivos y realizar experimentos prácticos en sus capítulos de origen para afianzar el conocimiento.
Al fin y al cabo, la terminología técnica no está pensada para memorizarse, sino para asimilarse con el uso diario. El propósito de este glosario es servir de red de seguridad de consulta rápida mientras completas ese proceso.
En el próximo artículo (39 Gestión y gobernanza empresarial) ampliaremos la escala del análisis: desde "cómo utiliza Codex un usuario individual" a "cómo administra una organización el uso de Codex": gestión centralizada de permisos, auditoría de seguridad y políticas de colaboración para grandes equipos. Una pequeña reflexión: si analizas las directivas de sandbox y aprobación, en un uso personal representan un cinturón de seguridad que tú mismo te abrochas; en un entorno corporativo con decenas de usuarios, ¿quién debe configurar ese cinturón y se debería permitir a los usuarios desactivarlo libremente? Este es el dilema que resolveremos en el siguiente capítulo.