For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegación principal
Theme

Aplicación de escritorio de ChatGPT para Windows

Usa la aplicación de escritorio de ChatGPT en Windows con soporte nativo para sandbox y PowerShell

Con la aplicación de escritorio de ChatGPT para Windows puedes trabajar en varios proyectos, mantener chats en paralelo y revisar los resultados desde una misma interfaz. La aplicación para Windows admite worktrees y tareas programadas, e incluye funciones de Git, un navegador integrado, vistas previas de archivos, complementos y habilidades. Se ejecuta de forma nativa en Windows con PowerShell y el sandbox de Windows. También puedes configurarla para que se ejecute en el Subsistema de Windows para Linux 2 (WSL2).

Descargar la aplicación de escritorio de ChatGPT

Descarga la aplicación de escritorio de ChatGPT para Windows.

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

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

Si prefieres instalarla desde la línea de comandos, ejecuta lo siguiente:

winget install --id 9PLM9XGG6VKS -s msstore

Sandbox nativo

La aplicación de escritorio de ChatGPT para Windows admite un sandbox nativo de Windows cuando el agente se ejecuta en PowerShell. Si ejecutas el agente en el Subsistema de Windows para Linux 2 (WSL2), la aplicación usa un entorno aislado de Linux. Para aplicar las protecciones del sandbox en cualquiera de los dos modos, selecciona Solicitar aprobación debajo del editor antes de enviar mensajes a Codex.

En el modo de acceso completo, Codex puede actuar fuera del directorio de tu proyecto y realizar por error acciones destructivas que podrían provocar la pérdida de datos. Mantén los límites del sandbox y usa reglas para definir excepciones específicas. También puedes configurar la política de aprobación para que nunca solicite aprobación. Así, Codex intentará resolver los problemas sin solicitar permisos elevados, según tu configuración de aprobación y seguridad.

Personalizar la aplicación para tu entorno de desarrollo

Editor preferido

Elige la aplicación predeterminada para Abrir, como Visual Studio, VS Code u otro editor. Puedes cambiar esa opción para cada proyecto. Si ya elegiste otra aplicación en el menú Abrir de un proyecto, esa elección tiene prioridad en ese proyecto.

Terminal integrada

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

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

Subsistema de Windows para Linux (WSL)

De forma predeterminada, la aplicación de escritorio de ChatGPT usa el agente de Codex nativo de Windows. En ese caso, el agente ejecuta los comandos en PowerShell. La aplicación también puede trabajar con proyectos almacenados en el Subsistema de Windows para Linux 2 (WSL2) mediante la CLI wsl cuando sea necesario.

Para agregar un proyecto desde el sistema de archivos de WSL, haz clic en Agregar nuevo proyecto o presiona Ctrl+O. Luego escribe \\wsl$\ en la ventana del Explorador de archivos. Desde allí, elige tu distribución de Linux y la carpeta que quieras abrir.

Si planeas seguir usando el agente nativo de Windows, es preferible que guardes tus proyectos en el sistema de archivos de Windows y accedas a ellos desde WSL mediante /mnt/<drive>/.... Esta configuración es más confiable que abrir los 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 nativo de Windows por el de WSL y reinicia la aplicación. El cambio solo se aplica después de reiniciar la aplicación. Tus proyectos deberían seguir en el mismo lugar después del reinicio.

Codex fue compatible con WSL1 hasta la versión 0.114 inclusive. A partir de Codex 0.115, el sandbox de Linux pasó a usar bubblewrap, por lo que Codex dejó de ser compatible con WSL1.

La terminal integrada se configura por separado del agente. Consulta Personalizar la aplicación para tu entorno de desarrollo para conocer las opciones de terminal. Según tu flujo de trabajo, puedes mantener el agente en WSL y usar PowerShell en la terminal, o usar WSL para ambos.

Herramientas útiles para el desarrollo

Codex funciona mejor si ya tienes instaladas algunas herramientas de desarrollo de uso común:

  • Git: habilita el panel de revisión de la aplicación de escritorio de ChatGPT y te permite inspeccionar o revertir cambios.
  • Node.js: herramienta de uso común que el agente utiliza para realizar tareas con mayor eficiencia.
  • Python: herramienta de uso común que el agente utiliza para realizar tareas con mayor eficiencia.
  • SDK de .NET: te sirve para crear aplicaciones nativas de Windows.
  • GitHub CLI: habilita las funciones específicas de GitHub en la aplicación de escritorio de ChatGPT.

Para instalar estas herramientas con winget, el administrador de paquetes predeterminado de Windows, pega los siguientes comandos en la terminal integrada o pídele a Codex que instale las herramientas:

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 otra versión de Python o .NET, cambia los identificadores de los paquetes por los que correspondan a la versión que quieras usar.

Solución de problemas y preguntas frecuentes

Ejecutar comandos con permisos elevados

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

La política de ejecución de PowerShell bloquea los comandos

Si nunca has usado herramientas como Node.js o npm en PowerShell, es posible que el agente de Codex o la terminal integrada muestren errores relacionados con la política de ejecución.

Esto también puede ocurrir si Codex crea scripts de PowerShell para ti. En ese caso, es posible que necesites una política de ejecución menos restrictiva para que PowerShell pueda ejecutarlos.

Podrías ver un error similar al siguiente:

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

Una solución habitual es establecer la política de ejecución en RemoteSigned:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

Antes de cambiar la política, consulta la guía de políticas de ejecución de Microsoft para conocer los detalles y otras opciones.

Scripts del entorno local en Windows

Si tu entorno local usa comandos multiplataforma, como los scripts de npm, puedes usar el mismo script de configuración o conjunto de acciones en todas las plataformas.

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

Las acciones se ejecutan en el entorno que usa la terminal integrada. Consulta Personalizar la aplicación para tu entorno de desarrollo.

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

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

La aplicación para Windows usa el mismo directorio de inicio que Codex cuando se ejecuta de forma nativa en Windows: %USERPROFILE%\.codex.

Si también ejecutas la CLI de Codex en WSL, la CLI usa de forma predeterminada el directorio de inicio de Linux. Por eso, no comparte automáticamente la configuración, los datos de autenticación en caché ni el historial de sesiones con la aplicación para Windows.

Para compartirlos, elige una de estas opciones:

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

Si quieres que esta configuración se aplique cada vez que abras un shell, agrégala 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 usar algunas funciones. Para instalarlo, ejecuta winget install Git.Git desde PowerShell o cmd.exe.

No se detecta Git en los proyectos abiertos desde \\wsl$

Por ahora, si quieres usar el agente nativo de Windows con un proyecto al que también puedas acceder desde WSL, la solución más confiable 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 Abrir

Si Cmder está instalado pero no aparece en el cuadro de diálogo Abrir de Codex, agrégalo al menú Inicio de Windows. Haz clic derecho en Cmder y selecciona Anclar a Inicio. Luego reinicia Codex o la computadora.