Documentação do ChatGPT
Português
Contacto goolvyouyou@gmail.com

Aplicação ChatGPT para ambiente de trabalho no Windows

Aplicação ChatGPT para ambiente de trabalho no Windows com uma barra lateral de projetos, uma conversa ativa e um painel de revisão

Utilize a aplicação ChatGPT para ambiente de trabalho no Windows com suporte nativo para sandbox e PowerShell

A aplicação ChatGPT para ambiente de trabalho no Windows disponibiliza uma única interface para trabalhar em vários projetos, executar conversas em paralelo e rever resultados. A aplicação para Windows suporta fluxos de trabalho essenciais, como worktrees, tarefas agendadas, funcionalidades do Git, o browser integrado, pré-visualizações de ficheiros, plugins e skills. É executada nativamente no Windows através do PowerShell e da sandbox do Windows, ou pode configurá-la para ser executada no Windows Subsystem for Linux 2 (WSL2).

Transferir a aplicação ChatGPT para ambiente de trabalho

Transfira a aplicação ChatGPT para ambiente de trabalho para Windows.

Em seguida, siga o guia de início rápido para começar.

Para conhecer as opções de instalação e atualização empresariais, consulte Implementar a aplicação para Windows.

Se preferir efetuar a instalação através da linha de comandos, execute:

winget install --id 9PLM9XGG6VKS -s msstore

Sandbox nativa

A aplicação ChatGPT para ambiente de trabalho no Windows suporta uma sandbox do Windows nativa quando o agente é executado no PowerShell e utiliza a sandbox do Linux quando executa o agente no Windows Subsystem for Linux 2 (WSL2). Para aplicar as proteções da sandbox em qualquer um dos modos, selecione Pedir aprovação sob a caixa de composição antes de enviar mensagens ao Codex.

Personalizar de acordo com o seu ambiente de desenvolvimento

Editor preferido

Definições da aplicação ChatGPT para ambiente de trabalho que mostram a aplicação predefinida para Abrir em no Windows

Escolha uma aplicação predefinida para Abrir, como o Visual Studio, o VS Code ou outro editor. Pode substituir essa escolha em cada projeto. Se já tiver escolhido uma aplicação diferente no menu Abrir de um projeto, essa escolha específica do projeto tem precedência.

Terminal integrado

Definições da aplicação ChatGPT para ambiente de trabalho que mostram a seleção do terminal integrado no Windows

Também pode escolher o terminal integrado predefinido. Consoante o que tiver instalado, as opções incluem:

  • PowerShell
  • Linha de Comandos
  • Git Bash
  • WSL

Esta alteração aplica-se apenas a novas sessões do terminal. Se já tiver um terminal integrado aberto, reinicie a aplicação ou inicie uma nova conversa antes de esperar que o novo terminal predefinido seja apresentado.

Windows Subsystem for Linux (WSL)

Definições da aplicação ChatGPT para ambiente de trabalho que mostram o seletor de agentes com as opções nativa do Windows e WSL

Por predefinição, a aplicação ChatGPT para ambiente de trabalho utiliza o agente Codex nativo do Windows. Isto significa que o agente executa comandos no PowerShell. A aplicação pode continuar a trabalhar com projetos armazenados no Windows Subsystem for Linux 2 (WSL2), utilizando a CLI wsl quando necessário.

Se pretender adicionar um projeto a partir do sistema de ficheiros do WSL, clique em Adicionar novo projeto ou prima Ctrl+O e, em seguida, introduza \\wsl$\ na janela do Explorador de Ficheiros. A partir daí, escolha a sua distribuição Linux e a pasta que pretende abrir.

Se tenciona continuar a utilizar o agente nativo do Windows, é preferível armazenar os projetos no sistema de ficheiros do Windows e aceder-lhes a partir do WSL através de /mnt/<drive>/.... Esta configuração é mais fiável do que abrir projetos diretamente a partir do sistema de ficheiros do WSL.

Se pretender que o próprio agente seja executado no WSL2, abra as Definições, altere o agente de nativo do Windows para WSL e reinicie a aplicação. A alteração só entra em vigor após o reinício. Os seus projetos deverão permanecer no mesmo local após o reinício.

O WSL1 era suportado até ao Codex 0.114. A partir do Codex 0.115, a sandbox do Linux passou a utilizar bubblewrap, pelo que o WSL1 deixou de ser suportado.

O terminal integrado é configurado de forma independente do agente. Consulte Personalizar de acordo com o seu ambiente de desenvolvimento para conhecer as opções do terminal. Pode manter o agente no WSL e continuar a utilizar o PowerShell no terminal, ou utilizar o WSL em ambos, consoante o seu fluxo de trabalho.

Ferramentas úteis para programadores

O Codex funciona melhor quando algumas ferramentas comuns para programadores já estão instaladas:

  • Git: Suporta o painel de revisão na aplicação ChatGPT para ambiente de trabalho e permite-lhe inspecionar ou reverter alterações.
  • Node.js: Uma ferramenta comum que o agente utiliza para realizar tarefas de forma mais eficiente.
  • Python: Uma ferramenta comum que o agente utiliza para realizar tarefas de forma mais eficiente.
  • .NET SDK: Útil quando pretende criar aplicações nativas para Windows.
  • GitHub CLI: Suporta as funcionalidades específicas do GitHub na aplicação ChatGPT para ambiente de trabalho.

Instale-as com o gestor de pacotes predefinido do Windows winget, colando este conteúdo 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.cli

Depois de instalar a GitHub CLI, execute gh auth login para ativar as funcionalidades do GitHub na aplicação.

Se precisar de uma versão diferente do Python ou do .NET, altere os IDs dos pacotes para a versão pretendida.

Resolução de problemas e perguntas frequentes

Executar comandos com permissões elevadas

Se precisar que o Codex execute comandos com permissões elevadas, inicie a própria aplicação ChatGPT para ambiente de trabalho como administrador. Após a instalação, abra o menu Iniciar, localize a aplicação e escolha Executar como administrador. O agente Codex herda esse nível de permissões.

A política de execução do PowerShell bloqueia comandos

Se nunca tiver utilizado ferramentas como o Node.js ou npm no PowerShell, o agente Codex ou o terminal integrado poderá encontrar erros de política de execução.

Isto também pode acontecer se o Codex criar scripts do PowerShell para si. Nesse caso, poderá precisar de uma política de execução menos restritiva para que o PowerShell consiga executá-los.

O erro poderá ter um aspeto semelhante a este:

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

Uma correção comum consiste em definir a política de execução como RemoteSigned:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

Para obter detalhes e conhecer outras opções, consulte o guia da política de execução da Microsoft antes de alterar a política.

Scripts do ambiente local no Windows

Se o seu ambiente local utilizar comandos multiplataforma, como scripts npm, pode manter um único script de configuração partilhado ou conjunto de ações para 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 utilizado pelo terminal integrado. Consulte Personalizar de acordo com o seu ambiente de desenvolvimento.

Os scripts de configuração local são executados no ambiente do agente: WSL se o agente utilizar WSL e PowerShell nos restantes casos.

Partilhar a configuração, a autenticação e as sessões com o WSL

A aplicação para Windows utiliza o mesmo diretório principal do Codex que o Codex nativo no Windows: %USERPROFILE%\.codex.

Se também executar a Codex CLI no WSL, a CLI utiliza por predefinição o diretório principal do Linux, pelo que não partilha automaticamente a configuração, a autenticação em cache nem o histórico de sessões com a aplicação para Windows.

Para os partilhar, utilize uma destas abordagens:

  • Sincronize ~/.codex do WSL com %USERPROFILE%\.codex no seu sistema de ficheiros.
  • Faça o WSL apontar para o diretório principal do Codex no Windows, definindo CODEX_HOME:
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

Se pretender aplicar essa definição em todas as shells, adicione-a ao perfil da shell do WSL, como ~/.bashrc ou ~/.zshrc.

As funcionalidades do Git não estão disponíveis

Se não tiver o Git instalado nativamente no Windows, a aplicação não poderá utilizar algumas funcionalidades. Instale-o com winget install Git.Git a partir do PowerShell ou cmd.exe.

O Git não é detetado em projetos abertos a partir de \\wsl$

Por enquanto, se pretender utilizar o agente nativo do Windows com um projeto também acessível a partir do WSL, a solução mais fiável consiste em armazenar o projeto na unidade nativa do Windows e aceder-lhe no WSL através de /mnt/<drive>/....

Cmder não aparece na caixa de diálogo de abertura

Se Cmder estiver instalado, mas não aparecer na caixa de diálogo de abertura do Codex, adicione-o ao menu Iniciar do Windows: clique com o botão direito do rato em Cmder e escolha Adicionar a Iniciar e, em seguida, reinicie o Codex ou o computador.