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, clique nos 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 utilize

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.

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, por predefinição, herdam os ficheiros registados no Git. Dependendo da forma como gere as dependências e as ferramentas do seu projeto, poderá ter de executar scripts de configuração na worktree através de um ambiente local ou copiar ficheiros de configuração ignorados com .worktreeinclude. Em alternativa, pode obter as alterações no 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, valide 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.