Codex en VS Code: cómo instalar y usar el agente de OpenAI
Aprende
cómo usar OpenAI Codex en VS Code
mediante la extensión oficial:
instalación,
inicio de sesión,
contexto del editor,
archivos abiertos,
selección de código,
modelos,
razonamiento,
permisos,
modo Local y Cloud,
AGENTS.md,
Skills,
MCP,
revisión de cambios
y configuración avanzada
con
config.toml.
¿Se puede usar Codex directamente en VS Code?
Sí. OpenAI ofrece una extensión oficial de Codex para VS Code y editores compatibles como Cursor y Windsurf. La extensión puede utilizar el proyecto abierto como contexto, añadir archivos o selecciones al prompt, modificar código, ejecutar herramientas, revisar diffs, utilizar Skills y servidores MCP y delegar trabajos más largos a Codex Cloud.
Qué aporta Codex dentro del editor
Contexto del editor
Archivos abiertos, selección actual y proyecto.
Edición agentic
Codex puede modificar varios archivos del proyecto.
Revisión visual
Inspecciona cambios junto al código antes de conservarlos.
Modelos
Selecciona modelo y nivel de razonamiento.
MCP
Conecta Codex con herramientas y contexto externo.
Cloud
Delega tareas largas sin bloquear tu flujo local.
Codex trabaja con el contexto que ya tienes delante
Abres código
VS Code ya conoce los archivos que estás mirando.
Añades contexto
Archivo, selección o chat relacionado.
Codex trabaja
Investiga, edita y ejecuta herramientas.
Revisas
Comprueba el diff junto al código.
Cómo instalar Codex en VS Code
Abre Extensions
Abre el Marketplace de extensiones de VS Code.
Busca Codex
Instala la extensión oficial de OpenAI.
Abre Codex
Pulsa el icono de Codex en el editor.
Inicia sesión
Conecta tu cuenta compatible.
abre la Command Palette y busca:
Codex: Open Codex SidebarLa extensión no funciona únicamente en VS Code
VS Code
Integración oficial principal.
Cursor
Puede utilizar la extensión de Codex.
Windsurf
También está documentado como compatible.
VS Code Insiders
También puede utilizar la integración.
OpenAI documenta integraciones específicas para esos IDE, en lugar de utilizar exactamente la extensión de VS Code.
Inicia sesión en Codex desde el editor
La extensión puede utilizar tu acceso a Codex asociado a la cuenta y plan correspondientes.
Plan, workspace, políticas empresariales y método de autenticación pueden afectar qué modelos y capacidades aparecen en la extensión.
Abre la carpeta correcta antes de iniciar el chat
La extensión considera la carpeta o workspace abierto en el IDE como el proyecto local del chat.
Si tienes varias raíces abiertas, selecciona la raíz correspondiente al chat que vas a iniciar.
Empieza usando el contexto del proyecto
Analiza este proyecto.
No modifiques nada todavía.
Explícame:
- arquitectura
- punto de entrada
- módulos principales
- dependencias
- tests
- build
- flujo principal
Después dime
qué archivos debería conocer
antes de empezar a trabajar.Así puedes comparar o revertir fácilmente el trabajo realizado.
La gran ventaja de Codex en VS Code es el contexto del editor
Puedes añadir directamente al chat:
Archivo completo actualmente abierto.
Selección específica de código.
Conversaciones recientes relacionadas.
Contexto disponible del editor.
Pregunta directamente sobre una función o bloque
Analiza el código seleccionado.
Quiero saber:
- qué hace
- qué supuestos realiza
- posibles bugs
- problemas de seguridad
- edge cases
- qué tests debería tener
No lo modifiques todavía.Acciones útiles de la extensión
| Acción | Qué hace |
|---|---|
| Add to Thread | Añade la selección actual al contexto |
| Add File to Thread | Añade el archivo completo |
| New Chat | Abre una conversación nueva |
| New Codex Panel | Crea otro panel de Codex |
| Open Command Menu | Abre el menú de comandos de Codex |
| Open Sidebar | Muestra la barra lateral de Codex |
Crear un nuevo chat desde el editor
Ctrl + N
Crea un chat nuevo de Codex.
Cmd + N
Crea un chat nuevo de Codex.
Esto evita mezclar contexto entre debugging, features, refactors o tareas sin relación.
Controla si Codex añade automáticamente el contexto del editor
/ide-contextPuedes desactivar el contexto automático y adjuntar únicamente los archivos que realmente necesita una tarea.
Local vs Cloud en la extensión de Codex
Trabaja en tu workspace
Adecuado para iteraciones rápidas sobre archivos locales.
- Código en tu equipo
- Herramientas locales
- Sandbox local
- Feedback inmediato
Delega la tarea
Adecuado para trabajos que necesitan más tiempo o aislamiento.
- Entorno remoto
- Trabajo delegado
- Continúa en segundo plano
- Resultado revisable al regresar
/local
/cloudSelecciona el entorno cloud cuando sea necesario
/cloud-environmentCodex crea un entorno remoto, hace checkout del repositorio correspondiente y ejecuta allí la tarea.
¿Existe un modo Worktree dentro de VS Code?
Los worktrees forman parte del ecosistema Codex, pero su gestión integrada está especialmente asociada a la aplicación de escritorio. Puedes abrir un worktree como cualquier carpeta en VS Code y utilizar la extensión allí.
Un worktree es otra copia local de un repositorio Git. Cloud es un entorno remoto donde Codex ejecuta la tarea.
Elegir modelo dentro de VS Code
/modelTambién puedes elegir el nivel de razonamiento:
/reasoningCambios claramente delimitados pueden utilizar una opción más rápida, reservando mayor razonamiento para arquitectura, debugging difícil o migraciones complejas.
Usa Plan Mode antes de una implementación compleja
/planDeja que Codex investigue arquitectura, dependencias, riesgos y tests antes de comenzar la implementación.
Permisos y sandbox también se aplican en VS Code
/permissionsSandbox
Limita técnicamente qué archivos y recursos puede utilizar un comando.
Aprobaciones
Determinan cuándo Codex debe pedirte permiso antes de actuar.
Evita ampliar permisos hacia directorios no relacionados salvo que la tarea realmente lo necesite.
AGENTS.md también funciona con la extensión IDE
# AGENTS.md
## Proyecto
Aplicación PHP + MySQL.
## Reglas
- Usa PDO.
- Usa prepared statements.
- Mantén compatibilidad con PHP 8.2+.
- No añadas dependencias sin necesidad.
- Ejecuta tests después de modificar código.
- No cambies APIs públicas sin autorización.Codex detecta instrucciones según la raíz del proyecto y la jerarquía de directorios correspondiente.
Las Skills independientes sí funcionan en la extensión IDE
Puedes utilizar Skills locales para procedimientos repetibles sin pegar nuevamente todas las instrucciones en cada chat.
/skillsTambién puedes invocar una Skill directamente:
$security-review revisa los cambios actualesLas Skills independientes están disponibles en la extensión IDE. Los Plugins completos no están soportados actualmente dentro de la extensión.
La extensión de VS Code no admite Plugins completos
Skills
Sí pueden utilizarse directamente desde la extensión.
Plugin browser
Los Plugins se gestionan desde Codex CLI o la aplicación de escritorio.
No conviene asumir que todas las funciones de Codex Desktop existen automáticamente en VS Code.
La extensión comparte los servidores MCP con Codex CLI
Codex Desktop, Codex CLI y la extensión IDE utilizan la misma configuración MCP cuando trabajan sobre el mismo host.
~/.codex/config.tomlComprueba los servidores conectados:
/mcpVS Code tiene dos capas de configuración
config.toml
Controla:
- modelo
- razonamiento
- permisos
- sandbox
- MCP
- personalización
chatgpt.*
Controla el comportamiento específico de la extensión dentro de VS Code.
- sidebar
- CodeLens
- composer
- reviews
- WSL
La CLI y VS Code comparten configuración del agente
~/.codex/config.tomlTambién puedes disponer de configuración por proyecto:
.codex/config.tomlLos proyectos no confiables no cargan todas las capas locales de configuración.
Abrir Codex Settings desde VS Code
Abre Codex
Ve a la barra lateral.
Pulsa el engranaje
Abre las opciones.
Codex Settings
Configura opciones comunes.
Open config.toml
Accede a opciones avanzadas.
Ajustes útiles de Codex para VS Code
| Setting | Uso |
|---|---|
chatgpt.openOnStartup |
Abrir Codex al iniciar VS Code |
chatgpt.commentCodeLensEnabled |
Mostrar acciones Codex sobre TODO |
chatgpt.followUpQueueMode |
Encolar o dirigir mensajes durante una ejecución |
chatgpt.composerEnterBehavior |
Configurar cómo se envían prompts |
chatgpt.reviewDelivery |
Review inline o en chat separado |
chatgpt.localeOverride |
Idioma de la interfaz |
chatgpt.runCodexInWindowsSubsystemForLinux |
Ejecutar Codex mediante WSL en Windows |
Son ajustes
propios
de VS Code.
La configuración
del agente Codex
utiliza
config.toml.
VS Code puede ejecutar Codex dentro de WSL2
"chatgpt.runCodexInWindowsSubsystemForLinux": trueEl cambio recarga VS Code para ejecutar Codex dentro del entorno Linux.
No necesitas apuntar VS Code manualmente a tu Codex CLI
La extensión
gestiona
el ejecutable
necesario
para su funcionamiento.
El ajuste
chatgpt.cliExecutable
está destinado
principalmente
al desarrollo
del propio Codex.
OpenAI advierte que sustituir manualmente el ejecutable incluido puede provocar que partes de la extensión dejen de funcionar.
Revisa los cambios junto al código
La extensión permite inspeccionar un resumen y las líneas modificadas sin separar el código de la explicación del agente.
/review
Puedes configurar
la revisión
como
inline
o
detached.
Inline intenta
mantenerla
dentro
del chat actual;
Detached crea
una conversación
separada.
Revisión después de implementar una feature
Revisa todos los cambios.
Prioriza:
- bugs
- regresiones
- seguridad
- pérdida de datos
- errores de concurrencia
- incompatibilidades
- requisitos incumplidos
No reportes
preferencias de estilo
sin impacto real.
Para cada hallazgo indica:
- severidad
- archivo
- línea
- impacto
- corrección sugerida.Puedes enviar instrucciones mientras Codex trabaja
La extensión permite decidir si un mensaje enviado durante una ejecución debe esperar al siguiente turno o intentar dirigir la ejecución actual.
| Modo | Comportamiento |
|---|---|
queue |
Espera al siguiente turno |
steer |
Intenta orientar la ejecución actual |
Puedes invertir
el comportamiento
para un mensaje
mediante
Cmd/Ctrl + Shift + Enter.
Codex puede mostrar acciones sobre comentarios TODO
// TODO: validate nonce before processing requestSe controla mediante:
"chatgpt.commentCodeLensEnabled": trueVS Code y la app de escritorio pueden compartir chats
Cuando la aplicación de escritorio y la extensión IDE están abiertas sobre el mismo proyecto, pueden compartir chats activos y contexto del editor.
Empieza investigando código desde VS Code.
Continúa la conversación en la app.
Conserva el proyecto relacionado.
Comprueba qué configuración está usando Codex
/statusPermite comprobar información como:
Modelo activo.
Política de aprobación.
Raíces con escritura.
Uso de contexto y tokens.
Depura configuraciones que no parecen aplicarse
/debug-configPuedes comprobar qué capa está definiendo una determinada política: proyecto, usuario o configuración administrada.
Ejemplo: usar Codex en VS Code para un plugin WordPress
Analiza el plugin abierto.
Primero identifica:
- archivo principal
- clases
- actions
- filters
- AJAX handlers
- REST routes
- shortcodes
- cron
- tablas propias
- WooCommerce hooks
- nonces
- capabilities
Después investiga
por qué este formulario
devuelve error 500.
No modifiques código
hasta encontrar
la causa raíz.Por ejemplo, el handler PHP, el archivo JavaScript y la clase que procesa la base de datos. Esto reduce búsquedas innecesarias.
Usa el editor para cambios visuales focalizados
Estos son los archivos
del componente actual.
Quiero mejorar
la versión responsive.
Restricciones:
- conserva HTML semántico
- no añadas framework
- reutiliza las clases existentes
- no cambies estilos desktop
Corrige únicamente
breakpoints inferiores a 768px.
Después revisa
el diff completo.Flujo recomendado con Codex dentro de VS Code
Abre el repositorio
Selecciona el workspace correcto.
Abre archivos relevantes
Reduce el contexto inicial.
Añade contexto
Archivo o selección.
Investiga
Pide comprensión antes de editar.
Planifica
Usa Plan para tareas complejas.
Implementa
Deja que Codex realice los cambios.
Revisa el diff
Comprueba cada archivo.
/review
Haz una revisión independiente.
VS Code vs Codex CLI vs Desktop vs Cloud
Cómo aprovechar mejor Codex en VS Code
Abre solamente el proyecto relacionado.
Añade archivos concretos cuando conozcas dónde está el problema.
Usa selección de código para preguntas focalizadas.
Define instrucciones persistentes en AGENTS.md.
Usa Skills para procesos repetitivos.
Usa MCP solamente para herramientas que realmente aporten contexto.
Revisa cada diff antes de integrar.
Delega al Cloud las tareas que no necesitan interacción constante.
No todas las funciones de Codex Desktop existen en VS Code
| Capacidad | VS Code |
|---|---|
| Contexto del editor | Sí |
| Edición del proyecto | Sí |
| AGENTS.md | Sí |
| Skills locales | Sí |
| MCP | Sí |
| Sandbox / permisos | Sí |
| Cloud delegation | Sí |
| Plugins completos | No actualmente |
| Gestor integrado de worktrees | Principalmente Desktop |
| Automations | Principalmente Desktop |
Documentación de Codex para IDE
Codex IDE Extension
Instalación, contexto, edición y Cloud.
Ver documentación →Developer Settings
config.toml, opciones IDE, WSL y permisos.
Ver ajustes →MCP
Servidores compartidos entre CLI, Desktop e IDE.
Ver MCP →Skills
Workflows reutilizables dentro de Codex.
Ver Skills →Guías relacionadas
FAQ sobre Codex en VS Code
Sí. OpenAI ofrece una extensión de Codex para VS Code que permite trabajar con el agente directamente junto al código.
Sí. OpenAI documenta VS Code, Cursor y Windsurf como editores compatibles con la extensión Codex para IDE.
Pulsa el icono de Codex. Si no aparece, abre la Command Palette y ejecuta Codex: Open Codex Sidebar.
Sí. Puedes añadir una selección de código al chat y utilizarla como contexto de la siguiente instrucción.
Sí. La extensión está diseñada para utilizar archivos abiertos, selecciones y otro contexto disponible en el editor.
Sí. Puedes mantener iteraciones rápidas de forma local o delegar trabajos más largos a Codex Cloud y regresar posteriormente para revisar el resultado.
Sí. La extensión utiliza la configuración del agente Codex y puede aplicar instrucciones persistentes definidas mediante AGENTS.md.
Sí. Las Skills independientes están disponibles en Codex CLI y en la extensión IDE. Puedes seleccionarlas con /skills o mencionarlas mediante $nombre-skill.
No actualmente. Los Plugins completos se utilizan desde interfaces compatibles como Codex CLI y la aplicación de escritorio. Las Skills independientes sí funcionan en la extensión IDE.
Sí. La aplicación de escritorio, Codex CLI y la extensión IDE comparten la configuración de servidores MCP del mismo host.
Sí. En Windows existe un ajuste para ejecutar Codex dentro de WSL cuando tu repositorio y herramientas utilizan un entorno Linux.
Sí. Los ajustes principales del agente, como modelo, razonamiento, permisos, sandbox y MCP, se comparten mediante config.toml. Los ajustes específicos del editor utilizan claves chatgpt.*.
Codex App: agentes, worktrees y tareas paralelas
Ya sabes cómo trabajar con Codex dentro de VS Code. Ahora veremos la aplicación de escritorio como centro de control para múltiples agentes, worktrees, Git, terminal, Skills, Plugins, Automations y proyectos de mayor duración.
Ver Codex App →