Todas as páginas
  1. Primeiros passos
  2. Conectar máquinas
  3. Pastas: o que o prédio vê
  4. Visões
  5. Conversar com as sessões
  6. Aprovações e avisos
  7. Ferramentas do dia a dia
  8. Times de agentes
  9. Código e Git
  10. Prévia no celular
  11. No celular
  12. Uso do plano
  13. Codex
  14. Antigravity
  15. GitHub Copilot
  16. Prédios, pessoas e papéis
  17. Central de comando
  18. Enterprise: política, SSO e relatórios
  19. Sua conta
  20. Assinatura
  21. Atalhos de teclado
  22. Solução de problemas
Documentação

Solução de problemas

Comece pelo log do coletor: quase todo problema aparece lá com uma mensagem clara.

A máquina não aparece

O que verComo
Log no Mactail -f ~/Library/Logs/fleetly-coletor.log
Log no Linuxjournalctl -u fleetly-coletor -f
Log no WindowsGet-Content $env:USERPROFILE\.fleetly\collector\coletor.log -Wait
O Claude Code está logado?claude deve abrir com a sua conta
O Node do coletor~/.fleetly/node/bin/node -v (só existe se a máquina não tinha Node 20)
  • "Não consegui abrir …/login": a máquina não alcança a central. Confira a saída para a internet e o proxy da rede.
  • "Rode com o seu usuário, não como root": instale com o usuário que tem o Claude Code logado.
  • Mac, sessões de Documentos ou Mesa não aparecem: dê Acesso Total ao Disco ao Node do coletor (veja Conectar máquinas).
  • Mac, um agente aberto pelo Fleetly não lê o OneDrive, o iCloud ou o Dropbox ("Operation not permitted"): tudo o que o app do Fleetly abre herda as permissões de privacidade dele, mesmo que o VS Code tenha as suas. A conversa avisa com o motivo. No Mac, em Ajustes do Sistema → Privacidade e Segurança → Arquivos e Pastas (ou Acesso Total ao Disco), libere o Fleetly. Longe do Mac, uma sessão aberta no VS Code consegue fazer o mesmo. Para saber antes de sair de perto do Mac: em Configurações → Conversa, Permissões do Mac mostra as pastas que o Fleetly não lê, com Abrir os Ajustes do Mac; e o app do coletor confere sozinho: na primeira vez, o passo Pastas protegidas do Mac da janela de configurar mostra cada pasta, abre os Ajustes no Acesso Total ao Disco, marca ✓ quando você liga o Fleetly e tem Já liguei: reiniciar o Fleetly (o macOS só aplica depois de reiniciar); e toda vez que o app abre, se faltar alguma, ele avisa e põe Liberar pastas do Mac no menu da barra. Uma pasta que você não usa sai da conta com Não uso essa pasta. Longe do Mac não dá para liberar: o macOS só deixa quem está nele.

"A central recusou o token"

O token foi revogado, ou a máquina foi removida do prédio. Gere um comando novo em Configurações → Prédios → Máquinas → Adicionar máquina → Por comando e rode na máquina: ele troca o token e religa o serviço.

As aprovações não chegam ao painel

  • Confira se os hooks estão gravados: rode node ~/.fleetly/collector/fleetly-collector.mjs hooks.
  • No Codex, aprove os hooks do Fleetly: no VS Code, Revisar hooks → Permitir tudo; no terminal, /hooks.
  • Em Configurações → Avisos e aprovações, no modo Automático, o pedido só vem para o painel depois do tempo sem mexer no computador. Para testar, use Sempre aqui.
  • Se o log disser que a porta 4747 está em uso, reinstale com --hook-port e outra porta livre.
  • A sessão precisa estar dentro das pastas da máquina.

Uma sessão não aparece

  • Ela está fora das pastas que a máquina mostra (veja Configurações → Prédios → Máquinas).
  • Um filtro está escondendo a sessão: veja os filtros ligados no canto do palco, ou o número no botão Filtros.
  • Sessão do Codex: o Codex precisa estar logado no mesmo usuário que roda o coletor.

A sessão aberta no VS Code não fez o que eu pedi

Para uma sessão aberta no VS Code ou no terminal, a mensagem do painel chega como uma nota, e o agente decide o que fazer com ela. Para que o pedido valha como seu, use Assumir pelo Fleetly ou Continuar no app do Claude (veja Conversar com as sessões).

Essa entrega usa a caixa de entrada do Claude Code, um formato que a Anthropic não documenta e que pode mudar numa atualização. Se o envio falhar, a conversa mostra o erro.

A prévia não abre

  • "Nada respondendo em 127.0.0.1:<porta>": o servidor de desenvolvimento não está rodando, ou está em outra porta. Suba o app (por exemplo npm run dev) e tente de novo.
  • "Não respondeu como um site": a porta é de outro tipo de serviço, como um banco de dados.
  • "A porta é do próprio Fleetly": as portas do coletor nunca viram prévia.
  • "Esta prévia foi fechada": ela passou do tempo. Abra de novo pelo painel.
  • Abrir exige o papel de operador ou dono.

Não consigo responder nem mandar trabalho

O teste acabou ou a assinatura venceu há mais de 3 dias, e a conta está no Grátis: você vê os agentes e aprova os pedidos numa máquina, mas responder e mandar trabalho é do Pessoal. Assinar em Configurações → Assinatura libera na hora. Nada é apagado.

Não achou o que procurava? Escreva para admin@fleetly.tools.