Mover o ChatGPT e o Codex para outra unidade

Examinamos onde o ChatGPT e o Codex armazenam seus arquivos, colocamos o aplicativo e seus dados principais na unidade D e mantivemos cerca de 3.78GB de ambientes de execução ativos e outros arquivos na unidade C. Os arquivos a considerar pertencem a três grupos: aplicativo, dados armazenados e ambientes de execução.

Três grupos principais de arquivos

“Mover tudo relacionado ao ChatGPT para a unidade D” acabou abrangendo coisas demais. Os arquivos que executam o aplicativo são diferentes dos que armazenam conversas e configurações. A CLI, o Python, o Node e outros componentes chamados pelo aplicativo também estavam instalados em locais diferentes.

A especificação de variáveis de ambiente da OpenAI informa que CODEX_HOME define a raiz de configurações, autenticação, logs, sessões, skills e estado relacionado. O diretório já precisa existir. Essa configuração não move o aplicativo, o AppData do Windows e todos os ambientes de execução associados de uma só vez.

Preservar as sessões locais do Codex também é diferente de exportar todo o histórico de conversas na nuvem de uma conta do ChatGPT. Não tratamos esse backup como uma exportação completa de todos os dados do ChatGPT.

O que já estava na unidade D e o que mudou

Quando a investigação começou, os dados reais do diretório principal do Codex já estavam na unidade D. Na unidade C, %USERPROFILE%\.codex era uma junção que apontava para CodexHome na unidade D. Esta operação não transferiu inicialmente cerca de 65GB do diretório principal de C para D: os dados já estavam em D.

Uma junção transforma uma pasta em ponto de entrada para outra. A Microsoft documenta como ela pode apontar para outro volume local do mesmo computador. Ver arquivos por uma entrada na unidade C não significa necessariamente que exista uma segunda cópia armazenada ali. Explicação da Microsoft sobre junções

Essa distinção também importou ao investigar o navegador. O navegador integrado e a integração com o Chrome se recuperaram depois de especificarmos o caminho real do diretório principal, encerrarmos totalmente o aplicativo e o reiniciarmos. Porém, não medimos separadamente os efeitos do caminho e da reinicialização. Nosso caso de recuperação do navegador descreve o estado anterior e posterior e as verificações realizadas.

Backup de cerca de 68.6GB com os aplicativos parados

Antes de mudar a inicialização, fizemos um backup com o ChatGPT, o Codex e os componentes relacionados do Codex no IDE parados. Copiamos o diretório principal do Codex, a área real de armazenamento do pacote e a pasta OpenAI no local habitual de Local AppData. Mantivemos o backup na unidade C, e não na de destino.

A tabela mostra o tamanho lógico do backup feito neste computador. Cada GB corresponde a um bilhão de bytes. Os aproximadamente 68.6GB são o tamanho do backup mantido em C, não o espaço liberado em C.

Somente o usuário e SYSTEM podem acessar o local do backup. O backup não está anexado ao artigo porque contém arquivos de autenticação e conversas privadas.

Teste de CODEX_HOME e verificação da inicialização normal

Como o diretório principal já estava em D, primeiro testamos uma única inicialização com CODEX_HOME=D:\CodexHome configurado. Mantivemos a mesma versão, encerramos totalmente o aplicativo e abrimos uma nova instância.

A única alteração foi na variável CODEX_HOME do usuário. Não alteramos as variáveis do sistema nem PATH. No Windows, as variáveis têm escopos de processo, usuário e máquina; por isso verificamos o aplicativo iniciado normalmente, em vez de parar ao ver o valor em um único shell. Explicação da Microsoft sobre variáveis de ambiente

Comandos somente de leitura para verificar o armazenamento

O PowerShell abaixo apenas lê valores. A primeira linha mostra o valor usado pelo shell; a segunda e a terceira, as configurações armazenadas no Windows; a última, a entrada do diretório principal padrão. Um valor pode estar vazio: um resultado em branco, sozinho, não indica perda de dados.

$env:CODEX_HOME
[Environment]::GetEnvironmentVariable('CODEX_HOME', 'User')
[Environment]::GetEnvironmentVariable('CODEX_HOME', 'Machine')
Get-Item -LiteralPath (Join-Path $env:USERPROFILE '.codex') -Force |
  Select-Object FullName, Attributes, LinkType, Target

Não há comandos para mover ou excluir aqui. O teste começou com dados que já estavam em D, o que é diferente de apontar a configuração para uma pasta vazia. Antes de aplicar esse procedimento em outro computador, decida o que copiar, quais aplicativos parar e onde restauraria os dados.

Transferência do aplicativo com o recurso do Windows

Após verificar o diretório principal e recuperar o navegador, o operador selecionou “Mover” para o ChatGPT na lista de aplicativos do Windows e o transferiu para D. Os destinos foram WindowsApps e WpSystem, gerenciados pelo Windows. Explicação da Microsoft sobre locais de armazenamento de pacotes

Verificamos o evento de transferência bem-sucedida, a assinatura válida do executável em D (OpenAI OpCo) e o link em C. As pastas correspondentes dos dados do aplicativo também tinham os mesmos identificadores de dispositivo e de arquivo.

O local exibido, sozinho, não comprova uma transferência bem-sucedida nem armazenamento duplicado. Verificamos juntos os locais reais, os destinos dos links e as operações básicas. Não alteramos as entradas nem as permissões gerenciadas pelo Windows.

Por que cerca de 3.78GB ficaram em C

Mesmo após mover os componentes principais, dados ativos continuaram em C. A tabela resume as áreas relacionadas identificadas, sem contar duas vezes as entradas que apontam para D.

O total é o tamanho lógico das pastas identificadas. Não é uma contagem exaustiva de caches de atualização, pontos de restauração ou tudo que cada navegador e editor armazena em C.

Os ambientes mantidos em C funcionam sem cópias equivalentes em D porque o aplicativo usa os arquivos atuais em C. Excluí-los supondo que já foram migrados pode impedir o funcionamento da CLI ou do controle do navegador. A configuração final usa tanto C quanto D.

Também examinamos a variável oficial CODEX_INSTALL_DIR, mas ela altera o local do instalador da CLI independente. Não transfere todos os componentes de CLI e ambientes compartilhados gerenciados pelo aplicativo. Instalar outra CLI em D não comprova que os arquivos existentes em C deixaram de ser necessários.

Também examinamos o processo de atualização desta versão sem alterá-lo e testamos a substituição com pequenas pastas de teste. Em uma configuração, transformar a pasta atualizada em link para D fez com que o link fosse separado como versão antiga e uma nova pasta comum fosse criada em C. Isso verificou apenas a substituição de arquivos, não a migração do aplicativo real.

Decidimos não acrescentar locais não oficiais e verificações após cada atualização só para mover cerca de 3GB de ambientes. Ponderamos o benefício de colocar o aplicativo e seus dados principais em D em relação ao espaço ainda ocupado em C e mantivemos os componentes que funcionavam normalmente.

O que verificamos após a migração

Não paramos em “o aplicativo abre”. Comparamos os valores salvos atuais com o backup. Os itens verificados coincidiram, incluindo 2 chats fixados, 18 projetos fixados, 63 projetos locais, 43 entradas de ordenação de projetos e 58 associações entre chats e projetos. Comparamos os valores completos dos itens selecionados, não apenas suas quantidades.

No histórico e nos arquivos relacionados, todos os arquivos correspondentes do backup estavam presentes e legíveis: 459 em sessions, 39 em archived_sessions, 4 em attachments e 3 em automations. Houve 0 arquivos ausentes e 0 erros de leitura. Foi uma verificação de presença dos arquivos; não significa que recalculamos hashes de cada conversa ou do conteúdo completo de cada banco de dados.

A verificação do status de login da CLI terminou com sucesso. O navegador integrado leu uma página pública, clicou em um link e voltou. Também verificamos leitura e navegação em uma aba de teste do Chrome e depois a fechamos. Não coletamos conteúdo das abas privadas existentes para o artigo.

Verificamos uma reinicialização normal do aplicativo, mas não a continuidade após reiniciar o próprio PC ou uma futura atualização. Essas duas verificações ficaram para um momento conveniente para o usuário. Não fizemos outra reinicialização apenas para completar o artigo.

A configuração que mantivemos

Consideramos a migração concluída neste escopo: apontar diretamente para o diretório principal real em D, colocar o aplicativo e seus dados principais em D e manter os ambientes em C. O backup anterior de cerca de 68.6GB permanece em C; o usuário decidirá separadamente quando excluí-lo.

O essencial era entender o que fica em cada local, qual aplicativo usa os arquivos e o que é mantido para recuperação, em vez de zerar o uso de C. Em especial, no primeiro registro de uma unidade como armazenamento de aplicativos do Windows, o plano de parada precisa abranger os discos virtuais e projetos ativos dessa mesma unidade.

Ordem para fazer a mesma migração

1. Separe o que será movido em três grupos: o diretório principal do Codex, o aplicativo e seus dados principais, e os ambientes de execução, como a CLI. Confirme o local atual de cada um.
2. Pare não só o ChatGPT e o Codex, mas também os aplicativos que usam a unidade de destino (como os discos virtuais do Docker) e os projetos em andamento.
3. Com tudo parado, faça um backup e compare a quantidade e o tamanho dos arquivos. Nos arquivos importantes, como configurações e autenticação, compare também os hashes. Guarde o backup em uma unidade diferente da de destino.
4. Teste CODEX_HOME primeiro com uma única inicialização e confirme as operações básicas. Só depois defina a variável de ambiente do usuário.
5. Mova o aplicativo com a opção "Mover" do Windows. Não exclua a entrada (junção) que permanece na unidade C.
6. Não exclua os ambientes de execução que ficam na unidade C enquanto o aplicativo os estiver usando.
7. Não considere a migração concluída só porque o aplicativo abriu. Verifique os itens salvos, os arquivos de histórico e as operações no navegador. Confirme também após reiniciar o PC e após atualizar o aplicativo. Só então decida se exclui o backup.

Perguntas frequentes

Definir CODEX_HOME em D move para lá tudo relacionado ao ChatGPT?

Não. Ele define a raiz usada para armazenar o estado do Codex. Neste computador, o aplicativo foi movido separadamente, enquanto a CLI, os ambientes compartilhados e a extensão do VS Code permaneceram em C.

Posso excluir as pastas .codex ou do aplicativo que aparecem em C?

Neste caso, C contém entradas para D. Mesmo que pareçam ocupar espaço, não são necessariamente cópias independentes. Excluir uma entrada quebra a referência. Também mantivemos inalterados os links de gerenciamento criados pelo Windows.

Posso excluir imediatamente o backup anterior à migração?

Nós o mantivemos neste computador. O plano é continuar o trabalho necessário com a nova organização, verificar após um reinício ou atualização quando adequado e deixar o usuário decidir quando excluir o backup.

Preciso mover o aplicativo só para corrigir o navegador?

Neste caso, o navegador se recuperou antes de mover o aplicativo para D. Não há fundamento aqui para recomendar a transferência como etapa obrigatória de reparo.