Comandos para desarrolladores

El editor de ChatGPT en la web tiene su propio menú de comandos. Escribe / para ver las acciones disponibles en el chat actual. El menú no incluye los comandos de la app de escritorio de ChatGPT ni los de la CLI. Los comandos slash de Codex, los comandos de la CLI y las opciones de línea de comandos de esta referencia no se aplican a ChatGPT en la web.

Comandos de la app de escritorio de ChatGPT

La página general de comandos explica cómo navegar por la app, usar atajos en los chats, personalizar el teclado y usar enlaces directos a chats, configuración, habilidades, tareas programadas, complementos y mascotas.

La página de comandos slash describe los comandos disponibles en el editor de la app, entre ellos /feedback, /goal, /init, /mcp, /plan, /review y /status.

Cómo leer esta referencia

Esta página reúne todos los comandos y las opciones de línea de comandos documentados de la CLI de Codex. Usa las tablas interactivas para buscar por clave o descripción. Cada sección indica el nivel de madurez de las opciones y señala las opciones obsoletas y las combinaciones riesgosas.

Opciones globales

Estas opciones se aplican al comando base codex. La mayoría se propagan a los comandos. Consulta las notas anteriores o la ayuda del comando correspondiente para ver las excepciones. Para usar las opciones que se propagan, sigue las indicaciones de la ayuda del comando correspondiente. Por ejemplo, codex exec --oss ... aplica --oss a exec.

Resumen de comandos

Detalles de los comandos

codex (interactivo)

Al ejecutar codex sin un subcomando, se abre la interfaz interactiva de la terminal (TUI). El agente acepta las opciones globales anteriores y permite adjuntar imágenes. La búsqueda web usa el modo de caché de forma predeterminada. Usa --search para navegar en tiempo real. Para trabajar en local con menos interrupciones, usa --sandbox workspace-write --ask-for-approval on-request.

Usa --remote ws://host:port o --remote wss://host:port para conectar la TUI a un servidor de aplicaciones iniciado con codex app-server --listen ws://IP:PORT. Para conectarte a un socket Unix local, usa --remote unix:// para el socket predeterminado o --remote unix://PATH para indicar una ruta explícita. Agrega --remote-auth-token-env <ENV_VAR> si el servidor requiere un token de portador para la autenticación por WebSocket.

codex agents

Abre el centro de comandos para explorar los chats y cambiar de agente en un servidor compartido. Usa --remote <URL> para conectarte a un servidor remoto y --cd <DIR> para establecer el directorio de las nuevas tareas remotas. codex agents no admite --no-daemon.

codex queue

Pon un mensaje de texto en la cola de una sesión existente:

codex queue --thread <SESSION_ID> --message "Run the remaining checks"

--thread acepta un UUID o el nombre exacto de la sesión. Usa un UUID si varias sesiones tienen el mismo nombre. Los mensajes en cola usan el modelo de la sesión. El comando solo acepta texto.

Agrega --resume para poner el mensaje en cola y luego reanudar la sesión si aún no está cargada. Para reanudarla, necesitas un daemon local en ejecución o un servidor seleccionado con --remote. Usa --remote-auth-token-env si el servidor requiere un token. Si Codex no puede reanudar la sesión, muestra una advertencia y aun así devuelve un código de salida de éxito.

codex app-server

Inicia el App Server de Codex en local. Está destinado principalmente al desarrollo y la depuración, y puede cambiar sin previo aviso.

codex app-server --listen stdio:// conserva el comportamiento predeterminado de transmitir JSONL por stdio. codex app-server --stdio es un alias para ese transporte. --listen ws://IP:PORT habilita el transporte WebSocket para los clientes de app-server. El servidor acepta URL de escucha con ws://. Usa terminación TLS o un proxy seguro cuando los clientes se conecten con wss://. Usa --listen unix:// para aceptar negociaciones de conexión WebSocket en el socket Unix predeterminado de Codex o --listen unix:///absolute/path.sock para elegir la ruta del socket. Si generas esquemas para los enlaces del cliente, agrega --experimental para incluir los campos y métodos de acceso restringido.

Usa --code-mode-host https://code-mode.example.com para conectar todos los hilos del proceso app-server a un host remoto de Code Mode mediante gRPC. La opción --listen controla cómo se conectan los clientes al App Server.

codex remote-control

Ejecuta codex remote-control para iniciar el control remoto mediante el servidor administrado en segundo plano cuando se cumplan los requisitos. De lo contrario, se ejecuta en primer plano. Usa codex remote-control --no-daemon para ejecutarlo explícitamente en primer plano. Usa codex remote-control start para iniciar el daemon local de app-server con el control remoto habilitado y codex remote-control stop para detenerlo. Los clientes administrados de control remoto y los flujos de trabajo remotos por SSH usan estos comandos. Si desarrollas un cliente local del protocolo, sigue usando codex app-server --listen.

Una vez que el daemon esté en ejecución, usa codex remote-control pair para crear y mostrar un código de vinculación manual de corta duración. Agrega --json a cualquier comando de control remoto para obtener una salida legible por máquina. Para pair, la respuesta JSON incluye pairingCode, manualPairingCode, environmentId y expiresAt. --no-daemon solo se aplica a remote-control sin subcomandos. No lo combines con start, stop ni pair.

codex app

Inicia la app de escritorio de ChatGPT desde la terminal en macOS o Windows. En macOS, Codex puede abrir una ruta específica del espacio de trabajo. En Windows, muestra la ruta que debes abrir.

codex app abre la app de escritorio de ChatGPT si está instalada o inicia el instalador si falta. En macOS, Codex abre la ruta del espacio de trabajo que indicaste. En Windows, muestra la ruta que debes abrir después de la instalación.

codex debug app-server send-message-v2

Envía un mensaje mediante el flujo de hilos y turnos V2 de app-server con el cliente de pruebas integrado de app-server.

Este flujo de depuración se inicializa con experimentalApi: true, inicia un hilo, envía un turno y transmite las notificaciones del servidor a medida que llegan. Úsalo para reproducir e inspeccionar en local el comportamiento del protocolo de app-server.

codex debug models

Muestra en JSON el catálogo de modelos sin procesar que recibe Codex.

Usa --bundled para inspeccionar solo el catálogo incluido en el binario actual sin actualizarlo desde el punto de acceso remoto de modelos.

codex debug prompt-input

Muestra en JSON la lista exacta de entradas del prompt que recibe el modelo. Úsalo para depurar la detección de instrucciones, el contexto de la sesión o la construcción del prompt.

codex apply

Aplica a tu repositorio local el diff más reciente de un chat de Codex Cloud. Debes autenticarte y tener acceso al chat.

Codex muestra los archivos modificados y devuelve un código de salida distinto de cero si git apply falla, por ejemplo, debido a conflictos.

codex review

Ejecuta una revisión de código sin interacción. Elige exactamente un objetivo de revisión o proporciona instrucciones de revisión personalizadas en un prompt.

--uncommitted, --base, --commit y un PROMPT personalizado son mutuamente excluyentes. Usa --title solo con --commit.

codex archive y codex unarchive

Archiva o restaura una sesión interactiva guardada mediante su ID o nombre. Usa estos comandos para despejar el selector de sesiones sin eliminar la transcripción. Los ID de sesión tienen prioridad sobre los nombres.

Cuando archivas o restauras una sesión, Codex también intenta archivar o restaurar las sesiones de subagentes que se iniciaron desde ella, incluidas todas sus sesiones descendientes.

codex archive <SESSION>
codex unarchive <SESSION>

codex delete

Elimina de forma permanente una sesión interactiva guardada mediante su ID o nombre. Usa este comando solo si quieres eliminar la transcripción en lugar de ocultarla en las listas de sesiones activas.

codex delete <SESSION>
codex delete <SESSION_UUID> --force

Usa --force solo con el UUID de una sesión. Si indicas un nombre, Codex sigue pidiendo confirmación para evitar que se elimine una sesión con un nombre repetido o ambiguo sin consultarte.

codex cloud

Interactúa con los chats de Codex Cloud desde la terminal. El comando predeterminado abre un selector interactivo. codex cloud exec envía una tarea directamente y codex cloud list devuelve los chats recientes para usarlos en scripts o consultarlos rápidamente.

La autenticación usa las mismas credenciales que la CLI principal. Codex devuelve un código de salida distinto de cero si falla el envío de la tarea.

codex cloud list

Enumera los chats recientes en la nube con opciones de filtrado y paginación.

La salida en texto sin formato muestra la URL de la tarea seguida de los detalles de su estado. Usa --json para automatizar el proceso. La respuesta JSON contiene un arreglo tasks y un valor cursor opcional. Cada tarea incluye id, url, title, status, updated_at, environment_id, environment_label, summary, is_review y attempt_total.

codex completion

Genera scripts de autocompletado para el shell y redirige la salida a la ubicación correspondiente, por ejemplo, con codex completion zsh > "${fpath[1]}/_codex".

codex doctor

Genera un informe de diagnóstico local antes de reportar un problema al equipo de soporte o mientras investigas una instalación de Codex que no funciona. El informe verifica el estado de la instalación, la configuración, la autenticación, el entorno de ejecución, Git, la terminal, app-server y el inventario de hilos.

codex features

Administra las opciones que activan o desactivan funciones en $CODEX_HOME/config.toml. Los comandos enable y disable guardan los cambios para que se apliquen a futuras sesiones. El subcomando features no acepta --profile.

codex exec

Usa codex exec (o su forma abreviada codex e) en scripts o en ejecuciones de integración continua (CI) que deban completarse sin intervención humana.

De forma predeterminada, Codex genera una salida con formato. Agrega --json para recibir eventos JSON separados por saltos de línea, uno por cada cambio de estado. El subcomando opcional resume te permite continuar tareas no interactivas. Usa --last para elegir la sesión más reciente del directorio de trabajo actual o agrega --all para buscar en todas las sesiones:

Usa codex exec fork <SESSION_ID> [PROMPT] para copiar una sesión guardada en una nueva. El argumento de sesión acepta un UUID o un nombre. Si no proporcionas un prompt, Codex crea el fork sin iniciar un turno. Pasa - como prompt para leerlo desde stdin o agrega --image para adjuntar imágenes.

Debes proporcionar un prompt si usas imágenes, --output-schema, --output-last-message o --ephemeral.

Agrega --worktree a una ejecución nueva o creada mediante un fork para crear un worktree de Git administrado:

codex exec --worktree "implement the next step"
codex exec fork <SESSION_ID> --worktree "try an alternative approach"

--worktree requiere ejecución local. No lo combines con resume, review, --ephemeral ni --ignore-user-config.

codex execpolicy

Verifica los archivos de reglas de execpolicy antes de guardarlos. codex execpolicy check acepta una o más opciones --rules (por ejemplo, para archivos en ~/.codex/rules) y genera una salida JSON con la decisión más estricta y las reglas que coincidan. Agrega --pretty para dar formato a la salida. El comando execpolicy está disponible como versión preliminar.

codex login

Autentica la CLI con una cuenta de ChatGPT, una clave de API o un token de acceso. Sin opciones, Codex abre un navegador para iniciar el flujo OAuth de ChatGPT.

codex login status devuelve el código de salida 0 si hay credenciales, lo que resulta útil en scripts de automatización.

codex logout

Elimina las credenciales guardadas tanto para la autenticación con clave de API como para la autenticación con ChatGPT. Este comando no tiene opciones.

codex mcp

Administra las entradas de servidores del protocolo de contexto de modelos (MCP) almacenadas en ~/.codex/config.toml.

El subcomando add admite los transportes stdio y HTTP con streaming:

Las acciones de OAuth (login, logout) solo funcionan con servidores HTTP con streaming y únicamente si el servidor admite OAuth.

codex plugin

Instala, enumera y elimina complementos de los marketplaces configurados.

codex plugin add --json muestra pluginId, name, marketplaceName, version, installedPath y authPolicy. codex plugin list --json muestra los arreglos installed y available. Las entradas incluyen pluginId, name, marketplaceName, version, installed, enabled, source, installPolicy, authPolicy y, cuando está disponible, marketplaceSource, con el tipo y el valor del origen configurado para el marketplace. codex plugin remove --json muestra pluginId, name y marketplaceName.

codex plugin marketplace

Administra los orígenes de los marketplaces que Codex puede explorar y desde los que puede instalar complementos.

codex plugin marketplace add acepta la notación abreviada de GitHub, como owner/repo u owner/repo@ref, URL de Git por HTTP, HTTPS o SSH y directorios raíz de marketplaces locales. Usa --ref para fijar una referencia de Git y repite --sparse PATH para usar un checkout parcial en los repositorios de marketplaces que usan Git.

codex plugin marketplace list muestra los nombres y directorios raíz de los marketplaces del ámbito actual, incluidos los marketplaces predeterminados que se detectan implícitamente y las instantáneas de marketplaces configuradas.

Agrega --json a los comandos para agregar, enumerar, actualizar o eliminar marketplaces si necesitas una salida apta para la automatización. Al agregar un marketplace, la salida JSON incluye marketplaceName, installedRoot y alreadyAdded. Al enumerarlos, incluye un arreglo marketplaces con name, root y, de forma opcional, marketplaceSource. Al actualizarlos, incluye selectedMarketplaces, upgradedRoots y errors. Al eliminar uno, incluye marketplaceName e installedRoot.

codex mcp-server

codex resume

Continúa una sesión interactiva por ID o reanuda el chat más reciente. codex resume limita --last al directorio de trabajo actual, a menos que indiques --all. Permite cambiar el modelo y el sandbox para esa ejecución, pero no admite --worktree.

Si el directorio de trabajo actual difiere del directorio guardado en la sesión, Codex te pregunta cuál usar. Configura tui.resume_cwd como "current" o "session" para reutilizar esa elección sin que Codex vuelva a preguntarte. Un valor explícito de --cd (-C) tiene prioridad sobre tui.resume_cwd.

codex fork

Crea un fork de una sesión interactiva anterior en un chat nuevo. De forma predeterminada, codex fork abre el selector de sesiones. Usa --last para crear un fork de la sesión más reciente del directorio actual. Usa --last --all para crear un fork de la sesión más reciente entre todos los directorios.

Si el directorio actual difiere del que se guardó en la sesión, codex fork muestra la misma pregunta sobre el directorio de trabajo y usa la misma opción tui.resume_cwd que codex resume.

Para crear el fork en un worktree de Git administrado, ejecuta codex fork <SESSION_ID> --worktree. Esta operación requiere un ID de sesión explícito y ejecución local. No admite --last ni el selector de sesiones.

codex sandbox

Usa la herramienta de sandbox para ejecutar un comando con las mismas políticas que Codex usa internamente.

Seatbelt de macOS

Sandbox de Linux

Windows

Antes de desinstalar el sandbox anterior de Windows, detén las apps que lo usan. Si está instalado el servicio de aprovisionamiento del sandbox, detenlo también. Luego ejecuta codex sandbox uninstall como administrador. El comando elimina las cuentas del sandbox y las reglas de red que se aplican a todo el equipo. Conserva tu directorio principal de Codex, incluidos los directorios del sandbox y los permisos del sistema de archivos.

codex update

Busca y aplica una actualización de la CLI de Codex si la versión instalada admite la actualización automática. Las compilaciones de depuración muestran un mensaje que te indica que instales una compilación de distribución.

Combinaciones de opciones y consejos de seguridad

• Usa --sandbox workspace-write para el trabajo local sin supervisión que pueda limitarse al espacio de trabajo. Evita --dangerously-bypass-approvals-and-sandbox salvo que trabajes dentro de una máquina virtual dedicada al sandbox.
• Si necesitas darle a Codex acceso de escritura a más directorios, usa preferentemente --add-dir en lugar de forzar --sandbox danger-full-access.
• Combina --json con --output-last-message en CI para registrar el progreso en un formato legible por máquina y obtener un resumen final en lenguaje natural.

Atajos interactivos

• Escribe @ para buscar un archivo en el espacio de trabajo y agregar su ruta al prompt.
• Presiona Flecha arriba o Flecha abajo para recuperar borradores del historial.
• Presiona Ctrl+R para buscar en el historial de prompts. Luego presiona Enter para usar una coincidencia o Escape para cancelar.
• Presiona Ctrl+ O  para copiar la última respuesta completa. Ejecuta /copy para elegir qué copiar.
• Comienza una línea con ! para ejecutar un comando de shell local con la configuración actual de aprobación y sandbox.
• Mientras Codex trabaja, presiona Tab para poner en la cola del siguiente turno un prompt de seguimiento, un comando slash o un comando de shell.
• Mientras Codex trabaja, presiona Enter para agregar instrucciones al turno actual.
• Con el editor vacío, presiona Escape dos veces para editar el mensaje anterior del usuario y crear un fork del chat a partir de ese punto.
• Presiona Ctrl+C o ejecuta /exit para cerrar la sesión.

Recursos relacionados

• Introducción a la CLI de Codex: instalación, actualizaciones y consejos rápidos.
• Conceptos básicos de configuración: guarda valores predeterminados, como el modelo y el proveedor.
• Configuración avanzada: perfiles, proveedores, ajustes del sandbox e integraciones.
• AGENTS.md: descripción general de las capacidades de los agentes de Codex y prácticas recomendadas.

Los comandos slash te permiten controlar Codex rápidamente desde el teclado. Escribe / en el editor para abrir el menú emergente de comandos slash y elige un comando. Codex puede realizar acciones como cambiar de modelo, ajustar permisos o resumir chats largos sin que tengas que salir de la terminal.

En esta guía aprenderás a:

• Encontrar el comando slash integrado adecuado para una tarea.
• Dirigir una sesión activa con comandos como /model, /fast, /permissions, /approve, /raw, /agents, /subagents y /status.

Comandos slash integrados

Codex incluye los siguientes comandos. Abre el menú emergente de comandos slash y empieza a escribir el nombre de un comando para filtrar la lista.

Si un chat ya está en ejecución, puedes escribir un comando slash y presionar Tab para ponerlo en la cola del siguiente turno. Codex interpreta los comandos slash en cola cuando los ejecuta, así que los menús y los errores aparecen una vez que termina el turno actual. El autocompletado sigue funcionando antes de que pongas el comando en la cola.

Tanto /quit como /exit cierran la CLI. Úsalos solo después de guardar el trabajo importante o registrarlo en un commit.

Usa /permissions para ajustar qué puede hacer Codex sin preguntarte primero. Usa /approve solo cuando necesites reintentar una acción reciente que la revisión automática rechazó.

Controlar la sesión con comandos slash

Con estos procedimientos puedes dirigir tu sesión sin reiniciar Codex.

Cambiar las preferencias de la terminal con /config

Escribe /config para abrir las preferencias de la terminal. Explora las opciones por grupo o presiona  /  para buscar. Codex guarda los cambios automáticamente.

Elegir el modo de terminal con /tui

1. Escribe /tui.
2. Elige el modo con historial de la terminal o el de pantalla completa y confirma.
3. Reinicia Codex para aplicar la selección.

Resultado esperado: la próxima vez que inicies Codex, usará el modo de terminal guardado. Las opciones que indiques al iniciarlo, como --no-alt-screen, seguirán aplicándose.

Exportar una conversación con /export

1. Escribe /export.
2. Elige Copiar al portapapeles o Guardar en un archivo.

Resultado esperado: Codex exporta la conversación completa en Markdown. Para guardarla directamente en un archivo, ejecuta /export session.md. Espera a que termine el turno actual antes de exportar.

Resumir el chat con /recap

1. Cuando Codex esté inactivo, escribe /recap.

Resultado esperado: Codex genera un resumen de la conversación, incluso si tui.auto_recap = false. Usa /compact si quieres liberar espacio de contexto.

Cambiar de directorio con /cd

1. Escribe /pwd (o /cwd) para consultar el directorio actual.
2. Escribe /cd <path> para cambiar de directorio o /cd para usar tu directorio personal.

Resultado esperado: Codex continúa el chat en el directorio seleccionado. Para cambiar de directorio, la sesión principal debe estar inactiva, sin entradas en cola ni terminales en segundo plano.

Continuar en un worktree con /worktree

1. Escribe /worktree en un repositorio de Git local.
2. Elige si quieres iniciar un chat nuevo o continuar la conversación actual en un worktree nuevo.

Resultado esperado: Codex crea un worktree de Git administrado e inicia allí el chat seleccionado. Elige Explorar worktrees para encontrar los worktrees existentes y los chats a los que pertenecen. Este comando requiere compatibilidad local con worktrees y no está disponible mientras se ejecuta una tarea.

Administrar el servidor en segundo plano con /daemon

1. Escribe /daemon.
2. Revisa la conexión con el servidor y las acciones disponibles.

Resultado esperado: Codex te ofrece instalar la última versión estable pública o usar la compilación actual de la CLI para el servidor local en segundo plano. Si confirmas una actualización, Codex se cierra y puede interrumpir el trabajo en curso. Para reiniciar un servidor local administrado, elige Reiniciar el servidor en segundo plano y confirma. Codex vuelve a conectarse automáticamente. El reinicio puede interrumpir el trabajo en curso o en cola de otros chats. Si la conexión es remota, administra el servidor en su host.

Inspeccionar advertencias con /warnings

1. Escribe /warnings.

Resultado esperado: Codex muestra las advertencias conservadas y sus detalles de diagnóstico.

Elegir el modelo activo con /model

El selector solo muestra los modelos disponibles para tu cuenta y tu espacio de trabajo. Si GPT-6.1 Sol no aparece en la lista, elige otro modelo. Consulta la disponibilidad de GPT-6.1 Sol por plan.

1. Inicia Codex y abre el editor.
2. Escribe /model y presiona Enter.
3. Elige un modelo como gpt-6-luna o gpt-6.1-sol en el menú emergente.

Resultado esperado: Codex confirma el nuevo modelo en la transcripción. Ejecuta /status para verificar el cambio.

Para cambiar directamente la configuración de la sesión actual, usa /model [model] [--reasoning=<level>] [--speed=<tier>]. Por ejemplo, /model --reasoning=high mantiene el modelo actual y establece un nivel alto de esfuerzo de razonamiento si el modelo lo admite.

Reutilizar prompts y comandos con /presets

Escribe /presets y presiona  n  para guardar un prompt o un comando slash en una posición numerada. Presiona  s  para crear un ajuste predefinido a partir del modelo, los permisos, el título de la terminal o la línea de estado que estés usando. Para ejecutar un ajuste guardado, abre /presets y presiona el número correspondiente.

Activar o desactivar el modo rápido con /fast

1. Escribe /fast para activar el nivel de servicio rápido del modelo actual.
2. Vuelve a escribir /fast para desactivarlo.

Resultado esperado: Codex cambia el nivel de servicio y guarda la selección. También puedes usar /statusline para mostrar el estado del modo rápido en la línea de estado al pie de la TUI.

Los comandos del nivel rápido dependen del catálogo. Si el modelo actual no indica que ofrece un nivel rápido, Codex no muestra /fast.

Activar o desactivar Daybreak

Si usas OpenAI como proveedor y tanto tu cuenta como el modelo tienen acceso a Daybreak, usa /daybreak para activar o desactivar Daybreak. Codex aplica la selección al chat actual y la guarda como opción predeterminada para los chats futuros.

Hablar con Codex mediante /voice

Si tu compilación de la CLI y tu sesión admiten voz, usa /voice o F8 para iniciar o detener una conversación de voz. Usa /voice mute para activar o desactivar el micrófono y /voice stop para finalizar la conversación. Usa /voice settings para elegir una voz para futuras conversaciones.

Cambiar al modo plan con /plan

1. Escribe /plan y presiona Enter para cambiar el chat activo al modo plan.
2. Si quieres, incluye el texto del prompt en el comando. Por ejemplo, para pedirle a Codex que proponga un plan de migración para este servicio, escribe /plan Propose a migration plan for this service.
3. Puedes pegar contenido o adjuntar imágenes cuando incluyas argumentos en la misma línea que /plan.

Resultado esperado: Codex entra en modo plan y usa el prompt que hayas incluido como primera solicitud de planificación.

Mientras Codex trabaja, /plan no está disponible temporalmente.

Definir o consultar el objetivo de una tarea con /goal

1. Escribe /goal <objective> para definir el objetivo. Por ejemplo, para pedirle a Codex que termine la migración y se asegure de que las pruebas sigan pasando, escribe /goal Finish the migration and keep tests green.
2. Escribe /goal para consultar el objetivo actual.
3. Usa /goal edit para modificar el objetivo. Usa /goal pause, /goal resume o /goal clear para pausarlo, reanudarlo o eliminarlo.

Resultado esperado: Codex mantiene el objetivo asociado al chat activo mientras continúa el trabajo.

El objetivo debe contener texto y tener un máximo de 4000 caracteres. Si necesitas dar instrucciones más largas, guarda los detalles en un archivo e indica ese archivo en el objetivo.

Activar o desactivar funciones experimentales con /experimental

1. Escribe /experimental y presiona Enter.
2. Activa o desactiva las funciones que quieras (por ejemplo, el proxy de red o la prevención de la suspensión durante la ejecución). Luego reinicia Codex si se te solicita.

Resultado esperado: Codex guarda tus elecciones en la configuración y las aplica al reiniciarse.

Aprobar un reintento tras un rechazo de la revisión automática con /approve

Usa /approve si el revisor automático rechazó una acción reciente y quieres que Codex la reintente una vez.

1. Escribe /approve.
2. Confirma el reintento cuando Codex muestre la acción rechazada correspondiente.

Resultado esperado: Codex vuelve a intentar esa acción una vez con la política de la sesión actual.

Configurar las memorias con /memories

1. Escribe /memories.
2. Elige si quieres que Codex use memorias existentes, genere memorias nuevas o mantenga desactivadas las funciones de memoria.

Resultado esperado: Codex actualiza la configuración de memoria correspondiente para las sesiones futuras.

Usar habilidades con /skills

1. Escribe /skills.
2. Elige la habilidad que quieres que Codex aplique.

Resultado esperado: Codex incorpora el contexto de la habilidad seleccionada para seguir sus instrucciones en la próxima solicitud.

Importar la configuración de Claude Code o Cursor con /import

1. Escribe /import.
2. Elige Claude Code o Cursor.
3. Selecciona la configuración, los archivos de proyecto o los chats recientes que quieres migrar.

Codex busca hasta 50 chats de los últimos 30 días. Si está conectado a un daemon local o a un servidor remoto, Codex lee e importa los archivos en el equipo donde se ejecuta ese daemon o servidor. Espera a que termine la tarea actual antes de iniciar una importación.

Para conocer el procedimiento en la app de escritorio y los tipos de elementos compatibles, consulta Importar desde otro agente.

Limpiar la terminal e iniciar un chat nuevo con /clear

1. Escribe /clear y presiona Enter.

Resultado esperado: Codex limpia la terminal, restablece la transcripción visible e inicia un chat nuevo en la misma sesión de la CLI.

Para darle un nombre al nuevo chat al crearlo, ejecuta /clear release prep.

A diferencia de Ctrl+L, /clear inicia un chat nuevo.

Ctrl+L solo limpia la vista de la terminal y conserva el chat actual. Codex desactiva ambas acciones mientras hay una tarea en curso.

Archivar la sesión actual con /archive

1. Escribe /archive y presiona Enter.
2. Confirma que quieres archivar la sesión actual.

Resultado esperado: Codex archiva la sesión y regresa al centro de comandos si está conectado a un servidor local en segundo plano o a un servidor remoto. Sin un servidor compartido, Codex se cierra. Codex conserva la transcripción. Puedes restaurarla más adelante con codex unarchive <SESSION>.

Si hay un turno en curso, al confirmar /archive se detiene ese turno antes de archivar la sesión.

Eliminar la sesión actual con /delete

1. Escribe /delete y presiona Enter.
2. Confirma que quieres eliminar la sesión actual.

Resultado esperado: Codex elimina de forma permanente la transcripción y las sesiones derivadas que se hayan creado. Si está conectado a un servidor local en segundo plano o a un servidor remoto, Codex regresa al centro de comandos. Sin un servidor compartido, Codex se cierra.

/delete no está disponible mientras se ejecuta un chat ni dentro de un chat secundario.

Actualizar permisos con /permissions

1. Escribe /permissions y presiona Enter.
2. Selecciona la configuración predefinida de aprobación que prefieras, por ejemplo, Auto para ejecuciones sin intervención o Read Only para revisar cambios. Cuando hay perfiles de permisos con nombre activos, el selector también muestra los perfiles personalizados configurados y sus descripciones.

Para seleccionar un perfil por ID para esta sesión, usa /permissions <profile-id> [--approval-policy=<policy>] [--reviewer=user|auto_review]. Por ejemplo, /permissions :workspace --approval-policy=on-request --reviewer=user selecciona el acceso al espacio de trabajo y te envía las solicitudes de aprobación cuando tu configuración lo permite.

Incluir contexto del IDE con /ide

1. Escribe /ide.
2. Si quieres, agrega texto en la misma línea para explicar qué debe hacer Codex con la selección actual del IDE o los archivos abiertos.

Resultado esperado: Codex incluye el contexto disponible del IDE en el siguiente prompt.

Activar o desactivar el modo Vim con /vim

1. Escribe /vim.
2. Sigue editando en el editor.

Resultado esperado: Codex activa o desactiva el modo Vim del editor para la sesión actual. Para usar Vim de forma predeterminada en las sesiones nuevas, establece tui.vim_mode_default = true en config.toml.

Configurar el sandbox de Windows con privilegios elevados mediante /setup-default-sandbox

Este comando solo aparece en Windows cuando Codex usa el sandbox de token restringido en modo degradado.

1. Escribe /setup-default-sandbox.
2. Sigue los pasos de configuración con privilegios de administrador.

Resultado esperado: Codex configura el sandbox de Windows con privilegios elevados y selecciona la configuración predefinida de aprobación automática correspondiente.

Copiar la última respuesta con /copy

En el modo con historial de la terminal, escribe /copy y elige qué copiar de la última respuesta completa: toda la respuesta, un bloque de código o una cita. En el modo de pantalla completa, selecciona un bloque en la transcripción. Presiona Enter para copiar la selección.

Después de ejecutar /status, usa /copy para copiar el estado completo o un campo individual. Para copiar directamente la última respuesta completa, presiona Ctrl+ O .

Activar o desactivar el historial de la terminal sin formato con /raw

1. Escribe /raw, /raw on o /raw off.

Resultado esperado: Codex activa o desactiva el modo de historial sin formato, que facilita seleccionar y copiar texto en la terminal. También puedes usar el atajo predeterminado Alt+R o guardar el modo como predeterminado con tui.raw_output_mode = true.

Inspeccionar la sesión con /status

1. Escribe /status en cualquier chat.
2. Revisa la salida para conocer el modelo activo, la política de aprobación, los directorios raíz con permiso de escritura y el uso actual de tokens. Si la TUI se conecta de forma remota, la salida también muestra la dirección remota y la versión del servidor.

Resultado esperado: Codex muestra un resumen que te permite confirmar que se está ejecutando donde esperabas.

Consultar el uso de la cuenta con /usage

1. Escribe /usage para abrir el menú de uso.
2. Elige si quieres ver la actividad de tokens o canjear un restablecimiento que hayas obtenido y esté disponible.
3. Para abrir directamente la actividad de tokens, escribe /usage daily, /usage weekly o /usage cumulative.

Resultado esperado: Codex abre las acciones de uso o muestra la actividad de tokens de la cuenta en la vista seleccionada. Si la sesión no está autenticada con una cuenta del servicio de Codex, Codex indica que debes iniciar sesión.

Inspeccionar las capas de configuración con /debug-config

1. Escribe /debug-config.
2. Revisa la salida para ver el orden de las capas de configuración (de menor a mayor prioridad), si están activadas y el origen de las políticas.

Resultado esperado: Codex muestra diagnósticos de las capas y detalles de las políticas, como allowed_approval_policies, allowed_sandbox_modes, mcp_servers, rules y network_proxy, cuando están configurados.

Usa esta salida para averiguar por qué un valor de configuración efectivo difiere del que aparece en config.toml.

Configurar los elementos del pie de la interfaz con /statusline

1. Escribe /statusline.
2. Usa el selector para activar, desactivar y reordenar los elementos. Luego confirma.

Resultado esperado: la línea de estado al pie de la interfaz se actualiza de inmediato y la selección se guarda en tui.status_line en config.toml.

Los elementos disponibles incluyen el modelo, el modelo con el razonamiento, las estadísticas de contexto, los límites de solicitudes, la rama de Git, los contadores de tokens, el ID de sesión, el directorio actual o la raíz del proyecto y la versión de Codex.

Para configurar el pie de la interfaz solo para esta sesión, indica los elementos en el orden en que quieres verlos. Por ejemplo, /statusline model project-name muestra el modelo antes del nombre del proyecto. Usa /statusline --clear para ocultar todos los elementos durante esta sesión.

Configurar los elementos del título de la terminal con /title

1. Escribe /title.
2. Usa el selector para activar, desactivar y reordenar los elementos. Luego confirma.

Resultado esperado: el título de la ventana o pestaña de la terminal se actualiza de inmediato y la selección se guarda en tui.terminal_title en config.toml.

Los elementos disponibles incluyen el nombre de la app, el proyecto, el indicador de actividad, el estado, el hilo, la rama de Git, el modelo y el progreso de la tarea.

Para configurar el título solo para esta sesión, indica los elementos en el orden en que quieres verlos. Por ejemplo, /title project-name model muestra el nombre del proyecto antes del modelo. Usa /title --clear para quitar los elementos del título durante esta sesión.

Elegir un tema de sintaxis con /theme

1. Escribe /theme.
2. Previsualiza un tema en el selector y confirma tu elección.

Resultado esperado: Codex actualiza el resaltado de sintaxis y guarda la elección en tui.theme en config.toml.

Elegir una mascota de la terminal con /pets

1. Escribe /pets (o /pet) para abrir el selector de mascotas.
2. Elige una mascota integrada o personalizada, o desactiva las mascotas.

Resultado esperado: Codex muestra la mascota de compañía seleccionada en las terminales compatibles y guarda la selección. También puedes escribir /pets off para ocultarla.

Reasignar atajos de la TUI con /keymap

Usa /keymap para consultar, actualizar y guardar las asignaciones de atajos de teclado de la TUI.

1. Escribe /keymap.
2. Elige el contexto del atajo y la acción que quieres cambiar.
3. Ingresa la nueva combinación de teclas o elimina la existente.

Resultado esperado: Codex actualiza el mapa de teclas activo y guarda la asignación personalizada en tui.keymap en config.toml.

Las asignaciones usan nombres como ctrl-a, shift-enter y page-down. Las asignaciones específicas de un contexto tienen prioridad sobre tui.keymap.global. Si la lista de asignaciones está vacía, la acción queda sin atajo.

Consultar las terminales en segundo plano con /ps

1. Escribe /ps.
2. Revisa la lista de terminales en segundo plano y sus estados.

Resultado esperado: Codex muestra el comando de cada terminal en segundo plano y hasta tres líneas recientes de salida que no estén vacías para que puedas ver el progreso de un vistazo.

Las terminales en segundo plano aparecen cuando se usa unified_exec. De lo contrario, la lista puede estar vacía.

Detener las terminales en segundo plano con /stop

1. Escribe /stop.
2. Si Codex te pide confirmación antes de detener las terminales de la lista, confirma.

Resultado esperado: Codex detiene todas las terminales en segundo plano de la sesión actual. /clean sigue disponible como alias de /stop.

Acortar las transcripciones con /compact

1. Después de un intercambio largo, escribe /compact.
2. Confirma cuando Codex te ofrezca resumir el chat hasta ese momento.

Resultado esperado: Codex reemplaza los turnos anteriores con un resumen conciso que libera espacio de contexto y conserva los detalles importantes.

Revisar los cambios con /diff

1. Escribe /diff para inspeccionar el diff de Git.
2. Desplázate por la salida en la CLI para revisar los cambios y los archivos agregados.

Resultado esperado: Codex muestra los cambios que ya preparaste para el commit, los que aún no preparaste y los archivos que Git aún no rastrea, para que puedas decidir qué conservar.

Señalar archivos con /mention

1. Escribe /mention seguido de una ruta, por ejemplo, /mention src/lib/api.ts.
2. Selecciona el resultado correspondiente en el menú emergente.

Resultado esperado: Codex agrega el archivo al chat para que los turnos posteriores hagan referencia directa a él.

Iniciar un chat nuevo con /new

1. Escribe /new y presiona Enter.
2. Si Codex te pide elegir una copia de trabajo, selecciona el directorio actual o un worktree nuevo.

Resultado esperado: Codex inicia un chat nuevo en la misma sesión de la CLI para que puedas cambiar de chat sin salir de la terminal.

Para darle un nombre al chat al crearlo, ejecuta /new bug bash.

A diferencia de /clear, /new no limpia primero la vista actual de la terminal.

Cambiar el nombre del chat actual con /rename

1. Escribe /rename <name> o escribe /rename para que Codex te pida un nombre.
2. Ingresa un nombre corto que te ayude a encontrar el chat más adelante.

Resultado esperado: Codex actualiza el nombre del chat guardado sin cambiar su transcripción.

Reanudar un chat guardado con /resume

1. Escribe /resume y presiona Enter.
2. Elige el ámbito de búsqueda en el selector. Cwd muestra los chats del directorio actual. Repo, cuando está disponible, incluye el directorio correspondiente en los worktrees locales vinculados. All busca en todos los directorios.
3. Selecciona el chat que quieres reanudar.

Resultado esperado: Codex vuelve a cargar la transcripción del chat seleccionado para que puedas continuar donde lo dejaste y conserva intacto el historial original.

Crear un fork del chat actual con /fork

1. Escribe /fork y presiona Enter.
2. Si Codex te pide elegir una copia de trabajo, selecciona el directorio actual o un worktree nuevo.

Resultado esperado: Codex clona el chat actual en uno nuevo con un ID distinto y conserva intacta la transcripción original para que puedas explorar otro enfoque en paralelo.

Si necesitas crear un fork de una sesión guardada en lugar de la actual, ejecuta codex fork en la terminal para abrir el selector de sesiones.

Continuar en la app de escritorio con /app

En macOS y Windows, escribe /app para abrir la sesión actual en la app de escritorio de ChatGPT. Si la app no está instalada o no se está ejecutando, Codex muestra un error que te pide instalarla o iniciarla.

Resultado esperado: la app de escritorio abre el mismo chat guardado para que puedas continuar allí.

Iniciar un chat secundario con /side

Usa /side para crear un fork temporal del chat actual sin salir del chat principal.

1. Escribe /side para abrir un chat secundario.
2. Si quieres, agrega texto en la misma línea. Por ejemplo, para pedirle a Codex que revise si este plan tiene algún riesgo evidente, escribe /side Check whether this plan has an obvious risk.
3. Vuelve al chat principal cuando termines la consulta puntual.

Resultado esperado: Codex abre un chat secundario con una transcripción independiente de la del chat principal. Mientras estás en el chat secundario, la TUI sigue mostrando el estado del chat principal para que puedas ver si aún se está ejecutando.

/side no está disponible dentro de otro chat secundario ni en el modo de revisión.

Generar AGENTS.md con /init

1. Ejecuta /init en el directorio donde quieras que Codex busque instrucciones persistentes.
2. Revisa el archivo AGENTS.md generado y edítalo según las convenciones de tu repositorio.

Resultado esperado: Codex crea una plantilla de AGENTS.md que puedes ajustar y guardar en un commit para futuras sesiones.

Solicitar una revisión del árbol de trabajo con /review

1. Escribe /review.
2. Luego usa /diff si quieres inspeccionar los cambios exactos en los archivos.

Resultado esperado: Codex resume los problemas que encuentra en tu árbol de trabajo, con énfasis en los cambios de comportamiento y las pruebas que faltan. Usa el modelo de la sesión actual, a menos que configures review_model en config.toml.

Enumerar las herramientas MCP con /mcp

1. Escribe /mcp.
2. Revisa la lista para confirmar qué servidores y herramientas MCP están disponibles.

Resultado esperado: verás las herramientas configuradas del protocolo de contexto de modelos (MCP) que Codex puede invocar en esta sesión.

Usa /mcp verbose para incluir diagnósticos detallados de los servidores. Usa /mcp login <name> para iniciar sesión en un servidor MCP configurado desde la sesión activa.

Explorar apps con /apps

1. Escribe /apps.
2. Elige una app de la lista.

Resultado esperado: Codex inserta la mención de la app en el editor como $app-slug, para que puedas pedirle de inmediato que la use.

Explorar complementos con /plugins

1. Escribe /plugins.
2. Elige la pestaña de un marketplace y selecciona un complemento para inspeccionar sus capacidades o las acciones disponibles.

Resultado esperado: Codex abre el explorador de complementos para que revises los complementos instalados, los que puedes descubrir según tu configuración y el estado de los que ya están instalados. Presiona la barra espaciadora sobre un complemento instalado para activarlo o desactivarlo.

Consultar y administrar los hooks del ciclo de vida con /hooks

1. Escribe /hooks.
2. Elige un evento de hook para inspeccionar los manejadores correspondientes.
3. Según lo necesites, marca como confiables, desactiva o vuelve a activar los hooks no administrados.

Resultado esperado: Codex abre el explorador de hooks para que revises los hooks del ciclo de vida configurados. Los hooks administrados aparecen identificados como tales y no se pueden desactivar desde el explorador de hooks del usuario.

Administrar chats con /agents

1. Escribe /agents y presiona Enter.
2. Selecciona un chat en el centro de comandos para abrirlo.

Resultado esperado: Codex muestra un resumen de los chats del servidor conectado. Puedes consultar sus estados y cambiar de uno a otro. Para abrir el centro de comandos directamente desde la terminal, ejecuta codex agents. El centro de comandos requiere un servidor compartido, local o remoto.

Cambiar de hilo de agente con /subagents

1. Escribe /subagents y presiona Enter.
2. Elige el hilo que quieras en el selector.

Resultado esperado: Codex cambia el hilo activo para que puedas inspeccionar o continuar el trabajo de ese agente.

Enviar comentarios con /feedback

1. Escribe /feedback y presiona Enter.
2. Sigue las indicaciones para incluir registros o diagnósticos.

Resultado esperado: Codex recopila los diagnósticos solicitados y los envía al equipo que mantiene Codex.

Cerrar sesión con /logout

1. Escribe /logout y presiona Enter.

Resultado esperado: Codex borra las credenciales locales de la sesión de usuario actual.

Salir de la CLI con /quit o /exit

1. Escribe /quit (o /exit) y presiona Enter.

Resultado esperado: Codex se cierra de inmediato. Antes, guarda el trabajo importante o regístralo en un commit.

Usa estos comandos para controlar Codex desde la paleta de comandos de VS Code. También puedes asignarles atajos de teclado.

Asignar un atajo de teclado

Para asignar o cambiar el atajo de teclado de un comando de Codex:

1. Abre la paleta de comandos (Cmd+Shift+P en macOS o Ctrl+Shift+P en Windows/Linux).
2. Ejecuta Preferencias: abrir métodos abreviados de teclado.
3. Busca Codex o el ID del comando (por ejemplo, chatgpt.newChat).
4. Selecciona el ícono del lápiz e ingresa el atajo que quieras.

Comandos de la extensión

Los comandos slash te permiten controlar Codex sin salir del editor. Úsalos para consultar el estado, alternar entre el modo local y el modo en la nube o enviar comentarios.

Usar un comando slash

1. En el editor de Codex, escribe /.
2. Selecciona un comando de la lista o sigue escribiendo para filtrarla (por ejemplo, /status).
3. Presiona Enter.

Comandos slash disponibles