Configuración para desarrolladores

ChatGPT web almacena las preferencias del producto y del espacio de trabajo en la configuración de ChatGPT. Los chats de ChatGPT Work se ejecutan en un entorno administrado y no leen los archivos locales de configuración de Codex. Usa los controles que tu espacio de trabajo ofrece en la configuración de ChatGPT; los administradores del espacio de trabajo pueden gestionar algunos ajustes por ti.

La página general de Configuración abarca las preferencias de la aplicación, incluidos el perfil, los atajos de teclado, las notificaciones, la apariencia, la personalización, las memorias y los chats archivados.

Comportamiento del proyecto y del terminal

Elige dónde se abren los archivos, cuánto contenido de la salida de los comandos aparece en los chats y dónde se abren de forma predeterminada las pestañas de la terminal.

Revisión de código

En Configuración > Git, usa Entrega de la revisión para elegir En línea y ejecutar /review en el chat actual cuando sea posible, o Separada para iniciar un chat de revisión independiente.

Sincronización con la extensión del IDE

Cuando la aplicación de escritorio de ChatGPT y la extensión del IDE están abiertas en el mismo proyecto, comparten los chats activos y el contexto del editor. Activa Contexto del IDE desde el cuadro de redacción de la aplicación para permitir que Codex use los archivos abiertos actualmente en el editor. Desactívalo cuando quieras que la instrucción de la aplicación excluya ese contexto del editor.

Puedes abrir un chat de la aplicación desde la extensión del IDE y continuar un chat del IDE en la aplicación. Ambas interfaces usan el mismo proyecto para determinar qué chats y contexto deben compartir.

Configuración del agente

Los agentes de Codex en la aplicación heredan la misma configuración que la extensión del IDE y la CLI. Usa los controles de la aplicación para las opciones habituales o edita config.toml para acceder a opciones avanzadas. Consulta Aprobaciones y seguridad de los agentes y Conceptos básicos de configuración para obtener más información.

Git

Usa la configuración de Git para estandarizar los nombres de las ramas y elegir si Codex utiliza inserciones forzadas. También puedes establecer las instrucciones que Codex usa para generar mensajes de confirmación y descripciones de solicitudes de incorporación de cambios.

Integraciones y MCP

Conecta herramientas externas mediante Model Context Protocol (MCP). Habilita los servidores recomendados o agrega los tuyos. Si un servidor requiere OAuth, la aplicación inicia el flujo de autenticación. Estas opciones también se aplican a Codex CLI y a la extensión del IDE porque la configuración de MCP se encuentra en config.toml. Consulta Model Context Protocol para obtener más información.

Modo de desarrollador del navegador

En Modo de desarrollador, activa Habilitar acceso completo a CDP para permitir que ChatGPT use Chrome DevTools Protocol para analizar el rendimiento y depurar el navegador con mayor profundidad. Si tu organización ha deshabilitado el acceso completo a CDP, no puedes habilitarlo de forma local. Consulta Modo de desarrollador para conocer los requisitos de configuración, riesgo, aprobación y administración.

Codex CLI lee tus valores predeterminados personales de ~/.codex/config.toml. Añade un archivo .codex/config.toml a un proyecto o una subcarpeta de confianza cuando necesites anulaciones específicas del proyecto. La CLI y la extensión del IDE comparten estas capas de configuración.

Inspecciona tus ajustes

Usa estos comandos para conocer la configuración efectiva de la sesión actual:

• Ejecuta /status para ver el modelo activo, la política de aprobación, las raíces con permiso de escritura y el uso de tokens.
• Ejecuta /debug-config para ver las capas de configuración en orden de precedencia y el origen de los requisitos de las políticas administradas.
• Inicia Codex con --strict-config para que las claves no reconocidas de config.toml se traten como errores en lugar de ignorarlas.

Consulta Comandos para desarrolladores para obtener la referencia completa de los comandos interactivos.

Cambia los ajustes para una sola ejecución

Usa una opción específica cuando exista. Algunos ejemplos habituales son --model, --sandbox, --ask-for-approval, --profile y --search. Usa -c o --config para sobrescribir cualquier clave de configuración compatible durante una sola ejecución.

El cambio de modelo que se muestra a continuación requiere acceso a GPT-6.1 Sol. Si no está disponible para tu cuenta o espacio de trabajo, omite --model o elige un modelo de la lista de /model. Consulta Disponibilidad de GPT-6.1 Sol por plan.

codex --model gpt-6.1-sol
codex --profile deep-review
codex --config model_reasoning_effort='"medium"'

Las opciones de la línea de comandos y los valores de --config tienen la máxima precedencia. Para consultar la lista completa de opciones, consulta Comandos para desarrolladores.

Capas de configuración

La CLI aplica las opciones de la línea de comandos y las anulaciones de --config antes que la configuración del proyecto, del perfil, del usuario, del sistema y la integrada. Usa este orden de precedencia para mantener los valores predeterminados compartidos en archivos de configuración y los cambios puntuales en la línea de comandos.

Para consultar el orden completo y las opciones habituales, consulta Conceptos básicos de configuración.

Cambia los ajustes en la TUI

La interfaz de terminal interactiva proporciona selectores para opciones habituales de la sesión y de visualización:

Algunos comandos solo se aplican a la sesión actual, mientras que algunos selectores permiten guardar la opción elegida. Establece la clave de configuración relacionada cuando quieras un valor predeterminado para sesiones futuras. Para obtener información sobre el tema de la terminal, el editor, el completado y los flujos de trabajo con atajos, consulta Personalización de la CLI.

Referencias de configuración

• Configuración avanzada abarca los perfiles, las anulaciones puntuales y otros flujos de trabajo avanzados.
• Referencia de configuración enumera las claves y los valores disponibles.
• Configuración de ejemplo proporciona un archivo de ejemplo completo.
• Variables de entorno documenta las variables que usan la CLI y el instalador.

La extensión de Codex para IDE tiene dos capas de configuración:

• La configuración de Codex controla el comportamiento del agente que se comparte con Codex CLI, incluidos el modelo, el esfuerzo de razonamiento, los permisos, el entorno aislado, los MCP servers y la personalización. Codex lee esta configuración de config.toml.
• La configuración del editor controla cómo se comporta la extensión dentro de VS Code y los editores compatibles. Esta configuración usa claves chatgpt.* en el sistema de configuración del editor.

Abre los ajustes de Codex

Selecciona el icono de engranaje en la barra lateral de Codex y, a continuación, selecciona Configuración de Codex. Usa el panel de configuración para los controles habituales del agente o selecciona Abrir config.toml para editar directamente la capa de configuración activa.

Para consultar el orden de las capas de configuración y las claves habituales, consulta Conceptos básicos de configuración. Para consultar todas las claves compatibles de config.toml, consulta la Referencia de configuración.

Cambia un ajuste del editor

Para cambiar una opción, sigue estos pasos:

1. Abre la configuración del editor.
2. Busca @ext:openai.chatgpt, Codex o el nombre de la opción.
3. Actualiza el valor.

La extensión también respeta la configuración de fuente integrada de VS Code para las superficies de chat de Codex.

Referencia de ajustes del editor

Las claves chatgpt.* anteriores pertenecen a la extensión del IDE y no se incluyen en config.toml. Para la configuración compartida de los agentes, consulta Configuración básica, Configuración avanzada y la Referencia de configuración.