Codex

Guía de la habilidad Codex

Ejecución de una tarea

1. Para una sesión nueva (las reanudaciones heredan el modelo/esfuerzo anterior — ver paso 5), pregunta al usuario (mediante AskUserQuestion) qué modelo y qué esfuerzo de razonamiento usar, en un único mensaje con dos preguntas. Cuando el usuario no exprese preferencia, usa por defecto gpt-6-astra con high.
   • Modelo — por defecto gpt-6-astra:
     • GPT-6: gpt-6-astra (frontera / más capaz — por defecto)
     • GPT-5.6: gpt-5.6-sol (caballo de batalla agente fiable), gpt-5.6-terra (equilibrado, para el día a día), gpt-5.6-luna (rápido y económico)
     • Legado (mantenido por compatibilidad): gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex-spark, gpt-5.3-codex
   • Esfuerzo de razonamiento — por defecto high: low, medium, high, xhigh, max, ultra.
     • max/ultra requieren un modelo GPT-6 o GPT-5.6; ultra solo está disponible en astra/sol/terra (luna tiene un máximo de max); los modelos heredados tienen un máximo de xhigh.
     • ultra = razonamiento máximo con delegación automática de tareas (el más lento y caro — resérvalo para los trabajos más difíciles).
     • Si el esfuerzo elegido supera el máximo del modelo seleccionado, usa el esfuerzo más alto soportado por ese modelo e informa al usuario.
2. Selecciona el modo de sandbox necesario para la tarea; usa por defecto --sandbox read-only a menos que sean necesarias ediciones o acceso a red.
3. Arma el comando con las opciones adecuadas:
   • -m, --model <MODEL>
   • --config model_reasoning_effort="<low|medium|high|xhigh|max|ultra>" (max/ultra solo en modelos GPT-6 / GPT-5.6; ultra solo en astra/sol/terra — ver paso 1)
   • --sandbox <read-only|workspace-write|danger-full-access>
   • --full-auto
   • -C, --cd <DIR>
   • --skip-git-repo-check
   • "tu mensaje aquí" (como argumento posicional final)
4. Usa siempre --skip-git-repo-check.
5. Al continuar una sesión anterior, usa codex exec --skip-git-repo-check resume --last mediante stdin. Al reanudar, no uses banderas de configuración a menos que el usuario las solicite explícitamente, por ejemplo, si especifica el modelo o el esfuerzo de razonamiento al pedir reanudar una sesión. Sintaxis de reanudación: echo "tu mensaje aquí" | codex exec --skip-git-repo-check resume --last 2>/dev/null. Todas las banderas deben colocarse entre exec y resume.
6. IMPORTANTE: Por defecto, añade 2>/dev/null a todos los comandos codex exec para suprimir los tokens de pensamiento (stderr). Solo muestra stderr si el usuario solicita explícitamente ver los tokens de pensamiento o si se necesita depuración.
7. IMPORTANTE (stdin): codex exec siempre lee stdin y lo concatena con el mensaje posicional, incluso cuando el mensaje se proporciona completamente como argumento posicional. Si stdin no se cierra, codex se bloquea indefinidamente. Al invocar desde un entorno automatizado (tareas en segundo plano, hooks, scripts donde stdin no es una TTY pero tampoco está cerrado), redirige stdin explícitamente: añade </dev/null al comando, por ejemplo, codex exec ... "mensaje" </dev/null 2>/dev/null. Síntoma de hacerlo mal: cero bytes de stdout, cero CPU acumulada, el proceso parece colgado indefinidamente.
8. Ejecuta el comando, captura stdout/stderr (filtrados según corresponda) y resume el resultado para el usuario.
9. Después de que Codex termine, informa al usuario: "Puedes reanudar esta sesión de Codex en cualquier momento diciendo 'codex resume' o pidiéndome que continúe con análisis o cambios adicionales."

Referencia rápida

Caso de uso	Modo de sandbox	Banderas clave
Revisión o análisis de solo lectura	read-only	--sandbox read-only 2>/dev/null
Aplicar ediciones locales	workspace-write	--sandbox workspace-write --full-auto 2>/dev/null
Permitir acceso a red o amplio	danger-full-access	--sandbox danger-full-access --full-auto 2>/dev/null
Reanudar sesión reciente	Heredado de la original	echo "mensaje" | codex exec --skip-git-repo-check resume --last 2>/dev/null (sin banderas permitidas)
Ejecutar desde otro directorio	Según necesidades de la tarea	-C <DIR> más otras banderas 2>/dev/null

Tiempos de espera de ejecución

Codex no produce ninguna salida intermedia — escribe el resultado solo al finalizar. Si el proceso se termina antes de finalizar, el archivo de salida está vacío silenciosamente (sin error).

Enfoque preferido: ejecutar de forma síncrona — elimina por completo el riesgo de tiempo de espera y la conversación espera el resultado de todas formas.

Si se ejecuta en segundo plano, establece el tiempo de espera de ejecución según el esfuerzo de razonamiento:

Esfuerzo de razonamiento	Tiempo de espera
low	150s
medium	300s
high	600s
xhigh	1200s
max	1800s
ultra	1800s

Seguimiento

• Después de cada comando codex, usa inmediatamente AskUserQuestion para confirmar los siguientes pasos, recopilar aclaraciones o decidir si reanudar con codex exec resume --last.
• Al reanudar, canaliza el nuevo mensaje mediante stdin: echo "nuevo mensaje" | codex exec resume --last 2>/dev/null. La sesión reanudada usa automáticamente el mismo modelo, esfuerzo de razonamiento y modo de sandbox de la sesión original.
• Vuelve a indicar el modelo elegido, el esfuerzo de razonamiento y el modo de sandbox al proponer acciones de seguimiento.

Evaluación crítica de la salida de Codex

Codex funciona con modelos OpenAI que tienen sus propios cortes de conocimiento y limitaciones. Trata a Codex como un colega, no una autoridad.

Directrices

• Confía en tu propio conocimiento cuando estés seguro. Si Codex afirma algo que sabes que es incorrecto, rebátelo directamente.
• Investiga los desacuerdos usando WebSearch o documentación antes de aceptar las afirmaciones de Codex. Comparte los hallazgos con Codex mediante reanudación si es necesario.
• Recuerda los cortes de conocimiento: es posible que Codex no conozca versiones recientes, API o cambios ocurridos después de sus datos de entrenamiento.
• No te pliegues ciegamente: Codex puede equivocarse. Evalúa sus sugerencias de forma crítica, especialmente en cuanto a:
  • Nombres y capacidades de modelos
  • Versiones recientes de bibliotecas o cambios en API
  • Prácticas recomendadas que pueden haber evolucionado

Cuando Codex se equivoca

1. Expresa claramente tu desacuerdo al usuario
2. Proporciona evidencia (tu propio conocimiento, búsqueda web, documentación)
3. Opcionalmente, reanuda la sesión de Codex para discutir el desacuerdo. Preséntate como Claude para que Codex sepa que es una discusión entre IA pares. Usa tu nombre de modelo real (por ejemplo, el modelo con el que estás funcionando actualmente) en lugar de un nombre fijo:

   echo "Este es Claude (<tu nombre de modelo actual>) haciendo seguimiento. No estoy de acuerdo con [X] porque [evidencia]. ¿Cuál es tu opinión sobre esto?" | codex exec --skip-git-repo-check resume --last 2>/dev/null
   

4. Plantea los desacuerdos como discusiones, no como correcciones: cualquiera de las dos IA podría estar equivocada
5. Deja que el usuario decida cómo proceder si hay ambigüedad real

Manejo de errores

• Detén e informa de fallos siempre que codex --version o un comando codex exec termine con código de salida distinto de cero; solicita instrucciones antes de reintentar.
• Antes de usar banderas de alto impacto (--full-auto, --sandbox danger-full-access, --skip-git-repo-check), pide permiso al usuario mediante AskUserQuestion a menos que ya se haya dado.
• Cuando la salida incluya advertencias o resultados parciales, resúmelos y pregunta cómo ajustar usando AskUserQuestion.