Resolução de problemas

Perguntas frequentes

Aparecem ficheiros no painel lateral que o Codex não editou

Se o seu projeto estiver num repositório Git, o painel de revisão apresenta automaticamente alterações com base no estado Git do projeto, incluindo alterações que o Codex não efetuou.

No painel de revisão, pode alternar entre alterações preparadas e alterações ainda não preparadas, bem como comparar o seu ramo com main.

Se pretender ver apenas as alterações da sua última interação com o Codex, mude o painel de diferenças para a vista Última interação.

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

Remover um projeto da barra lateral

Para remover um projeto da barra lateral, passe o cursor sobre o nome do projeto, selecione os três pontos e escolha Remover. Para o restaurar, volte a adicionar o projeto através do botão Adicionar novo projeto junto a Conversas ou utilizando

Cmd+O.

Encontrar conversas arquivadas

Pode encontrar as conversas arquivadas nas Definições. Quando desarquiva uma conversa, esta reaparece na localização original na barra lateral.

Uma conversa do Work não aparece noutro dispositivo

• Confirme que tem sessão iniciada com o ChatGPT na mesma conta e no mesmo espaço de trabalho em cada dispositivo.
• Peça ao proprietário do espaço de trabalho que verifique se o Work Cloud e Permitir acesso ao computador local estão ativados. Se enforce_residency estiver ativado em qualquer política da nuvem, Permitir acesso ao computador local fica desativado tanto para o Work como para os dots. Esta salvaguarda não configura a residência dos dados do espaço de trabalho nem, por si só, desativa o Work Cloud ou os dots.
• Verifique quando a tarefa foi criada. A sincronização aplica-se a novas tarefas criadas após a sua ativação. As tarefas existentes, incluindo as tarefas em projetos, não são migradas e mantêm o seu comportamento original: apenas local ou na nuvem sem ficheiros locais.

Para as empresas, o seletor Local/Nuvem na aplicação e a sua predefinição mantêm-se inalterados no lançamento. Uma determinada posição do seletor ou um modo predefinido não confirma, por si só, se uma conversa pode ser sincronizada. Ao procurar uma conversa do Work, considere o histórico do Codex separadamente. Consulte Acesso ao computador local para o Work Cloud e os dots para obter instruções de configuração e as Perguntas frequentes para administradores do Work para esclarecer dúvidas comuns.

Uma tarefa sincronizada não consegue utilizar os ficheiros ou as ferramentas do computador

Mantenha o computador online e ligado. Se estiver indisponível quando se iniciar um novo turno, uma tarefa sincronizada elegível pode continuar num contentor na nuvem sem acesso aos ficheiros ou às ferramentas do computador. Um turno em execução não é transferido automaticamente do computador para a nuvem.

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

Desativar o acesso ao computador local com o Work Cloud interrompe os turnos em execução. Se ainda tiver acesso ao Work, envie uma nova mensagem para iniciar outro turno. Numa conversa existente na nuvem, esse turno utiliza automaticamente o Work Cloud sem acesso a ficheiros locais.

Faltam atualizações automáticas das políticas

Utilize a API de políticas para gerir as definições Global. Para gerir as definições Local ou Codex Cloud, utilize a interface do Agent Security. Os fluxos de trabalho existentes da API Global continuam disponíveis após a migração. Teste os seus scripts e as integrações com o Terraform e confirme que as atribuições e a ordenação das políticas se mantêm inalteradas.

Apenas algumas conversas aparecem na barra lateral

A barra lateral permite filtrar conversas com base no estado de um projeto. Se estiverem a faltar conversas, selecione o ícone de filtro junto a Conversas e, em seguida, selecione Cronológica. Se continuar sem ver a conversa, abra as Definições e consulte Conversas arquivadas.

O código não é executado numa worktree

As worktrees são criadas num diretório diferente e herdam, por predefinição, os ficheiros registados no Git. Consoante a forma como gere as dependências e as ferramentas do seu projeto, poderá ter de executar scripts de configuração na sua worktree utilizando um ambiente local ou copiar ficheiros de configuração ignorados com .worktreeinclude. Também pode aplicar as alterações ao seu projeto local habitual. Consulte a documentação sobre worktrees para saber mais.

A aplicação não deteta o ambiente local partilhado por um colega de equipa

A configuração do ambiente local tem de estar dentro da pasta .codex na raiz do projeto. Se estiver a trabalhar num monorepo com mais do que um projeto, certifique-se de que abre o projeto no diretório que contém a pasta .codex.

O Codex pede acesso ao Apple Music

Consoante a tarefa, o Codex poderá precisar de navegar no sistema de ficheiros. Determinados diretórios no macOS, incluindo Música, Descargas ou Secretária, requerem aprovação adicional do utilizador. Se o Codex precisar de ler o seu diretório pessoal, o macOS solicita-lhe que aprove o acesso a essas pastas.

As tarefas agendadas criam muitas worktrees

Tarefas agendadas frequentes podem criar muitas worktrees ao longo do tempo. Arquive as execuções agendadas de que já não necessita e evite afixar execuções, a menos que pretenda manter as respetivas worktrees.

Recuperar um pedido após selecionar o destino errado

Se iniciou acidentalmente uma conversa com o destino errado (Local, Worktree ou Cloud), pode cancelar a execução atual e recuperar o pedido anterior premindo a tecla de seta para cima no editor de mensagens.

Uma funcionalidade opera no Codex CLI, mas não na aplicação ChatGPT para computador

A aplicação ChatGPT para computador e o Codex CLI podem incluir versões diferentes do Codex, pelo que as funcionalidades podem chegar a uma interface antes da outra. As funcionalidades experimentais também podem ser disponibilizadas primeiro no Codex CLI.

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

codex --version

Para obter a versão do Codex incluída na aplicação ChatGPT para computador, utilize o caminho preservado do pacote de compatibilidade Codex.app:

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

Comentários e registos

Introduza / no editor de mensagens para enviar comentários à equipa. Se acionar o envio de comentários numa conversa existente, pode optar por partilhar a sessão existente juntamente com os seus comentários. Depois de enviar os comentários, receberá um ID de sessão que poderá partilhar com a equipa.

Para comunicar um problema:

1. Procure problemas existentes no repositório GitHub do Codex.
2. Abra um novo problema no GitHub

Estão disponíveis mais registos nas seguintes localizações:

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

Se partilhar registos, reveja-os primeiro para confirmar que não contêm informações confidenciais.

Estados bloqueados e padrões de recuperação

Se uma conversa parecer bloqueada:

1. Verifique se o Codex está a aguardar uma aprovação.
2. Abra o terminal e execute um comando básico, como git status.
3. Inicie uma nova conversa com um pedido menor e mais específico.

Se cancelar por engano a criação da worktree e perder o seu pedido, prima a tecla de seta para cima no editor de mensagens para o recuperar.

Problemas do terminal

O terminal parece bloqueado

1. Feche o painel do terminal.
2. Volte a abri-lo com Ctrl+`.
3. Volte a executar um comando básico, como pwd ou git status.

Se os comandos se comportarem de forma diferente da esperada, verifique primeiro o diretório atual e o ramo no terminal.

Se continuar bloqueado, aguarde até que as conversas ativas estejam concluídas e reinicie a aplicação.

Os tipos de letra não são apresentados corretamente

O Codex utiliza o mesmo tipo de letra no painel de revisão, no terminal integrado e em qualquer outro código apresentado na aplicação. Pode configurar o tipo de letra no painel Definições, na opção Tipo de letra do código.

Um ambiente permite o acesso à rede, mas a ação está bloqueada

Verifique a prioridade das políticas antes de comparar definições individuais. Uma política de prioridade superior prevalece sobre uma política de prioridade inferior, mesmo que esta seja mais específica. Dentro de uma política, as substituições de ambiente específicas de um sistema operativo têm prioridade sobre as substituições de ambiente para todos os sistemas operativos, seguindo-se Global.

Alguns requisitos de rede têm regras de combinação específicas de cada campo e limites do ambiente de execução. As portas de escuta HTTP/SOCKS geridas e os serviços de escuta de proxy em endereços que não sejam de loopback não são suportados pelo ambiente de execução na nuvem; o suporte de regras de sockets depende do percurso de execução. O comportamento de combinação na execução local é distinto.

Compare as políticas efetivas e teste as ações que devem ser permitidas e bloqueadas. Consulte Configuração gerida para conhecer os casos em detalhe. Não flexibilize a configuração base global para contornar um teste falhado.