Comandos para desarrolladores

Comandos de ChatGPT web

ChatGPT web tiene su propio menú de comandos en el cuadro de redacción. Escribe / para ver las acciones disponibles en el chat actual. No ofrece el conjunto de comandos de la aplicación de escritorio de ChatGPT ni de la CLI; los comandos con barra de Codex, los subcomandos de la CLI y las opciones de esta referencia no se aplican a ChatGPT web.

Comandos de la aplicación de escritorio de ChatGPT

La página general Comandos abarca la navegación por la aplicación, los atajos de chat, la personalización del teclado y los enlaces profundos para chats, ajustes, habilidades, tareas programadas, plugins y mascotas.

La página Comandos con barra abarca los comandos disponibles en el cuadro de redacción de la aplicación, incluidos /feedback, /goal, /init, /mcp, /plan, /review y /status.

Referencia de comandos de Codex CLI

Cómo leer esta referencia

Esta página cataloga todos los comandos y opciones documentados de Codex CLI. Usa las tablas interactivas para buscar por clave o descripción. Cada sección indica si la opción es estable o experimental y señala las combinaciones de riesgo.

Opciones globales

Estas opciones se aplican al comando base codex. La mayoría se propaga a otros comandos; consulta las notas anteriores o la ayuda del comando correspondiente para conocer las excepciones. Para las opciones propagadas, sigue la ayuda del comando correspondiente. Por ejemplo, codex exec --oss ... aplica --oss a exec.

Resumen de comandos

Detalles de los comandos

codex (interactivo)

Ejecutar codex sin subcomandos inicia la interfaz de terminal interactiva (TUI). El agente acepta las opciones globales anteriores, además de imágenes adjuntas. La búsqueda web usa de forma predeterminada el modo en caché; usa --search para cambiar a la navegación en vivo. Para trabajar localmente 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 un socket Unix local, usa --remote unix:// para el socket predeterminado o --remote unix://PATH para una ruta explícita. Añade --remote-auth-token-env <ENV_VAR> cuando el servidor requiera un token de portador para la autenticación mediante WebSocket.

codex app-server

Inicia localmente el servidor de aplicaciones de Codex. 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 JSONL mediante stdio, y codex app-server --stdio es un alias de ese transporte. --listen ws://IP:PORT habilita el transporte WebSocket para clientes de app-server. El servidor acepta URL de escucha ws://; usa terminación TLS o un proxy seguro cuando los clientes se conecten con wss://. Usa --listen unix:// para aceptar conexiones WebSocket en el socket Unix predeterminado de Codex, o --listen unix:///absolute/path.sock para elegir una ruta de socket. Si generas esquemas para enlaces de cliente, añade --experimental para incluir campos y métodos restringidos.

Añade --code-mode-host wss://code-mode.example.com/host para conectar app-server a un host remoto de Code Mode en lugar de iniciar uno local. Esta conexión saliente es independiente de --listen y la comparten todos los hilos del proceso app-server. Usa ws:// únicamente para un host localhost o reenviado mediante SSH.

codex remote-control

Ejecuta codex remote-control para iniciar el control remoto 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 de control remoto administrados y los flujos de trabajo remotos mediante SSH usan estos comandos; no sustituyen a codex app-server --listen cuando creas un cliente de protocolo local.

Cuando el daemon esté en ejecución, usa codex remote-control pair para crear y mostrar un código de emparejamiento manual de corta duración. Añade --json a cualquier comando de control remoto para obtener una salida legible por máquinas. Para pair, la respuesta JSON incluye pairingCode, manualPairingCode, environmentId y expiresAt.

codex app

Inicia la aplicación de escritorio de ChatGPT desde la terminal en macOS o Windows. En macOS, Codex puede abrir la ruta de un espacio de trabajo específico; en Windows, Codex muestra la ruta que se debe abrir.

codex app abre una aplicación de escritorio de ChatGPT instalada o inicia el instalador cuando falta la aplicación. En macOS, Codex abre la ruta del espacio de trabajo indicada; en Windows, muestra la ruta que se debe abrir tras la instalación.

codex debug app-server send-message-v2

Envía un mensaje mediante el flujo V2 de hilo/turno de app-server usando el cliente de prueba integrado de app-server.

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

codex debug models

Muestra como JSON el catálogo de modelos sin procesar que ve Codex.

Usa --bundled cuando quieras inspeccionar únicamente el catálogo incluido en el binario actual, sin actualizarlo desde el endpoint remoto de modelos.

codex debug prompt-input

Representa como JSON la lista exacta de entradas del prompt visible para el modelo. Úsalo al 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 en la nube. Debes autenticarte y tener acceso al chat.

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

codex review

Ejecuta una revisión de código de forma no interactiva. Elige exactamente un objetivo de revisión o pasa instrucciones de revisión personalizadas como prompt.

--uncommitted, --base, --commit y un valor PROMPT personalizado entran en conflicto entre sí. Usa --title únicamente con --commit.

codex archive y codex unarchive

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

codex archive <SESSION>
codex unarchive <SESSION>

codex delete

Elimina permanentemente una sesión interactiva guardada mediante su ID o nombre. Úsalo únicamente cuando quieras eliminar la transcripción en vez de ocultarla de las listas de sesiones activas.

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

Usa --force únicamente con un UUID de sesión. Las sesiones con nombre siguen requiriendo confirmación para que Codex no elimine sin preguntar un nombre repetido o ambiguo.

codex cloud

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

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

codex cloud list

Enumera chats recientes en la nube con filtros y paginación opcionales.

La salida de texto sin formato muestra la URL de una tarea seguida de los detalles de su estado. Usa --json para la automatización. La carga JSON contiene una matriz 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 de shell y redirige la salida a la ubicación correspondiente, por ejemplo, codex completion zsh > "${fpath[1]}/_codex".

codex doctor

Genera un informe de diagnóstico local antes de presentar una incidencia de soporte o mientras investigas una instalación de Codex que no funciona. El informe comprueba el estado de la instalación, la configuración, la autenticación, el tiempo de ejecución, Git, la terminal, app-server y el inventario de hilos.

codex features

Administra las marcas de funcionalidad almacenadas en $CODEX_HOME/config.toml. Los comandos enable y disable guardan los cambios para que se apliquen a sesiones futuras. El subcomando features no acepta --profile.

codex exec

Usa codex exec (o la forma abreviada codex e) para ejecuciones mediante scripts o con estilo de CI que deban finalizar sin interacción humana.

Codex escribe una salida con formato de manera predeterminada. Añade --json para recibir eventos JSON delimitados por saltos de línea (uno por cada cambio de estado). El subcomando opcional resume permite continuar tareas no interactivas. Usa --last para elegir la sesión más reciente del directorio de trabajo actual o añade --all para buscar en todas las sesiones:

codex execpolicy

Comprueba los archivos de reglas execpolicy antes de guardarlos. codex execpolicy check acepta una o varias opciones --rules (por ejemplo, archivos ubicados en ~/.codex/rules) y emite JSON que muestra la decisión más estricta y las reglas coincidentes. Añade --pretty para dar formato a la salida. El comando execpolicy está actualmente en versión preliminar.

codex login

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

codex login status termina con 0 cuando hay credenciales, lo que resulta útil en scripts de automatización.

codex logout

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

codex mcp

Administra las entradas de servidores de Model Context Protocol almacenadas en ~/.codex/config.toml.

El subcomando add admite transportes tanto stdio como HTTP transmisible:

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

codex plugin

Instala, enumera y elimina plugins de los marketplaces configurados.

codex plugin add --json muestra pluginId, name, marketplaceName, version, installedPath y authPolicy. codex plugin list --json muestra las matrices 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 de la fuente de marketplace configurada. codex plugin remove --json muestra pluginId, name y marketplaceName.

codex plugin marketplace

Administra las fuentes de marketplaces de plugins que Codex puede explorar e instalar.

codex plugin marketplace add acepta notaciones abreviadas de GitHub como owner/repo o owner/repo@ref, URL HTTP o HTTPS de Git, URL SSH de Git y directorios raíz de marketplaces locales. Usa --ref para fijar una referencia de Git y repite --sparse PATH para usar una extracción dispersa en repositorios de marketplace basados en Git.

codex plugin marketplace list muestra los nombres y las raíces de los marketplaces incluidos en el ámbito, incluidos los marketplaces predeterminados detectados de forma implícita y las instantáneas de marketplaces configuradas.

Añade --json a los comandos para añadir, enumerar, actualizar o eliminar marketplaces a fin de obtener una salida apta para la automatización. El JSON para añadir un marketplace incluye marketplaceName, installedRoot y alreadyAdded; el JSON de la lista incluye una matriz marketplaces con name, root y el valor opcional marketplaceSource; el JSON de actualización incluye selectedMarketplaces, upgradedRoots y errors; el JSON de eliminación incluye marketplaceName y installedRoot.

codex mcp-server

Ejecuta Codex como servidor MCP mediante stdio para que otras herramientas puedan conectarse. Este comando hereda las sustituciones de configuración globales y termina cuando el cliente posterior cierra la conexión.

codex resume

Continúa una sesión interactiva mediante su ID o reanuda el chat más reciente. codex resume limita --last al directorio de trabajo actual, salvo que pases --all. Acepta las mismas opciones globales que codex, incluidas las sustituciones de modelo y aislamiento.

Si el directorio de trabajo actual difiere del directorio guardado de la sesión, Codex pregunta qué directorio debe usar. Establece tui.resume_cwd en "current" o "session" para reutilizar esa elección sin preguntar. Una sustitución explícita --cd (-C) tiene prioridad sobre tui.resume_cwd.

codex fork

Bifurca una sesión interactiva anterior en un chat nuevo. De forma predeterminada, codex fork abre el selector de sesiones; añade --last para bifurcar en su lugar la sesión más reciente.

Cuando los directorios de la sesión actual y guardada difieren, codex fork usa la misma solicitud de directorio de trabajo y el mismo ajuste tui.resume_cwd que codex resume.

codex sandbox

Usa el asistente de aislamiento para ejecutar un comando con las mismas políticas que Codex usa internamente.

Seatbelt de macOS

Landlock de Linux

Windows

codex update

Busca y aplica una actualización de Codex CLI cuando la versión instalada admite la actualización automática. Las compilaciones de depuración muestran un mensaje que indica que debes instalar una compilación de lanzamiento.

Combinaciones de opciones y consejos de seguridad

• Usa --sandbox workspace-write para trabajo local desatendido que pueda permanecer dentro del espacio de trabajo y evita --dangerously-bypass-approvals-and-sandbox salvo que estés dentro de una máquina virtual aislada dedicada.
• Cuando necesites conceder a Codex acceso de escritura a más directorios, prefiere --add-dir en lugar de forzar --sandbox danger-full-access.
• Combina --json con --output-last-message en CI para capturar el progreso legible por máquinas y un resumen final en lenguaje natural.

Atajos interactivos

• Escribe @ para buscar un archivo en el espacio de trabajo y añadir su ruta al prompt.
• Presiona Up o Down para restaurar el historial de borradores.
• Presiona Ctrl+R para buscar en el historial de prompts y, a continuación, presiona Enter para usar una coincidencia o Esc para cancelar.
• Presiona Ctrl+O o ejecuta /copy para copiar la salida completada más reciente de Codex.
• Añade ! al principio de una línea para ejecutar un comando de shell local con los ajustes actuales de aprobación y aislamiento.
• Presiona Tab mientras Codex trabaja para poner en cola un prompt de seguimiento, un comando con barra o un comando de shell para el siguiente turno.
• Presiona Enter mientras Codex trabaja para introducir instrucciones nuevas en el turno actual.
• Presiona Esc dos veces con el cuadro de redacción vacío para editar el mensaje anterior del usuario y bifurcar el chat desde ese punto.
• Presiona Ctrl+C o ejecuta /exit para cerrar la sesión.

Recursos relacionados

• Descripción general de Codex CLI: 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 aislamiento e integraciones.
• AGENTS.md: descripción conceptual de las capacidades de los agentes de Codex y las prácticas recomendadas.

Los comandos con barra te ofrecen un control rápido de Codex centrado en el teclado. Escribe / en el cuadro de redacción para abrir el menú emergente de comandos con barra, elige un comando y Codex realizará acciones como cambiar de modelo, ajustar los permisos o resumir chats largos sin salir de la terminal.

Esta guía muestra cómo:

• Encontrar el comando con barra integrado adecuado para una tarea
• Dirigir una sesión activa con comandos como /model, /fast, /personality, /permissions, /approve, /raw, /agent y /status

Comandos con barra de Codex CLI

Comandos con barra integrados

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

Cuando ya haya un chat en curso, puedes escribir un comando con barra y presionar Tab para ponerlo en cola para el siguiente turno. Codex analiza los comandos con barra en cola cuando se ejecutan, por lo que los menús de comandos y los errores aparecen después de que termine el turno actual. El autocompletado de comandos con barra sigue funcionando antes de poner el comando en cola.

/quit y /exit cierran la CLI. Úsalos solo después de guardar o confirmar cualquier trabajo importante.

Usa /permissions para ajustar lo que Codex puede hacer sin preguntar primero. Usa /approve solo cuando necesites reintentar una acción reciente que la revisión automática haya rechazado.

Controla tu sesión con comandos de barra

Los siguientes flujos de trabajo mantienen tu sesión encaminada sin reiniciar Codex.

Define el modelo activo con /model

1. Inicia Codex y abre el editor.
2. Escribe /model y pulsa Enter.
3. Elige un modelo como gpt-5.6-luna o gpt-5.6-terra en la ventana emergente.

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

Activa o desactiva el modo Fast con /fast

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

Resultado esperado: Codex cambia el nivel y guarda la selección. En el pie de la TUI, también puedes mostrar un elemento de la línea de estado del modo Fast con /statusline.

Los comandos del nivel Fast dependen del catálogo. Si el modelo actual no anuncia un nivel Fast, Codex no mostrará /fast.

Define un estilo de comunicación con /personality

Usa /personality para cambiar cómo se comunica Codex sin reescribir tu instrucción.

1. En un chat activo, escribe /personality y pulsa Enter.
2. Elige un estilo en la ventana emergente.

Resultado esperado: Codex confirma el nuevo estilo en la transcripción y lo usa en las respuestas posteriores del chat.

Codex admite las personalidades friendly, pragmatic y none. Usa none para desactivar las instrucciones de personalidad.

Si el modelo activo no admite instrucciones específicas de personalidad, Codex oculta este comando.

Cambia al modo de planificación con /plan

1. Escribe /plan y pulsa Enter para cambiar el chat activo al modo de planificación.
2. Opcional: proporciona texto de instrucción en línea (por ejemplo, /plan Propose a migration plan for this service).
3. Puedes pegar contenido o adjuntar imágenes al usar argumentos en línea de /plan.

Resultado esperado: Codex entra en el modo de planificación y usa tu instrucción opcional en línea como primera solicitud de planificación.

Mientras Codex ya está trabajando, /plan no está disponible temporalmente.

Define o consulta el objetivo de una tarea con /goal

1. Escribe /goal <objective> para definir el objetivo, por ejemplo, /goal Finish the migration and keep tests green.
2. Escribe /goal para consultar el objetivo actual.
3. Usa /goal edit para revisar 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.

Los objetivos deben tener contenido y un máximo de 4000 caracteres. Para instrucciones más largas, incluye los detalles en un archivo y haz que el objetivo apunte a ese archivo.

Activa o desactiva funciones experimentales con /experimental

1. Escribe /experimental y pulsa Enter.
2. Activa o desactiva las funciones que quieras (por ejemplo, Network proxy o Prevent sleep while running) y reinicia Codex si se te solicita.

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

Aprueba un rechazo de la revisión automática con /approve

Usa /approve cuando el revisor automático haya rechazado una acción reciente y quieras que Codex la reintente una vez.

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

Resultado esperado: Codex reintenta esa acción rechazada una vez conforme a la política de la sesión actual.

Configura las memorias con /memories

1. Escribe /memories.
2. Elige si Codex debe usar las memorias existentes, generar memorias nuevas o mantener desactivado el comportamiento de las memorias.

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

Usa skills con /skills

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

Resultado esperado: Codex inserta el contexto de la skill seleccionada para que la siguiente solicitud siga las instrucciones de esa skill.

Importa la configuración de Claude Code con /import

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

Resultado esperado: Codex abre el selector de importación de agentes externos e importa los artefactos compatibles seleccionados en la configuración y los archivos locales de Codex. La detección de sesiones incluye hasta 50 chats de los últimos 30 días.

Ejecuta /import desde una sesión local de la TUI. No está disponible mientras se ejecuta una tarea, en sesiones remotas ni mientras exista una conexión con el daemon del servidor de aplicaciones local.

Para consultar el flujo de trabajo de la aplicación de escritorio y los tipos de artefactos compatibles, consulta Importar desde otro agente.

Borra el terminal e inicia un chat nuevo con /clear

1. Escribe /clear y pulsa Enter.

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

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

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

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

Archiva la sesión actual con /archive

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

Resultado esperado: Codex archiva la sesión actual y cierra la TUI interactiva. Codex conserva la transcripción de la sesión almacenada localmente; restáurala después con codex unarchive <SESSION>.

/archive no está disponible mientras se ejecuta una tarea.

Elimina la sesión actual con /delete

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

Resultado esperado: Codex elimina la transcripción de la sesión actual y cierra la TUI interactiva. La eliminación es permanente y también elimina las sesiones descendientes creadas.

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

Actualiza los permisos con /permissions

1. Escribe /permissions y pulsa Enter.
2. Selecciona el ajuste predefinido de aprobación que corresponda a tu nivel de comodidad, por ejemplo, Auto para ejecuciones autónomas o Read Only para revisar las ediciones. Cuando haya perfiles de permisos con nombre activos, el selector también mostrará los perfiles personalizados configurados y sus descripciones.

Resultado esperado: Codex anuncia la política actualizada. Las acciones futuras respetan el modo de aprobación actualizado hasta que vuelvas a cambiarlo.

Incluye contexto del IDE con /ide

1. Escribe /ide.
2. Añade texto opcional en línea si quieres 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 la siguiente instrucción.

Activa o desactiva el modo Vim con /vim

1. Escribe /vim.
2. Continúa editando en el editor.

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

Configura el entorno aislado con privilegios elevados de Windows con /setup-default-sandbox

Este comando solo aparece en Windows cuando Codex usa el entorno aislado degradado de token restringido.

1. Escribe /setup-default-sandbox.
2. Sigue el flujo de configuración del administrador.

Resultado esperado: Codex configura el entorno aislado con privilegios elevados de Windows y selecciona el ajuste predefinido de aprobación automática correspondiente.

Copia la respuesta más reciente con /copy

1. Escribe /copy y pulsa Enter.

Resultado esperado: Codex copia en el portapapeles la salida completada más reciente de Codex.

Si aún se está ejecutando un turno, /copy usa la salida completada más reciente en lugar de la respuesta en curso. El comando no está disponible antes de la primera salida completada de Codex ni inmediatamente después de una reversión.

También puedes pulsar Ctrl+O desde la TUI principal para copiar la respuesta completada más reciente sin abrir el menú de comandos de barra.

Activa o desactiva el historial 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 hace más directas la selección y la copia en el terminal. También puedes usar la asignación predeterminada Alt+R o conservar el valor predeterminado con tui.raw_output_mode = true.

Concede acceso de lectura al entorno aislado con /sandbox-add-read-dir

Este comando solo está disponible al ejecutar la CLI de forma nativa en Windows.

1. Escribe /sandbox-add-read-dir C:\absolute\directory\path y pulsa Enter.
2. Confirma que la ruta sea un directorio absoluto existente.

Resultado esperado: Codex actualiza la política del entorno aislado de Windows y concede acceso de lectura a ese directorio para los comandos posteriores que se ejecuten en el entorno aislado.

Inspecciona la sesión con /status

1. En cualquier chat, escribe /status.
2. Revisa en la salida el modelo activo, la política de aprobación, las raíces con permiso de escritura y el uso actual de tokens. Cuando 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 confirma que funciona donde esperas.

Consulta el uso de la cuenta con /usage

1. Escribe /usage para abrir el menú de uso.
2. Elige entre mostrar la actividad de tokens o canjear un restablecimiento obtenido que 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 para la vista seleccionada. Si la sesión no tiene autenticación de cuenta del servicio Codex, Codex muestra un requisito de inicio de sesión.

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

1. Escribe /debug-config.
2. Revisa en la salida el orden de las capas de configuración (primero la de menor precedencia), su estado activado/desactivado y las fuentes de las políticas.

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

Usa esta salida para depurar por qué una configuración efectiva difiere de config.toml.

Configura los elementos del pie con /statusline

1. Escribe /statusline.
2. Usa el selector para activar, desactivar y reordenar elementos; después, confirma.

Resultado esperado: La línea de estado del pie se actualiza inmediatamente y se conserva en tui.status_line dentro de config.toml.

Los elementos disponibles de la línea de estado incluyen el modelo, el modelo y el razonamiento, estadísticas de contexto, límites de frecuencia, rama de git, contadores de tokens, id de sesión, directorio actual/raíz del proyecto y versión de Codex.

Configura los elementos del título del terminal con /title

1. Escribe /title.
2. Usa el selector para activar, desactivar y reordenar elementos; después, confirma.

Resultado esperado: El título de la ventana o pestaña del terminal se actualiza inmediatamente y se conserva en tui.terminal_title dentro de config.toml.

Los elementos disponibles del título incluyen el nombre de la aplicación, el proyecto, el indicador de carga, el estado, el hilo, la rama de git, el modelo y el progreso de la tarea.

Elige un tema de sintaxis con /theme

1. Escribe /theme.
2. Previsualiza un tema en el selector y, después, confirma.

Resultado esperado: Codex actualiza el resaltado de sintaxis y conserva la opción en tui.theme dentro de config.toml.

Elige una mascota del 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 ambiental seleccionada en los terminales compatibles y conserva la selección. También puedes escribir /pets off para ocultarla.

Reasigna los atajos de la TUI con /keymap

Usa /keymap para inspeccionar, actualizar y conservar las asignaciones de atajos de teclado de la TUI.

1. Escribe /keymap.
2. Elige el contexto del atajo y la acción que quieras cambiar.
3. Introduce la nueva asignación o elimina la existente.

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

Las asignaciones de teclas usan nombres como ctrl-a, shift-enter y page-down. Las asignaciones específicas del contexto tienen prioridad sobre tui.keymap.global; una lista de asignaciones vacía desvincula la acción.

Comprueba los terminales en segundo plano con /ps

1. Escribe /ps.
2. Revisa la lista de terminales en segundo plano y su estado.

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

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

Detén los terminales en segundo plano con /stop

1. Escribe /stop.
2. Confirma si Codex pregunta antes de detener los terminales enumerados.

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

Mantén ligeras 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 sustituye los turnos anteriores por un resumen conciso, lo que libera contexto sin perder los detalles fundamentales.

Revisa los cambios con /diff

1. Escribe /diff para inspeccionar el diff de Git.
2. Desplázate por la salida dentro de la CLI para revisar las ediciones y los archivos añadidos.

Resultado esperado: Codex muestra los cambios que has preparado, los que todavía no has preparado y los archivos que Git aún no rastrea, para que puedas decidir cuáles conservar.

Destaca archivos con /mention

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

Resultado esperado: Codex añade el archivo al chat para garantizar que los turnos posteriores hagan referencia a él directamente.

Inicia un chat nuevo con /new

1. Escribe /new y pulsa Enter.

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

Para dar nombre al chat nuevo al crearlo, ejecuta /new bug bash.

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

Cambia el nombre del chat actual con /rename

1. Escribe /rename <name> o /rename para abrir la solicitud de nombre.
2. Introduce un nombre corto que te ayude a encontrar el chat más tarde.

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

Reanuda un chat guardado con /resume

1. Escribe /resume y pulsa Enter.
2. Elige la sesión que quieras en el selector de sesiones guardadas.

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

Bifurca el chat actual con /fork

1. Escribe /fork y pulsa Enter.

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

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

Continúa en la aplicación de escritorio con /app

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

Resultado esperado: La aplicación de escritorio abre el mismo chat guardado para que puedas continuar allí.

Inicia un chat lateral con /side

Usa /side para iniciar una bifurcación efímera desde el chat actual sin salir del chat principal.

1. Escribe /side para abrir un chat lateral.
2. Añade texto en línea de forma opcional, por ejemplo, /side Check whether this plan has an obvious risk.
3. Vuelve al chat principal cuando finalice el desvío específico.

Resultado esperado: Codex abre un chat lateral cuya transcripción está separada de la del chat principal. Mientras estás en el modo lateral, la TUI sigue mostrando el estado del chat principal para que puedas comprobar si todavía se está ejecutando.

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

Genera 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 para adaptarlo a las convenciones de tu repositorio.

Resultado esperado: Codex crea una estructura AGENTS.md que puedes perfeccionar y confirmar para futuras sesiones.

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

1. Escribe /review.
2. Continúa con /diff si quieres inspeccionar los cambios exactos de los archivos.

Resultado esperado: Codex resume los problemas que encuentra en el árbol de trabajo, centrándose en los cambios de comportamiento y las pruebas que faltan. Usa el modelo de la sesión actual, salvo que establezcas review_model en config.toml.

Enumera 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 de Model Context Protocol (MCP) que Codex puede invocar en esta sesión.

Usa /mcp verbose para incluir diagnósticos detallados del servidor. Si pasas cualquier valor distinto de verbose, Codex muestra el uso del comando.

Explora aplicaciones con /apps

1. Escribe /apps.
2. Elige una aplicación de la lista.

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

Explora plugins con /plugins

1. Escribe /plugins.
2. Elige una pestaña del marketplace y, después, un plugin para inspeccionar sus capacidades o acciones disponibles.

Resultado esperado: Codex abre el explorador de plugins para que puedas revisar los plugins instalados, los plugins detectables que permite tu configuración y el estado de los plugins instalados. Pulsa Space sobre un plugin instalado para activar o desactivar su estado habilitado.

Consulta y administra los hooks del ciclo de vida con /hooks

1. Escribe /hooks.
2. Elige un evento de hook para inspeccionar los controladores correspondientes.
3. Confía, desactiva o vuelve a activar los hooks no administrados según sea necesario.

Resultado esperado: Codex abre el explorador de hooks para que puedas revisar los hooks configurados del ciclo de vida. Los hooks administrados aparecen como tales y no pueden desactivarse desde el explorador de hooks del usuario.

Cambia entre hilos de agente con /agent

1. Escribe /agent o /subagents y pulsa Enter.
2. Selecciona en el selector el hilo que quieras.

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

Envía comentarios con /feedback

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

Resultado esperado: Codex recopila los diagnósticos solicitados y los envía a los responsables de mantenimiento.

Cierra la sesión con /logout

1. Escribe /logout y pulsa Enter.

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

Cierra la CLI con /quit o /exit

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

Resultado esperado: Codex se cierra inmediatamente. Guarda o confirma cualquier trabajo importante primero.

Comandos de la extensión del IDE

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

Asigna un atajo de teclado

Para asignar o cambiar un 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 Preferences: Open Keyboard Shortcuts.
3. Busca Codex o el ID del comando (por ejemplo, chatgpt.newChat).
4. Selecciona el icono del lápiz e introduce el atajo que quieras.

Comandos de la extensión

Comandos de barra de la extensión del IDE

Los comandos de barra te permiten controlar Codex sin salir del editor. Úsalos para comprobar el estado, cambiar entre los modos local y en la nube, o enviar comentarios.

Usa un comando de barra

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

Comandos de barra disponibles