Objetivo del tema
Explorar cómo Codex CLI convive con Git, automatiza ejecuciones de pruebas y linters, y se combina con editores como VS Code, Cursor o Windsurf en su versión más reciente.
Codex CLI opera como agente local, por lo que puede ejecutar comandos, editar archivos y dejar registro de la sesión mientras trabajas. Para sacar provecho de sus capacidades conviene coordinarlo con tu flujo de Git, tus scripts de calidad y el editor que uses a diario.
Codex detiene acciones peligrosas si el repo no está limpio. Pídele que revise git status, cree commits o prepare un revert, siempre con confirmación humana.
Solicita al agente que ejecute pruebas y linters, o usa codex exec para incorporar scripts en pipelines.
VS Code, Cursor y Windsurf disponen de extensiones que unifican la experiencia entre la TUI y el IDE.
Codex CLI requiere, por defecto, un repositorio Git para evitar sobrescrituras imprevistas. Si tu carpeta es nueva, inicializa el repositorio antes de lanzar la sesión:
git init
git add .
git commit -m "init"En una sesión interactiva describe lo que necesitas y deja que el agente proponga cambios:
codex --full-auto "Refina la API y prepara commit con mensaje descriptivo"Cuando Codex muestre los diffs, usa el panel para aceptar o descartar archivos. Luego pídele tareas complementarias:
# Dentro de la sesión
"Muestra git status y resume los cambios pendientes"
"Genera un mensaje de commit conciso y ejecuta git commit -am <mensaje>"Si prefieres aprobar cada comando que involucre Git, inicia en modo supervisado:
codex --sandbox workspace-write --ask-for-approval on-request "Ayuda con branching y commits seguros"Al trabajar con ramas, Codex puede crear y alternar branches bajo tu autorización:
# Dentro de la sesión
"Crea una rama feature/health-logging y muéstrame git status"
"Vuelve a main y prepara un git revert del último commit, pero pídeme confirmación"Para automatizar pasos de Git fuera de la sesión interactiva, recurre a codex exec registrando el resultado en tu historial:
codex exec --full-auto "git status --short"
codex exec --full-auto "git log -3 --oneline"/status dentro de Codex para confirmar el directorio de trabajo, las ramas visibles y el modo de aprobaciones. Si una acción potencialmente destructiva es necesaria, documenta el motivo antes de autorizarla.
Codex es capaz de identificar comandos comunes en tu stack (scripts de package.json, targets de Makefile, suites de Pytest, etc.). Para un control completo, especifica qué deseas ejecutar:
codex --full-auto "Ejecuta pytest -q y dime si aparece algún error"
codex --full-auto "Revisa con ruff check y aplica los fixes permitidos"Si Codex detecta scripts relevantes te los sugerirá en el panel de acciones. Puedes confirmarlos o pedir alternativas («prefiero npm run verify», «usa tox en lugar de pytest directo»).
Para pipelines o cronjobs, el modo no interactivo deja un rastro explícito:
codex exec --full-auto "npm run lint && npm test"
codex exec --json --output-last-message resultados.json "poetry run pytest -q"El flag --json produce eventos en formato JSON Lines, útil para integrarlos con dashboards o herramientas de monitoreo. Si necesitas ejecutar scripts repetidamente, guarda un prompt personalizado en ~/.codex/prompts/<nombre>.md y simplemente invócalo con /nombre desde la sesión.
Codex también está disponible como extensión para editores gráficos. Instálalo desde el marketplace correspondiente y sincroniza el inicio de sesión con tu cuenta de ChatGPT.
Busca “OpenAI Codex” en el marketplace o visita la página oficial. Una vez instalada, abre la paleta de comandos y ejecuta Codex: New Session.
Cursor integra Codex en su barra lateral. Al enlazar tu cuenta se replica la configuración de sandbox y aprobaciones que definas en ~/.codex/config.toml.
En Windsurf, activa Codex desde la vista de agentes para mantener la misma conversación entre el IDE y la terminal. Ideal para revisar diffs de forma visual.
El contexto de archivos, mensajes recientes y configuración se comparte entre la TUI y el IDE. Puedes iniciar una sesión en Codex CLI, continuar desde VS Code y volver a la terminal con codex resume --last sin perder el historial.
| Aspecto | Preguntas de control | Acción recomendada |
|---|---|---|
| Git | ¿La rama está limpia y el commit tiene contexto suficiente? | Solicita a Codex un resumen de cambios y valida con git status / git show. |
| Pruebas | ¿Se ejecutaron los tests y linters relevantes recientemente? | Registra la ejecución desde Codex o adjunta el resultado de codex exec en tu documentación. |
| Editor | ¿La sesión del IDE y la de la terminal comparten el mismo estado? | Sincroniza con codex resume y cierra la conversación dejando un mensaje final. |
| Config | ¿Las políticas de sandbox y aprobación son adecuadas para la tarea? | Revisa /status y ajusta con /approvals o perfiles en config.toml. |
Codex CLI se vuelve más potente cuando interactúa con el ecosistema de herramientas que ya usas. Aprovecha la colaboración con Git para mantener historial claro, automatiza calidad desde el propio agente y alterna entre CLI e IDE según lo requiera el flujo. Así obtienes la velocidad del agente sin perder la trazabilidad ni el control manual.