Solução de problemas
A maioria dos problemas tem uma solução rápida. Se o seu não estiver aqui, mande um e-mail ao suporte com seu sistema operacional, a versão do PATerminal (Configurações → Atualizações) e o que você já tentou.
Escrito para o PATerminal v1.8.3
Instalação e abertura
- Windows: “O Windows protegeu o computador”
- Clique em Mais informações e depois em Executar assim mesmo. O SmartScreen alerta sobre apps novos; se quiser ter certeza, compare o SHA-256 com o do guia de instalação para Windows.
- O macOS pergunta antes de abrir
- Escolha Abrir. O app é assinado com um Developer ID e notarizado pela Apple.
O Git mostra um erro
Quando algo no seu computador impede o git de funcionar, o PATerminal mostra O Git não pode ser executado neste computador com a correção. Os casos mais comuns:
| Causa | Correção |
|---|---|
| macOS: licença do Xcode não aceita (muitas vezes logo depois de atualizar o Xcode) | sudo xcodebuild -license accept |
| macOS: Command Line Tools ausentes ou com problema | xcode-select --install |
| Git não instalado | Instale o Git (Windows: winget install Git.Git); o PATerminal o detecta automaticamente. |
| “Dubious ownership” em outra unidade ou compartilhamento de rede | git config --global --add safe.directory <path> — só para pastas em que você confia. |
| Windows: caminho longo demais | git config --global core.longpaths true |
Pull requests ou issues não carregam
Verifique se o gh está instalado e com login feito (gh auth status) e se o repositório tem um remoto do GitHub. Depois de corrigir, clique em Tentar de novo.
Uma sessão fica parada em “Executando”
- Algo nela ainda está gerando saída — um servidor de desenvolvimento, um watcher ou um spinner. Isso é saída real, então o status está correto.
- O Codex 0.154.0 ou posterior foi iniciado antes de o PATerminal salvar
tui.whimsy = false: reinicie essa sessão do Codex. Uma configuração explícita no nível do projeto ou na linha de comando pode sobrescrever isso. Veja Observação para quem usa o Codex.
Nenhuma notificação aparece
- Verifique se Configurações → Notificações está ativado.
- Permita as notificações do PATerminal nas configurações do sistema e confira o Foco / Não Perturbe.
- As notificações só são enviadas para sessões que você não está vendo.
Uma conversa não é retomada
- O agente pode ter encerrado antes de salvar a conversa. Abra-a pelo Histórico.
- Mover o Claude Code para uma pasta não relacionada requer o Claude Code v2.1.223 ou posterior.
- Opções que você passou só na linha de comando original não são reaplicadas.
Uma atualização falha
Se a atualização assinada não puder ser instalada, o PATerminal não é reiniciado e nada muda. Tente de novo mais tarde, ou baixe o instalador mais recente na página de download e instale por cima da versão atual — suas sessões e configurações são mantidas.
Onde ficam meus dados?
Sessões, grupos, notas, frases e configurações ficam salvos como arquivos locais no seu computador; as conversas dos agentes ficam nas pastas dos próprios agentes (por exemplo ~/.claude e ~/.codex). Nada é sincronizado com um servidor, e o PATerminal não tem telemetria.
Ainda com dúvidas?
Confira as perguntas frequentes ou mande um e-mail com seu sistema operacional, a versão do PATerminal e o que você já tentou. Respondemos a todas as mensagens.