Solución de problemas

Preguntas frecuentes

Aparecen en el panel lateral archivos que Codex no editó

Si tu proyecto está dentro de un repositorio Git, el panel de revisión muestra automáticamente los cambios según el estado de Git de tu proyecto, incluidos los cambios que Codex no realizó.

En el panel de revisión, puedes alternar entre los cambios preparados y los cambios que aún no se han preparado, y comparar tu rama con main.

Si solo quieres ver los cambios de tu último turno de Codex, cambia el panel de diferencias a la vista Último turno.

Obtén más información sobre cómo usar el panel de revisión.

Eliminar un proyecto de la barra lateral

Para eliminar un proyecto de la barra lateral, pasa el cursor sobre el nombre del proyecto, haz clic en los tres puntos y elige "Eliminar". Para restaurarlo, vuelve a añadir el proyecto con el botón Añadir nuevo proyecto situado junto a Chats o mediante

Cmd+O.

Buscar chats archivados

Los chats archivados se encuentran en Configuración. Cuando desarchivas un chat, vuelve a aparecer en su ubicación original de la barra lateral.

Solo aparecen algunos chats en la barra lateral

La barra lateral te permite filtrar los chats según el estado de un proyecto. Si te faltan chats, selecciona el icono de filtro situado junto a Chats y, a continuación, selecciona Cronológico. Si sigues sin ver el chat, abre Configuración y consulta Chats archivados.

El código no se ejecuta en un árbol de trabajo

Los árboles de trabajo se crean en otro directorio y, de forma predeterminada, heredan los archivos registrados en Git. Según cómo gestiones las dependencias y las herramientas de tu proyecto, quizá tengas que ejecutar scripts de configuración en tu árbol de trabajo mediante un entorno local o copiar los archivos de configuración ignorados con .worktreeinclude. Como alternativa, puedes extraer los cambios en tu proyecto local habitual. Consulta la documentación sobre árboles de trabajo para obtener más información.

La aplicación no detecta el entorno local compartido de un compañero

La configuración del entorno local debe estar dentro de la carpeta .codex en la raíz de tu proyecto. Si trabajas en un monorepo con más de un proyecto, asegúrate de abrir el proyecto en el directorio que contiene la carpeta .codex.

Codex solicita acceso a Apple Music

Según la tarea, es posible que Codex necesite navegar por el sistema de archivos. Algunos directorios de macOS, como Música, Descargas o Escritorio, requieren una aprobación adicional del usuario. Si Codex necesita leer tu directorio de inicio, macOS te pide que apruebes el acceso a esas carpetas.

Las tareas programadas crean muchos árboles de trabajo

Las tareas programadas frecuentes pueden crear muchos árboles de trabajo con el tiempo. Archiva las ejecuciones programadas que ya no necesites y evita fijar ejecuciones, salvo que quieras conservar sus árboles de trabajo.

Recuperar una instrucción tras seleccionar el destino equivocado

Si iniciaste por accidente un chat con el destino equivocado (Local, Worktree o Cloud), puedes cancelar la ejecución actual y recuperar la instrucción anterior pulsando la tecla de flecha hacia arriba en el cuadro de redacción.

Una función está disponible en Codex CLI, pero no en la aplicación de escritorio de ChatGPT

La aplicación de escritorio de ChatGPT y Codex CLI pueden incluir versiones diferentes de Codex, por lo que las funciones pueden llegar a una interfaz antes que a la otra. Las funciones experimentales también podrían llegar primero a Codex CLI.

Para obtener la versión de Codex CLI instalada en tu sistema, ejecuta:

codex --version

Para obtener la versión de Codex incluida con tu aplicación de escritorio de ChatGPT, usa la ruta conservada del paquete de compatibilidad Codex.app:

/Applications/Codex.app/Contents/Resources/codex --version

Comentarios y registros

Escribe / en el cuadro de redacción de mensajes para enviar comentarios al equipo. Si activas los comentarios en un chat existente, puedes optar por compartir la sesión existente junto con tus comentarios. Después de enviar tus comentarios, recibirás un ID de sesión que podrás compartir con el equipo.

Para informar de un problema:

1. Busca problemas existentes en el repositorio de Codex en GitHub.
2. Abre un nuevo problema en GitHub

Hay más registros disponibles en las siguientes ubicaciones:

• Registros de la aplicación (macOS): ~/Library/Logs/com.openai.codex/YYYY/MM/DD
• Transcripciones de sesiones: $CODEX_HOME/sessions (valor predeterminado: ~/.codex/sessions)
• Sesiones archivadas: $CODEX_HOME/archived_sessions (valor predeterminado: ~/.codex/archived_sessions)

Si compartes registros, revísalos primero para confirmar que no contengan información confidencial.

Estados bloqueados y patrones de recuperación

Si un chat parece bloqueado:

1. Comprueba si Codex está esperando una aprobación.
2. Abre el terminal y ejecuta un comando básico como git status.
3. Inicia un nuevo chat con una instrucción más breve y específica.

Si cancelas por error la creación de un árbol de trabajo y pierdes la instrucción, pulsa la tecla de flecha hacia arriba en el cuadro de redacción para recuperarla.

Problemas del terminal

El terminal parece bloqueado

1. Cierra el panel del terminal.
2. Vuelve a abrirlo con Ctrl+`.
3. Vuelve a ejecutar un comando básico como pwd o git status.

Si los comandos se comportan de forma distinta a la esperada, comprueba primero el directorio y la rama actuales en el terminal.

Si continúa bloqueado, espera a que terminen los chats activos y reinicia la aplicación.

Las fuentes no se muestran correctamente

Codex usa la misma fuente para el panel de revisión, el terminal integrado y cualquier otro código que se muestre dentro de la aplicación. Puedes configurar la fuente en el panel de Configuración, en Fuente del código.