Guía de instalación, configuración y desinstalación de Codex: tutorial de CLI, aplicación y extensión para IDE para 2026
Una guía práctica de configuración de Codex para desarrolladores y equipos técnicos, que abarca Codex CLI, la aplicación Codex, la configuración de la extensión para IDE, el inicio de sesión, config.toml, MCP, flujos de trabajo en Windows/macOS/Linux, solución de problemas y pasos para una desinstalación limpia. También conecta los flujos de trabajo de programación con IA con la lógica de crecimiento del sitio web escaparate de We0.ai, mostrando cómo la salida de código puede convertirse en páginas de producto, contenido SEO/GEO y clientes potenciales.
El punto clave: Codex no queda terminado después de la instalación
Cuando las personas leen un tutorial de Codex por primera vez, normalmente se centran en “cómo instalarlo”. Pero una vez que empiezas a usarlo, la instalación es solo el primer paso.
Codex se comporta más como un agente de programación con IA que trabaja dentro del directorio de tu proyecto. Puede leer código, editar archivos, ejecutar comandos y afectar a un repositorio real. Por eso, la configuración correcta no es “instalar y listo”. Primero necesitas cuentas, permisos, configuración, puntos de control en Git y límites claros.
En otras palabras, Codex no es solo un instalador. Es un flujo de trabajo de desarrollo: instalar → iniciar sesión → configurar → entrar en un proyecto → ejecutar una tarea → revisar el resultado → fusionar o revertir.
Elige el punto de entrada adecuado: CLI, aplicación, extensión de IDE o nube
Codex ya no es una única interfaz. Puedes usar la CLI de Codex en la terminal, gestionar el trabajo en la aplicación Codex para macOS / Windows, usar la extensión de IDE en editores como VS Code, Cursor y Windsurf, o delegar trabajo mediante Codex en la nube.
La elección es sencilla. Si vives en la terminal, usa la CLI de Codex. Si quieres gestión de proyectos multihilo, revisión visual y cambio entre proyectos, usa la aplicación Codex. Si pasas todo el día dentro de tu editor, la extensión de IDE te resultará más natural.
Esa es la estructura útil del artículo original: no expliques solo un comando. Explica la instalación, la configuración, la desinstalación y la resolución de problemas como un único flujo de configuración.
Qué preparar antes de instalar
Antes de la instalación, comprueba cuatro cosas: cuenta, red, proyecto y reversión. Si falta una de ellas, más adelante puede convertirse en errores confusos.
Para la cuenta, prepara una cuenta de ChatGPT / OpenAI que pueda acceder a Codex, según tu plan y la configuración de tu organización. Para el proyecto, usa Codex dentro de un repositorio Git siempre que sea posible, y conserva puntos de control antes y después de las tareas importantes.
Para la red, mantenla estable en lugar de cambiar de ubicación durante el inicio de sesión. Para la configuración, comprende las ubicaciones de configuración a nivel de usuario y a nivel de proyecto, especialmente ~/.codex/config.toml y .codex/config.toml dentro de un repositorio.
Etapa | Práctica recomendada | Ten cuidado con |
Punto de entrada | Elige CLI / aplicación / extensión de IDE según el escenario | No instales todas las interfaces el primer día |
Instalación | Usa el instalador oficial, npm o Homebrew | Evita instalaciones mixtas desde varios métodos |
Configuración | Usa ~/.codex/config.toml y .codex/config.toml a nivel de proyecto | No disperses secretos entre documentos |
Prueba Codex primero en una carpeta segura | Usa puntos de control de Git en repositorios reales | |
Desinstalación | Elimina primero el programa y luego decide si quieres borrar ~/.codex | Haz una copia de seguridad de la configuración antes de eliminarla |
Cómo instalar Codex CLI
Si quieres un flujo de trabajo centrado en la terminal, Codex CLI es el punto de entrada más directo. La documentación oficial ofrece varias vías de instalación: instalador independiente, npm y Homebrew.
En macOS o Linux, puedes usar el instalador de shell oficial. En Windows, puedes usar el instalador de PowerShell. Si ya dependes de Node.js, npm funciona bien. Si eres desarrollador de macOS, Homebrew suele ser la opción más limpia.
Después de la instalación, no dejes que Codex reescriba inmediatamente un proyecto real. Abre un directorio de prueba, ejecuta codex, inicia sesión y pídele que explique la carpeta o cree un archivo pequeño. Confirma primero que la ruta, los permisos y la autenticación funcionen correctamente.
Referencia rápida de comandos
Instalador independiente para macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Instalador de PowerShell para Windows
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
Instalación con npm
npm install -g @openai/codex
Instalación con Homebrew
brew install --cask codex
Ejecutar
codex
Desinstalación con npm
npm uninstall -g @openai/codex
Desinstalación con Homebrew
brew uninstall --cask codex
Eliminar cuidadosamente la configuración local
rm -rf ~/.codex
Cómo elegir entre Codex App y la extensión de IDE
Codex App es mejor cuando quieres gestionar varias tareas en un solo lugar. Se adapta a hilos paralelos, revisión, worktrees, vista previa en el navegador y cambio de proyecto.
La extensión de IDE es mejor para “preguntar mientras editas”. Te mantiene dentro del editor, lo que resulta útil para corregir errores, añadir pruebas, explicar funciones y refactorizar módulos pequeños.
Mi sugerencia es simple: los desarrolladores pueden empezar con la CLI o la extensión de IDE. Los líderes de equipo y las personas que revisan varios proyectos pueden añadir la aplicación Codex más adelante. No instales todas las interfaces el primer día si eso complica el flujo de trabajo.
Configuración: config.toml, permisos y MCP
La configuración de Codex no debería vivir en mensajes de chat aleatorios. La documentación de OpenAI indica que la configuración a nivel de usuario se almacena en ~/.codex/config.toml, y las reglas específicas del repositorio pueden estar en .codex/config.toml dentro del proyecto.
Esto importa porque un agente de programación con IA hace más que responder preguntas. Puede leer archivos, ejecutar comandos y escribir código. Debe quedar explícito qué carpetas puede leer, qué comandos requieren confirmación y qué herramientas puede llamar.
Si conectas servidores MCP, trátalo también como una gestión de configuración real. MCP puede conectar Codex con más herramientas, pero más herramientas también implican límites de permisos más estrictos y mejores ciclos de revisión.
Problemas comunes: normalmente el problema es el entorno
La mayoría de los problemas de principiantes no se deben a que Codex esté roto. Provienen de entornos inconsistentes: PATH no actualizado, versiones instaladas tanto con npm como con Homebrew, permisos de Windows, rutas de WSL y de Windows nativo mezcladas, o autenticación de la terminal que no coincide con la sesión de la aplicación.
El orden de depuración es simple: comprueba codex --version, luego comprueba which codex o where codex, y confirma si tu binario activo proviene de npm, brew, un instalador independiente o el flujo de trabajo de la aplicación.
En Windows, presta especial atención al modo sandbox, winget, la aprobación de administrador y WSL2. Usa primero la ruta nativa de Windows cuando sea posible, y usa WSL2 cuando tu flujo de trabajo de desarrollo realmente necesite herramientas de Linux.
Desinstalación: ¿eliminar la aplicación o también la configuración?
Al desinstalar Codex, no elimines primero todas las carpetas. Decide si solo quieres eliminar el programa o si también quieres eliminar la autenticación, la configuración y el historial local.
Si lo instalaste con npm, usa npm uninstall -g @openai/codex. Si lo instalaste con Homebrew, usa brew uninstall --cask codex. Si usaste un instalador independiente, elimina el binario de la ruta de instalación real. Para Codex App, desinstálala como una aplicación normal del sistema.
Elimina ~/.codex solo si quieres quitar intencionalmente la configuración local. Eso puede borrar la configuración, la configuración de MCP, el estado de inicio de sesión y las preferencias locales, así que hazlo con cuidado.
Cómo se relaciona esto con We0.ai
Codex ayuda a convertir la intención en código. Pero el código no es la meta final. Para llegar a los clientes, aún necesitas mostrar el valor del producto, casos, documentación, tutoriales y confianza.
Ahí es donde encaja We0.ai. We0.ai no es solo un creador de sitios web con IA normal. Es una Plataforma de Crecimiento de Sitios Web de Presentación con IA. Se centra en el recorrido Crear → Presentar → Crecer → Leads: crear el producto, explicarlo con claridad, ser descubierto por búsquedas y respuestas de IA, y convertir visitantes en leads.
Un flujo de trabajo más sólido es este: usa Codex para mejorar el desarrollo y la entrega, luego usa We0.ai para convertir las funciones del producto, los servicios, los casos y los tutoriales en un sitio web de presentación que se pueda buscar, entender y esté listo para convertir.
Conclusión final
Si solo quieres probar Codex, seguir los comandos de instalación es suficiente.
Pero si quieres incorporarlo a un proceso de desarrollo real, no te centres solo en la instalación. Diseña un flujo de trabajo estable: punto de entrada fijo, configuración clara, reversión con Git, límites de permisos y limpieza regular.
Las herramientas de codificación con IA seguirán volviéndose más potentes. Pero los equipos más valiosos no serán los que tengan más herramientas. Serán los que conecten las herramientas con flujos de trabajo empresariales reales. El código debe ejecutarse. Los productos deben mostrarse. El contenido debe ser descubrible. Los sitios web deben generar leads.
Preguntas frecuentes
¿Cuál es la diferencia entre Codex CLI y Codex App?
Codex CLI es mejor para flujos de trabajo centrados en la terminal, donde Codex lee, edita y ejecuta código en el directorio actual del proyecto. Codex App es mejor para la gestión visual de tareas, revisión, worktrees y cambio entre proyectos.
¿Tengo que instalar Codex con npm?
No. La documentación oficial admite instaladores independientes, npm y Homebrew. Elige un método principal que se ajuste a tu entorno de desarrollo y evita mezclar varios métodos de instalación.
¿Dónde está el archivo de configuración de Codex?
La configuración a nivel de usuario normalmente se almacena en ~/.codex/config.toml. La configuración específica del repositorio puede estar en .codex/config.toml dentro de un proyecto. La CLI y la extensión de IDE comparten estas capas de configuración.
¿Los usuarios de Windows deberían elegir Windows nativo o WSL2?
Usa el flujo de trabajo nativo de Windows cuando funcione. Usa WSL2 cuando tu repositorio y tus herramientas ya dependan de un entorno nativo de Linux.
¿Debería eliminar ~/.codex al desinstalar Codex?
Elimínalo solo cuando quieras quitar intencionalmente la configuración local, la configuración de MCP, el estado de inicio de sesión y las preferencias. Una desinstalación normal no siempre requiere eliminar esta carpeta.
¿Por qué una guía de Codex menciona We0.ai?
Codex ayuda con la entrega de código. We0.ai ayuda con la presentación y el crecimiento. Un flujo de trabajo completo de producto no consiste solo en escribir código; también convierte páginas de producto, casos, documentación y tutoriales en un sitio web que los motores de búsqueda y las respuestas de IA puedan entender.
Herramientas relacionadas
- GitHub
- Homebrew
- Node.js
- We0.ai
Fuentes
- Conceptos básicos de configuración de Codex
- Referencia de configuración de Codex
- Repositorio de GitHub de OpenAI Codex