Funciones de la aplicación de escritorio

📚 Navegación de la serie: El artículo anterior 06 · Ejecutar la primera tarea te guió en tu primera interacción práctica con Codex. En este capítulo analizaremos la aplicación de escritorio, que es la interfaz principal promovida oficialmente, detallando la distribución de su interfaz, características clave, ajustes y atajos de teclado. El próximo artículo 08 · Manual de la CLI te guiará de vuelta a la terminal.

OpenAI distribuye Codex en cuatro interfaces, pero la web principal de descarga, la estructura de la sección app de la documentación y los vídeos de demostración se centran en el mismo componente: la aplicación de escritorio. No en la CLI ni en la web, sino en este panel independiente.

Esto tiene un motivo claro. Al revisar la documentación oficial, se observa que la sección app agrupa múltiples páginas de características (features, commands, settings, review, worktrees, automations, browser, computer-use, local-environments, chrome-extension); un volumen de documentación que duplica el dedicado a la CLI. Esto refleja la apuesta de OpenAI por esta interfaz.

A primera vista, se podría asumir que la aplicación de escritorio es una versión simplificada de la CLI para usuarios menos técnicos. Sin embargo, en el caso de Codex, esta suposición es incorrecta: la aplicación de escritorio no es un subconjunto de la CLI, sino la interfaz más completa, ya que integra ejecución paralela de tareas, aislamiento mediante Git worktrees, revisión de cambios visual, navegador web integrado y automatizaciones.

En este artículo analizaremos en detalle esta interfaz: la distribución de sus secciones, cómo ejecutar tareas concurrentes de forma segura, el panel de revisión de cambios y los atajos de teclado indispensables.

Al leer este artículo, obtendrás:

• Un diagrama de distribución de la aplicación de escritorio para localizar la barra lateral, el chat central y el panel de revisión de cambios.
• La diferencia de funcionamiento de los tres modos de ejecución (Local, Worktree y Cloud) y cuándo emplear cada uno.
• Cómo usar el panel de revisión visual (Review pane) para añadir comentarios línea por línea, aceptar o revertir cambios por bloques de código (hunks) y crear Pull Requests.
• El uso de la terminal integrada, botones de acciones rápidos (Actions) y automatizaciones de tareas (Automations).
• Una tabla de correspondencia de atajos de teclado y comandos de barra diagonal, con un flujo práctico de inicio.

⚠️ Los atajos de teclado, parámetros y directivas descritos en este artículo corresponden a la documentación oficial de Codex. Ten en cuenta que las teclas se documentan de forma predeterminada para macOS; en Windows, consulta las equivalencias en Settings > Keyboard Shortcuts en la aplicación local.

---

01 Concepto: El espacio de trabajo concurrente de Codex

Al abrir la aplicación por primera vez, la cantidad de barras laterales, paneles y botones puede resultar confusa. Para entenderla, conviene aclarar su propósito de diseño.

Para resumir en una frase: la aplicación de escritorio de Codex es un panel de control diseñado para la ejecución paralela de tareas de código. La documentación oficial la define como "a focused desktop experience for working on Codex threads in parallel" (una interfaz de escritorio enfocada a trabajar en múltiples hilos de Codex en paralelo). Un hilo (thread) representa una tarea o sesión de chat independiente, similar a la que ejecutamos en el capítulo 06.

Analogía: Un taller con múltiples mesas de trabajo. (Las mesas de trabajo representan cada hilo de ejecución de Codex, no tu puesto físico). Trabajar en la CLI equivale a sentarte en una única mesa y completar un encargo antes de empezar el siguiente; la aplicación de escritorio es como gestionar un taller con varias mesas operando simultáneamente: en una mesa Codex depura un fallo, en otra genera pruebas unitarias y en una tercera procesa una tarea de larga duración. Tú supervisas el taller, ves el progreso de cada mesa y resuelves dudas cuando los agentes lo requieren. La gestión y supervisión visual de tareas simultáneas es el propósito de la aplicación.

La aplicación se ejecuta sobre el mismo núcleo de Codex que la CLI o las extensiones de IDE; comparte las mismas reglas en AGENTS.md (el manual del proyecto explicado en el capítulo 02), la configuración de servidores MCP y las Skills de desarrollo. Es la misma herramienta operando en una interfaz optimizada para la concurrencia y la visualización.

Escenarios donde se recomienda el uso de la aplicación:

• Desarrollo de múltiples cambios menores e independientes en paralelo, evitando mezclar cambios en el mismo directorio de archivos.
• Análisis y edición de interfaces web, utilizando el navegador integrado de la aplicación para ver la representación visual de los cambios de Codex en tiempo real.
• Automatización de resúmenes de commits diarios del repositorio para generar informes de estado por la mañana.

Estas características, complejas de configurar o no disponibles en la CLI, vienen integradas por defecto en la aplicación.

💡 Resumen en una frase: La aplicación de escritorio es una interfaz optimizada para la gestión de tareas paralelas y la revisión de cambios visual, que comparte el mismo núcleo y configuración que la CLI de Codex.

---

02 Disponibilidad de plataformas y limitaciones

Una consideración importante a tener en cuenta antes de planificar tu entorno de desarrollo: la aplicación de escritorio no está disponible para Linux en la actualidad.

La documentación oficial muestra un registro de espera para soporte de Linux; los usuarios de esta plataforma deben emplear la CLI (explicada en el próximo capítulo). Las instrucciones de instalación para macOS y Windows se detallan en el capítulo 03; resumimos aquí los puntos clave:

Plataforma	Descarga	Consideraciones de instalación
macOS (Apple Silicon)	Descarga directa del instalador estándar	Seleccionar el instalador correspondiente a la arquitectura de tu procesador
macOS (Intel)	Seleccionar Intel build en el listado de descargas	Evitar instalar la versión de Apple Silicon para prevenir cierres inesperados
Windows	Descarga e instalación directa con winget install Codex -s msstore	Parámetros del sandbox detallados en el capítulo 03
Linux	No disponible; registro en la lista de espera	Utilizar la CLI como alternativa de desarrollo

Al iniciar sesión por primera vez, considera esta restricción de acceso:

Iniciar sesión con cuenta de ChatGPT habilita todas las funciones de la aplicación; usar una API key limita o desactiva ciertas funciones en la nube. La documentación advierte de que "some functionality might not be available" (algunas funciones podrían no estar disponibles). Las restricciones específicas cambian con las actualizaciones; como regla general, si quieres disponer de todas las funciones de la aplicación de escritorio, inicia sesión con tu cuenta de ChatGPT. Como vimos en el capítulo 04, el uso de Codex se asocia a los planes Plus, Pro, Business, Edu o Enterprise de tu cuenta.

En mis pruebas iniciales con la aplicación, inicié sesión con una API key por comodidad y observé que ciertas funciones de sincronización en la nube se mostraban atenuadas. Al cerrar sesión e iniciar sesión de nuevo con mi cuenta de ChatGPT, estas funciones se activaron de inmediato.

💡 Resumen en una frase: La aplicación de escritorio está disponible para macOS y Windows; asegúrate de descargar la arquitectura adecuada para Mac e iniciar sesión con tu cuenta de ChatGPT para evitar restricciones de funciones en la nube.

---

03 Distribución de la interfaz: Barra lateral, zona central y panel de revisión

Al iniciar la aplicación de escritorio, la ventana se organiza en tres columnas principales: la barra lateral izquierda gestiona los directorios y sesiones, la zona central es el chat de instrucciones y el panel derecho visualiza los resultados y cambios.

El siguiente diagrama muestra la distribución del espacio de trabajo:

El flujo de desarrollo se desplaza de izquierda a derecha: seleccionas el proyecto o sesión en la barra lateral → introduces instrucciones en el chat central → revisas y validas los cambios en el panel derecho.

Barra lateral izquierda: Panel de navegación

La barra lateral izquierda agrupa las opciones de acceso y configuración (la nomenclatura exacta puede variar en sucesivas versiones):

• New Thread: inicia una nueva sesión o hilo de ejecución de Codex para una tarea específica.
• Search: busca términos y fragmentos de código en tus conversaciones pasadas e historiales de proyectos.
• Plugins: gestiona complementos externos integrados en Codex, como integraciones de navegadores o GitHub.
• Automations: configura automatizaciones y tareas programadas (detalles en la sección 05).
• Projects: enumera las carpetas y repositorios locales asociados; permite cambiar de entorno de trabajo rápidamente.
• Chats: conversaciones generales sin acceso al sistema de archivos, ideales para consultas generales de programación.

Aclaremos la diferencia entre un Proyecto (Project) y un Chat estándar (Chat):

Analogía: Un proyecto es un programador contratado con acceso al servidor; un chat estándar es un consultor externo al que le haces preguntas en la oficina. El proyecto asocia la conversación a un directorio físico de tu disco duro, y Codex dispone de permisos para leer y modificar archivos o ejecutar comandos locales en él. El chat estándar no está asociado a carpetas de tu sistema y las sesiones se almacenan en el directorio del sistema de Codex (predeterminado en ~/.codex/threads), siendo idóneo para consultas de lógica que no afecten a tu base de código.

Escenarios recomendados:

• Si quieres que Codex modifique las rutas en tu carpeta ~/code/my-app → inicia un Proyecto.
• Si quieres consultar «cómo funciona el recolector de basura en Python» → inicia un Chat estándar.

Zona central: Interfaz de chat y configuración de sesión

El panel central contiene la conversación (los archivos leídos por el agente, los comandos sugeridos y las respuestas) y el cuadro de entrada de texto. En la barra inferior del cuadro de entrada se ubican controles esenciales que debes revisar antes de enviar mensajes:

• Modo de ejecución: permite seleccionar entre Local, Worktree o Cloud para determinar dónde procesará el agente la tarea (ver sección 04).
• Modelo: selector del modelo activo en la sesión (permite cambiar de modelo en mitad de una sesión).
• Permisos: control de la política de aprobación y sandbox para la sesión.

Panel derecho: Visualización de cambios y herramientas

El panel derecho se puede expandir mediante el icono de la esquina superior derecha de la ventana. Agrupa las pestañas de supervisión del agente:

• Review (Revisión de diffs): visualiza las líneas de código añadidas y eliminadas de los archivos modificados por Codex (ver sección 03).
• Terminal: terminal integrada asociada al directorio del proyecto o worktree (ver sección 05).
• Preview (Vista previa): visor web, visor de documentos y visor de archivos adjuntos.

La distribución general se detalla en el siguiente gráfico:

El gráfico identifica las seis áreas principales: la barra superior (con selección de proyecto, modo, modelo y botones de acción), el panel de proyectos y sesiones a la izquierda, el chat de instrucciones al centro, el panel de revisión de cambios en el cuadrante superior derecho, la terminal integrada en el cuadrante inferior derecho y la barra de estado inferior (que indica la rama activa, tokens consumidos y estado de conexión). Los componentes y posiciones exactas se adaptan en sucesivas versiones de la aplicación.

A continuación se muestra una captura de la interfaz de usuario:

💡 Resumen en una frase: La distribución se organiza en tres columnas: navegación y sesiones a la izquierda, entrada de chat al centro y paneles de diff y terminal a la derecha; recuerda asociar la conversación a un proyecto para modificar archivos locales.

---

04 Modos de ejecución: Local, Worktree y Cloud

Antes de enviar instrucciones al agente, debes seleccionar el modo de ejecución en el selector del chat. Es una de las configuraciones más importantes de la aplicación de escritorio, ya que define dónde y cómo se aplican los cambios en tus archivos.

La documentación oficial especifica el comportamiento de los tres modos:

Modo	Entorno de ejecución	Aplicación de cambios	Escenario recomendado
Local	Tu equipo local, carpeta del proyecto	Modificaciones físicas directas en tu directorio activo	Tareas diarias donde quieras ver y verificar los cambios inmediatamente
Worktree	Tu equipo local, en un Git worktree independiente	En una copia aislada, sin modificar tu directorio activo	Pruebas de concepto o tareas simultáneas sobre el mismo repositorio sin mezclar cambios
Cloud	Entornos aislados en la nube de OpenAI	Sandbox virtual; los cambios se retornan como Pull Requests o informes	Tareas pesadas o de larga duración que no quieras procesar localmente

La documentación oficial aclara que tanto el modo Local como el modo Worktree se ejecutan de forma local en tu ordenador, reservando el modo Cloud para procesamiento remoto en los servidores de OpenAI.

Detalle del modo Worktree, que habilita la ejecución paralela y segura en la aplicación de escritorio:

Analogía: Fotocopiar los planos de construcción para que varios contratistas trabajen por separado. Si tienes varios contratistas (agentes de Codex) trabajando en el mismo edificio y todos dibujan sobre el mismo plano original (modo Local), las anotaciones se mezclarán y taparán entre sí. El modo Worktree crea una copia exacta e independiente de los planos para cada contratista (un Git worktree, que equivale a ejecutar git worktree localmente), permitiéndoles modificar la estructura por separado. Una vez revisada y aprobada una copia, se fusionan los cambios en el plano original. Las modificaciones de un hilo no interfieren en las del resto hasta que decidas unirlas.

El uso de múltiples hilos en modo Local sobre el mismo repositorio puede provocar colisiones de archivos y sobreescrituras accidentales de código. Para tareas paralelas, el modo Worktree es la opción más segura.

Consideraciones técnicas sobre el uso de Worktrees:

• Requiere un repositorio Git: el modo Worktree se basa en el comando nativo git worktree, por lo que el proyecto debe disponer de control de versiones Git inicializado.
• Ignora archivos en .gitignore: dado que se genera a partir del historial de Git, los archivos excluidos del control de versiones (como claves de entorno .env o la carpeta node_modules) no se copian al worktree temporal. Si la compilación de la tarea depende de estos elementos, debes configurar scripts de entorno para cargarlos (ver sección 05).
• Directorio de almacenamiento: los directorios temporales se generan por defecto bajo la ruta ~/.codex/worktrees, en estado de puntero desacoplado ("detached HEAD") para no alterar las ramas activas de tu repositorio principal.
• Función Hand off (Entrega de tarea): permite transferir un hilo y sus cambios entre el entorno aislado del Worktree y tu directorio Local para continuar la edición en tu IDE habitual mediante la opción Hand off en la barra del hilo.
• Gestión de espacio: el sistema conserva por defecto un histórico de los últimos 15 worktrees generados por Codex, eliminando los antiguos automáticamente para ahorrar espacio (guardando una copia de seguridad recuperable en caso necesario). Estos valores se pueden modificar en el panel de configuración de la aplicación.

💡 Resumen en una frase: El modo Local edita tus archivos activos, el modo Worktree crea copias locales aisladas para desarrollo concurrente y el modo Cloud delega el procesamiento en la nube; prefiere Worktree para tareas simultáneas en el mismo repositorio.

---

05 Características exclusivas de la interfaz gráfica

A continuación detallamos las herramientas de la aplicación de escritorio que no están disponibles o requieren configuraciones complejas en la interfaz de línea de comandos (CLI).

Panel visual de revisión (Review pane)

Este panel proporciona un entorno gráfico interactivo que supera la salida de texto de la terminal al revisar diferencias de código.

Analogía: Pasar de leer un texto corrido a usar el modo de sugerencias en un procesador de textos. En la CLI, el diff es una salida estática de líneas verdes y rojas en la consola; el panel de revisión funciona como un editor colaborativo: puedes interactuar directamente con el código propuesto, añadir comentarios en líneas específicas y tomar decisiones sobre fragmentos de código concretos.

Capacidades del panel de revisión:

• Lectura del estado de Git: muestra los cambios pendientes de confirmar en el repositorio, incluyendo modificaciones hechas a mano y las propuestas por Codex.
• Filtros de visualización: permite alternar entre ver cambios pendientes (Uncommitted changes), cambios acumulados de la rama (All branch changes) o solo los cambios de la última respuesta del agente (Last turn changes). En entornos locales, permite filtrar por cambios preparados o sin preparar (Staged / Unstaged).
• Comentarios línea por línea (Inline annotations): sitúa el cursor sobre una línea del diff, haz clic en el icono + y escribe tus instrucciones específicas sobre ese fragmento (por ejemplo: «extrae esta constante a un archivo de configuración»). Envía el mensaje y Codex actualizará el código basándose en el comentario de esa línea exacta.
• Gestión por bloques de código (Hunks): permite preparar para commit (stage), descartar (unstage) o revertir (revert) cambios a nivel de archivo individual o por bloques específicos de código dentro de un mismo archivo.

Integración con control de versiones: una vez validados los cambios en el panel, puedes crear commits, hacer push de las ramas y abrir Pull Requests en GitHub directamente desde los controles de la aplicación de escritorio sin recurrir a la terminal.

Nota: El panel de revisión requiere que el proyecto esté bajo control de versiones Git. Si vas a interactuar con comentarios de PRs de GitHub directamente en la aplicación, debes tener instalado y autenticado el cliente de consola GitHub CLI (gh) en tu máquina local.

El uso de comentarios en líneas específicas facilita la corrección de código, evitando tener que describir la ubicación exacta de las funciones al dar instrucciones a Codex.

Terminal integrada

Cada sesión o hilo de ejecución de la aplicación incluye acceso a una terminal integrada asociada al directorio del proyecto o al worktree activo. Se puede abrir desde el menú de la aplicación o pulsando la tecla Cmd + J en macOS (verificar equivalencias en Windows).

Su ventaja de diseño: la terminal integrada comparte el contexto y el directorio de la sesión activa de Codex. Al ejecutar comandos como npm test o git status, actuarás directamente sobre el subdirectorio temporal o local que Codex está modificando, evitando inconsistencias entre los archivos que edita el agente y los que compila tu terminal. Además, Codex tiene acceso de lectura a la salida de esta terminal, lo que le permite analizar los logs de error de compilación o de ejecución de pruebas para corregir fallos de forma autónoma.

Nota de atajo de teclado: el atajo Cmd + K en la aplicación de escritorio está asignado para abrir el menú de comandos globales, no para limpiar la terminal integrada. Para limpiar el buffer de la terminal, utiliza Ctrl + L.

Botones de acción rápida (Actions)

Permite registrar secuencias de comandos recurrentes (como inicializadores de servidores, linters o compiladores) como accesos directos en la barra de menú superior de la aplicación.

Analogía: Crear accesos directos en la pantalla de inicio. En lugar de abrir la terminal y escribir la secuencia de comandos de compilación cada vez, registras un botón de acción que ejecuta el proceso con un clic.

Las acciones rápidas (Actions) y los scripts de configuración de entorno se gestionan bajo el apartado Local Environments (Entornos locales). Los parámetros se guardan en el subdirectorio .codex en la raíz de tu proyecto, pudiendo integrarse en Git para compartirse con los miembros del equipo. Los scripts de entorno se ejecutan automáticamente al inicializar un worktree (útiles para instalar dependencias ignoradas en Git), mientras que las Actions permanecen accesibles en el panel superior para su ejecución manual.

Automatización de tareas (Automations)

Permite programar la ejecución de tareas recurrentes a intervalos definidos (horas, días o semanas) para que Codex las ejecute de forma autónoma en segundo plano.

Analogía: Configurar una tarea programada en el sistema. Codex se activará en los periodos indicados, ejecutará las instrucciones configuradas y registrará los resultados o informes en la interfaz.

Escenarios prácticos:

• Generación de informes de Git: programar un análisis diario de los commits aplicados en el repositorio para redactar un resumen de cambios realizados.
• Análisis de calidad de código: programar ejecuciones semanales de herramientas de análisis estático de código para proponer correcciones automáticas de fallos leves.
• Persistencia de hilos (Thread automation): mantener una sesión activa para procesar tareas complejas de desarrollo de forma periódica conservando el contexto de ejecución.

Requisito de ejecución: las automatizaciones programadas requieren que la aplicación de escritorio esté abierta y el proyecto sea accesible en el disco duro.

Habilitar una automatización de resumen de commits diarios permite disponer de un registro detallado del progreso del repositorio en la interfaz de la aplicación de escritorio de forma transparente y automatizada.

💡 Resumen en una frase: La revisión visual de diffs, la terminal compartida con acceso de lectura para el agente, las Actions rápidas de compilación y las Automaciones programadas son características exclusivas que diferencian a la aplicación de escritorio de la CLI.

---

06 Atajos de teclado y comandos de barra diagonal

Reunimos a continuación los comandos e interacciones más frecuentes para agilizar tu flujo de trabajo en la aplicación de escritorio:

⚠️ Los atajos de teclado documentados corresponden por defecto a macOS. En sistemas Windows, consulta la lista completa de correspondencias locales en el menú Settings > Keyboard Shortcuts (Configuración > Atajos de teclado), donde podrás también personalizar las teclas de acceso.

Atajos recomendados para macOS (fuente: documentación oficial de comandos de la aplicación):

Atajo en macOS	Acción en la interfaz	Utilidad
Cmd + Shift + P o Cmd + K	Abre el panel de comandos globales	Permite buscar y ejecutar cualquier acción en la aplicación
Cmd + N o Cmd + Shift + O	Inicia una nueva sesión (New Thread)	Punto de partida para nuevas tareas en paralelo
Cmd + J	Muestra u oculta la terminal integrada	Acceso a la consola del proyecto activo
Cmd + B	Muestra u oculta la barra lateral izquierda	Amplía la zona de chat central
Cmd + Option + B	Muestra u oculta el panel de revisión (Review pane)	Acceso visual a los diffs de cambios
Cmd + G	Abre el buscador de hilos históricos	Permite localizar sesiones de trabajo anteriores
Cmd + F	Busca términos en la sesión activa	Filtra texto dentro del chat actual
Cmd + ,	Abre el panel de configuración global	Acceso a parámetros de cuenta, Git y MCP
Ctrl + L	Limpia la consola de la terminal integrada	Libera espacio visual en la consola
Ctrl + M	Inicia la entrada de instrucciones por voz	Transcribe dictados de voz a texto en el chat

Diferencia de búsqueda: el atajo Cmd + G busca a través de los historiales de todas las sesiones de la aplicación, mientras que Cmd + F limita la búsqueda al texto del hilo de chat activo.

Comandos de barra diagonal (Slash commands) disponibles en el cuadro de entrada de texto:

Comando	Acción del sistema
/status	Muestra los identificadores de la sesión, consumo de tokens y límites de cuota
/review	Inicia la revisión de cambios en el diff comparando con la rama base
/plan	Activa o desactiva el modo de planificación estructurada de Codex
/goal	Define un objetivo de desarrollo persistente para el agente (se aconseja definir la estrategia primero con /plan)
/mcp	Muestra la conexión y el estado de las herramientas de los servidores MCP asociados
/feedback	Abre el asistente de envío de informes de error y comentarios del sistema

Uso de Skills: escribir el símbolo $ en el chat despliega el menú de Skills registradas; las Skills integradas también se indexan en el listado desplegable del comando /. Si el comando /goal no aparece en el listado, verifica que está habilitado en tu archivo config.toml con features.goals = true o ejecuta codex features enable goals en la terminal.

El comando /status es la utilidad más frecuente para comprobar de forma rápida el consumo de tokens y la cuota disponible de la sesión antes de solicitar cambios complejos.

💡 Resumen en una frase: Familiarízate con Cmd + K para buscar acciones, Cmd + N para crear sesiones de chat concurrentes, /status para supervisar la cuota de uso y /review para abrir el panel de diffs visuales; en Windows, verifica la asignación en la configuración de teclado local.

---

07 Práctica: Flujo de trabajo concurrente

Ejecutemos una práctica básica en la aplicación de escritorio para crear dos tareas en paralelo en entornos aislados (Worktree) y verificar los cambios en el panel de revisión:

Requisitos previos: tener instalada la aplicación de escritorio, la sesión iniciada con tu cuenta de ChatGPT y un proyecto local inicializado como repositorio Git (necesario para el uso de Worktrees y el Review pane).

Paso 1: Asociar el proyecto y seleccionar el modo Worktree

En la barra lateral izquierda, añade tu carpeta del proyecto. Al iniciar un nuevo hilo de chat, selecciona el modo de ejecución Worktree en la barra inferior del cuadro de entrada.

Resultado esperado: el selector de modo muestra el estado Worktree y te permite definir la rama base de origen (como main o tu rama activa actual). Si la aplicación indica que se requiere un repositorio Git, inicializa el control de versiones en la carpeta del proyecto antes de continuar.

Paso 2: Enviar la primera instrucción

En el cuadro de chat, solicita una tarea menor y definida, por ejemplo:

Busca comentarios que incluyan la etiqueta TODO en el código y escribe su implementación

o bien:

Añade una sección sobre cómo ejecutar el proyecto localmente en el archivo README.md

Envía el mensaje. Resultado esperado: Codex creará un Git worktree aislado en tu equipo local y aplicará los cambios en ese directorio temporal, manteniendo intacta tu carpeta de trabajo activa.

Paso 3: Iniciar una tarea paralela

Sin esperar a que finalice la primera tarea, haz clic en New Thread en la barra lateral izquierda, asocia el mismo proyecto en modo Worktree y solicita una tarea diferente:

Elimina todas las llamadas de depuración console.log del código

Resultado esperado: la barra lateral mostrará dos hilos activos en paralelo, cada uno editando copias aisladas (worktrees) del mismo proyecto. Puedes alternar entre ambos chats para supervisar el progreso de cada agente por separado sin riesgo de que mezclen sus cambios.

Paso 4: Revisar y validar cambios en el Review pane

Selecciona una de las tareas finalizadas y abre el panel visual de revisión (Review pane) en la columna derecha de la aplicación.

Prueba las siguientes interacciones:

• Comentarios en líneas: sitúa el cursor sobre una línea modificada en el diff, haz clic en +, escribe «añade un comentario aclaratorio aquí» y envíalo; a continuación escribe en el chat central «aplica la sugerencia del comentario» para comprobar que Codex actualiza el archivo según la indicación.
• Preparación por bloques: prepara para commit (stage) o descarta (revert) bloques de código (hunks) específicos dentro del diff.

Resultado esperado: los cambios de Codex permanecen en el entorno de pruebas del worktree hasta que decidas integrarlos en tu rama o descartarlos desde el panel.

Paso 5: Integración local (Hand off)

Si los cambios aplicados en el worktree son correctos y quieres traerlos a tu directorio de trabajo activo para continuar editando en tu editor habitual, haz clic en la opción Hand off en la cabecera del hilo de chat para transferir la sesión al modo Local.

Resultado esperado: Codex gestiona la integración de los archivos en tu carpeta local mediante operaciones de Git nativas y la sesión de chat cambia al modo de ejecución Local para continuar el desarrollo. Ten en cuenta que los archivos listados en .gitignore no se transfieren en este paso.

Este flujo de trabajo te familiarizará con la ejecución paralela y la validación de cambios en la aplicación de escritorio.

💡 Resumen en una frase: Inicia sesiones en modo Worktree para trabajar en paralelo de forma segura, utiliza el Review pane para añadir comentarios o descartar fragmentos del diff y emplea la opción Hand off para integrar los cambios aprobados en tu directorio de trabajo principal.

---

08 Resumen

En este capítulo hemos detallado la aplicación de escritorio de Codex:

• Propósito: diseñada para la gestión de tareas en paralelo y la revisión de cambios visual, compartiendo el mismo núcleo y configuraciones globales que la CLI y las extensiones.
• Plataformas: disponible en macOS y Windows (Linux no disponible en la actualidad); se recomienda iniciar sesión con cuenta de ChatGPT para evitar restricciones en funciones en la nube.
• Distribución: barra lateral de navegación a la izquierda, ventana de chat al centro y paneles de diff y terminal integrada a la derecha.
• Modos de ejecución: Local para edición directa, Worktree para copias aisladas que faciliten la concurrencia y Cloud para delegación en la nube.
• Herramientas exclusivas: panel visual de diffs con comentarios en línea, terminal integrada compartida con el agente, Actions rápidas y automatización de tareas con Automations.
• Atajos: comandos globales con Cmd + K, nuevas sesiones con Cmd + N, e informes de estado de cuota y contexto con /status.

Con este análisis completado, conoces las posibilidades de la aplicación de escritorio para gestionar flujos de desarrollo concurrente de forma segura y visual.

El próximo capítulo 08 · Manual de la CLI te guiará para trabajar con Codex directamente desde la terminal de comandos, detallando la sintaxis del ejecutable, los modos de inicio y cómo integrar al agente en tus scripts de automatización locales.

---

Lecturas recomendadas

• Uso de Git Worktrees en Codex: flujos de desarrollo aislado
• Conexión y uso de servidores MCP
• Estructurar directivas en el archivo AGENTS.md