Documentación de ChatGPT
Español
Contacto goolvyouyou@gmail.com

Aplicación de escritorio ChatGPT para Windows

Aplicación de escritorio ChatGPT para Windows que muestra una barra lateral de proyectos, un chat activo y un panel de revisión

Usa la aplicación de escritorio ChatGPT en Windows con compatibilidad nativa con el entorno aislado y PowerShell

La aplicación de escritorio ChatGPT para Windows proporciona una única interfaz para trabajar en distintos proyectos, ejecutar chats en paralelo y revisar resultados. La aplicación para Windows admite flujos de trabajo principales, como worktrees, tareas programadas, funcionalidad de Git, el navegador integrado, vistas previas de archivos, plugins y skills. Se ejecuta de forma nativa en Windows mediante PowerShell y el entorno aislado de Windows, o puedes configurarla para que se ejecute en Windows Subsystem for Linux 2 (WSL2).

Descargar la aplicación de escritorio ChatGPT

Descarga la aplicación de escritorio ChatGPT para Windows.

Luego, sigue la guía de inicio rápido para comenzar.

Para conocer las opciones de instalación y actualización empresariales, consulta Implementar la aplicación para Windows.

Si prefieres instalarla mediante la línea de comandos, ejecuta:

winget install --id 9PLM9XGG6VKS -s msstore

Entorno aislado nativo

La aplicación de escritorio ChatGPT para Windows admite un entorno aislado de Windows nativo cuando el agente se ejecuta en PowerShell y utiliza el entorno aislado de Linux cuando ejecutas el agente en Windows Subsystem for Linux 2 (WSL2). Para aplicar las protecciones del entorno aislado en cualquiera de los modos, selecciona Solicitar aprobación debajo del cuadro de redacción antes de enviar mensajes a Codex.

Personalizar para tu entorno de desarrollo

Editor preferido

Configuración de la aplicación de escritorio ChatGPT que muestra la aplicación predeterminada de Abrir en en Windows

Elige una aplicación predeterminada para Abrir, como Visual Studio, VS Code u otro editor. Puedes reemplazar esa selección en cada proyecto. Si ya seleccionaste una aplicación diferente en el menú Abrir de un proyecto, esa selección específica del proyecto tiene prioridad.

Terminal integrada

Configuración de la aplicación de escritorio ChatGPT que muestra la selección de la terminal integrada en Windows

También puedes elegir la terminal integrada predeterminada. Según lo que tengas instalado, las opciones incluyen:

  • PowerShell
  • Símbolo del sistema
  • Git Bash
  • WSL

Este cambio solo se aplica a las nuevas sesiones de terminal. Si ya tienes una terminal integrada abierta, reinicia la aplicación o inicia un chat nuevo antes de esperar que aparezca la nueva terminal predeterminada.

Windows Subsystem for Linux (WSL)

Configuración de la aplicación de escritorio ChatGPT que muestra el selector de agentes con las opciones nativa de Windows y WSL

De forma predeterminada, la aplicación de escritorio ChatGPT utiliza el agente Codex nativo de Windows. Esto significa que el agente ejecuta comandos en PowerShell. La aplicación también puede trabajar con proyectos ubicados en Windows Subsystem for Linux 2 (WSL2) mediante la CLI wsl cuando sea necesario.

Si quieres añadir un proyecto desde el sistema de archivos de WSL, haz clic en Añadir proyecto nuevo o presiona Ctrl+O y, a continuación, escribe \\wsl$\ en la ventana del Explorador de archivos. Desde allí, elige tu distribución de Linux y la carpeta que quieras abrir.

Si piensas seguir utilizando el agente nativo de Windows, es preferible guardar los proyectos en tu sistema de archivos de Windows y acceder a ellos desde WSL mediante /mnt/<drive>/.... Esta configuración es más fiable que abrir proyectos directamente desde el sistema de archivos de WSL.

Si quieres que el propio agente se ejecute en WSL2, abre Configuración, cambia el agente de Windows nativo a WSL y reinicia la aplicación. El cambio no tendrá efecto hasta que la reinicies. Tus proyectos deberían permanecer en su lugar después del reinicio.

WSL1 era compatible hasta Codex 0.114. A partir de Codex 0.115, el entorno aislado de Linux se trasladó a bubblewrap, por lo que WSL1 ya no es compatible.

La terminal integrada se configura de forma independiente del agente. Consulta Personalizar para tu entorno de desarrollo para conocer las opciones de terminal. Puedes mantener el agente en WSL y seguir utilizando PowerShell en la terminal, o utilizar WSL para ambos, según tu flujo de trabajo.

Herramientas útiles para desarrolladores

Codex funciona mejor cuando algunas herramientas comunes para desarrolladores ya están instaladas:

  • Git: Proporciona el panel de revisión de la aplicación de escritorio ChatGPT y te permite inspeccionar o revertir cambios.
  • Node.js: Una herramienta habitual que el agente utiliza para realizar tareas de forma más eficiente.
  • Python: Una herramienta habitual que el agente utiliza para realizar tareas de forma más eficiente.
  • .NET SDK: Resulta útil cuando quieres crear aplicaciones nativas para Windows.
  • GitHub CLI: Proporciona la funcionalidad específica de GitHub en la aplicación de escritorio ChatGPT.

Instálalas con el administrador de paquetes predeterminado de Windows winget. Para ello, pega lo siguiente en la terminal integrada o pide a Codex que las instale:

winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3.14
winget install --id Microsoft.DotNet.SDK.10
winget install --id GitHub.cli

Después de instalar GitHub CLI, ejecuta gh auth login para habilitar las funciones de GitHub en la aplicación.

Si necesitas una versión diferente de Python o .NET, cambia los identificadores de paquete por los de la versión que quieras.

Solución de problemas y preguntas frecuentes

Ejecutar comandos con permisos elevados

Si necesitas que Codex ejecute comandos con permisos elevados, inicia la propia aplicación de escritorio ChatGPT como administrador. Después de instalarla, abre el menú Inicio, busca la aplicación y elige Ejecutar como administrador. El agente Codex hereda ese nivel de permisos.

La directiva de ejecución de PowerShell bloquea los comandos

Si nunca antes has utilizado herramientas como Node.js o npm en PowerShell, es posible que el agente Codex o la terminal integrada encuentren errores relacionados con la directiva de ejecución.

Esto también puede ocurrir si Codex crea scripts de PowerShell para ti. En ese caso, quizá necesites una directiva de ejecución menos restrictiva antes de que PowerShell pueda ejecutarlos.

El error podría tener un aspecto similar a este:

npm.ps1 cannot be loaded because running scripts is disabled on this system.

Una solución habitual es establecer la directiva de ejecución en RemoteSigned:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

Para obtener más información y consultar otras opciones, revisa la guía sobre directivas de ejecución de Microsoft antes de cambiar la directiva.

Scripts del entorno local en Windows

Si tu entorno local utiliza comandos multiplataforma, como scripts de npm, puedes mantener un único script de configuración compartido o conjunto de acciones para todas las plataformas.

Si necesitas un comportamiento específico de Windows, crea scripts de configuración específicos de Windows o acciones específicas de Windows.

Las acciones se ejecutan en el entorno que utiliza tu terminal integrada. Consulta Personalizar para tu entorno de desarrollo.

Los scripts de configuración local se ejecutan en el entorno del agente: WSL si el agente utiliza WSL y PowerShell en caso contrario.

Compartir la configuración, la autenticación y las sesiones con WSL

La aplicación para Windows utiliza el mismo directorio de inicio de Codex que Codex nativo en Windows: %USERPROFILE%\.codex.

Si también ejecutas Codex CLI dentro de WSL, la CLI utiliza de forma predeterminada el directorio de inicio de Linux, por lo que no comparte automáticamente la configuración, la autenticación en caché ni el historial de sesiones con la aplicación para Windows.

Para compartirlos, utiliza uno de estos métodos:

  • Sincroniza ~/.codex de WSL con %USERPROFILE%\.codex en tu sistema de archivos.
  • Configura WSL para que utilice el directorio de inicio de Codex de Windows mediante CODEX_HOME:
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

Si quieres aplicar esa configuración en cada shell, añádela al perfil del shell de WSL, como ~/.bashrc o ~/.zshrc.

Las funciones de Git no están disponibles

Si no tienes Git instalado de forma nativa en Windows, la aplicación no puede utilizar algunas funciones. Instálalo con winget install Git.Git desde PowerShell o cmd.exe.

Git no se detecta en proyectos abiertos desde \\wsl$

Por ahora, si quieres utilizar el agente nativo de Windows con un proyecto al que también se puede acceder desde WSL, la solución alternativa más fiable es guardar el proyecto en la unidad nativa de Windows y acceder a él desde WSL mediante /mnt/<drive>/....

Cmder no aparece en el cuadro de diálogo para abrir

Si Cmder está instalado pero no aparece en el cuadro de diálogo para abrir de Codex, añádelo al menú Inicio de Windows: haz clic con el botón derecho en Cmder y elige Añadir a Inicio; después, reinicia Codex o el equipo.