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 quitar un proyecto de la barra lateral, pasa el cursor sobre el nombre del proyecto, selecciona los tres puntos y elige Quitar. Para restaurarlo, vuelve a añadir el proyecto con el botón Añadir nuevo proyecto 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.

Una conversación de Work no aparece en otro dispositivo

• Confirma que has iniciado sesión con ChatGPT en la misma cuenta y el mismo espacio de trabajo en cada dispositivo.
• Pide al propietario de tu espacio de trabajo que compruebe que Work Cloud y Permitir el acceso al equipo local estén activados. Si enforce_residency está activado en alguna política de la nube, Permitir el acceso al equipo local se desactiva tanto para Work como para dots. Esta medida de protección no configura la residencia del espacio de trabajo ni, por sí sola, desactiva Work Cloud o dots.
• Comprueba cuándo se creó la tarea. La sincronización se aplica a las tareas nuevas creadas después de activarla. Las tareas existentes, incluidas las de los proyectos, no se migran y conservan su comportamiento original: solo local o en la nube sin archivos locales.

Para las empresas, el selector Local/Nube de la aplicación y su valor predeterminado se mantienen sin cambios en el lanzamiento. Un selector o modo predeterminado concreto no confirma por sí solo si una conversación puede sincronizarse. Considera el historial de Codex por separado al buscar una conversación de Work. Consulta Acceso al equipo local para Work Cloud y dots para obtener instrucciones de configuración y las Preguntas frecuentes para administradores de Work para resolver dudas habituales.

Una tarea sincronizada no puede usar los archivos o las herramientas del equipo

Mantén el equipo en línea y conectado. Si no está disponible cuando comienza un nuevo turno, una tarea sincronizada que cumpla los requisitos puede continuar en un contenedor en la nube sin acceso a los archivos ni a las herramientas del equipo. Un turno en ejecución no se traslada automáticamente del equipo a la nube.

Un turno se detuvo después de desactivar el acceso al equipo local con Work Cloud

Desactivar el acceso al equipo local con Work Cloud interrumpe los turnos en ejecución. Si aún tienes acceso a Work, envía un nuevo mensaje para iniciar otro turno. En una conversación existente en la nube, ese turno usa automáticamente Work Cloud sin acceso a los archivos locales.

Faltan las actualizaciones automatizadas de las políticas

Usa la API de políticas para administrar la configuración global. Para administrar la configuración local o de Codex Cloud, usa la interfaz de Agent Security. Los flujos de trabajo existentes de la API global siguen disponibles después de la migración. Prueba tus scripts e integraciones de Terraform y confirma que las asignaciones y el orden de las políticas no hayan cambiado.

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 un directorio diferente y, de forma predeterminada, heredan los archivos registrados en Git. Según cómo gestiones las dependencias y las herramientas de tu proyecto, puede que tengas que ejecutar scripts de configuración en tu árbol de trabajo mediante un entorno local o copiar archivos de configuración ignorados con .worktreeinclude. También puedes incorporar los cambios a tu proyecto local habitual. Consulta la documentación de á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.

Aprobar por mí no aparece o está desactivado

Para usar la revisión automática, selecciona Aprobar por mí en el control de permisos situado debajo del cuadro de redacción. Si el modo no aparece o está deshabilitado:

1. Actualiza la aplicación de escritorio y revisa el menú de permisos del chat donde quieras usar la revisión automática. Las opciones disponibles pueden variar entre los entornos locales y en la nube.
2. Para la ejecución local de Codex, comprueba si tu configuración efectiva incluye un ajuste explícito features.guardian_approval = false y revisa el perfil de permisos, la política de aprobación y el revisor de aprobaciones configurados. Consulta Conceptos básicos de configuración para conocer la precedencia de la configuración. La configuración local no controla un entorno de ejecución administrado en la nube.
3. Si un modo está deshabilitado o no aparece en un espacio de trabajo administrado, pide a tu administrador que compruebe los perfiles de permisos, los modos de aislamiento, las políticas de aprobación y los revisores de aprobaciones permitidos. La política de la organización o del dispositivo puede restringir estas opciones; los ajustes locales no pueden anularla.

Si el modo sigue sin estar disponible de forma inesperada, incluye la versión de la aplicación, el sistema operativo, el entorno de ejecución y si la opción no aparece o está deshabilitada en tus comentarios.

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 la CLI de Codex pueden incluir versiones diferentes de Codex, por lo que las funciones pueden llegar a una interfaz antes que a la otra.

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 actual y la rama 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.

Un entorno permite el acceso a la red, pero la acción está bloqueada

Comprueba la prioridad de las políticas antes de comparar ajustes individuales. Una política de mayor prioridad prevalece sobre una de menor prioridad, aunque esta última sea más específica. Dentro de una misma política, las anulaciones de entorno específicas de un sistema operativo tienen prioridad sobre las aplicables a todos los sistemas operativos, seguidas de Global.

Algunos requisitos de red tienen reglas de combinación específicas para cada campo y límites del entorno de ejecución. El entorno de ejecución en la nube no admite puertos de escucha HTTP/SOCKS administrados ni escuchas de proxy en direcciones que no sean de bucle local; la compatibilidad con las reglas de sockets depende de la ruta de ejecución. El comportamiento de combinación para la ejecución local es independiente.

Compara las políticas efectivas y prueba las acciones que deberían permitirse y bloquearse. Consulta Configuración administrada para ver los casos detallados. No amplíes los permisos de la configuración base global para eludir una prueba fallida.