Sistema
❓ Soluções ← Site
← Voltar ao início
NXT Lab de Criação · Setup

Manual do Lab

O Lab roda imagem, vídeo, carrossel e motion pelo terminal. Pra isso funcionar, instalamos 7 ferramentas-base — uma vez só. Escolha seu sistema ali em cima e siga os 8 passos.

Etapa 1/8

1. A base — o instalador de programas

Antes de instalar as ferramentas do Lab, você precisa de um gerenciador de pacotes: o "instalador de programas" que baixa e atualiza tudo por linha de comando. É a base de tudo que vem depois.

🍎 macOS Homebrew

No Mac usamos o Homebrew. Abra o Terminal (Cmd+Espaço → "Terminal") e cole:

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  • Ele pode pedir sua senha do Mac (a senha não aparece enquanto digita — é normal). Aperte Enter.
  • Ao final, ele pode mostrar 2 comandos "Next steps" pra adicionar o brew ao PATH — copie e cole esses comandos.
🍎 Só para Macs com chip Apple (M1/M2/M3/M4) Nesses Macs o Homebrew instala em /opt/homebrew e o terminal ainda não "enxerga" ele. Cole estas duas linhas (uma vez) pra registrar no PATH:
$ echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile $ eval "$(/opt/homebrew/bin/brew shellenv)"
Macs com chip Intel não precisam disso.

Confirme:

$ brew --version
✓ Resultado esperado: algo como Homebrew 4.x.x.

🪟 Windows Winget (já vem no Windows)

No Windows 10/11 o gerenciador winget já vem instalado. Abra o PowerShell (menu Iniciar → digite "PowerShell" → abra) e confirme:

> winget --version
  • Apareceu uma versão (ex.: v1.x)? Está pronto.
  • Se não, atualize o "Instalador de Aplicativo" pela Microsoft Store e tente de novo.
✓ Resultado esperado: aparece a versão do winget.
Dica de ouro: deixe o Claude fazer Em vez de digitar, cole cada comando no Claude Code e peça "instala isso e confirma a versão". Ele executa e te avisa se deu certo.

2. Node + npm — o motor

O Node.js roda a maioria das ferramentas do Lab (e todos os comandos npx). O npm vem junto. Instale sempre a versão LTS (estável).

$ brew install node

Sem Homebrew? Baixe o instalador LTS (.pkg) em nodejs.org e clique até o fim.

> winget install OpenJS.NodeJS.LTS
  • Sem winget? Baixe o instalador LTS (.msi) em nodejs.org e avance com as opções padrão.
  • Feche e reabra o PowerShell ao terminar.

Confirme (cada linha deve mostrar um número):

$ node -v $ npm -v
✓ Resultado esperado: v22.x.x (Node) e 10.x.x (npm).

3. Git — baixar e versionar

O Git baixa projetos e mantém histórico de versões. Várias ferramentas do Lab usam ele por baixo.

$ brew install git

Alternativa: xcode-select --install (instala as ferramentas de linha de comando da Apple, que já incluem o Git).

> winget install Git.Git

Sem winget? Baixe o Git for Windows em git-scm.com e avance com as opções padrão.

Confirme:

$ git --version
✓ Resultado esperado: git version 2.x.x.

4. Python — os scripts de geração

Parte das skills do Lab (render de PDF, desdobramento de social, coleta) roda em Python 3. Junto vem o pip.

$ brew install python

No Mac, o comando costuma ser python3 e pip3.

> winget install Python.Python.3.12
  • Se preferir o instalador de python.org: na primeira tela, marque "Add Python to PATH" antes de instalar.
  • Feche e reabra o PowerShell.

Confirme:

$ python3 --version $ python3 -m pip --version
✓ Resultado esperado: Python 3.x.x e a versão do pip. (No Windows pode ser python --version; e pip3 --version também funciona.)

5. Playwright — automação de navegador

O Playwright controla um navegador automaticamente — é o que permite ao Lab renderizar artes em HTML, capturar telas e gerar PDFs. Depende do Node (Passo 2). O comando é o mesmo nos dois sistemas:

Instale o Playwright globalmente e depois baixe os navegadores que ele usa:

$ npm install -g playwright $ playwright install

Confirme a versão:

$ playwright --version
✓ Resultado esperado: aparece algo como Version 1.x.x e o playwright install baixa o Chromium sem erro.

Prefere a versão em Python? pip3 install playwright e depois playwright install.

Por que o Lab precisa É com o Playwright que o Claude "enxerga e age" em páginas — essencial pro render de artes e capturas.

6. Higgsfield — imagem & vídeo por IA

O Higgsfield é o motor visual do Lab: gera imagens (Nano Banana) e vídeos (Seedance) pelo terminal. Você instala a CLI e faz login uma vez. Os comandos são iguais nos dois sistemas.

Requisito: plano Higgsfield Plus ou superior Pra gerar imagens, sua conta Higgsfield precisa estar no plano Plus (ou acima). No plano gratuito o login até funciona, mas a geração fica bloqueada. Garanta o plano antes de começar.

Instale a CLI do Higgsfield via npm (precisa do Node — Passo 2):

$ npm install -g @higgsfield/cli

Faça login (abre o navegador pra autorizar):

$ higgsfield auth login

Confirme que conectou e veja os modelos:

$ higgsfield auth whoami $ higgsfield model list

Teste gerando uma imagem (o Lab faz isso por você, mas dá pra rodar direto):

$ higgsfield generate create nano_banana_2 --prompt "product shot cinematográfico" --wait
✓ Resultado esperado: o whoami mostra seu usuário e o generate retorna um link da imagem.
Atenção aos créditos A geração pelo terminal consome créditos da sua conta Higgsfield. O ilimitado fica no app web.

7. Remotion — render de vídeo & motion

O Remotion cria vídeo a partir de código — é o que a skill nxt-motion usa pra montar Reels, legendas animadas e motion graphics. Depende do Node (Passo 2). Comandos iguais nos dois sistemas.

Instale a CLI do Remotion

$ npm install -g @remotion/cli

Confirme a versão:

$ remotion versions
✓ Resultado esperado: aparece a versão (ex.: 4.x.x).

Criar um projeto de vídeo

$ npx create-video@latest

Renderizar (dentro da pasta do projeto)

$ npx remotion render
✓ Resultado esperado: cria a pasta do projeto e gera um arquivo .mp4.
Não precisa decorar Na prática você só chama /nxt-motion no Claude Code — ele cuida do Remotion por baixo.

8. Claude Desktop — skills & conexões

Por fim, o Claude Desktop: o app oficial da Anthropic onde você conversa com o Claude, ativa as skills do Lab e conecta ferramentas (MCP) — sem terminal.

Requisito: plano Claude Pro ou Max Pra rodar as skills no Desktop, sua conta precisa estar no plano Pro ou Max. Confirme antes de começar.

1 · Baixar e instalar

  • Abra claude.com/download e baixe a versão macOS (arquivo .dmg).
  • Abra o .dmg — aparece o ícone do Claude e a pasta Aplicativos.
  • Arraste o ícone do Claude para a pasta Aplicativos.
  • Abra claude.com/download e baixe a versão Windows (arquivo .exe).
  • Abra o .exe e avance no instalador com as opções padrão.

2 · Abrir e entrar na conta

  • Abra o app Claude (Mac: em Aplicativos; Windows: no menu Iniciar).
  • Na tela de boas-vindas, clique em Começar.
  • O navegador abre pra você fazer login — entre com a conta do seu plano Pro/Max e clique em Autorizar.
  • Volte pro app: ele conecta sozinho.

3 · Ativar as skills do Lab

  • No menu lateral, abra Habilidades (Skills) e clique no +.
  • Adicione: nxt-dna, nxt-images, nxt-carrossel, nxt-cinematic, nxt-motion, nxt-social.
  • Abra uma conversa nova e chame a skill que quiser.
✓ Tudo pronto! 🎉 Se você conversa com o Claude no app e as skills aparecem, está 100% operacional.
Próximo passo: criar Comece pelo DNA da marca (/nxt-dna) e siga pra imagens, carrosséis e vídeo. Veja tudo no Arsenal NXT →

❓ Soluções — erros comuns

Travou em algum passo? Quase tudo cai num destes. Acha o seu, aplica a correção e segue.

▸ "comando não encontrado" / "is not recognized"
Quase sempre é só fechar e reabrir o terminal (ele só "enxerga" o programa novo depois de reabrir). Se persistir, reinstale a ferramenta com as opções padrão.
▸ 🪟 Windows Python não é reconhecido
Você provavelmente instalou pelo python.org sem marcar "Add Python to PATH". Reinstale marcando essa caixa — ou instale via winget install Python.Python.3.12.
▸ 🪟 Windows Script bloqueado no PowerShell
Se um script não roda por política de execução, abra o PowerShell como Administrador e rode: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned, confirme com S, e tente de novo.
▸ 🍎 macOS "app não pode ser aberto" / desenvolvedor não verificado
Vá em Ajustes do Sistema → Privacidade e Segurança, role até a mensagem do app e clique em Abrir mesmo assim.
▸ 🍎 macOS "brew: command not found" após instalar o Homebrew
Faltou adicionar o brew ao PATH. Rode os 2 comandos "Next steps" que apareceram no fim da instalação (ou reabra o Terminal) e teste brew --version de novo.
▸ npx playwright install falha ou trava
Geralmente é rede. Confira a conexão e rode o comando de novo — ele continua de onde parou. Se persistir, rode npm install -D playwright antes.
▸ Higgsfield: login não conecta
Rode higgsfield auth login de novo e conclua a autorização no navegador. Confira com higgsfield auth whoami. Geração consumindo "crédito 0"? O ilimitado é só no app web.
▸ Claude Desktop: as skills não aparecem
Confira 3 coisas: (a) você está num plano Pro/Max; (b) o app está atualizado; (c) você adicionou as skills em Habilidades → +. Feche e reabra o app depois de adicionar.
📸 Não achou aqui? Manda um print pro Claude Tira um print da tela com o erro, cola direto no Claude (no chat do Claude Code) e peça pra resolver — ele lê o erro e te desbloqueia na hora.