Codex App: cómo usar agentes, worktrees y tareas paralelas
Codex en la aplicación de escritorio de ChatGPT convierte tu computadora en un centro de trabajo para agentes. Puedes ejecutar varios chats en paralelo, aislar cambios mediante Git worktrees, trabajar en Local o Cloud, utilizar una terminal integrada, revisar diffs, hacer commits, crear Pull Requests, utilizar Skills, Plugins, MCP, tareas programadas y continuar supervisando el trabajo incluso desde otro dispositivo.
¿Qué es Codex App?
Codex es una vista especializada dentro de la aplicación de escritorio de ChatGPT para macOS y Windows. Está diseñada para trabajar con repositorios, carpetas locales, terminales y herramientas de desarrollo. Su principal diferencia frente a la CLI o una extensión IDE es que permite supervisar múltiples agentes y tareas simultáneas, utilizando chats separados, worktrees aislados y entornos cloud cuando necesitas ejecutar trabajos en paralelo.
Qué puedes hacer con Codex en escritorio
Múltiples agentes
Ejecuta distintos chats sobre tareas independientes.
Worktrees
Aísla los cambios de cada tarea en Git.
Terminal integrada
Tests, build, Git y servidores sin salir del chat.
Git integrado
Diff, stage, commit, push y Pull Request.
Plugins
Añade Skills, MCP y herramientas externas.
Tareas programadas
Automatiza workflows recurrentes.
De programar con un agente a supervisar varios trabajos
Abres un proyecto
Repositorio, carpetas y configuración.
Creas tareas
Un chat para cada objetivo.
Aíslas trabajo
Local, Worktree o Cloud.
Supervisas
Diffs, tests, Git y resultados.
Codex está disponible en macOS y Windows
Disponible
Acceso a proyectos, worktrees, terminal, Git, Plugins y herramientas de escritorio.
Disponible
Codex también ofrece experiencia de escritorio nativa en Windows.
Dentro de la app, selecciona Codex desde el selector principal. Sus chats e historial permanecen separados de los chats normales de ChatGPT.
Inicia sesión con tu cuenta de ChatGPT
Abre ChatGPT Desktop
Utiliza la versión más reciente.
Selecciona Codex
Abre la vista especializada.
Añade un proyecto
Selecciona una carpeta o repositorio.
Inicia un chat
Local, Worktree o Cloud.
Organiza el trabajo por proyecto
Un proyecto puede contener una carpeta principal y otras carpetas relacionadas. Codex utiliza la carpeta principal para operaciones como Git y para detectar automáticamente elementos como AGENTS.md, Skills y config.toml.
mi-proyecto/
├── AGENTS.md
├── .codex/
├── src/
├── tests/
├── package.json
└── .git/Un proyecto puede utilizar varias carpetas
Aplicación principal.
Backend separado.
Documentación técnica.
Sitio frontend.
Las carpetas secundarias siguen disponibles para búsqueda, lectura y edición, pero la detección automática de configuración ocurre principalmente desde la carpeta marcada como principal.
Un chat independiente para cada resultado
La app organiza los agentes mediante threads o chats separados. Cada chat conserva el contexto de su propia tarea.
Login
Corregir autenticación.
API
Crear endpoint REST.
Tests
Mejorar cobertura.
Frontend
Corregir responsive.
Varios agentes pueden trabajar en paralelo
En vez de esperar a que termine una tarea para comenzar la siguiente, puedes iniciar varios chats sobre trabajos independientes y supervisarlos desde la misma interfaz.
Agente A → corregir login
Agente B → crear tests
Agente C → investigar rendimiento
Agente D → actualizar documentaciónLocal, Worktree o Cloud
| Modo | Dónde trabaja | Uso recomendado |
|---|---|---|
| Local | Tu checkout habitual | Cambios directos e interactivos |
| Worktree | Copia Git aislada | Trabajo paralelo |
| Cloud | Entorno remoto | Tareas delegadas y de larga duración |
Trabajar directamente sobre tu checkout
Codex trabaja directamente dentro de la carpeta de desarrollo que utilizas habitualmente.
Tu servidor de desarrollo ya funciona.
Quieres revisar cambios inmediatamente en tu IDE.
La tarea es focalizada.
Otros agentes podrían interferir si modifican el mismo checkout.
La clave para ejecutar varios agentes sin mezclar cambios
Un worktree es un segundo checkout del mismo repositorio. Cada chat puede trabajar sobre su propia copia de los archivos mientras comparte los metadatos Git del repositorio.
Repositorio
├── Local
│ └── trabajo actual
│
├── Worktree A
│ └── feature login
│
├── Worktree B
│ └── tests
│
└── Worktree C
└── refactor APICómo iniciar una tarea aislada
Nuevo chat
Inicia una tarea nueva.
Selecciona Worktree
Cambia el destino desde Local.
Selecciona rama base
main, master u otra rama.
Envía la tarea
Codex crea automáticamente el worktree.
Esto permite crear múltiples entornos sin generar automáticamente una rama Git para cada tarea.
Mueve un chat entre Worktree y Local
Cuando una tarea deje de ser trabajo en segundo plano y quieras probarla directamente en tu entorno habitual, puedes transferir el chat desde Worktree hacia Local.
Worktree
↓ Transferir
Local
↓ Transferir
WorktreeSi posteriormente vuelves a transferirlo a Worktree, Codex puede regresar al entorno asociado a ese chat.
Convierte el trabajo del agente en una rama
Si quieres mantener el trabajo dentro del worktree, utiliza:
Codex convierte el trabajo actual en una rama que puedes guardar, hacer push y convertir en Pull Request.
Si quieres utilizar esa rama directamente desde tu checkout Local, normalmente resulta más cómodo transferir el chat a Local.
No todos los worktrees tienen que ser temporales
Por chat
Ligero, temporal y pensado para una tarea.
Proyecto independiente
Conserva el worktree para iniciar varios chats a largo plazo.
.worktreeinclude: copiar archivos locales que Git ignora
Un worktree se crea principalmente desde los archivos controlados por Git. Si necesitas copiar determinados archivos ignorados, puedes declarar cuáles necesita Codex.
# .worktreeinclude
.env
.env.local
config/local.jsonTen especial cuidado con secretos y credenciales antes de copiar archivos hacia múltiples worktrees.
Los worktrees pueden ocupar bastante espacio
Cada worktree puede contener dependencias, builds, cachés y una copia completa de los archivos del repositorio.
Codex conserva normalmente los 15 worktrees administrados más recientes, aunque este límite puede modificarse desde Configuración.
Configura automáticamente cada nuevo worktree
Un worktree nuevo puede necesitar instalar dependencias, compilar el proyecto o preparar archivos. Los entornos locales permiten automatizar ese proceso.
npm install
npm run buildPuedes versionarla dentro del repositorio para que otros miembros del equipo utilicen la misma configuración.
Crea accesos rápidos para comandos habituales
Servidor
npm startTests
npm testLint
npm run lintEsto evita escribir repetidamente los mismos comandos en la terminal.
Cada chat puede utilizar una terminal integrada
Puedes abrirla desde el icono de terminal o mediante:
Ctrl + `Algunos comandos habituales:
git status
npm test
npm run lint
npm run devEso permite mostrarle directamente un build fallido, test roto o servidor de desarrollo que ya está ejecutándose.
Revisión y operaciones Git sin salir de Codex
Ver cambios del checkout.
Stage de archivos o fragmentos.
Revertir cambios.
Crear commit.
Subir una rama.
Crear Pull Request.
Esos comentarios pueden utilizarse como feedback para que Codex ajuste su implementación.
Workflow recomendado antes de integrar el trabajo de un agente
Lee el resumen
Qué cambió y por qué.
Revisa el diff
Inspecciona cada archivo importante.
Ejecuta tests
Comprueba la implementación.
Comenta errores
Pide correcciones sobre el diff.
Commit
Solo después de verificar.
PR
Envía el trabajo para integración.
Delega tareas a un entorno remoto
Para determinados trabajos puedes ejecutar Codex en un entorno remoto en vez de utilizar tu checkout local.
Contenedor
Codex crea el entorno.
Checkout
Descarga la rama o commit seleccionado.
Setup
Instala y configura el proyecto.
Agent
Codex ejecuta la tarea.
Resultado
Entrega respuesta y diff.
El acceso a Internet del agente está restringido por defecto
Los scripts de configuración pueden acceder a Internet para instalar dependencias. Durante la fase agentic, el acceso a Internet está desactivado por defecto, aunque puede configurarse.
Convierte procesos repetitivos en Skills
Una Skill reúne instrucciones, referencias y recursos para una tarea determinada.
$security-review
$wordpress-plugin-review
$release-checklistPuedes mantenerlas dentro del proyecto y compartirlas con otros miembros del equipo.
Amplía Codex desde el directorio de Plugins
Un Plugin puede combinar Skills, servidores MCP y otras capacidades dentro de un paquete instalable.
GitHub
Issues, PR, CI y workflows.
Vercel
Desarrollo y despliegue web.
Linear
Issues y proyectos.
Slack
Contexto y workflows de equipo.
Esto lo diferencia de la extensión Codex para VS Code, donde actualmente los Plugins completos no están soportados.
Puedes dejar que Codex elija un Plugin o indicarlo tú
@GitHub revisa los PR abiertos
y dime cuáles tienen CI fallido.O simplemente describe la tarea y permite que Codex utilice las herramientas disponibles.
Los Plugins también pueden aportar herramientas MCP
MCP permite conectar Codex con datos y acciones de servicios externos.
Instalar un Plugin no concede automáticamente acceso ilimitado a servicios externos. Los servidores MCP pueden solicitar autenticación y mantienen los controles propios del servicio.
Tareas programadas para trabajos recurrentes
La aplicación de escritorio puede utilizar la experiencia de tareas programadas para ejecutar procesos recurrentes sin tener que iniciar manualmente cada ejecución.
Triage de bugs
Revisar incidencias nuevas.
Fallos de tests
Analizar builds fallidos.
Resumen diario
Preparar cambios recientes.
Revisión recurrente
Buscar problemas periódicamente.
Esto evita que una tarea automática interfiera con los cambios que estás realizando manualmente.
Supervisa Codex desde otro dispositivo
La app móvil de ChatGPT puede conectarse a una computadora donde Codex está ejecutándose y mostrar el estado real de los trabajos.
Iniciar chats nuevos.
Enviar instrucciones adicionales.
Aprobar acciones.
Revisar cambios.
Ver resultados de pruebas.
Consultar salida del terminal.
El código sigue viviendo en la computadora host
Teléfono
│
│ supervisa
▼
Codex Host
│
├── repositorio
├── archivos
├── credenciales
├── terminal
├── plugins
└── herramientas localesLa app móvil actúa como interfaz para supervisar el Codex que sigue ejecutándose en el host.
También puedes trabajar con proyectos en hosts remotos
La aplicación permite conectarse a proyectos mediante SSH cuando tu entorno de desarrollo vive en otra máquina.
Devbox remoto.
Servidor especializado.
Servidor Linux.
Entorno corporativo.
Codex también puede interactuar con aplicaciones gráficas
En configuraciones compatibles, Plugins de Computer Use permiten que Codex vea, haga clic y escriba dentro de aplicaciones del escritorio.
Un agente puede ejecutar el proyecto, abrir la interfaz y recorrer flujos reales para encontrar errores.
Codex App vs CLI vs VS Code
| Función | Desktop | CLI | VS Code |
|---|---|---|---|
| Agente local | Sí | Sí | Sí |
| Cloud | Sí | Sí | Sí |
| Worktrees administrados | Sí | Manual / CLI | Abrir como carpeta |
| Multiagente visual | Sí | Terminal | Varios chats |
| Terminal integrada | Sí | Nativa | Terminal del IDE |
| Git visual | Sí | CLI Git | Git de VS Code |
| Plugins | Sí | Sí | No actualmente |
| Skills | Sí | Sí | Sí |
| MCP | Sí | Sí | Sí |
| Tareas programadas | Administración disponible | Sin interfaz de administración | Sin interfaz de administración |
| IDE context | Con integración IDE | No principal | Sí |
Cuándo usar cada modo
Trabajar en paralelo sobre un plugin WordPress
Proyecto: mi-plugin-wordpress
Worktree A
Corrige el error AJAX
del formulario público.
Worktree B
Revisa seguridad:
- nonces
- capabilities
- sanitización
- escaping
- SQL
Worktree C
Añade tests
para creación
y eliminación
de registros.
Worktree D
Revisa compatibilidad
con PHP 8.2+.Después puedes revisar cada resultado por separado y decidir cuáles integrar.
Ejemplo completo de trabajo multiagente
Abre proyecto
Selecciona el repositorio correcto.
Define AGENTS.md
Establece reglas comunes.
Crea worktrees
Uno por tarea independiente.
Envía prompts
Objetivos pequeños y verificables.
Supervisa
Responde preguntas y aprobaciones.
Ejecuta tests
Valida cada worktree.
Revisa diffs
Comenta problemas y corrige.
Integra
Branch, commit, push y PR.
Cómo trabajar con múltiples agentes sin perder el control
Un objetivo independiente por chat.
Usa Worktree para tareas paralelas.
Define AGENTS.md antes de escalar.
Automatiza setup de worktrees.
Añade tests a cada criterio de aceptación.
Revisa siempre el diff.
No integres varios cambios grandes simultáneamente sin revisión.
Limpia worktrees que ya no necesites.
Problemas habituales en Codex Desktop
| Problema | Qué revisar |
|---|---|
| Worktree sin dependencias | Entorno local y setup script |
| Falta .env | .worktreeinclude |
| Rama bloqueada | Ya está usada por otro worktree |
| Demasiados worktrees | Archivar chats y limpieza |
| Terminal parece bloqueada | Directorio, rama y chats activos |
| Configuración no detectada | .codex en la raíz correcta |
| Función disponible en CLI pero no Desktop | Versiones distintas de Codex |
| Prompt enviado al destino equivocado | Cancelar y recuperar con flecha arriba |
¿Cuándo conviene usar Codex App?
Documentación de Codex Desktop
Codex App
Multiagente, worktrees, Skills y automatización.
Ver Codex App →Worktrees
Aislamiento, Transferencia y ramas.
Ver Worktrees →Terminal integrada
Git, tests, builds y Actions.
Ver terminal →Plugins
Skills, MCP y herramientas.
Ver Plugins →Continúa con las guías de Codex
FAQ sobre Codex App
Codex es una vista especializada de la aplicación de escritorio de ChatGPT para trabajar con repositorios, carpetas locales, terminales y múltiples agentes de programación.
Sí. Codex está disponible actualmente dentro de la aplicación de escritorio de ChatGPT tanto para Windows como para macOS.
Codex CLI está orientado principalmente al trabajo desde terminal. La experiencia Desktop añade una interfaz para administrar proyectos, múltiples chats, worktrees, diffs, Git, terminal integrada, Plugins y tareas programadas.
Son worktrees de Git que permiten crear checkouts separados del mismo repositorio. Codex los utiliza para ejecutar chats en paralelo sin que todos modifiquen el mismo conjunto de archivos.
Sí. La función Transferir permite mover un chat y sus cambios entre el checkout Local y el worktree asociado. Codex administra las operaciones Git necesarias durante la transferencia.
Es un archivo que permite indicar determinados archivos ignorados por Git que Codex debe copiar a nuevos worktrees administrados, por ejemplo archivos locales de configuración necesarios para ejecutar el proyecto.
Sí. Cada chat puede utilizar una terminal vinculada al proyecto o worktree correspondiente. Puedes ejecutar tests, builds, Git y servidores sin salir de la aplicación.
Sí. Las herramientas Git integradas permiten revisar cambios, preparar o revertir archivos y fragmentos, crear commits, hacer push y crear Pull Requests.
Sí. Codex dentro de la aplicación de escritorio puede utilizar Plugins del directorio compatible. Estos pueden incluir Skills, servidores MCP y otras capacidades.
Sí. Puedes utilizar Skills para encapsular procedimientos, instrucciones y recursos reutilizables. Las Skills también pueden compartirse entre distintas superficies de Codex.
Sí. La experiencia de escritorio permite administrar tareas programadas para ejecutar workflows recurrentes. En repositorios Git, estas ejecuciones pueden utilizar worktrees dedicados para no interferir con el trabajo en curso.
Sí. La función Remoto de ChatGPT móvil permite conectarse a una computadora compatible donde Codex está ejecutándose, iniciar o continuar chats, aprobar acciones y revisar resultados mientras los archivos permanecen en el host.
AGENTS.md: cómo dar instrucciones permanentes a Codex
Ya sabes cómo administrar proyectos, agentes y worktrees. Ahora veremos cómo crear un AGENTS.md para que Codex conozca automáticamente la arquitectura, reglas, comandos, tests, convenciones y restricciones de cada repositorio.
Aprender AGENTS.md →