Solução de problemas

Perguntas frequentes

O painel lateral mostra arquivos que o Codex não editou

Se o projeto estiver em um repositório Git, o painel de revisão mostrará automaticamente as alterações com base no estado do projeto no Git, inclusive as que o Codex não fez.

No painel de revisão, você pode alternar entre as alterações que já estão na área de staging e as que ainda não estão, além de comparar sua branch com a main.

Para ver apenas as alterações do último turno do Codex, selecione a visualização Último turno no painel de diferenças.

Saiba mais sobre como usar o painel de revisão.

Como remover um projeto da barra lateral

Na barra lateral, passe o ponteiro sobre o nome do projeto, selecione o menu de três pontos e escolha Remover. Para restaurar o projeto, adicione-o novamente usando o botão Adicionar novo projeto ao lado de Chats ou o atalho

Cmd+O.

Como encontrar chats arquivados

Você encontra os chats arquivados em Configurações. Quando você desarquiva um chat, ele volta ao lugar que ocupava na barra lateral.

Uma conversa do modo Work não aparece em outro dispositivo

• Em cada dispositivo, entre no ChatGPT com a mesma conta, acesse o mesmo espaço de trabalho e procure a conversa no histórico do modo Work. O Codex tem um histórico separado.
• Peça ao proprietário do espaço de trabalho para verificar se o Work Cloud e a opção Permitir acesso ao computador local estão ativados nas permissões do espaço de trabalho. Uma política de nuvem com enforce_residency ativado bloqueia o acesso ao computador local.
• Se a tarefa foi criada antes da ativação do acesso ao computador local, selecione Nuvem no editor do aplicativo para desktop e inicie uma nova tarefa no modo Work.

Uma tarefa sincronizada não consegue usar os arquivos ou as ferramentas do computador

Abra o aplicativo do ChatGPT para desktop no computador onde estão os arquivos, entre no mesmo espaço de trabalho e mantenha o computador online e conectado. Se você iniciou um turno enquanto o computador estava offline, o turno pode estar em execução em um contêiner na nuvem sem acesso a esses arquivos.

Um turno foi interrompido após a desativação do acesso ao computador local com o Work Cloud

Se você ainda tiver acesso ao modo Work, envie uma nova mensagem na conversa que já está na nuvem. O novo turno pode usar o Work Cloud, mas não tem acesso aos arquivos locais.

As atualizações automáticas de políticas não aparecem

Use a API de políticas para gerenciar as configurações do escopo Global. Para gerenciar as configurações dos escopos Local ou Codex Cloud, use a interface de segurança de agentes. Os fluxos de trabalho existentes que usam a API para o escopo Global continuam disponíveis após a migração. Teste seus scripts e integrações com o Terraform e confirme que as políticas continuam atribuídas da mesma forma e na mesma ordem.

Apenas alguns chats aparecem na barra lateral

A barra lateral permite filtrar os chats pelo estado do projeto. Se algum chat não aparecer, selecione o ícone de filtro ao lado de Chats e escolha Ordem cronológica. Se ainda não encontrar o chat, abra Configurações e verifique Chats arquivados.

O código não é executado em uma árvore de trabalho

As árvores de trabalho são criadas em outro diretório e, por padrão, herdam os arquivos incluídos nos commits do Git. Dependendo de como você gerencia as dependências e ferramentas do projeto, talvez seja necessário executar scripts de configuração na árvore de trabalho usando um ambiente local ou copiar arquivos de configuração ignorados pelo Git com .worktreeinclude. Você também pode fazer checkout das alterações no diretório local que costuma usar para o projeto. Saiba mais na documentação sobre árvores de trabalho.

O aplicativo não reconhece o ambiente local compartilhado por alguém da equipe

A configuração do ambiente local precisa estar na pasta .codex, na raiz do projeto. Se você trabalha em um monorepo com vários projetos, abra o projeto no diretório que contém a pasta .codex.

O Codex pede acesso ao Apple Music

Dependendo da tarefa, o Codex pode precisar navegar pelo sistema de arquivos. Alguns diretórios do macOS, como Música, Downloads e Mesa, exigem uma aprovação adicional do usuário. Se o Codex precisar ler seu diretório pessoal, o macOS pedirá que você autorize o acesso a essas pastas.

As tarefas agendadas criam muitas árvores de trabalho

Tarefas agendadas que são executadas com frequência podem criar muitas árvores de trabalho ao longo do tempo. Arquive as execuções agendadas de que você não precisa mais e só fixe as execuções cujas árvores de trabalho deseja manter.

Como recuperar um prompt após selecionar o destino errado

Se você iniciou um chat no destino errado (Local, Árvore de trabalho ou Nuvem) por engano, cancele a execução atual e pressione a tecla de seta para cima no editor para recuperar o prompt anterior.

A opção Aprovar por mim não aparece ou está desativada

Para usar a revisão automática, selecione Aprovar por mim no controle de permissões abaixo do editor. Se esse modo não aparecer ou estiver desativado:

1. Atualize o aplicativo para desktop e verifique o menu de permissões no chat em que deseja usar a revisão automática. As opções disponíveis podem variar entre os ambientes locais e os de nuvem.
2. Se você executa o Codex localmente, verifique se a configuração efetiva inclui a definição explícita features.guardian_approval = false. Confira também o perfil de permissões, a política de aprovação e o responsável pela revisão das aprovações definidos na configuração. Para entender a ordem de precedência, consulte os fundamentos da configuração. A configuração local não controla um ambiente de execução gerenciado na nuvem.
3. Se o modo estiver desativado ou não aparecer em um espaço de trabalho gerenciado, peça ao administrador para verificar quais perfis de permissões, modos de sandbox, políticas de aprovação e responsáveis pela revisão das aprovações são permitidos. Uma política da organização ou do dispositivo pode restringir essas opções, e as configurações locais não podem se sobrepor a ela.

Se o modo continuar indisponível quando deveria estar disponível, informe a versão do aplicativo, o sistema operacional e o ambiente de execução no seu feedback. Indique também se a opção não aparece ou se está desativada.

Um recurso funciona na CLI do Codex, mas não no aplicativo do ChatGPT para desktop

O aplicativo do ChatGPT para desktop e a CLI do Codex podem incluir versões diferentes do Codex. Por isso, um recurso pode chegar a um deles antes de chegar ao outro.

Para verificar a versão da CLI do Codex no seu sistema, execute:

codex --version

Para verificar a versão do Codex incluída no aplicativo do ChatGPT para desktop, use o caminho do pacote Codex.app, mantido para fins de compatibilidade:

/Applications/Codex.app/Contents/Resources/codex --version

Feedback e logs

Digite / no campo de mensagem para enviar feedback à equipe. Se você iniciar o envio de feedback em um chat existente, poderá compartilhar a sessão junto com seus comentários. Após o envio, você receberá um ID de sessão que poderá compartilhar com a equipe.

Para relatar um problema:

1. Procure issues existentes no repositório do Codex no GitHub.
2. Abra uma nova issue do GitHub

Você encontra mais logs nos seguintes locais:

• Logs do aplicativo (macOS): ~/Library/Logs/com.openai.codex/YYYY/MM/DD
• Transcrições das sessões: $CODEX_HOME/sessions (padrão: ~/.codex/sessions)
• Sessões arquivadas: $CODEX_HOME/archived_sessions (padrão: ~/.codex/archived_sessions)

Antes de compartilhar os logs, revise o conteúdo para confirmar que não há informações sensíveis.

Como retomar um chat travado

Se um chat parecer travado:

1. Verifique se o Codex está aguardando uma aprovação.
2. Abra o terminal e execute um comando básico, como git status.
3. Inicie um novo chat com um prompt mais curto e específico.

Se você cancelar por engano a criação de uma árvore de trabalho e perder o prompt, pressione a tecla de seta para cima no editor para recuperá-lo.

Problemas com o terminal

O terminal parece travado

1. Feche o painel do terminal.
2. Abra-o novamente com Ctrl+`.
3. Execute novamente um comando básico, como pwd ou git status.

Se os comandos não funcionarem como esperado, verifique primeiro o diretório e a branch atuais no terminal.

Se o terminal continuar travado, aguarde a conclusão dos chats ativos e reinicie o aplicativo.

As fontes não são exibidas corretamente

O Codex usa a mesma fonte no painel de revisão, no terminal integrado e em qualquer outro código exibido no aplicativo. No painel Configurações, você pode alterar a fonte em Fonte do código.

O ambiente permite acesso à rede, mas a ação é bloqueada

Verifique a prioridade das políticas antes de comparar configurações individuais. A política de maior prioridade prevalece mesmo que a de menor prioridade seja mais específica. Dentro de uma mesma política, as substituições de configuração do ambiente específicas de um sistema operacional têm prioridade sobre as que se aplicam a todos os sistemas operacionais. As configurações do escopo Global têm a menor prioridade.

Alguns requisitos de rede têm regras de mesclagem específicas para cada campo e limites que dependem do ambiente de execução. O ambiente de execução na nuvem não oferece suporte a portas de escuta HTTP/SOCKS gerenciadas nem a proxies que escutam em endereços fora da interface de loopback. O suporte a regras de socket depende do caminho de execução. A execução local segue regras de mesclagem próprias.

Compare as políticas efetivas e teste tanto as ações que devem ser permitidas quanto as que devem ser bloqueadas. Consulte os casos detalhados em Configuração gerenciada. Se um teste falhar, não torne a configuração global de base mais permissiva para contornar a falha.