Passo a passo completo para instalar tudo que você precisa. Do zero ao AIOX rodando. Simples assim.
Conceitos Básicos
Antes de Começar
O que é o Claude Code?
Pense no Claude Code como um assistente super inteligente que mora dentro do seu Terminal (aquela tela preta de computador). Você digita comandos e ele faz coisas pra você.
O que são os comandos / e * ?
Comando / = Abre um agente (um especialista). É como chamar uma pessoa pra te ajudar.
Exemplo: /dev = chama o desenvolvedor, /devops = chama o cara de infraestrutura.
Comando * = Usa uma skill (habilidade) do agente que você abriu. É como pedir pro especialista fazer algo específico.
Exemplo: dentro do /devops, você usa *environment-bootstrap = pede pro devops configurar tudo.
Regra de ouro: Primeiro você abre o agente com / , depois usa as skills dele com *
Parte 1
Instalação do Claude Code
1
Abrir o Terminal
Aperte Command + Espaço (abre a busca do Spotlight)
Digite Terminal
Clique no ícone do Terminal que aparecer
2
Verificar se tem Node.js
No Terminal, digite:
node --version
Se aparecer v18.x.x ou maior — pule para o Passo 4
Verificar: Feche o Terminal, abra de novo e digite node --version. Se aparecer v22.x.x, deu certo!
4
Instalar o Claude Code
No Terminal, digite:
npm install -g @anthropic-ai/claude-code
Aperte Enter e espere 1-2 minutos.
5
Abrir o Claude Code
No Terminal, digite:
claude
6
Fazer login
Vai aparecer opções na tela. Use as setas do teclado para escolher:
Plano Pro ou Max: escolha "Anthropic (login)" — abre o navegador — faça login com sua conta.
7
Pronto!
Digite qualquer coisa e aperte Enter para testar. Se respondeu, está funcionando!
1
Abrir o Terminal
Aperte Windows + R
Digite cmd e aperte Enter
Ou: busque "Prompt de Comando" na barra de pesquisa
2
Verificar se tem Node.js
No Terminal, digite:
node --version
Se aparecer v18.x.x ou maior — pule para o Passo 4
Se aparecer 'node' não é reconhecido — siga o Passo 3
3
Instalar o Node.js (só se precisar)
Abra o navegador e vá em nodejs.org
Clique no botão verde "LTS"
Vai baixar um arquivo tipo node-v22.x.x.msi
Dê duplo clique no arquivo baixado
Clique Next > Next > Accept > Next > Install
Clique Finish
Verificar: Feche o Terminal, abra de novo e digite node --version. Se aparecer v22.x.x, deu certo!
4
Instalar o Claude Code
No Terminal, digite:
npm install -g @anthropic-ai/claude-code
Aperte Enter e espere 1-2 minutos.
5
Abrir o Claude Code
claude
6
Fazer login
Escolha "Anthropic (login)" — abre o navegador — faça login.
7
Pronto!
Digite qualquer coisa e aperte Enter para testar.
1
Abrir o Terminal
Use o atalho Ctrl + Alt + T
2
Verificar se tem Node.js
node --version
Se aparecer v18.x.x ou maior — pule para o Passo 4
Verificar: Feche o Terminal, abra de novo e digite node --version.
4
Instalar o Claude Code
npm install -g @anthropic-ai/claude-code
Espere 1-2 minutos.
5
Abrir o Claude Code
claude
6
Fazer login
Escolha "Anthropic (login)" — abre o navegador — faça login.
7
Pronto!
Digite qualquer coisa e aperte Enter para testar.
Parte 2
Instalação do AIOX
Importante: Antes de começar, verifique se você está FORA do Claude Code. Se a tela mostrar o ícone do Claude, digite /exit e aperte Enter para sair.
1
Criar a pasta do projeto
Crie uma pasta no seu computador para o projeto (pode ser em qualquer lugar).
2
Abrir o Terminal nessa pasta
Mac/Linux: Clique com o botão direito na pasta > "Abrir Terminal aqui"
Windows: Abra a pasta no Explorador > clique na barra de endereço > digite cmd > Enter
3
Instalar o AIOX
Com o terminal aberto na pasta, digite:
npx aiox-core@latest install
4
Responder as perguntas
O instalador vai fazer perguntas. Responda assim:
Escolha o idioma > Enter
Selecione modo assistido > Enter
Selecione greenfield (projeto novo) > Enter
Enter
Enter novamente
Selecione o plano pro > Enter
Selecione login ou criar conta > Enter
Coloque seu email > Enter
Crie ou insira sua senha > Enter
Pronto! O AIOX está instalado.
Parte 3
Instalação do AIOXSquad Imersão
Baixar o repositório da imersão e configurar tudo no seu projeto.
Opção A: Via Terminal (recomendado)
1
Sair do Claude Code (se estiver dentro)
/exit
2
Instalar o GitHub CLI (se ainda não tem)
Mac:brew install gh
Windows: Baixe em cli.github.com
Linux:sudo apt install gh
3
Fazer login no GitHub CLI
gh auth login
Siga as instruções na tela (escolha GitHub.com > HTTPS > Login with browser).
4
Clonar o repositório
gh repo clone AIOXsquad/SEUGITHUB
Atenção: Troque SEUGITHUB pelo nome real do seu repositório.
5
Mover os arquivos para a raiz
Os arquivos do repositório clonado precisam estar na raiz da pasta onde você instalou o AIOX (junto com a pasta .aios-core/), não dentro de uma subpasta.
Opção B: Via Download ZIP
Acesse: https://github.com/AIOXsquad/SEUGITHUB
Clique no botão verde "Code" > "Download ZIP"
Extraia o ZIP
Copie todos os arquivos de dentro da pasta extraída para a raiz da pasta do seu projeto
Depois de ter os arquivos: Configurar
6
Abrir o Claude Code
claude
7
Ativar o agente DevOps
/devops
Aguarde carregar.
8
Pedir pra ele configurar tudo
*environment-bootstrap
Siga todos os passos que ele pedir. Quando perguntar o que instalar, escolha "install all".
Atenção: Troque SEUGITHUB pelo nome real do seu repositório.
11
Ativar o agente Master
/master
Aguarde carregar.
12
Instalar todos os comandos
Cole este prompt e aperte Enter:
Analise a pasta e faça a instalação de todos os comandos de agentes e squads, os com /. Exemplo, /dev, /devops
13
Sair e entrar de novo
Aguarde terminar. Depois:
/exit
Entre novamente:
claude
Pronto! Todos os comandos novos foram instalados. Agora você tem acesso a todos os agentes e squads.
Parte 4 — Palestra do Pedro
Diagnóstico + SOPs do Negócio
Contexto
Na palestra do Pedro, ele mostrou como usar o AIOX para fazer um diagnóstico completo do negócio e criar SOPs (Procedimentos Operacionais Padrão) — os processos que fazem seu negócio rodar no automático.
Etapa 1: Diagnóstico do Negócio
Abrir o agente "COO Orchestrator" (o Diretor de Operações virtual) para analisar e diagnosticar seu negócio.
1
Ativar o agente COO
Dentro do Claude Code, digite:
/aiox-workspace:coo-orchestrator
Aguarde carregar.
2
Preparar o ambiente
*bootstrap
O que acontece? Ele vai configurar o workspace, criar pastas e preparar tudo para o diagnóstico. Aguarde terminar.
3
Fazer o diagnóstico do negócio
*diagnose-business conta_magic
Atenção: Troque conta_magic pelo slug/nome do seu negócio.
O que acontece? Ele vai te fazer perguntas sobre o seu negócio (o que você vende, quem é seu cliente, como funciona, etc.). Responda com calma. No final, ele gera um relatório completo.
Etapa 2: Criar SOPs (Procedimentos)
Abrir o agente "SOP Chief" para criar os processos operacionais do negócio.
4
Ativar o agente de SOPs
/aiox-sop:sop-chief
Aguarde carregar.
5
Mapear o backlog de SOPs
*map-core-sop-backlog
O que acontece? Ele analisa o diagnóstico anterior e lista todos os procedimentos que seu negócio precisa (vendas, atendimento, onboarding, etc.).
6
Criar um SOP específico
*create nome-do-sop
Atenção: Troque nome-do-sop pelo slug do SOP que você quer criar (listado no passo anterior).
Exemplo: *create onboarding-cliente
O que acontece? Ele cria o documento completo do procedimento, com todos os passos, responsáveis e critérios de qualidade.
Parte 5 — Palestra do Alan
Squad Creator
Contexto
Na palestra do Alan, ele mostrou como usar o Squad Creator para criar times de agentes IA especializados em qualquer área. O Squad Creator pesquisa mentes reais (experts de verdade) e clona o jeito deles pensar e falar.
O que é um Squad?
Um Squad é um time de agentes IA, cada um especialista em algo:
Copywriting
Agentes baseados em Gary Halbert, David Ogilvy, Eugene Schwartz...
Tráfego
Agentes baseados em especialistas reais de mídia paga
Design
Agentes baseados em designers renomados
1
Chamar o Squad Creator
Pensa no Squad Creator como uma fábrica de times. Você pede e ele monta um time de robôs pra você. Dentro do Claude Code, digite:
/squad-creator
Espera ele carregar. Quando aparecer a mensagem de boas-vindas, tá pronto.
2
Transformar sua SOP em Squad
Lembra a SOP que você criou no Dia 1? Agora vamos transformar ela num time de robôs que executa aquele processo sozinho. O comando precisa de duas coisas: o nome do seu negócio e onde estão as SOPs:
Troquenome-do-negocio pelo slug do seu negócio (ex: minha-empresa). O que acontece? Ele lê suas SOPs e cria os agentes, as tarefas e as regras de qualidade — tudo automático.
3
Planejar um squad do zero (alternativa)
Se você não tem SOP ainda, pode pedir pro Squad Creator inventar o time pra você. Ele pesquisa as melhores mentes reais naquela área e monta o plano:
*plan-squad editais --purpose "Automatizar gestão de editais"
Troqueeditais pela área que você quer (ex: copywriting, vendas, atendimento). Ele mostra o plano e você aprova antes de criar.
4
Atualizar o registro
Depois de criar o squad, avisa o sistema que tem gente nova no time:
*refresh-registry
Ele olha a pasta squads/ e atualiza a lista. É tipo fazer a chamada na escola — conferir quem tá presente.
5
Validar a qualidade do squad
Agora vamos testar se o time tá pronto. É tipo uma prova — ele verifica se todos os agentes estão bem configurados:
*validate-squad nome-do-squad
Troquenome-do-squad pelo nome do squad que você criou (ex: minha-empresa-ops).
Se passar, tá pronto pra usar. Se falhar, ele diz o que arrumar.
Outros comandos úteis
Comando
O que faz
*create-squad {domínio}
Cria um squad completo do zero (ex: *create-squad copywriting)
*clone-mind {nome}
Clona uma mente específica (ex: *clone-mind gary-halbert)
*status
Mostra o estado atual do que está sendo criado
*help
Mostra todos os comandos disponíveis
Parte 6 — Palestra do Finch
AIOX ADS Squad de Tráfego
Contexto
Na palestra do Finch, ele mostrou o AIOX ADS Squad — 10 agentes de IA que operam tráfego pago com 38 skills, 7 quality gates e 3 tiers de autonomia. Caso real: Eduardo Krupeizak escalou de R$2K para R$60K/dia usando apenas 4 dos 10 agentes.
Pensa assim: o agente de tráfego é como um motorista de Uber muito bom. Ele sabe dirigir perfeitamente. Mas pra começar a trabalhar, ele precisa de 3 coisas: a chave do carro (API Key), o endereço (API URL) e a permissão pra entrar (Access Token). Sem isso, ele fica parado. Com isso, ele faz mágica.
Etapa 1: Configurar o .env
1
Gerar o token do Meta em 2 cliques
Vai em pipeboard.co, faz login com OAuth e copia o token. Sem criar app manual, sem permissões granulares — 2 cliques e pronto.
Cola os dois valores no arquivo .env do projeto. Pensa nele como um cofre — é onde ficam todas as senhas.
Etapa 2: Ligar o motor
2
Instalar os MCPs (as "pontes" com as plataformas)
MCPs são como cabos que conectam o agente nas plataformas de anúncios. Você precisa de dois:
Pipeboard
Meta Ads — 29 ferramentas
Adspirer
Google, LinkedIn, TikTok — 91+ ferramentas
3
Rodar o bootstrap (checar se tudo tá certo)
Um único comando verifica se tudo tá conectado direitinho:
bash squads/aiox-ads/scripts/bootstrap.sh
Apareceu tudo [OK]? Tá pronto. Apareceu [FAIL]? Ele mesmo te fala o que fazer pra corrigir.
Etapa 3: Ensinar o agente sobre seu negócio
4
Onboarding — ele te faz 40 perguntas
Pensa como uma entrevista. O agente precisa conhecer seu negócio antes de criar qualquer anúncio:
*setup-business-profile
São 3 fases: Fase 1 — Sua empresa (15 perguntas): nome, site, diferencial... Fase 2 — Seu produto (13 perguntas): preço, benefícios, objeções... Fase 3 — Seu público (12 perguntas): idade, dor, onde eles estão...
Se já tem dados de outro squad (como o C-Level), ele pré-preenche e pode cair pra só 10 perguntas.
Etapa 4: Criar sua primeira campanha
5
Pedir a campanha em português normal
Fala pro agente o que você quer. Sem código, sem complicação:
Cria uma campanha de Meta Ads pra vender meu produto principal
O que ele faz sozinho:
1. Carrega estratégias anteriores
2. Analisa seu site e produtos
3. Pesquisa 3-5 concorrentes
4. Encontra seu diferencial
5. Puxa métricas e benchmarks
Regra de ouro: Campanhas são SEMPRE criadas como PAUSED — nunca gasta dinheiro sozinha. Você ativa quando estiver pronto.
Referência
Todos os Agentes
Agentes AIOX
Comando
Quem é
O que faz
/master
AIOS Master
Orquestrador geral — pode fazer qualquer coisa
/dev
Dex
Desenvolve código, implementa features
/devops
Gage
Configura ambiente, GitHub, deploy
/qa
Quinn
Testa e revisa código
/sm
River
Cria e gerencia stories
/pm
PM
Gerencia produto, cria PRDs
/po
PO
Aceita stories, prioriza backlog
/analyst
Analista
Analisa negócio, documenta projeto
/architect
Arquiteto
Define arquitetura do sistema
/data-engineer
Data Engineer
Banco de dados, migrations, schemas
/ux-design-expert
UX Expert
Design de interface e experiência
/squad-creator
Squad Creator
Cria squads de agentes especializados
Dicas
Dicas Importantes
01
Sempre espere o agente terminar antes de digitar o próximo comando
02
Se algo der errado, digite /exit e comece de novo com claude
03
Para ver os comandos de qualquer agente, use *help depois de ativá-lo
04
Nunca feche o Terminal no meio de uma operação — espere terminar
05
Os arquivos do projeto ficam na pasta que você criou — pode abrir no VS Code para ver