Kit Piloto AutomáticoV30 · Tropa do Choque
Começar
Materiais·12+ casos

Troubleshooting

Erros mais comuns + correção: pasta errada, dependência faltando, token vazado, MCP travado, lockfile platform-specific.

Os 12 erros mais comuns + correção em passos. Se o seu não está aqui, manda pro suporte@choqueounada.com com print + comando + sistema operacional.

01Claude não reconhece a estrutura do kitexpandir +

Sintoma

Você pede 'leia esta pasta' e o Claude responde algo genérico ou não vê os arquivos do V30.

Causa provável

Abriu o Claude na pasta errada (home, Desktop genérico, Downloads).

Correção

  1. Fecha o Claude.
  2. No terminal: cd até dentro de Kit-Piloto-Automatico-V30/.
  3. Abre o Claude DALI.
  4. No Desktop: confirma que o Project tem os arquivos do Tier 1 enviados (ver 22_CLAUDE_DESKTOP/knowledge-files.md).
02Comando /xxx não encontradoexpandir +

Sintoma

Você digita /preflight-acessos e Claude trata como mensagem comum.

Causa provável

Claude Desktop não suporta barra. Use só a palavra-chave.

Correção

  1. No Desktop, digita 'preflight' (sem barra).
  2. No Code, valida que está dentro da pasta certa rodando 'claude' lá.
03MCP travou (Composio, WhatsApp, Filesystem)expandir +

Sintoma

MCP server fica 'starting' ou retorna erro de auth.

Causa provável

Token expirou, .env mal configurado, ou versão desatualizada.

Correção

  1. Olha em 20_MCP_SETUP/<mcp>/README.md as instruções de re-auth.
  2. Confere que o token está válido no provider (Composio, Meta Business Manager, etc).
  3. Se persistir: claude mcp restart <nome-do-mcp>.
04Erro de plataforma no npm install (Vercel ou outro deploy)expandir +

Sintoma

EBADPLATFORM 'Unsupported platform for X: wanted win32, current linux'.

Causa provável

Alguém deu npm install --force em binary windows-only que foi gravado no lockfile.

Correção

  1. Remove o pacote windows-only do package.json.
  2. rm -rf node_modules package-lock.json.
  3. npm install limpo.
  4. Commit lockfile novo. Redeploy.
05.env não está sendo lidoexpandir +

Sintoma

Tokens aparecem como undefined em scripts.

Causa provável

Next.js auto-carrega .env.local; scripts standalone não.

Correção

  1. Pra scripts: usa dotenv-cli (npx dotenv -e .env.local -- node script.js).
  2. Verifica que .env.local existe (não confunde com .env).
  3. Variáveis client-side precisam de prefixo NEXT_PUBLIC_.
06Cliente Cowork não importa fluxo WhatsAppexpandir +

Sintoma

Você exportou o YAML mas o Cowork rejeita.

Causa provável

Formato YAML inválido (indentação mexida durante copy/paste) ou versão do schema desatualizada.

Correção

  1. Re-exporta direto do kit usando /whatsapp-system.
  2. Não edita YAML manualmente — use o editor do kit.
  3. Confirma versão do Cowork (12_WHATSAPP_STACK/README.md tem versão suportada).
07Meta Ads CLI não autenticaexpandir +

Sintoma

meta auth status retorna 'not authenticated' mesmo após config.

Causa provável

Token Meta no .profile do WSL não foi carregado na sessão atual.

Correção

  1. source ~/.profile (no WSL).
  2. Confirma echo $ACCESS_TOKEN retorna o valor.
  3. Se vazou em log: revoga token no Meta Business Manager + gera novo + atualiza .profile.
08Build local do site falha (Windows) — Tailwind oxideexpandir +

Sintoma

Cannot find module 'tailwindcss-oxide.win32-x64-msvc.node' / errno 4551.

Causa provável

Tailwind v4.3.0 tem incompatibilidade com Node 24 no Windows.

Correção

  1. Override no package.json: 'overrides': { '@tailwindcss/oxide': '4.1.13' }.
  2. rm -rf node_modules package-lock.json && npm install.
  3. Vercel (Linux) não tem esse problema — deploy continua funcionando.
09Wizard /instalar-kpa30 trava numa etapaexpandir +

Sintoma

Ele para de responder ou pula etapas.

Causa provável

Dependência faltando (Node, Git) ou permissão de pasta.

Correção

  1. Confere node --version (precisa ≥ 20) e git --version.
  2. No Windows: PowerShell como Admin pode resolver permissão.
  3. Roda etapas separadas: /mcp-setup, /preflight-acessos, /meta-cli-install.
10Primeira tarefa entrega algo genéricoexpandir +

Sintoma

/primeira-tarefa retorna template padrão sem contexto do seu negócio.

Causa provável

Setup de nicho não foi feito ou foi feito mal.

Correção

  1. Roda /setup-nicho novamente.
  2. Confirma que .claude/config.md existe e tem seu negócio descrito.
  3. Pede pro Claude: 'leia .claude/config.md e me confirme o que sabe sobre meu negócio'.
11Vazei um token em log/printexpandir +

Sintoma

Você compartilhou screenshot/log que tinha token.

Causa provável

Token aparece em output de comando que não foi sanitizado.

Correção

  1. Revoga IMEDIATAMENTE no provider (Meta, Google, OpenAI, Composio, etc).
  2. Gera token novo.
  3. Atualiza .env.local e dashboard Vercel (vercel env rm / vercel env add).
  4. Em logs: usa sed/grep pra mascarar antes de compartilhar.
12Output do agente está mal formatadoexpandir +

Sintoma

Listas viraram parágrafos, código sem destaque, headings ignorados.

Causa provável

Markdown não foi preservado no envio (Claude Desktop às vezes flata).

Correção

  1. Pede explicitamente: 'me devolve em markdown puro pra eu copiar/colar'.
  2. Se vai pra WhatsApp/email: pede 'me devolve em texto plano sem markdown'.
O chatbot resolve a maioria
Antes de mandar pro suporte, tenta no KPA Assistant — ele tem essa lista toda na memória + outras 50+ situações.