O aplicativo do ChatGPT para desktop no Windows oferece uma única interface para trabalhar em vários projetos, executar conversas em paralelo e revisar resultados. O aplicativo para Windows oferece suporte a fluxos de trabalho essenciais, como árvores de trabalho, tarefas agendadas e recursos do Git, além do navegador integrado, visualizações de arquivos, plug-ins e habilidades. Ele é executado nativamente no Windows usando o PowerShell e o sandbox do Windows, ou você pode configurá-lo para ser executado no Subsistema do Windows para Linux 2 (WSL2).
Open
Commit
Baixar o aplicativo do ChatGPT para desktop
Baixe o aplicativo do ChatGPT para desktop para Windows.
Depois, siga o início rápido para começar.
Para ver as opções de instalação e atualização para empresas, consulte Implantar o aplicativo para Windows.
Se preferir instalar pela linha de comando, execute:
winget install --id 9PLM9XGG6VKS -s msstoreSandbox nativo
O aplicativo do ChatGPT para desktop no Windows oferece suporte a um sandbox do Windows nativo quando o agente é executado no PowerShell e usa o ambiente isolado do Linux quando o agente é executado no Subsistema do Windows para Linux 2 (WSL2). Para aplicar as proteções do sandbox em qualquer um dos modos, selecione Pedir aprovação abaixo do campo de mensagem antes de enviar mensagens ao Codex.
Executar o Codex no modo Acesso completo significa que ele não fica restrito ao diretório do projeto e pode realizar ações destrutivas não intencionais, o que pode causar perda de dados. Mantenha os limites do sandbox e use regras para exceções específicas ou defina a política de aprovação como never para que o Codex tente resolver problemas sem pedir permissões elevadas, de acordo com sua configuração de aprovação e segurança.
Personalize seu ambiente de desenvolvimento
Editor preferencial
Escolha um aplicativo padrão para Abrir, como o Visual Studio, o VS Code ou outro editor. Você pode substituir essa escolha em cada projeto. Se já tiver escolhido outro aplicativo no menu Abrir para um projeto, a escolha específica desse projeto terá prioridade.
Terminal integrado
Você também pode escolher o terminal integrado padrão. Dependendo do que estiver instalado, as opções incluem:
- PowerShell
- Prompt de Comando
- Git Bash
- WSL
Essa alteração se aplica apenas a novas sessões de terminal. Se já houver um terminal integrado aberto, reinicie o aplicativo ou inicie uma nova conversa para que o novo terminal padrão seja exibido.
Subsistema do Windows para Linux (WSL)
Por padrão, o aplicativo do ChatGPT para desktop usa o agente do Codex nativo para Windows. Isso significa que o agente
executa comandos no PowerShell. O aplicativo ainda 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. Depois, digite \\wsl$\ na janela do Explorador de
Arquivos. Nela, escolha sua distribuição Linux e a pasta que você
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 por meio de
/mnt/<drive>/.... Essa configuração é mais confiável do que abrir os projetos
diretamente do sistema de arquivos do WSL.
Se quiser que o próprio agente seja executado no WSL2, abra Configurações, mude o agente de Windows nativo para WSL e reinicie o aplicativo. A alteração só entra em vigor após reiniciar o aplicativo. Seus projetos devem continuar disponíveis após o reinício.
O WSL1 teve suporte até o Codex 0.114. A partir do Codex 0.115, o sandbox do
Linux migrou para bubblewrap; por isso, o WSL1 não tem mais suporte.
O terminal integrado é configurado independentemente do agente. Consulte Personalize seu ambiente de desenvolvimento para ver as opções de terminal. Você pode manter o agente no WSL e usar o PowerShell no terminal ou usar o WSL para os dois, de acordo com seu fluxo de trabalho.
Ferramentas úteis para desenvolvimento
O Codex funciona melhor quando algumas ferramentas comuns de desenvolvimento já estão instaladas:
- Git: viabiliza o painel de revisão do aplicativo do ChatGPT para desktop e permite inspecionar ou reverter alterações.
- Node.js: uma ferramenta comum que o agente usa para realizar tarefas com mais eficiência.
- Python: uma ferramenta comum que o agente usa para realizar tarefas com mais eficiência.
- .NET SDK: útil para criar aplicativos nativos do Windows.
- GitHub CLI: viabiliza os recursos específicos do GitHub no aplicativo do ChatGPT para desktop.
Instale essas ferramentas com o gerenciador de pacotes padrão do Windows, o winget, colando isto
no terminal integrado ou
pedindo ao Codex que as 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.cliDepois de instalar a GitHub CLI, execute gh auth login para ativar os recursos do GitHub
no aplicativo.
Se você precisar de outra versão do Python ou do .NET, altere os IDs dos pacotes para a versão desejada.
Solução de problemas e perguntas frequentes
Executar comandos com permissões elevadas
Se precisar que o Codex execute comandos com permissões elevadas, inicie o próprio aplicativo do ChatGPT para desktop como administrador. Após a instalação, abra o menu Iniciar, localize o aplicativo e escolha 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 tiver usado ferramentas como Node.js ou npm no PowerShell, o
agente do Codex ou o terminal integrado poderá encontrar erros de 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 usar uma política de execução menos restritiva para que o PowerShell possa executá-los.
Um erro pode ter esta aparência:
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 RemoteSignedPara ver detalhes e outras opções, consulte o guia sobre políticas de execução da Microsoft antes de alterar a política.
Scripts do ambiente local no Windows
Se o seu ambiente local usar comandos multiplataforma,
como scripts do npm, você pode manter um único script de configuração ou
conjunto de ações compartilhado entre todas as plataformas.
Se precisar de um comportamento específico do Windows, crie scripts de configuração específicos do Windows ou ações específicas do Windows.
As ações são executadas no ambiente usado pelo terminal integrado. Consulte Personalize seu ambiente de desenvolvimento.
Os scripts de configuração local são executados no ambiente do agente: no WSL quando o agente usa o WSL e, caso contrário, no PowerShell.
Compartilhar configurações, autenticação e sessões com o WSL
O aplicativo para Windows e o Codex nativo no Windows usam o mesmo diretório inicial do Codex:
%USERPROFILE%\.codex.
Se você também executar a Codex CLI no WSL, a CLI usará o diretório inicial do Linux por padrão e, por isso, não compartilhará automaticamente as configurações, a autenticação em cache nem o histórico de sessões com o aplicativo para Windows.
Para compartilhá-los, use uma destas abordagens:
- Sincronize
~/.codexdo WSL com%USERPROFILE%\.codexno seu sistema de arquivos. - Aponte o WSL para o diretório inicial do Codex no Windows definindo
CODEX_HOME:
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codexPara aplicar essa configuração a todos os shells, adicione-a ao perfil do shell do WSL,
como ~/.bashrc ou ~/.zshrc.
Recursos do Git indisponíveis
Se o Git não estiver instalado nativamente no Windows, o aplicativo não poderá usar alguns
recursos. Instale-o com winget install Git.Git no PowerShell ou no cmd.exe.
O Git não é detectado em projetos abertos a partir de \\wsl$
Por enquanto, se quiser usar o agente nativo do Windows com um projeto também
acessível pelo WSL, a solução alternativa mais confiável é armazenar o projeto
na unidade nativa do Windows e acessá-lo pelo WSL por meio de /mnt/<drive>/....
Cmder não aparece na caixa de diálogo Abrir
Se 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 em Cmder e escolha Fixar em Iniciar. Depois,
reinicie o Codex ou o computador.