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 ver | Como |
|---|---|
| Log no Mac | tail -f ~/Library/Logs/fleetly-coletor.log |
| Log no Linux | journalctl -u fleetly-coletor -f |
| Log no Windows | Get-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-porte 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.