Tiempo: 30–60 minutos
Superficie: aplicación, CLI o IDE
Plataformas: rutas separadas para macOS, Windows y Linux
Qué vas a aprender
- Instalar la superficie adecuada sin mezclar instrucciones de sistemas distintos.
- Iniciar sesión con ChatGPT.
- Entender por qué una clave API no es necesaria para empezar.
Antes de instalar
Utiliza únicamente páginas y comandos oficiales. No descargues instaladores desde anuncios, repositorios desconocidos o páginas que pidan tu contraseña de ChatGPT. Comprueba que estás en chatgpt.com, openai.com o la documentación oficial enlazada.
Para aprender, la ruta recomendada es iniciar sesión con ChatGPT. La clave API es una forma de acceso de pago por uso para flujos locales o programáticos. No concede automáticamente las funciones de la cuenta de ChatGPT y no debe pegarse en prompts, documentos ni capturas.
Ruta A — macOS
- Abre el Quickstart oficial.
- Descarga la aplicación de escritorio indicada para macOS.
- Mueve o instala la aplicación siguiendo el asistente del sistema.
- Ábrela y selecciona Continue to sign in.
- Completa el inicio de sesión en la ventana del navegador.
- Vuelve a la aplicación y confirma que aparece tu cuenta o espacio de trabajo.
- En el selector de ChatGPT, localiza Codex.
No concedas todavía acceso a Documentos, Escritorio ni a una carpeta con archivos reales. La siguiente lección creará un espacio de práctica.
Ruta B — Windows
- Abre la página oficial de la aplicación para Windows.
- Instálala desde Microsoft Store.
- Como alternativa oficial desde PowerShell, puedes utilizar:
winget install Codex -s msstore
- Abre la aplicación y completa Continue to sign in.
- Confirma que aparece tu cuenta y que puedes seleccionar Codex.
- Mantén el agente en Windows nativo. WSL2 es una opción técnica, no un requisito para empezar.
Si tu organización administra el equipo, Microsoft Store, plugins o Codex pueden estar restringidos. En ese caso no intentes eludir la política: consulta a la persona administradora.
Ruta C — Linux
La aplicación de escritorio no está disponible para Linux. Puedes utilizar ChatGPT Work en el navegador para archivos subidos y entregables. Para trabajar con una carpeta local mediante Codex, utiliza la CLI o la extensión de IDE.
En una distribución compatible, abre una terminal y ejecuta el instalador autónomo oficial:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex
Sigue el inicio de sesión que se abre en el navegador. Para que el sandbox de Linux sea fiable, instala bubblewrap con el gestor de paquetes de tu distribución:
# Ubuntu o Debian
sudo apt install bubblewrap
# Fedora
sudo dnf install bubblewrap
Si no tienes permisos para instalar paquetes, utiliza ChatGPT Work en la web o pide ayuda a la persona administradora. No desactives las protecciones del sistema únicamente para completar el curso.
CLI opcional en macOS o Windows
La CLI se enseñará en la lección 19. Si ya quieres disponer de ella, la documentación oficial publica instaladores autónomos para shell (install.sh) y PowerShell (install.ps1). No necesitas instalar Node.js ni npm para seguir la ruta principal de este curso.
Comprobación de inicio de sesión
- En la aplicación o extensión, abre el menú de perfil y comprueba la cuenta activa.
- En CLI, si Codex se inicia sin pedir de nuevo credenciales y muestra el compositor, la sesión está disponible.
- No publiques capturas que muestren correo, nombre del espacio de trabajo, claves o identificadores privados.
Encargo listo para copiar
Después de iniciar sesión, escribe:
Estoy aprendiendo. No abras carpetas, no ejecutes comandos y no cambies archivos.
Indícame qué superficie estoy usando, qué cuenta o espacio de trabajo está activo
sin mostrar datos sensibles, y dónde puedo revisar los permisos antes de una tarea.
Resultado esperado
Codex identifica la superficie y señala el control de permisos. No debe solicitar acceso a una carpeta ni mostrar credenciales.
Recuperación
- Si has iniciado sesión con la cuenta incorrecta, utiliza Log out y vuelve a entrar.
- Si pegaste accidentalmente una clave API en un prompt, revócala inmediatamente desde el panel de API y crea otra solo si realmente la necesitas.
- Si el instalador no procede de una página oficial, cancela la instalación y elimina el archivo descargado.
Error frecuente
Confundir la suscripción de ChatGPT con la facturación de API. Son rutas de acceso distintas. Iniciar sesión con una clave API utiliza facturación de la plataforma API y puede limitar funciones dependientes de ChatGPT o de la nube.
Evidencia que debes guardar
Anota sistema operativo, superficie instalada y método de acceso. No guardes tokens, contraseñas ni claves.
Ejemplo resuelto: instalar sin adivinar
Dani instala Codex, inicia sesión y escribe inmediatamente «arregla mi proyecto». Ese salto oculta demasiadas incógnitas. Una primera comprobación más segura es:
Todavía no cambies nada. Indícame:
1. qué carpeta tienes abierta;
2. qué archivos de instrucciones detectas;
3. qué herramientas puedes utilizar;
4. qué limitaciones o permisos ves.
No leas archivos fuera de la carpeta seleccionada.
La respuesta esperada no es idéntica en todos los equipos. Debe permitir comprobar la ruta, el alcance y las capacidades. Si menciona otra carpeta, Dani detiene la tarea y corrige el entorno antes de continuar.
Después realiza una prueba mínima: crea una carpeta vacía llamada practica-codex, la selecciona y pide una inspección sin modificaciones. Solo cuando la ubicación es correcta continúa con la lección 4.
Diagnóstico por síntomas:
- No aparece una función: comprueba plataforma, aplicación actualizada, plan y despliegue; no inventes un botón.
- La sesión no se inicia: revisa conexión, cuenta y método de acceso antes de reinstalar.
- Codex ve la carpeta equivocada: cierra o cambia el proyecto; no intentes compensarlo con un prompt.
- En Linux buscas la misma interfaz de escritorio: utiliza la alternativa documentada para CLI, IDE o web.
Criterio de terminado: puedes abrir un entorno de práctica, identificar su ruta y recibir una descripción sin que se modifique ningún archivo.
Cambia una variable
Repite la comprobación después de cambiar de carpeta. Debe cambiar la ruta informada, pero mantenerse la instrucción de no modificar.
Comprueba que lo has entendido
- ¿Por qué «la instalación se abrió» no demuestra que el entorno esté bien configurado?
- Si falta una función, ¿debes seguir una captura antigua o verificar disponibilidad?
Respuesta razonada
Abrir la aplicación no confirma la carpeta, permisos ni herramientas disponibles. Cuando una función falta, se verifica su disponibilidad actual y se utiliza la alternativa del curso; no se fuerza una interfaz que puede haber cambiado.
Fuentes oficiales
Revisado contra la documentación: 14 de julio de 2026.
Prueba multiplataforma pendiente antes de publicación: instalador, inicio de sesión y nombres de menú en macOS, Windows nativo y Linux.