Codex
Perfiles
- (sin perfil) — análisis de solo lectura (sin compilación, sin pruebas)
--profile edit— ediciones locales, compilación o pruebas (workspace-write, totalmente automático)--profile full— acceso a red o sistema de archivos amplio (danger-full-access, totalmente automático)
Usa --profile edit siempre que la tarea involucre go test, go build o cualquier comando que escriba artefactos de compilación. El sandbox predeterminado de solo lectura bloquea todas las escrituras, incluidos los directorios temporales del compilador.
Para tareas complejas, añade --config model_reasoning_effort="xhigh".
Selección de modelo
Usa el modelo del proyecto por defecto en .codex/config.toml (gpt-5.4).
Usa --model gpt-5.3-codex-spark para trabajo interactivo que prioriza la velocidad:
- iteraciones rápidas de ida y vuelta
- corrección rápida de errores y ediciones dirigidas
- refactorizaciones pequeñas o medianas, o ajustes de interfaz
- prototipado rápido donde se espera redirigir o interrumpir con frecuencia
Mantén el modelo predeterminado gpt-5.4 para trabajo que prioriza la profundidad:
- ejecuciones autónomas largas
- cambios amplios en múltiples archivos con razonamiento intenso
- tareas con muchas pruebas o verificación
- superficies de alto riesgo/corrección donde vale la pena un razonamiento más profundo a cambio de mayor latencia
Si el usuario solicita explícitamente un modelo, sigue su solicitud.
Comandos
Valores predeterminados del proyecto en .codex/config.toml. Incluye siempre --skip-git-repo-check y 2>/dev/null. Solo sobrescribe el modelo cuando el usuario lo solicite explícitamente, o cuando la tarea claramente cumpla con los criterios de velocidad de Spark indicados arriba.
| Caso de uso | Comando |
|---|---|
| Análisis de solo lectura | codex exec --skip-git-repo-check -o "$CODEX_OUT" "prompt" 2>/dev/null |
| Bucle interactivo que prioriza velocidad (Spark) | añade --model gpt-5.3-codex-spark |
| Aplicar ediciones locales | añade --profile edit |
| Acceso a red / amplio | añade --profile full |
| Reanudar sesión | `echo "prompt" |
Crea un archivo temporal para la salida antes de ejecutar: CODEX_OUT=$(mktemp /tmp/codex-out.XXXXXX). Lee el resultado de $CODEX_OUT después de la finalización.
Ejecuta con Bash run_in_background: true. Monitorea mediante TaskOutput con block: true, timeout: 600000 — NO uses comandos sleep para sondear. Lee el archivo -o para la respuesta final.
Reanudación
No pases indicadores de modelo/esfuerzo/sandbox al reanudar: la configuración de la sesión original se conserva. -o es seguro incluirlo.
Convenciones
Este es un proyecto Go. Usa go test, go build, go vet en los prompts. Los workers de Codex no reciben CLAUDE.md ni hooks, por lo que las convenciones del proyecto deben ser explícitas.
Verificación posterior a la ejecución
Verifica siempre la salida de Codex mediante git diff --stat — nunca confíes en la lista de archivos auto-reportada por el worker. Los workers de Codex pueden realizar cambios fuera del alcance (eliminar archivos, revertir código no relacionado, eliminar funciones de prueba). La promesa de finalización puede listar solo los archivos previstos mientras omite efectos secundarios destructivos.
Cuando exista otro trabajo en el mismo código base, incluye listas explícitas de archivos "NO modificar ni eliminar" en el prompt. La instrucción positiva ("solo toca estos archivos") es insuficiente: Codex interpreta "limpiar" de manera amplia.
Según [[principles/prove-it-works]]: confía en los artefactos, no en los auto-informes.
Uso de worktree
Con -C <worktree-dir>, el worktree tiene su propio índice git. .claude/ puede enlazar simbólicamente a .agents/ — usa rutas de .agents/ para operaciones de git.