Conceptos clave de Codex

Antes de usar Codex, es muy importante comprender varios conceptos clave. Estos conceptos forman la base del funcionamiento de Codex.


Prompt (instrucción)

Interactúas con Codex enviando Prompts, describiendo la tarea que quieres que complete.

Ciclo de trabajo del Prompt

Cuando envías un Prompt, Codex trabaja siguiendo el siguiente ciclo:

  1. Llama al modelo de lenguaje para comprender la tarea.
  2. Ejecuta las operaciones indicadas por la salida del modelo (leer archivos, editar código, ejecutar comandos).
  3. Retroalimenta al modelo con los resultados de las operaciones.
  4. Ejecuta el ciclo hasta que la tarea se complete o tú la canceles.

Codex funciona enmodo de ciclo Agent—el modelo emite instrucciones de operación, los resultados de las operaciones se devuelven al modelo, y el ciclo continúa hasta que la tarea se completa.

Principios para un Prompt eficaz

PrincipioDescripciónEjemplo
Incluir pasos de verificaciónCuando Codex puede verificar su trabajo, la calidad de la salida es mayor."Escribe una función que incluya casos de prueba para verificar que maneja listas vacías"
Descomponer tareas complejasLas tareas pequeñas son más fáciles de probar y revisar."Primer paso: crea el modelo; cuando termines, dime para continuar con el segundo paso."
Proporcionar contextoHacer referencia a archivos e imágenes relevantes."Consulta el estilo de src/auth.py para implementar una funcionalidad similar."

Codex se desempeña mejor cuando maneja tareas pequeñas y enfocadas. Las tareas grandes deben dividirse en pasos pequeños y ejecutarse gradualmente.


Thread (hilo/sesión)

Un Thread es una sesión de una sola tarea: tu Prompt más las salidas posteriores del modelo y las llamadas a herramientas.

Tipos de Thread

TipoEntorno de ejecuciónCaracterísticas
Thread localTu máquina (dentro del sandbox)Puede leer y escribir archivos, usar herramientas existentes, ejecutar comandos.
Thread en la nubeEntorno aislado en la nubeClona el repositorio para ejecutar, adecuado para tareas paralelas, delegación entre dispositivos.

Reglas de uso del Thread

Los Threads en ejecución pueden ser concurrentes, pero hay que tener en cuenta:

  • Evita que dos Threads modifiquen el mismo archivo al mismo tiempo.
  • Un Thread puede reanudarse más tarde continuando con otro Prompt.
  • Las tareas de larga duración pueden comprimir automáticamente el contexto.

Context (contexto)

Cuando envías un Prompt, incluyes el contexto que Codex puede usar: referencias a archivos e imágenes relevantes.

Fuentes del contexto

  • Extensión del IDE: incluye automáticamente la lista de archivos abiertos y el rango de texto seleccionado.
  • Especificación manual: hace referencia a rutas de archivos o adjunta imágenes en el Prompt.
  • Historial de conversación: el contenido de conversaciones anteriores en el Thread.

Ventana de contexto

Toda la información en el Thread debe caber en la ventana de contexto del modelo.

Codex monitorea y reporta el espacio restante. Cuando se acerca al límite, recibirás una notificación.

Compactación automática

Para tareas más largas, Codex puede comprimir automáticamente el contexto.

El mecanismo de compresión resume la información relevante, descarta los detalles menos importantes y libera espacio para continuar procesando.

Gestionar el contexto

# Iniciar una nueva sesión para liberar contexto
/new

# Ver el uso actual del contexto
/status

Cuando Codex informe un uso elevado de contexto, considera iniciar una nueva sesión o reducir los mensajes históricos.


Sandbox (entorno aislado)

El Sandbox es el mecanismo de aislamiento de seguridad de Codex que evita la modificación accidental de archivos fuera del área de trabajo.

Modo Sandbox

ModoModificación de archivosAcceso a redCasos de uso
Read-onlyProhibidoProhibidoAnálisis de solo lectura, revisión de código
Workspace-writeSolo área de trabajoProhibidoDesarrollo diario (predeterminado)
Full-accessPermitidoPermitidoEntorno de total confianza (usar con precaución)

Mecanismo de Approval (aprobación)

Algunas operaciones requieren tu confirmación antes de ejecutarse:

  • Ejecutar comandos de Shell (especialmente rm, kill, etc.)
  • Modificar o eliminar archivos
  • Acceder a directorios sensibles (como ~/.ssh/, /etc/)
  • Solicitudes de red

Configurar el modo Sandbox

# Cambiar el modo Sandbox en la CLI
codex --sandbox workspace-write

# O especificar en el Prompt
"Analiza este código, no modifiques ningún archivo"

El Sandbox es la primera línea de defensa de la política de seguridad de Codex, asegurando que las operaciones de IA no excedan el alcance esperado.


Approval Policy (política de aprobación)

La política de aprobación controla si Codex necesita confirmación antes de ejecutar operaciones.

Tipos de política

PolíticaDescripciónComportamiento
askPreguntar cada vezSolicita confirmación antes de operaciones sensibles (predeterminado)
approveAprobación automáticaEjecuta automáticamente sin confirmación (usar con precaución)
denyRechazo automáticoRechaza todas las operaciones que puedan causar efectos secundarios.

Configurar la política de aprobación

# ~/.codex/config.toml

approval_policy = "ask"

Resumen

Después de comprender estos conceptos clave, puedes usar Codex de manera más efectiva:

  • Prompt: Describe la tarea con claridad, incluye pasos de verificación.
  • Thread: Gestiona las sesiones de tareas, presta atención a las reglas de concurrencia.
  • Context: Proporciona contexto relevante, monitorea el uso de la ventana.
  • Sandbox: Conoce los mecanismos de seguridad, elige el modo adecuado.

Preguntas frecuentes

P: ¿El Prompt debe estar en chino o en inglés?

Codex admite varios idiomas, pero el inglés suele funcionar mejor. Al usar chino, asegúrate de que la descripción sea lo suficientemente detallada y clara.

P: ¿Cómo ver el estado actual del hilo?

Usa/statusel comando para ver el ID del Thread, el uso de contexto y la información de configuración.

P: ¿Qué hacer si la ventana de contexto está llena?

Inicia una nueva sesión (/new), o deja que Codex comprima automáticamente el historial.

P: ¿Se puede cambiar dinámicamente el modo Sandbox?

Se puede especificar al iniciar la CLI, o configurar un valor predeterminado en el archivo de configuración.

Otras extensiones