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.
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.
O que você vai instalar
O terminal onde tudo acontece.
A "loja de apps" do terminal.
Guarda o histórico de versões.
Motor que roda o AIOX e os sistemas.
O Claude trabalhando nas suas pastas.
Conecta você aos projetos da IAM.
Acesso ao banco de dados.
Time de agentes dentro do Claude.
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.
- 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.
- Abra o Claude da IAM
Em claude.ai ou no app do Claude, logado na conta da Inglês AutomaticaMente.
- 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.
- 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.
Pegue a janela inteira: o comando que você colou e tudo o que apareceu embaixo.
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:
- Copie os comandos pelo botão Copiar. Digitar à mão gera erro de letra.
- Cole com CmdCtrl + V e aperte Enter.
- Espere a linha vazia voltar antes de colar o próximo comando.
- Instalou algo? Feche o terminal e abra de novo. Ele só enxerga programas novos depois de reaberto. Foi o erro mais comum no intensivo.
- 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.
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.
- Baixe o instalador
Acesse warp.dev e clique em Download. O site já detecta seu sistema.
- Instale
Abra o arquivo
.dmge arraste o ícone do Warp para a pasta Aplicativos. - Instale
Abra o arquivo
.exee clique em Avançar até o fim. - Abra e entre
Entre com o Google ou pule o cadastro. Se perguntar qual "shell" usar, escolha PowerShell.
O Warp abre com uma linha esperando você digitar. Daqui em diante, use sempre o Warp.
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.
- 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)"
- 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:
zshecho '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".
- Feche, abra o Warp e confira
~ brew --version Homebrew 4.4.6
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).
- Confira se o winget existe
PowerShell
winget --version
Se aparecer "winget não é reconhecido": Microsoft Store → procure Instalador de Aplicativo → Atualizar → reabra o Warp.
- 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
Sse perguntar:PowerShellSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
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.
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).
- Instale
zsh
brew install git
PowerShellwinget install --id Git.Git -e --source winget
- Feche e abra o Warp. Diga ao Git quem é você
Use seu nome e o e-mail da sua conta do GitHub.
zshPowerShellgit config --global user.name "Seu Nome" git config --global user.email "seu-email@exemplo.com"
- Confira
zshPowerShell
git --version
Resposta esperada:
git version 2.x.x
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-corenão funciona.
- Instale a versão LTS
zsh
brew install node
PowerShellwinget install --id OpenJS.NodeJS.LTS -e --source winget
Prefere clicar? nodejs.org → botão LTS → abra o instalador e avance até o fim.
- Feche, abra o Warp e confira
zshPowerShell
node -v npm -v
v22.11.0 ← precisa ser v20 ou maior 10.9.0
Faltou o Set-ExecutionPolicy do passo 02. Rode e reabra o Warp.
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.
- Instale
zsh
curl -fsSL https://claude.ai/install.sh | bash
PowerShellirm https://claude.ai/install.ps1 | iex
- Feche, abra o Warp e confira
zshPowerShell
claude --version
- 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. - Escolha o modelo Opus 5.5
Dentro do Claude Code, digite
/modele selecione Opus 5.5. Foi o que definimos no intensivo: ótimo resultado gastando menos limite.> /model Selecione o modelo ❯ Opus 5.5 recomendado pela IAM Sonnet Haiku ↑↓ para navegar · Enter para escolherUse as setas e Enter - Para sair
Digite
/exitou aperte Ctrl + C duas vezes.
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.
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.
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
inglesautomaticamentee enviar mudanças sem digitar senha.
- 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".
- Instale
zsh
brew install gh
PowerShellwinget install --id GitHub.cli -e --source winget
- Feche, abra o Warp e faça login
zshPowerShell
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 - Autorize no navegador
Confira a foto da sua conta pessoal no canto da tela, cole o código e autorize.
Device ActivationEnter the code displayed on your deviceAB12–CD34ContinueDepois do Continue, clique em Authorize GitHub CLI - Confira
zshPowerShell
gh auth status
Resposta esperada:
✓ Logged in to github.com account seu-usuario
Rode gh auth logout, saia da conta errada no navegador e faça gh auth login de novo.
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.
- Instale
zsh
brew install supabase/tap/supabase
- Instale o Scoop
No Windows o Supabase vem por outra "loja", o Scoop. Rode no Warp normal, não como administrador:
PowerShellInvoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
- Instale o Supabase
PowerShell
scoop bucket add supabase https://github.com/supabase/scoop-bucket.git scoop install supabase
- Feche, abra o Warp, confira e entre
O navegador abre: entre com a conta indicada pela IAM e autorize.
zshPowerShellsupabase --version supabase login
npm install -g supabasenão funciona. O Supabase não aceita instalação global pelo npm.- Falhou? Abra o
claudee peça: "Instale o Supabase CLI no meu MacWindows e faça o login". Foi o que resolveu no intensivo.
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.
mkdir -p ~/empresas/ingles-automaticamente cd ~/empresas/ingles-automaticamente pwd
mkdir $HOME\empresas\ingles-automaticamente -Force cd $HOME\empresas\ingles-automaticamente pwd
Comandos de pasta que você vai usar
| Comando | O que faz |
|---|---|
pwd | Mostra em qual pasta você está |
ls | Lista o que tem dentro |
cd nome | Entra numa pasta |
cd .. | Volta uma pasta |
mkdir nome | Cria uma pasta |
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.
- Veja os repositórios que você tem acesso
zshPowerShell
gh repo list inglesautomaticamente
- Clone o que você vai usar
Troque
nome-do-repopelo nome que apareceu na lista. Rode dentro da pasta do passo 08.zshPowerShellgh 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.
# 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".
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.
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.
- Entre na pasta e rode o instalador
zsh
cd ~/empresas/ingles-automaticamente npx aiox-core@latest install
PowerShellcd $HOME\empresas\ingles-automaticamente npx aiox-core@latest install
- Responda as perguntas
Setas para navegar, Espaço para marcar, Enter para confirmar.
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ídaRespostas certas em azul - Chame o AIOX Master
Na mesma pasta, abra
claude, digite/e escolha/AIOX:agents:aiox-master. Depois digite*help.
O Claude Code só enxerga o AIOX quando é aberto de dentro da pasta onde ele foi instalado. Use pwd para conferir onde você está.
npx: command not found: Node não instalado ou Warp não reaberto (passo 04).ECOMPROMISEDou erro de cache: rodenpm cache verifye tente de novo.- "limite de dispositivos excedido": você escolheu Pro. Rode de novo e escolha Community.
- Algo estranho:
npx aiox-core@latest doctorfaz um diagnóstico.
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.
- Instale
Baixe em wisprflow.ai.
- Idioma Português
Nas configurações do app.
- Escolha um atalho que você não usa
No intensivo, o Caps Lock atrapalhou quem digita em maiúsculas. Prefira outra tecla.
Conferência final
Feche e abra o Warp e rode tudo de uma vez. Cada linha deve responder com uma versão, sem erro:
git --version node -v claude --version gh auth status supabase --version
Problemas comuns
| O que aparece | O 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 senha | Digite a senha do Mac (ela não aparece) e Enter. Não use sudo se o guia não mandou. |
| "Repository not found" / sem acesso | Aceite o convite no GitHub e confira a conta com gh auth status. |
| Comando parece travado | Espere 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 cheio | Libere espaço antes de continuar. Node e repositórios precisam de alguns GB. |
| Qualquer outra coisa | Tire um print do terminal e mande no Claude da IAM (como fazer). |