Solución de problemas

Preguntas frecuentes

En el panel lateral aparecen archivos que Codex no editó

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

En el panel de revisión, puedes alternar entre los cambios preparados para el commit y los que aún no lo están. También puedes comparar tu rama con main.

Si solo quieres ver los cambios del último turno de Codex, selecciona la vista Último turno en el panel de diferencias.

Consulta cómo usar el panel de revisión.

Quitar un proyecto de la barra lateral

Para quitar un proyecto de la barra lateral, coloca el cursor sobre el nombre del proyecto, selecciona los tres puntos y elige Quitar. Para restaurarlo, vuelve a agregar el proyecto con el botón Agregar nuevo proyecto junto a Chats o presiona

Cmd+O.

Buscar chats archivados

Puedes encontrar los chats archivados en Configuración. Cuando desarchivas un chat, vuelve a aparecer en su ubicación original en la barra lateral.

Una conversación del modo Work no aparece en otro dispositivo

• En cada dispositivo, inicia sesión con ChatGPT en la misma cuenta y el mismo espacio de trabajo. Busca la conversación en el historial del modo Work. Codex tiene su propio historial.
• Pide al propietario de tu espacio de trabajo que verifique en los permisos del espacio de trabajo que estén habilitados Work Cloud y la opción Permitir el acceso a la computadora local. Una política de la nube que tenga habilitado enforce_residency bloquea el acceso a la computadora local.
• Si la tarea se creó antes de que se habilitara el acceso a la computadora local, selecciona Nube en el editor de la aplicación de escritorio e inicia una tarea nueva en el modo Work.

Una tarea sincronizada no puede usar los archivos o las herramientas de la computadora

Abre la aplicación de escritorio de ChatGPT en la computadora donde están los archivos, inicia sesión en el mismo espacio de trabajo y mantén la computadora en línea y conectada. Si iniciaste un turno mientras la computadora estaba sin conexión, es posible que ese turno se esté ejecutando en un contenedor en la nube sin acceso a esos archivos.

Un turno se detuvo después de desactivar el acceso a la computadora local con Work Cloud

Si aún tienes acceso al modo Work, envía un mensaje nuevo en la conversación existente en la nube. El nuevo turno puede usar Work Cloud, pero no puede usar los archivos locales.

Faltan las actualizaciones automáticas de las políticas

Usa la API de políticas para administrar la configuración global. Para administrar la configuración local o la de Codex Cloud, usa la interfaz de seguridad de agentes. Después de la migración, siguen disponibles los flujos de trabajo existentes que usan la API para la configuración global. Prueba tus scripts e integraciones con Terraform y confirma que se conserven las asignaciones y el orden de las políticas.

En la barra lateral solo aparecen algunos chats

La barra lateral te permite filtrar los chats según el estado de un proyecto. Si faltan chats, selecciona el ícono de filtro junto a Chats y luego selecciona Cronológico. Si aún no ves el chat, abre Configuración y revisa Chats archivados.

El código no se ejecuta en un worktree

Los worktrees se crean en otro directorio y, de forma predeterminada, heredan los archivos incluidos en los commits de Git. Según cómo administres las dependencias y herramientas de tu proyecto, es posible que debas ejecutar scripts de configuración en tu worktree mediante un entorno local o copiar los archivos de configuración que Git ignora con .worktreeinclude. También puedes hacer checkout de los cambios en tu proyecto local habitual. Para obtener más información, consulta la documentación sobre worktrees.

La aplicación no detecta el entorno local que compartió alguien de tu equipo

La configuración del entorno local debe estar en 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 recorrer 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 pedirá que apruebes el acceso a esas carpetas.

Las tareas programadas crean muchos worktrees

Si las tareas programadas se ejecutan con frecuencia, pueden crear muchos worktrees con el tiempo. Archiva las ejecuciones programadas que ya no necesites y evita fijarlas, salvo que quieras conservar sus worktrees.

Recuperar un prompt después de seleccionar el destino equivocado

Si por error iniciaste un chat con el destino equivocado (Local, Worktree o Nube), puedes cancelar la ejecución actual y recuperar tu prompt anterior presionando la tecla de flecha hacia arriba en el editor.

La opción Aprobar por mí no aparece o está deshabilitada

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

1. Actualiza la aplicación de escritorio y revisa el menú de permisos en el chat donde quieras usar la revisión automática. Las opciones disponibles pueden variar entre los entornos locales y los de la nube.
2. Si ejecutas Codex de forma local, comprueba si tu configuración efectiva incluye explícitamente features.guardian_approval = false. Revisa también el perfil de permisos, la política de aprobación y el revisor de aprobaciones configurados. Consulta los conceptos básicos de configuración para conocer el orden de prioridad de la configuración. La configuración local no controla un entorno de ejecución administrado en la nube.
3. Si el modo está deshabilitado o no aparece en un espacio de trabajo administrado, pide a tu administrador que revise qué perfiles de permisos, modos de sandbox, políticas de aprobación y revisores de aprobaciones están permitidos. Las políticas de la organización o del dispositivo pueden restringir estas opciones. La configuración local no puede anular esas restricciones.

Si esperabas que el modo estuviera disponible y aún no puedes usarlo, incluye en tus comentarios la versión de la aplicación, el sistema operativo y el entorno de ejecución, e indica si la opción no aparece o está deshabilitada.

Una función funciona en la CLI de Codex, 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 distintas de Codex, por lo que algunas funciones pueden llegar a una antes que a la otra.

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

codex --version

Para consultar la versión de Codex incluida en tu aplicación de escritorio de ChatGPT, usa la ruta del paquete Codex.app que se conserva por compatibilidad:

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

Comentarios y registros

Escribe / en el espacio para escribir texto para enviar comentarios al equipo. Si lo haces desde un chat existente, puedes compartir la sesión junto con tus comentarios. Después de enviarlos, recibirás un ID de sesión que puedes compartir con el equipo.

Para informar de un problema:

1. Busca issues existentes en el repositorio de Codex en GitHub.
2. Abre un nuevo Issue de GitHub

Puedes encontrar más registros en las siguientes ubicaciones:

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

Si vas a compartir registros, revísalos primero para confirmar que no contengan información sensible.

Cómo recuperarse de un bloqueo

Si un chat parece haberse bloqueado:

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

Si cancelas por error la creación de un worktree y pierdes tu prompt, presiona la tecla de flecha hacia arriba en el editor para recuperarlo.

Problemas con la terminal

La terminal parece haberse bloqueado

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

Si los comandos no funcionan como esperabas, comprueba primero el directorio y la rama actuales en la terminal.

Si la terminal sigue bloqueada, espera a que finalicen tus chats activos y reinicia la aplicación.

Las fuentes no se muestran correctamente

Codex usa la misma fuente para el panel de revisión, la terminal integrada y el resto del código que se muestra en la aplicación. Para cambiarla, abre el panel de Configuración y selecciona Fuente del código.

Un entorno permite el acceso a la red, pero la acción se bloquea

Revisa la prioridad de las políticas antes de comparar los ajustes individuales. Una política de mayor prioridad prevalece sobre otra de menor prioridad, incluso si esta última es más específica. Dentro de una misma política, los ajustes del entorno específicos de un sistema operativo tienen prioridad sobre los que se aplican a todos los sistemas operativos. La configuración global tiene la prioridad más baja.

Algunos requisitos de red tienen reglas de combinación específicas para cada campo y están sujetos a límites del entorno de ejecución. El entorno de ejecución en la nube no admite puertos de escucha HTTP/SOCKS administrados ni proxies que escuchen en direcciones que no sean de loopback. La compatibilidad con las reglas de sockets depende de la ruta de ejecución. La combinación de ajustes para la ejecución local se rige por reglas distintas.

Compara las políticas efectivas y prueba tanto las acciones que deberían permitirse como las que deberían bloquearse. Consulta Configuración administrada para ver los casos en detalle. Si una prueba falla, no amplíes los permisos de la configuración global de base para que pase.