Comandos para desarrolladores

La versión web de ChatGPT 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 de barra de Codex, los comandos de la CLI y las opciones de esta referencia no se aplican a la versión web de ChatGPT.

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, configuración, habilidades, tareas programadas, plugins y mascotas.

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

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 destaca las combinaciones arriesgadas.

Opciones globales

Estas opciones se aplican al comando base codex. La mayoría se propaga a los 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 ningún subcomando inicia la interfaz de terminal interactiva (TUI). El agente acepta las opciones globales anteriores, además de archivos de imagen adjuntos. 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 fricción, 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 app-server 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 bearer para la autenticación mediante WebSocket.

codex agents

Abre el centro de comandos para explorar chats y cambiar entre agentes 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

Añade un mensaje de texto a 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 una sesión. Usa un UUID cuando las sesiones compartan el mismo nombre. El comando también acepta --remote y --remote-auth-token-env; no se admiten imágenes adjuntas.

codex app-server

Inicia el app-server de Codex localmente. Está destinado principalmente al desarrollo y la depuración, y puede cambiar sin previo aviso.

codex app-server --listen stdio:// mantiene 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 clientes, 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 de app-server. Usa ws:// solo para un host localhost o reenviado mediante SSH.

codex remote-control

Ejecuta codex remote-control para iniciar el control remoto a través del servidor administrado en segundo plano cuando se cumplan los requisitos, con una alternativa en primer plano. Usa codex remote-control --no-daemon para ejecutarlo explícitamente en primer plano. Usa codex remote-control start para iniciar el demonio 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; no sustituyen a codex app-server --listen cuando desarrollas un cliente local del protocolo.

Una vez que el demonio 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. --no-daemon solo se aplica al comando remote-control sin subcomandos; no lo combines con start, stop ni pair.

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 debes 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 proporcionada; en Windows, muestra la ruta que debe abrirse después de 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 las 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 con 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 visibles 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 PROMPT personalizado son incompatibles entre sí. 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 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 solo cuando quieras eliminar la transcripción en lugar de ocultarla de las listas de sesiones activas.

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

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

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 usarlos en scripts o inspeccionarlos rápidamente.

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 los chats recientes en la nube con filtrado y paginación opcionales.

La salida de texto sin formato muestra una URL de tarea seguida de los detalles del 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 adecuada, por ejemplo, codex completion zsh > "${fpath[1]}/_codex".

codex doctor

Genera un informe de diagnóstico local antes de presentar una solicitud de asistencia o mientras investigas una instalación defectuosa de Codex. El informe comprueba el estado de la instalación, la configuración, la autenticación, la ejecución, Git, la terminal, app-server y el inventario de hilos.

codex features

Gestiona las marcas de función 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 al 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 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:

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

Se requiere un prompt al usar imágenes, --output-schema, --output-last-message o --ephemeral.

Añade --worktree a una ejecución nueva o bifurcada para crear un árbol de trabajo 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

Comprueba los archivos de reglas execpolicy antes de guardarlos. codex execpolicy check acepta una o varias opciones --rules (por ejemplo, archivos en ~/.codex/rules) y emite JSON que muestra la decisión más estricta y todas 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 OAuth de ChatGPT.

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 de la API key como de la autenticación de ChatGPT. Este comando no tiene opciones.

codex mcp

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

El subcomando add admite tanto el transporte stdio como el HTTP transmisible:

Las acciones 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

Gestiona 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 de Git HTTP o HTTPS, URL de Git SSH y directorios raíz de marketplaces locales. Usa --ref para fijar una referencia de Git y repite --sparse PATH para usar un checkout disperso en repositorios de marketplaces 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 implícitamente y las instantáneas de marketplaces configurados.

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 enumeración 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

codex resume

Continúa una sesión interactiva por su ID o reanuda el chat más reciente. codex resume limita el alcance de --last al directorio de trabajo actual, a menos que pases --all. Admite opciones para sobrescribir el modelo y el entorno aislado, pero no --worktree.

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 solicitarla. Una sobrescritura 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 tu sesión más reciente.

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

Para bifurcar la sesión en un árbol de trabajo de Git administrado, ejecuta codex fork <SESSION_ID> --worktree. Esto requiere un ID de sesión explícito y ejecución local; no admite --last ni el selector de sesiones.

codex sandbox

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

seatbelt de macOS

Entorno aislado 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 en su lugar.

Combinaciones de opciones y consejos de seguridad

• Usa --sandbox workspace-write para el 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 VM de aislamiento 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.
• Pulsa Arriba o Abajo para recuperar el historial de borradores.
• Pulsa Ctrl+R para buscar en el historial de prompts y, después, pulsa Enter para usar una coincidencia o Escape para cancelar.
• Pulsa Ctrl+O o ejecuta /copy para copiar la última respuesta completada de Codex.
• Añade ! al principio de una línea para ejecutar un comando de shell local con la configuración actual de aprobación y entorno aislado.
• Pulsa Tab mientras Codex está trabajando para poner en cola un prompt de seguimiento, un comando de barra o un comando de shell para el siguiente turno.
• Pulsa Enter mientras Codex está trabajando para introducir nuevas instrucciones en el turno actual.
• Pulsa Escape dos veces con el campo de entrada vacío para editar el mensaje anterior del usuario y bifurcar el chat desde ese punto.
• Pulsa 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, ajuste del aislamiento e integraciones.
• AGENTS.md: descripción conceptual de las capacidades de los agentes de Codex y prácticas recomendadas.

Los comandos con barra diagonal te permiten controlar Codex rápidamente con el teclado. Escribe / en el editor para abrir el menú emergente de comandos con barra diagonal, 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 te muestra cómo:

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

Comandos de barra integrados

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

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

/quit y /exit cierran la CLI. Úsalos solo después de haber guardado o confirmado 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 la sesión bien encaminada sin reiniciar Codex.

Elige el modo de terminal con /tui

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

Resultado esperado: El próximo inicio usa el modo de terminal guardado. Las opciones de inicio como --no-alt-screen siguen teniendo prioridad.

Exporta 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 como Markdown. Para guardarla directamente en un archivo, ejecuta /export session.md. Espera a que termine el turno actual antes de exportarla.

Resume 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 cuando quieras liberar espacio de contexto.

Cambia de directorio con /cd

1. Escribe /pwd (o /cwd) para comprobar 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.

Continúa en un árbol de trabajo con /worktree

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

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

Administra 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 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. Al confirmar una actualización, se cierra Codex y puede interrumpirse el trabajo activo. Para una conexión remota, administra el servidor en el equipo que lo aloja.

Revisa las advertencias con /warnings

1. Escribe /warnings.

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

Establece el modelo activo con /model

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

1. Inicia Codex y abre el editor de mensajes.
2. Escribe /model y pulsa Enter.
3. Elige un modelo como gpt-6-luna o gpt-6.1-sol 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 estado del nivel y guarda la selección. En el pie de la TUI, también puedes mostrar un elemento del modo Fast en la línea de estado con /statusline.

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

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 mensaje 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 el mensaje opcional en línea como primera solicitud de planificación.

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

Establece o consulta el objetivo de una tarea con /goal

1. Escribe /goal <objective> para establecer el objetivo, por ejemplo, /goal Finish the migration and keep tests green.
2. Escribe /goal para ver 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.

Los objetivos deben contener texto y tener como máximo 4000 caracteres. Para instrucciones más largas, incluye los detalles en un archivo y haz que el objetivo apunte a él.

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 el mensaje te lo solicita.

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

Aprueba una acción denegada por 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 de acuerdo con 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 memoria.

Resultado esperado: Codex actualiza los ajustes de memoria correspondientes para sesiones futuras.

Usa habilidades con /skills

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

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 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 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 durante la 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.

Limpia la terminal e inicia un chat nuevo con /clear

1. Escribe /clear y pulsa Enter.

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

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

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

Ctrl+L solo limpia la vista del terminal y mantiene 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.

Resultado esperado: Codex archiva la sesión y vuelve al centro de comandos cuando 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; restáurala más adelante con codex unarchive <SESSION>.

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

Elimina la sesión actual con /delete

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

Resultado esperado: Codex elimina permanentemente la transcripción y las sesiones descendientes creadas. Cuando está conectado a un servidor local en segundo plano o a un servidor remoto, Codex vuelve 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 lateral.

Actualiza los permisos con /permissions

1. Escribe /permissions y pulsa Enter.
2. Selecciona la configuración de aprobación predefinida que corresponda a tu nivel de comodidad, por ejemplo, Auto para ejecuciones autónomas o Read Only para revisar las modificaciones. Cuando hay perfiles de permisos con nombre activos, el selector también muestra 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 el 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 el siguiente mensaje.

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 hacer que el modo Vim sea el predeterminado en sesiones nuevas, establece tui.vim_mode_default = true en config.toml.

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

Este comando aparece solo 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 la configuración de aprobación automática predefinida correspondiente.

Copia la última respuesta con /copy

1. Escribe /copy y pulsa Enter.

Resultado esperado: Codex copia la última salida completada de Codex en el portapapeles.

Si todavía hay un turno en curso, /copy usa la última salida completada 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 última respuesta completada sin abrir el menú de comandos de barra diagonal.

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 el enlace predeterminado Alt+R o conservar el valor predeterminado con tui.raw_output_mode = true.

Inspecciona la sesión con /status

1. En cualquier chat, escribe /status.
2. Revisa la salida para consultar 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 si quieres mostrar la actividad de tokens o canjear un restablecimiento obtenido 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 la cuenta de servicio de 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 la salida para consultar el orden de las capas de configuración (primero la de menor precedencia), su estado activado/desactivado y los orígenes 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 experimental_network cuando están configurados.

Usa esta salida para depurar por qué un ajuste efectivo difiere de config.toml.

Configura los elementos del pie con /statusline

1. Escribe /statusline.
2. Usa el selector para activar, desactivar y reordenar elementos; luego 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+razonamiento, las estadísticas de contexto, los límites de frecuencia, la rama de git, los contadores de tokens, el id de sesión, el directorio actual o raíz del proyecto y la versión de Codex.

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

1. Escribe /title.
2. Usa el selector para activar, desactivar y reordenar elementos; luego 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 de título disponibles incluyen el nombre de la aplicación, el proyecto, el indicador de actividad, 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 luego confirma.

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

Elige 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 desactívalas.

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 los enlaces 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 el nuevo enlace o elimina el existente.

Resultado esperado: Codex actualiza el mapa de teclas activo y escribe el enlace personalizado en tui.keymap dentro de config.toml.

Los enlaces de teclas usan nombres como ctrl-a, shift-enter y page-down. Los enlaces específicos de un contexto anulan tui.keymap.global; una lista de enlaces vacía desvincula la acción.

Revisa las 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 junto con un máximo de tres líneas de salida recientes que no estén vacías para que puedas evaluar el progreso rápidamente.

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

Detén las terminales en segundo plano con /stop

1. Escribe /stop.
2. Confirma si Codex lo solicita 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 las transcripciones compactas con /compact

1. Después de un intercambio largo, escribe /compact.
2. Confirma cuando Codex 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 esenciales.

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 modificaciones y los archivos añadidos.

Resultado esperado: Codex muestra los cambios que has preparado, los que aún no has preparado y los archivos que Git todavía no sigue, para que puedas decidir qué 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 nuevo chat con /new

1. Escribe /new y pulsa Enter.
2. Si Codex ofrece elegir una copia de trabajo, elige el directorio actual o un nuevo árbol de trabajo.

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 asignar un nombre al chat nuevo al crearlo, ejecuta /new bug bash.

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

Cambia el nombre del chat actual con /rename

1. Escribe /rename <name> o escribe /rename para abrir el mensaje de asignación de nombre.
2. Introduce un nombre breve que te ayude a encontrar el chat más adelante.

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 retomar el trabajo donde lo dejaste, manteniendo intacto el historial original.

Bifurca el chat actual con /fork

1. Escribe /fork y pulsa Enter.
2. Si Codex ofrece elegir una copia de trabajo, elige el directorio actual o un nuevo árbol de trabajo.

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 otro enfoque 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 solicita que la instales o inicies.

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

Inicia un chat secundario 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 termine 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 ver si este sigue en ejecución.

/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, después, edítalo para que se ajuste a las convenciones de tu repositorio.

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

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, con énfasis en los cambios de comportamiento y las pruebas que faltan. Usa el modelo de la sesión actual a menos 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. Usa /mcp login <name> para iniciar sesión en un MCP server configurado desde la sesión activa.

Explora las aplicaciones con /apps

1. Escribe /apps.
2. Elige una aplicación en 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 los plugins con /plugins

1. Escribe /plugins.
2. Elige una pestaña del marketplace y, luego, selecciona 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 en hooks no administrados, desactívalos o vuelve a activarlos según sea necesario.

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

Gestiona chats con /agents

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

Resultado esperado: Codex muestra una vista general de los chats del servidor conectado. Puedes consultar su estado y alternar entre ellos. Para abrir el centro de comandos directamente desde tu terminal, ejecuta codex agents. El centro de comandos requiere un servidor compartido local o remoto.

Cambia de hilo de agente con /subagents

1. Escribe /subagents y pulsa Enter.
2. Selecciona 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.

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.

Sal de la CLI con /quit o /exit

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

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

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 enlace de teclas para 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 icono de lápiz y, a continuación, introduce el atajo que quieras.

Comandos de la extensión

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

Usa un comando de barra

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

Comandos de barra disponibles