Cómo descargar e instalar la app de Codex en macOS (guía de 2027)
Cómo descargar e instalar la app de Codex en macOS (guía de 2027)
Si quieres probar Codex en tu Mac, seguramente te importe más saber si encajará con tu proyecto que dedicar una tarde a configurar otra app. La instalación es solo el principio: después toca comprobar que puede leer el repositorio, reconocer tus cambios y ejecutar lo que necesita sin acceder a más de la cuenta.
Antes de descargar nada, hay un cambio importante: desde el 9 de julio de 2026, Codex forma parte de la aplicación de escritorio de ChatGPT. Conserva su espacio para programar, pero el punto de entrada ya no es una descarga independiente de Codex. Así lo recoge la actualización oficial de la aplicación de escritorio.
Vamos a recorrer la instalación, la apertura de un proyecto y tres comprobaciones sencillas para verificar archivos, Git y terminal antes de confiarle trabajo importante.
Esta guía se publica en Macaron.
Lista de requisitos
Comprueba estos puntos antes de empezar. Te ayudarán a distinguir un problema de instalación de uno de acceso a la cuenta o de configuración del proyecto.
Una comprobación que merece la pena: si macOS muestra un símbolo de prohibición sobre la app, revisa primero la compatibilidad del sistema y del procesador. Ese símbolo, por sí solo, no permite saber cuál de los dos está fallando.
Si tienes un Mac Intel y no encuentras una descarga de escritorio compatible, consulta los requisitos de Codex CLI, la alternativa para trabajar desde el terminal. No intentes resolver una incompatibilidad de arquitectura desactivando las protecciones de macOS.
Descarga e instalación: errores habituales
El recorrido sigue siendo sencillo: descargar, instalar y abrir. Lo importante es hacerlo desde el sitio correcto y entender los avisos que puedan aparecer.
Paso 1: descarga la aplicación
Entra en la página oficial de descarga de ChatGPT para escritorio y elige la versión para macOS.
El nombre y el tamaño del instalador pueden cambiar. No utilices una cifra fija de megabytes como comprobación de autenticidad ni busques una copia antigua de Codex.dmg para seguir un tutorial.
Paso 2: abre la imagen de disco y mueve la app a Aplicaciones
Si la descarga se entrega como archivo .dmg:
- Haz doble clic en el archivo para abrirlo.
- Arrastra la aplicación a la carpeta Aplicaciones, siguiendo las indicaciones del instalador.
- Expulsa la imagen de disco cuando termine la copia.
Paso 3: abre la app por primera vez
Ábrela desde Aplicaciones. Estos son dos avisos que conviene distinguir.
Error 1: «Apple no puede comprobar si la aplicación contiene software malicioso»
No significa necesariamente que hayas instalado la app mediante Homebrew ni que la descarga esté dañada. Es un aviso relacionado con las comprobaciones de seguridad de macOS.
Primero confirma que has descargado la aplicación desde el enlace oficial. Si necesitas revisar sus atributos extendidos, este comando solo los muestra; no los elimina ni desactiva protecciones:
# Ajusta la ruta si la aplicación tiene otro nombre o ubicación.
xattr -l "/Applications/ChatGPT.app"
El resultado no demuestra por sí solo que la app sea segura.
Si has confirmado su procedencia e integridad, macOS puede ofrecer la opción Abrir igualmente en Ajustes del Sistema → Privacidad y seguridad. Utilízala únicamente si entiendes el aviso y confías en la aplicación. La guía de Apple para abrir aplicaciones con seguridad explica cuándo puede hacerse una excepción.
No borres de forma indiscriminada los atributos de cuarentena para hacer desaparecer el mensaje.
Error 2: «La aplicación está dañada y no puede abrirse»
Puede deberse a una descarga incompleta, a archivos modificados o a otro problema de integridad. No lo interpretes automáticamente como un simple error de descarga.
Cierra la app, mueve a la Papelera la copia que acabas de instalar y vuelve a descargarla desde el sitio oficial. No borres tus proyectos ni carpetas de configuración como parte de este paso. Si el aviso persiste, consulta con soporte antes de forzar la apertura.
Solución: no puedes iniciar sesión o no aparece Codex
Una vez instalada la aplicación, completa el inicio de sesión y selecciona Codex. Si no puedes continuar, comprueba cuál de estas situaciones encaja con lo que ves.
Caso A: Codex no aparece en tu cuenta
Revisa que hayas iniciado sesión con la cuenta correcta y, si utilizas una cuenta de empresa o de estudios, en el espacio de trabajo adecuado.
Ya no conviene partir de que necesitas obligatoriamente Plus o un plan superior. La disponibilidad actual de Codex según el plan incluye acceso de escritorio para Free y Go sujeto al despliegue, con diferencias de modelos, funciones y límites.
Antes de contratar nada:
- Actualiza la aplicación.
- Comprueba la cuenta y el espacio de trabajo seleccionados.
- Si tu cuenta está gestionada por una organización, pregunta si tu puesto y tu rol permiten utilizar Codex.
- Cierra sesión y vuelve a entrar si sospechas que la sesión no se ha actualizado correctamente.
Volver a iniciar sesión puede ayudar, pero no corrige una restricción del administrador ni concede acceso a una función que tu cuenta no incluye.
Caso B: el inicio de sesión entra en bucle o aparece un error relacionado con la clave API
Distingue entre iniciar sesión con ChatGPT y utilizar una clave API. No son dos formas equivalentes de consumir el mismo plan.
La clave API permite trabajar con Codex en local, pero el uso se factura a través de la cuenta de la API. Algunas funciones vinculadas a ChatGPT o a servicios en la nube pueden no estar disponibles. Codex en la nube requiere iniciar sesión con ChatGPT, según la documentación de autenticación.
Si quieres utilizar el acceso de tu suscripción, completa el inicio de sesión con ChatGPT en el navegador y vuelve a la app cuando termine.
Si ya utilizabas la CLI o una extensión del editor, revisa la configuración que se haya cargado. Compartir parte de la configuración no significa que todos los proyectos, historiales y ajustes se transfieran automáticamente.
Crea tu primer proyecto y una conversación
Con la sesión iniciada, el siguiente paso es darle acceso a una carpeta concreta. Un proyecto local reúne las conversaciones relacionadas con ese trabajo y permite utilizar sus archivos como contexto.
Configuración rápida:
- Abre la vista Projects y crea un proyecto.
- Añade la carpeta de tu repositorio. En un proyecto existente, puedes hacerlo desde Edit project → Add folder.
- Selecciona Codex y comprueba que vas a trabajar con la carpeta local, no en un entorno remoto.
- Abre una conversación nueva y envía tu primera petición.
En proyectos con varias carpetas, la carpeta principal determina el directorio de trabajo inicial y las operaciones Git predeterminadas. La organización de proyectos y carpetas locales también permite añadir carpetas secundarias, así que revisa cuáles has incluido.
Para empezar, basta con un repositorio pequeño. No necesitas esperar a que la app anuncie que ha «indexado» todos los archivos ni tomar un tiempo de carga concreto como referencia.
Petición de prueba:
Muéstrame los archivos modificados más recientemente y explícame
qué hace este proyecto a partir del README. No cambies ningún archivo.
Esto permite comprobar dos cosas:
- Que Codex puede leer los archivos del proyecto.
- Que su explicación utiliza el contenido del README y no una suposición sobre el proyecto.
Si responde que no puede acceder a los archivos, comprueba la ruta seleccionada, los permisos de la carpeta y cualquier solicitud pendiente de macOS. No des por hecho que añadir una carpeta concede todos los permisos necesarios.
Comprobación rápida: estado de Git, diff y ejecución
Antes de encargarle un cambio importante, verifica cómo trabaja con el estado actual de tu repositorio.
Prueba 1: reconocimiento de Git
¿En qué rama estoy y qué cambios tengo sin confirmar?
Distingue entre los cambios preparados para el commit y los demás.
No modifiques nada.
Comprueba la respuesta con el estado del repositorio. Si no puede obtenerlo, ejecuta git --version en Terminal para comprobar que Git está disponible y confirma que has abierto la carpeta correcta.
Prueba 2: revisión de diferencias
Pide un cambio pequeño y fácil de deshacer, por ejemplo, añadir un comentario a una función concreta. Después:
Muéstrame el diff del cambio que acabas de hacer.
La app incluye un panel para revisar cambios. Puedes examinar las líneas añadidas y eliminadas, preparar cambios para un commit o revertirlos. Ten en cuenta que el panel puede mostrar todos los cambios pendientes del repositorio, incluidos los tuyos, no solo los de Codex. La revisión de cambios locales permite distinguir distintos ámbitos de revisión.
Si quieres mantener el trabajo del agente separado de tu copia habitual, inicia la tarea en un worktree. No es una protección que se active automáticamente para cualquier conversación.
Prueba 3: ejecución en el terminal
Abre el terminal integrado del proyecto y ejecuta el comando de desarrollo correspondiente. En un proyecto Node.js que tenga ese script definido:
npm run dev
# O utiliza el comando de arranque que corresponda a tu proyecto.
Si arranca, habrás comprobado que ese comando funciona en el entorno de la app. Eso no garantiza que todas las herramientas del proyecto estén configuradas.
Si aparece command not found, revisa qué ejecutable falta y compara el entorno con tu terminal habitual. Puede tratarse de una dependencia sin instalar o de una diferencia en PATH. Comprueba la configuración de tu shell y reinicia la app después de realizar los cambios necesarios.
En un worktree nuevo también pueden faltar dependencias o archivos locales que Git no incluye. Los entornos locales de Codex permiten definir los pasos de preparación y los comandos habituales del proyecto.
Ajustes prudentes antes de empezar
Antes de dejar que un agente modifique un proyecto real, revisa qué puede hacer y dónde. No hace falta conceder acceso completo al ordenador para comprobar si te resulta útil.
Abre los ajustes con ⌘, y revisa los permisos aplicables a la conversación:
- Aprobaciones: comprueba qué acciones requieren tu confirmación. No presupongas que un modo automático te preguntará antes de cada edición.
- Worktrees: utiliza uno cuando necesites separar los cambios del agente de tu trabajo actual. Un worktree crea otra copia de trabajo del repositorio; no sustituye al control de permisos.
- Acceso a archivos: empieza con el alcance más limitado que permita hacer la tarea. Añade otras carpetas o acceso a la red solo cuando haya una necesidad concreta.
Los nombres de los controles pueden variar según la versión y la configuración de tu organización. Lo importante es distinguir qué permite el entorno de cuándo debe pedirte aprobación, como explica la guía de aprobaciones y seguridad de Codex.
Puedes plantear esta comprobación:
Antes de actuar, comprueba si tus permisos permiten crear test.txt
en mi carpeta personal, fuera del proyecto. No crees el archivo
ni solicites ampliar permisos. Explica qué restricción se aplicaría.
La respuesta sirve para revisar cómo interpreta su configuración, pero no demuestra por sí sola que el aislamiento funcione. Para verificarlo técnicamente, utiliza un entorno de prueba sin datos importantes y comprueba que una escritura permitida funciona y otra fuera del alcance queda bloqueada. Si concedes una excepción durante la prueba, ya no estás comprobando el límite original.
Revisa también las tareas programadas. Pueden ejecutarse en segundo plano en el proyecto local o en un worktree. Las que necesitan archivos locales requieren que el ordenador esté encendido y la app abierta. Sus ejecuciones aparecen en Scheduled, según la documentación de tareas programadas.
Antes de activar una, prueba la petición manualmente y comprueba su horario, su alcance y dónde dejará los resultados.
Lo que de verdad importa
Instalar la app suele ser la parte más corta. Las comprobaciones que merecen atención son estas:
- Compatibilidad: que el instalador corresponda a tu Mac y a tu versión de macOS.
- Acceso a la cuenta: que estés utilizando la cuenta, el espacio de trabajo y el método de autenticación adecuados.
- Primer proyecto: que Codex lea la carpeta correcta, reconozca el estado de Git y pueda ejecutar los comandos necesarios.
No necesitas empezar con un repositorio grande ni contratar el plan más caro para comprobar si esta forma de trabajar te encaja. Abre un proyecto pequeño, pide una lectura sin cambios y pasa después a una modificación fácil de revisar.
Cuando el agente empiece a editar, mira el diff antes de aceptar el resultado. Que una tarea termine sin errores no significa que haya hecho exactamente lo que querías.
En Macaron nos interesa que delegar una tarea no te obligue a aprender otra interfaz compleja. Pero conviene separar las necesidades: revisar código en un repositorio no es lo mismo que crear una pequeña app para organizar una actividad cotidiana.
Macaron es una IA personal que recuerda las preferencias y el contexto que compartes y permite pedir herramientas personalizadas con una frase. Puede encajarte si buscas una Mini-App a medida sin configurar un entorno de desarrollo; no sustituye las comprobaciones de Git, permisos y ejecución de esta guía.
Puedes probar Macaron gratis con una tarea concreta y decidir si el resultado te sirve. Las funciones básicas son gratuitas; las funciones prémium pueden requerir una suscripción o recargas.
Artículos Relacionados
Apply to become Macaron's first friends
Read & discover
Explore Playbooks
AI Personal Assistant
Free calculators
