Docs IAM/Ambiente/Setup MacSetup Windows

Setup do ambiente de trabalho com IA

Tudo o que instalamos no intensivo, na ordem certa, explicado para quem nunca usou um terminal. Você está vendo a versão para MacWindows. Troque no menu ao lado se precisar.

⏱ 40 a 60 min10 ferramentasnível: inicianteWindows 10 ou 11macOS 13 ou mais novo

Como as peças se encaixam

Você vai trabalhar dentro do Warp (o terminal). Lá dentro roda o Claude Code com os agentes do AIOX. Eles usam o Git e o Node.js por baixo e se conectam ao GitHub, onde ficam os projetos, e ao Supabase, onde ficam os dados.

SEU COMPUTADOR Warp · o terminal a janela onde você digita os comandos Claude Code + agentes AIOX lê arquivos, roda comandos, escreve código e texto Gitguarda versões Node.js · npm · npxroda o AIOX e os sistemas INTERNET GitHubrepositórios da IAMconectado pelo gh Supabasebanco: leads, vendasconectado pelo supabase CLI git push / pull
Visão geral do ambiente que você vai montar

O que você vai instalar

Leia antes

Quando der erro (e vai dar)

Seu computador nunca teve essas ferramentas. É normal algum comando reclamar de algo que está faltando. Nada disso estraga o computador. Não precisa explicar nada: tire um print e mande no chat do Claude da IAM.

  1. Tire o print da tela do terminal com o erro

    Aperte Cmd + Ctrl + Shift + 4 e arraste por cima da janela do Warp. O print vai direto para a área de transferência.

    Aperte Win + Shift + S e arraste por cima da janela do Warp. O print vai direto para a área de transferência.

  2. Abra o Claude da IAM

    Em claude.ai ou no app do Claude, logado na conta da Inglês AutomaticaMente.

  3. Cole o print e envie

    Clique na caixa de mensagem, aperte CmdCtrl + V e envie. Só a imagem. O Claude lê o erro e responde o que fazer.

  4. Faça o que ele disser e volte para o guia

    Depois do passo 05, você também pode pedir ajuda ao próprio Claude Code, direto no terminal.

Print bom

Pegue a janela inteira: o comando que você colou e tudo o que apareceu embaixo.

Passo 00 · conceito

O terminal

O terminal é uma janela onde você dá ordens ao computador por texto. Você cola um comando, aperta Enter, e ele responde. Veja como fica:

Warp
—☐✕
~ PS C:\Users\voce> node -v ← 1. você cola o comando e aperta Enter v22.11.0 ← 2. o computador responde~ PS C:\Users\voce> ▍ ← 3. linha vazia de novo = terminou
Anatomia de um comando no terminal
5 regras que evitam quase todos os problemas
  1. Copie os comandos pelo botão Copiar. Digitar à mão gera erro de letra.
  2. Cole com CmdCtrl + V e aperte Enter.
  3. Espere a linha vazia voltar antes de colar o próximo comando.
  4. Instalou algo? Feche o terminal e abra de novo. Ele só enxerga programas novos depois de reaberto. Foi o erro mais comum no intensivo.
  5. Quando pedir senha do computador, digite mesmo que nada apareça na tela, e aperte Enter.

Até instalar o Warp, use o Terminal que já vem no Mac: Cmd + Espaço, digite "Terminal" e Enter.

Até instalar o Warp, use o PowerShell que já vem no Windows: clique em Iniciar, digite "PowerShell" e Enter. Todos os comandos deste guia são de PowerShell, não do "Prompt de Comando" antigo.

Passo 01 · ferramenta

Warp

O que é
Um terminal moderno, mais fácil de usar que o padrão do MacWindows.
Para que serve
Abas, pastas, copiar e colar fácil, e cada comando separado em blocos. É onde você vai trabalhar todo dia.
  1. Baixe o instalador

    Acesse warp.dev e clique em Download. O site já detecta seu sistema.

  2. Instale

    Abra o arquivo .dmg e arraste o ícone do Warp para a pasta Aplicativos.

  3. Instale

    Abra o arquivo .exe e clique em Avançar até o fim.

  4. Abra e entre

    Entre com o Google ou pule o cadastro. Se perguntar qual "shell" usar, escolha PowerShell.

Pronto quando

O Warp abre com uma linha esperando você digitar. Daqui em diante, use sempre o Warp.

Passo 02 · ferramenta

Homebrewwinget e permissões do PowerShell

O que é
Uma "loja de aplicativos" que funciona pelo terminal.
Para que serve
Instala programas com um comando curto (brew install nome), sem procurar site por site.
  1. Rode o instalador

    Vai pedir a senha do Mac e depois Enter para confirmar. Leva de 5 a 10 minutos.

    zsh
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  2. Coloque o brew no caminho

    No final aparece uma seção Next steps. Em Mac com chip Apple (M1 a M4), são estes dois comandos:

    zsh
    echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
    eval "$(/opt/homebrew/bin/brew shellenv)"

    Mac antigo com processador Intel? Copie exatamente o que aparecer no seu "Next steps".

  3. Feche, abra o Warp e confira
    Warp
    ~ brew --version Homebrew 4.4.6
zsh: command not found: brew

Faltou rodar os comandos do "Next steps" ou reabrir o Warp.

O que é
O winget é a "loja de aplicativos" pelo terminal que já vem no Windows 10 e 11.
Para que serve
Instala Git, Node.js e GitHub CLI com um comando curto (winget install nome).
  1. Confira se o winget existe
    PowerShell
    winget --version

    Se aparecer "winget não é reconhecido": Microsoft Store → procure Instalador de Aplicativo → Atualizar → reabra o Warp.

  2. Libere o PowerShell para rodar instaladores

    O Windows bloqueia scripts por padrão. Sem isso, Claude Code, npm e Supabase dão erro. Rode uma vez e responda S se perguntar:

    PowerShell
    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Janela "Deseja permitir alterações?"

Nas instalações seguintes o Windows pode pedir permissão. Clique em Sim. Às vezes a janela abre atrás do Warp: se parecer travado, olhe a barra de tarefas.

Passo 03 · dependência

Git

O que é
O programa que guarda cada versão dos arquivos, como um "salvar versões" infinito.
Para que serve
Baixar os repositórios, criar sua branch e enviar alterações. O Claude Code precisa dele (no Windows é obrigatório).
  1. Instale
    zsh
    brew install git
    PowerShell
    winget install --id Git.Git -e --source winget
  2. Feche e abra o Warp. Diga ao Git quem é você

    Use seu nome e o e-mail da sua conta do GitHub.

    zshPowerShell
    git config --global user.name "Seu Nome"
    git config --global user.email "seu-email@exemplo.com"
  3. Confira
    zshPowerShell
    git --version

    Resposta esperada: git version 2.x.x

Passo 04 · dependência

Node.js

O que é
O motor que roda programas em JavaScript fora do navegador. Traz junto o npm e o npx.
Para que serve
O AIOX e nossos sistemas rodam nele. Sem Node, o npx aiox-core não funciona.
  1. Instale a versão LTS
    zsh
    brew install node
    PowerShell
    winget install --id OpenJS.NodeJS.LTS -e --source winget

    Prefere clicar? nodejs.org → botão LTS → abra o instalador e avance até o fim.

  2. Feche, abra o Warp e confira
    zshPowerShell
    node -v
    npm -v
    resposta esperada
    —☐✕
    v22.11.0 ← precisa ser v20 ou maior 10.9.0
npm.ps1 não pode ser carregado

Faltou o Set-ExecutionPolicy do passo 02. Rode e reabra o Warp.

Passo 05 · ferramenta principal

Claude Code

O que é
O Claude dentro do terminal. Diferente do chat, ele lê seus arquivos, roda comandos e escreve direto nas pastas.
Para que serve
Criar agentes, mexer no legado, gerar roteiros, automatizar processos. E resolver sozinho erros de instalação.
  1. Instale
    zsh
    curl -fsSL https://claude.ai/install.sh | bash
    PowerShell
    irm https://claude.ai/install.ps1 | iex
  2. Feche, abra o Warp e confira
    zshPowerShell
    claude --version
  3. Abra e faça login com a conta da IAM

    Digite claude, escolha um tema, depois conta Claude (assinatura). O navegador abre: entre com a conta da Inglês AutomaticaMente e clique em Autorizar.

  4. Escolha o modelo Opus 5.5

    Dentro do Claude Code, digite /model e selecione Opus 5.5. Foi o que definimos no intensivo: ótimo resultado gastando menos limite.

    Warp · claude
    —☐✕
    > /model Selecione o modelo ❯ Opus 5.5 recomendado pela IAM Sonnet Haiku ↑↓ para navegar · Enter para escolher
    Use as setas e Enter
  5. Para sair

    Digite /exit ou aperte Ctrl + C duas vezes.

Deixe o Claude Code instalar o resto

Se algum passo seguinte der erro, abra o claude e peça: "Verifique se tenho Git, Node.js, GitHub CLI e Supabase CLI. Instale o que faltar e me explique cada passo." Foi assim que resolvemos o GitHub CLI no intensivo.

Erros comuns
  • command not found: claude / "não é reconhecido": reabra o Warp. Se continuar: npm install -g @anthropic-ai/claude-code
  • "requires git-bash": volte ao passo 03 e instale o Git.
Passo 06 · ferramenta

GitHub CLI

O que é
O GitHub é o site onde ficam os projetos da IAM. O gh é o GitHub pelo terminal.
Para que serve
Liga seu computador à sua conta para baixar os repositórios da organização inglesautomaticamente e enviar mudanças sem digitar senha.
Antes: conta pessoal e convites aceitos
  • Crie sua conta pessoal em github.com/signup e mande o e-mail no grupo.
  • Decidimos usar contas individuais: a IAM não paga a mais por membro e cada commit mostra quem fez.
  • Aceite todos os convites que chegarem por e-mail ou em github.com/notifications. Sem aceitar, aparece "sem acesso".
  1. Instale
    zsh
    brew install gh
    PowerShell
    winget install --id GitHub.cli -e --source winget
  2. Feche, abra o Warp e faça login
    zshPowerShell
    gh auth login
    Warp · gh auth login
    —☐✕
    ? Where do you use GitHub? GitHub.com ? Preferred protocol for Git operations? HTTPS ? Authenticate Git with your GitHub credentials? Yes ? How would you like to authenticate? Login with a web browser ! First copy your one-time code: AB12-CD34 Press Enter to open github.com in your browser...
    Respostas certas, em azul. O código muda a cada vez
  3. Autorize no navegador

    Confira a foto da sua conta pessoal no canto da tela, cole o código e autorize.

    github.com/login/device
    Device ActivationEnter the code displayed on your device
    AB12–CD34
    Continue
    Depois do Continue, clique em Authorize GitHub CLI
  4. Confira
    zshPowerShell
    gh auth status

    Resposta esperada: ✓ Logged in to github.com account seu-usuario

Entrou na conta errada?

Rode gh auth logout, saia da conta errada no navegador e faça gh auth login de novo.

Passo 07 · ferramenta

Supabase CLI

O que é
O Supabase é o banco de dados da IAM: leads, vendas, métricas. O CLI é o acesso pelo terminal.
Para que serve
Você e o Claude Code consultam dados, criam tabelas e publicam funções sem abrir o painel do site.
  1. Instale
    zsh
    brew install supabase/tap/supabase
  2. Instale o Scoop

    No Windows o Supabase vem por outra "loja", o Scoop. Rode no Warp normal, não como administrador:

    PowerShell
    Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
  3. Instale o Supabase
    PowerShell
    scoop bucket add supabase https://github.com/supabase/scoop-bucket.git
    scoop install supabase
  4. Feche, abra o Warp, confira e entre

    O navegador abre: entre com a conta indicada pela IAM e autorize.

    zshPowerShell
    supabase --version
    supabase login
Erros comuns
  • npm install -g supabase não funciona. O Supabase não aceita instalação global pelo npm.
  • Falhou? Abra o claude e peça: "Instale o Supabase CLI no meu MacWindows e faça o login". Foi o que resolveu no intensivo.
Passo 08 · organização

Pasta de trabalho

Todos os projetos da IAM ficam numa pasta fixa. Assim você sempre sabe onde está cada coisa, e o Claude Code encontra os arquivos certos.

/Users/voce/C:\Users\voce\ └── empresas/ └── ingles-automaticamente/ ✓ minúsculas e hífen ├── iam-agents/ ← repositórios clonados no passo 09 ├── iam-apresentacao-comercial/ └── iam-legacy/ ✗ Inglês AutomaticaMente/ espaço e acento quebram comandos
zsh
mkdir -p ~/empresas/ingles-automaticamente
cd ~/empresas/ingles-automaticamente
pwd
PowerShell
mkdir $HOME\empresas\ingles-automaticamente -Force
cd $HOME\empresas\ingles-automaticamente
pwd

Comandos de pasta que você vai usar

ComandoO que faz
pwdMostra em qual pasta você está
lsLista o que tem dentro
cd nomeEntra numa pasta
cd ..Volta uma pasta
mkdir nomeCria uma pasta
Passo 09 · projetos

Repositórios e branches

Clonar
Baixar uma cópia de um repositório do GitHub, já conectada ao original.
Branch
Uma cópia paralela onde você faz sua tarefa sem mexer na versão que está no ar.
  1. Veja os repositórios que você tem acesso
    zshPowerShell
    gh repo list inglesautomaticamente
  2. Clone o que você vai usar

    Troque nome-do-repo pelo nome que apareceu na lista. Rode dentro da pasta do passo 08.

    zshPowerShell
    gh repo clone inglesautomaticamente/nome-do-repo

Regra de ouro: nunca trabalhe direto na main

A main é a versão em produção, rodando para os clientes. Cada tarefa vai numa branch sua. Você testa lá, e só depois de revisada ela volta para a main.

main · produção matheus/ajuste-contrato git checkout -b commits e testes revisão + merge
Sua branch sai da main, recebe seus commits e só volta depois de revisada
zshPowerShell
# 1. entrar no projeto e pegar a versão mais nova
cd nome-do-repo
git checkout main
git pull
# 2. criar sua branch: seu-nome/o-que-vai-fazer
git checkout -b seu-nome/descricao-da-tarefa
# 3. depois de mexer e testar: salvar e enviar
git add .
git commit -m "explica o que mudou"
git push -u origin seu-nome/descricao-da-tarefa

Não precisa decorar. Dentro do claude, peça: "crie uma branch para esta tarefa" ou "faça o commit e envie minha branch, sem mexer na main".

Passo 10 · agentes

AIOX Community

O que é
Um time de agentes de IA que roda dentro do Claude Code, liderado pelo AIOX Master (Orion).
Para que serve
Você chama o agente certo em vez de escrever um prompt enorme. Gasta menos limite e entrega padronizado. É a base do nosso futuro IAM Core.
Você pede AIOX Master · Orionentende e escolhe o especialista @analyst @pm @dev @qa @ux @devops
Pesquisa, produto, código, testes, design e publicação, cada um com seu agente
Use a edição Community (gratuita)

A licença Pro bateu o limite de dispositivos no intensivo. Por enquanto, todo mundo instala a Community. Dá para ativar o Pro depois, na mesma pasta.

  1. Entre na pasta e rode o instalador
    zsh
    cd ~/empresas/ingles-automaticamente
    npx aiox-core@latest install
    PowerShell
    cd $HOME\empresas\ingles-automaticamente
    npx aiox-core@latest install
  2. Responda as perguntas

    Setas para navegar, Espaço para marcar, Enter para confirmar.

    Warp · npx aiox-core install
    —☐✕
    Need to install aiox-core. Ok to proceed? (y) y ? Idioma ............ Português ? Modo .............. Modo Assistido ? Tipo de projeto ... Greenfield (Brownfield se a pasta já tem código) ? Ferramentas ....... ◉ Claude Code (tecla a marca todas) ? Tech Preset ....... None ? Edição ............ ❯ Community / Free ✓ Instalação concluída
    Respostas certas em azul
  3. Chame o AIOX Master

    Na mesma pasta, abra claude, digite / e escolha /AIOX:agents:aiox-master. Depois digite *help.

O AIOX não aparece?

O Claude Code só enxerga o AIOX quando é aberto de dentro da pasta onde ele foi instalado. Use pwd para conferir onde você está.

Erros comuns
  • npx: command not found: Node não instalado ou Warp não reaberto (passo 04).
  • ECOMPROMISED ou erro de cache: rode npm cache verify e tente de novo.
  • "limite de dispositivos excedido": você escolheu Pro. Rode de novo e escolha Community.
  • Algo estranho: npx aiox-core@latest doctor faz um diagnóstico.
Opcional

Wispr Flow: falar em vez de digitar

O que é
Um app que transforma sua voz em texto em qualquer janela, inclusive no terminal.
Para que serve
Pedidos longos para o Claude saem muito mais rápido falando. Mais contexto, melhor resultado.
  1. Instale

    Baixe em wisprflow.ai.

  2. Idioma Português

    Nas configurações do app.

  3. Escolha um atalho que você não usa

    No intensivo, o Caps Lock atrapalhou quem digita em maiúsculas. Prefira outra tecla.

Final

Conferência final

Feche e abra o Warp e rode tudo de uma vez. Cada linha deve responder com uma versão, sem erro:

zshPowerShell
git --version
node -v
claude --version
gh auth status
supabase --version
Referência

Problemas comuns

O que apareceO que fazer
"command not found" / "não é reconhecido"Feche e abra o Warp. Se continuar, o programa não foi instalado: refaça o passo.
"a execução de scripts foi desabilitada"Rode o Set-ExecutionPolicy do passo 02.
"Permission denied" ou pede senhaDigite a senha do Mac (ela não aparece) e Enter. Não use sudo se o guia não mandou.
"Repository not found" / sem acessoAceite o convite no GitHub e confira a conta com gh auth status.
Comando parece travadoEspere alguns minutos. Procure uma janela de permissão escondida na barra de tarefas. Se nada mudar, Ctrl + C e rode de novo.
"no space left" / disco cheioLibere espaço antes de continuar. Node e repositórios precisam de alguns GB.
Qualquer outra coisaTire um print do terminal e mande no Claude da IAM (como fazer).
Docs IAM · Guia do Intensivo de 21/11/2026 · Dúvida rápida: WhatsApp do grupo.