Troubleshooting

Problemas comuns e como resolver. Se algo nao funciona, provavelmente esta aqui.

Essa pagina lista os problemas mais frequentes que aparecem ao configurar ou usar o Nomics Hub. Cada um tem a causa provavel e a solucao direta. Se o seu problema nao estiver aqui, pergunte ao Prometheus — ele conhece o sistema inteiro.

Primeira coisa a tentar

Antes de qualquer debug, rode bash squads/smoke-test.sh no terminal. Esse script verifica os 8 squads e aponta exatamente o que esta falhando.

claude: command not foundInstalacao

Causa

Claude Code nao esta instalado globalmente

Solucao

npm install -g @anthropic-ai/claude-code

$npm install -g @anthropic-ai/claude-code

brew: command not foundInstalacao

Causa

Homebrew nao esta instalado

Solucao

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

yt-dlp: command not foundInstalacao

Causa

yt-dlp nao esta no PATH do sistema

Solucao

export PATH="$HOME/Library/Python/3.9/bin:$PATH" (adicione ao ~/.zshrc)

MCP nao conecta (meta-ads)MCP

Causa

Token de acesso expirado ou venv nao existe

Solucao

Renove o token em developers.facebook.com/tools/explorer/ e atualize no .env

$Renove o token em developers.facebook.com/tools/explorer/ e atualize no .env

MCP nao conecta (n8n)MCP

Causa

Variavel MCP_MODE nao definida no settings.json

Solucao

Adicione "MCP_MODE": "stdio" nas env vars do n8n-mcp no settings.json

$Adicione "MCP_MODE": "stdio" nas env vars do n8n-mcp no settings.json

MCP nao conecta (instagram)MCP

Causa

Venv nao criado ou requirements nao instalados

Solucao

cd tools/instagram-mcp-server && python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt

$cd tools/instagram-mcp-server && python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt

Squad nao respondeSquad

Causa

Arquivo config.yaml com erro de sintaxe ou path incorreto

Solucao

bash squads/smoke-test.sh (identifica qual squad falhou e por que)

Modelo errado sendo usadoClaude Code

Causa

O hook de tarefa sugere um modelo diferente do ativo

Solucao

/model opus (para estrategia/dev) ou /model sonnet (para copy)

Contexto nao carregadoContexto

Causa

Path do expert ou acao incorreto, ou arquivo nao existe

Solucao

Verifique se o arquivo existe em projetos/[Expert]/[expert]-context.md com ls

$Verifique se o arquivo existe em projetos/[Expert]/[expert]-context.md com ls

Permission denied ao executar scriptSistema

Causa

Arquivo nao tem permissao de execucao

Solucao

chmod +x [caminho-do-script]

$chmod +x [caminho-do-script]

Fonts nao carregam na LPDeploy

Causa

Caminho incorreto para arquivos WOFF2 no CSS

Solucao

Verifique se as fonts estao em public/fonts/ e os paths no CSS usam /fonts/[arquivo].woff2

$Verifique se as fonts estao em public/fonts/ e os paths no CSS usam /fonts/[arquivo].woff2

Drive export erro de autenticacaoMCP

Causa

Arquivo credentials.json ausente ou token.json expirado

Solucao

Reconfigure OAuth: delete token.json e rode o script novamente para reautenticar

$Reconfigure OAuth: delete token.json e rode o script novamente para reautenticar

Vercel deploy falhaDeploy

Causa

CLI nao autenticada ou projeto nao linkado

Solucao

vercel login && vercel link (na pasta do deploy)

faster-whisper: ModuleNotFoundErrorInstalacao

Causa

Pacote nao instalado no Python global

Solucao

pip3 install faster-whisper (primeiro uso baixa modelo ~1.5GB)

Prometheus nao faz boot sequenceClaude Code

Causa

CLAUDE.md nao esta sendo lido (pasta .claude/ ausente ou corrompida)

Solucao

Verifique se .claude/CLAUDE.md existe e tem conteudo com cat .claude/CLAUDE.md | head -5

$Verifique se .claude/CLAUDE.md existe e tem conteudo com cat .claude/CLAUDE.md | head -5

Nao encontrou seu problema?

Abra o Claude Code e descreva o erro em portugues. O Prometheus consegue diagnosticar a maioria dos problemas lendo logs, verificando configs e sugerindo correcoes. Diga algo como: "Estou com esse erro: [cole o erro]".