Com o aplicativo de desktop do ChatGPT para Windows, você pode trabalhar em vários projetos, manter chats em paralelo e revisar os resultados em uma única interface. O aplicativo para Windows oferece recursos como árvores de trabalho, tarefas agendadas, integração com o Git, navegador integrado, pré-visualização de arquivos, plug-ins e habilidades. Ele é executado nativamente no Windows com o PowerShell e o sandbox do Windows. Você também pode configurá-lo para funcionar no Subsistema do Windows para Linux 2 (WSL2).
Baixe o aplicativo de desktop do ChatGPT
Baixe o aplicativo de desktop do ChatGPT para Windows.
Depois, siga o guia de início rápido para começar a usar o aplicativo.
Para conhecer as opções de instalação e atualização em empresas, consulte Implantar o aplicativo para Windows.
Se preferir instalar pela linha de comando, execute:
winget install --id 9PLM9XGG6VKS -s msstoreSandbox nativo
O aplicativo de desktop do ChatGPT para Windows oferece suporte ao sandbox nativo do Windows quando o agente é executado no PowerShell. Quando você executa o agente no Subsistema do Windows para Linux 2 (WSL2), o aplicativo usa um ambiente isolado do Linux. Para aplicar as proteções do sandbox em qualquer um dos modos, selecione Pedir aprovação abaixo do editor antes de enviar mensagens ao Codex.
No modo de acesso completo, o Codex pode atuar fora do diretório do projeto e executar, sem intenção, ações destrutivas que podem causar perda de dados. Mantenha os limites do sandbox e use regras para definir exceções específicas. Outra opção é definir a política de aprovação como nunca para que o Codex tente resolver problemas sem solicitar permissões elevadas, de acordo com suas configurações de aprovação e segurança.
Personalize seu ambiente de desenvolvimento
Editor preferido
Escolha o aplicativo padrão da opção Abrir, como o Visual Studio, o VS Code ou outro editor. Você pode escolher um aplicativo diferente para cada projeto. Se já escolheu outro aplicativo no menu Abrir de um projeto, essa escolha tem prioridade nesse projeto.
Open
Terminal integrado
Você também pode escolher o terminal integrado padrão. Dependendo das ferramentas instaladas, as opções incluem:
- PowerShell
- Prompt de Comando
- Git Bash
- WSL
A alteração vale apenas para novas sessões de terminal. Se o terminal integrado já estiver aberto, reinicie o aplicativo ou inicie um novo chat para que o novo terminal padrão apareça.
Subsistema do Windows para Linux (WSL)
Por padrão, o aplicativo de desktop do ChatGPT usa o agente do Codex nativo do Windows. Nesse modo, o agente executa comandos no PowerShell. O aplicativo também pode trabalhar com projetos armazenados no Subsistema do Windows para Linux 2 (WSL2), usando a CLI wsl quando necessário.
Para adicionar um projeto do sistema de arquivos do WSL, clique em Adicionar novo projeto ou pressione Ctrl+O. Em seguida, digite \\wsl$\ na janela do Explorador de Arquivos. Escolha sua distribuição Linux e a pasta que deseja abrir.
Se pretende continuar usando o agente nativo do Windows, prefira armazenar os projetos no sistema de arquivos do Windows e acessá-los pelo WSL usando /mnt/<drive>/.... Essa configuração é mais confiável do que abrir projetos diretamente do sistema de arquivos do WSL.
Para executar o próprio agente no WSL2, abra as Configurações, mude o agente de Windows nativo para WSL e reinicie o aplicativo. A alteração só entra em vigor após a reinicialização. Seus projetos devem continuar no mesmo lugar quando você reabrir o aplicativo.
O Codex oferecia suporte ao WSL1 até a versão 0.114. A partir do Codex 0.115, o sandbox do Linux passou a usar bubblewrap, e o Codex deixou de oferecer suporte ao WSL1.
A configuração do terminal integrado é independente da configuração do agente. Consulte Personalize seu ambiente de desenvolvimento para ver as opções de terminal. Dependendo de como você trabalha, pode manter o agente no WSL e usar o PowerShell no terminal ou usar o WSL nos dois.
Ferramentas úteis para desenvolvimento
O Codex funciona melhor quando algumas ferramentas comuns de desenvolvimento já estão instaladas:
- Git: permite usar o painel de revisão no aplicativo de desktop do ChatGPT para examinar ou reverter alterações.
- Node.js: ferramenta comum que o agente usa para executar tarefas com mais eficiência.
- Python: ferramenta comum que o agente usa para executar tarefas com mais eficiência.
- SDK do .NET: útil para criar aplicativos nativos para Windows.
- GitHub CLI: permite usar os recursos específicos do GitHub no aplicativo de desktop do ChatGPT.
Para instalar essas ferramentas com winget, o gerenciador de pacotes padrão do Windows, cole os comandos abaixo no terminal integrado ou peça ao Codex que instale as ferramentas:
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.cliApós instalar a GitHub CLI, execute gh auth login para habilitar os recursos do GitHub no aplicativo.
Se precisar de outra versão do Python ou do .NET, ajuste os IDs dos pacotes para instalar a versão desejada.
Solução de problemas e perguntas frequentes
Execute comandos com permissões elevadas
Se precisar que o Codex execute comandos com permissões elevadas, inicie o próprio aplicativo de desktop do ChatGPT como administrador. Após a instalação, abra o menu Iniciar, localize o aplicativo e selecione Executar como administrador. O agente do Codex herda esse nível de permissão.
A política de execução do PowerShell bloqueia comandos
Se você nunca usou ferramentas como Node.js ou npm no PowerShell, o agente do Codex ou o terminal integrado pode apresentar erros relacionados à política de execução.
Isso também pode acontecer se o Codex criar scripts do PowerShell para você. Nesse caso, talvez seja necessário adotar uma política de execução menos restritiva para que o PowerShell execute os scripts.
A mensagem de erro pode ser semelhante a esta:
npm.ps1 cannot be loaded because running scripts is disabled on this system.Uma solução comum é definir a política de execução como RemoteSigned:
Set-ExecutionPolicy -ExecutionPolicy RemoteSignedAntes de alterar a política, consulte o guia da Microsoft sobre políticas de execução para ver os detalhes e conhecer outras opções.
Scripts do ambiente local no Windows
Se o seu ambiente local usa comandos multiplataforma, como scripts do npm, você pode usar o mesmo script de configuração ou conjunto de ações em todas as plataformas.
Se precisar de um comportamento específico no Windows, crie scripts de configuração ou ações específicos para essa plataforma.
As ações são executadas no ambiente do terminal integrado. Consulte Personalize seu ambiente de desenvolvimento.
Os scripts de configuração local são executados no ambiente do agente: no WSL se o agente usa WSL, ou no PowerShell nos demais casos.
Compartilhe configurações, autenticação e sessões com o WSL
O aplicativo para Windows usa o mesmo diretório inicial do Codex que a versão nativa do Codex para Windows: %USERPROFILE%\.codex.
Se você também usa a CLI do Codex no WSL, ela usa o diretório inicial do Linux por padrão. Por isso, a CLI não compartilha automaticamente as configurações, os dados de autenticação em cache nem o histórico de sessões com o aplicativo para Windows.
Para compartilhar esses dados, escolha uma das opções:
- Sincronize o diretório
~/.codexdo WSL com%USERPROFILE%\.codexno seu sistema de arquivos. - Configure
CODEX_HOMEno WSL para apontar para o diretório inicial do Codex no Windows:
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codexPara aplicar essa configuração em todas as sessões do shell, adicione-a ao arquivo de perfil do shell no WSL, como ~/.bashrc ou ~/.zshrc.
Os recursos do Git estão indisponíveis
Se o Git não estiver instalado nativamente no Windows, o aplicativo não poderá usar alguns recursos. Instale o Git executando winget install Git.Git no PowerShell ou no cmd.exe.
O aplicativo não detecta o Git em projetos abertos a partir de \\wsl$
Por enquanto, se você quiser usar o agente nativo do Windows em um projeto que também possa acessar pelo WSL, a solução mais confiável é armazenar o projeto na unidade nativa do Windows e acessá-lo pelo WSL usando /mnt/<drive>/....
Cmder não aparece na caixa de diálogo Abrir
Se o Cmder estiver instalado, mas não aparecer na caixa de diálogo Abrir do Codex, adicione-o ao menu Iniciar do Windows. Clique com o botão direito do mouse em Cmder e selecione Fixar em Iniciar. Em seguida, reinicie o Codex ou o computador.