Seção 01 de 05
Como Configurar Sua Máquina
Vamos instalar tudo que você precisa para trabalhar. Siga cada passo na ordem. Você só precisa fazer isso uma vez -- depois disso, sua máquina está pronta para sempre.
Instalar o gerenciador de pacotes
O Homebrew é um instalador de programas para Mac. Copie e cole o comando abaixo no Terminal e aperte Enter.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
A instalação pode demorar alguns minutos. Espere até aparecer a mensagem de sucesso.
O Windows 11 já vem com o winget (Windows Package Manager) instalado. Vamos verificar se está funcionando.
winget --version
Instalar o Git
O Git é o sistema que salva o histórico do seu código. Ele permite guardar cada versão do seu projeto e compartilhar com a equipe.
brew install git
winget install Git.Git
git seja reconhecido.
Configurar o Git com seu nome e email
Agora vamos dizer ao Git quem você é. Substitua "Seu Nome" pelo seu nome real e o email pelo seu email.
git config --global user.name "Seu Nome"
git config --global user.email "seuemail@exemplo.com"
git config --global user.name "Maria Silva"git config --global user.email "maria@consolatio.com.br"Esses comandos são idênticos no macOS e no Windows.
Instalar o GitHub CLI
O GitHub CLI permite que você se conecte ao GitHub (onde guardamos todo o código da Consolatio) direto pelo terminal.
brew install gh
winget install GitHub.cli
gh seja reconhecido.
Autenticar no GitHub
Agora vamos fazer login no GitHub. Cole o comando abaixo e siga as instruções que aparecem na tela.
gh auth login
O terminal vai fazer várias perguntas. Responda exatamente assim:
- What account do you want to log into? -- Escolha GitHub.com (aperte Enter)
- What is your preferred protocol for Git operations? -- Escolha HTTPS (aperte Enter)
- Authenticate Git with your GitHub credentials? -- Escolha Yes (aperte Enter)
- How would you like to authenticate GitHub CLI? -- Escolha Login with a web browser
Uma página do navegador vai abrir automaticamente.
Cole o código na página e clique em "Authorize".
Instalar o Node.js
O Node.js é necessário para rodar o Claude Code CLI. Vamos instalá-lo.
brew install node
winget install OpenJS.NodeJS.LTS
Para confirmar que funcionou:
node --version && npm --version
Instalar o Docker Desktop
O Docker é usado para rodar os projetos localmente. Ele garante que o ambiente no seu computador é idêntico ao de produção.
brew install --cask docker
Após instalar, abra o aplicativo Docker (ele aparece em Aplicativos). Na primeira vez, ele vai pedir permissões -- aceite todas.
winget install Docker.DockerDesktop
wsl --installe reinicie o computador.
Após instalar, abra o Docker Desktop pelo menu Iniciar. Na primeira vez, ele pode pedir para reiniciar o computador.
Para confirmar que o Docker está rodando:
docker --version
Instalar sua ferramenta de trabalho
O Claude Code CLI é o agente de IA que roda no terminal. Ele é sua principal ferramenta de trabalho.
npm install -g @anthropic-ai/claude-code
sudo npm install -g @anthropic-ai/claude-code(vai pedir a senha do Mac)
Você pode instalar de duas formas:
npm install -g @anthropic-ai/claude-code
irm https://claude.ai/install.ps1 | iex
O Claude Code Desktop é um aplicativo com interface gráfica. Você não precisa usar o terminal -- é só abrir o app, selecionar uma pasta de projeto e conversar com o agente.
Baixe em: claude.ai/download
Abra o arquivo .dmg baixado e arraste o Claude Code para a pasta Aplicativos.
Baixe em: claude.ai/download
Execute o instalador .exe e siga as instruções na tela.
O Antigravity é uma IDE do Google (parecida com VS Code) com agentes de IA integrados.
Baixe em: idx.google.com/antigravity
Instale normalmente para o seu sistema operacional e abra o aplicativo.
Instalar o CLAUDE.md Global
O CLAUDE.md global é um arquivo de instruções que ensina o agente de IA a seguir os padrões da Consolatio. Com ele, o agente já sabe nossas regras automaticamente.
mkdir -p ~/.claude && curl -o ~/.claude/CLAUDE.md https://onboarding.consolatio.com.br/claude-global.md
mkdir "$env:USERPROFILE\.claude" -Force; Invoke-WebRequest -Uri "https://onboarding.consolatio.com.br/claude-global.md" -OutFile "$env:USERPROFILE\.claude\CLAUDE.md"
$env:USERPROFILE é um atalho automático do Windows que aponta para a sua pasta de usuário (ex: C:\Users\seu-nome). Basta copiar e colar o comando exatamente como está.
.claude na sua Home e baixa o arquivo de instruções da Consolatio.
Configurar o GEMINI.md para Antigravity
O Antigravity usa o Gemini como modelo de IA, e ele não lê arquivos CLAUDE.md automaticamente. Precisamos criar um arquivo especial para que ele siga os padrões da Consolatio.
mkdir -p ~/.gemini && curl -o ~/.gemini/GEMINI.md https://onboarding.consolatio.com.br/gemini-global.md
mkdir "$env:USERPROFILE\.gemini" -Force; Invoke-WebRequest -Uri "https://onboarding.consolatio.com.br/gemini-global.md" -OutFile "$env:USERPROFILE\.gemini\GEMINI.md"
Verificar que tudo está funcionando
Último passo! Vamos verificar que tudo foi instalado corretamente.
gh auth status && claude --version && docker --version
gh auth status; claude --version; docker --version
gh auth status && docker --version
gh auth status; docker --version
Além disso, abra o aplicativo Claude Code Desktop e confirme que ele abre normalmente.
gh auth status && docker --version
gh auth status; docker --version
Além disso, abra o Antigravity IDE e confirme que ele abre normalmente e que o painel de chat de IA está acessível na lateral.
Como atualizar suas instruções
Os arquivos de instruções que você instalou (CLAUDE.md e GEMINI.md) ficam salvos na sua máquina e não atualizam automaticamente. Quando o Thiago avisar que houve uma atualização nas regras, basta rodar novamente o comando abaixo para baixar a versão mais recente.
curl -o ~/.claude/CLAUDE.md https://onboarding.consolatio.com.br/claude-global.md
Invoke-WebRequest -Uri "https://onboarding.consolatio.com.br/claude-global.md" -OutFile "$env:USERPROFILE\.claude\CLAUDE.md"
curl -o ~/.claude/CLAUDE.md https://onboarding.consolatio.com.br/claude-global.md
Invoke-WebRequest -Uri "https://onboarding.consolatio.com.br/claude-global.md" -OutFile "$env:USERPROFILE\.claude\CLAUDE.md"
curl -o ~/.gemini/GEMINI.md https://onboarding.consolatio.com.br/gemini-global.md
Invoke-WebRequest -Uri "https://onboarding.consolatio.com.br/gemini-global.md" -OutFile "$env:USERPROFILE\.gemini\GEMINI.md"
Seção 02 de 05
Como Iniciar um Novo Projeto
Você não precisa saber programar. O agente de IA faz tudo por você. Seu papel é dizer o que você quer e o agente cria o projeto completo.
Abra sua ferramenta de trabalho
Aperte Command + Espaço no seu Mac, digite Terminal e aperte Enter.
Aperte Windows + X e clique em Terminal, ou procure PowerShell no menu Iniciar.
Esse é o seu terminal -- é por aqui que você conversa com o agente.
Abra o aplicativo Claude Code Desktop no seu computador.
Você verá um campo de chat e a opção de abrir um projeto.
Abra o Antigravity IDE no seu computador.
Você verá um painel de chat de IA na lateral.
Abra o agente de IA
No terminal, digite o comando abaixo e aperte Enter. Isso abre o agente de IA.
claude
Parece um chat -- você escreve e o agente responde.
No app, o agente já está aberto. Você verá um campo de chat pronto para receber instruções.
No Antigravity, o painel de chat de IA fica na lateral direita. Clique nele para abrir o agente.
Criar a pasta de projetos (apenas primeira vez)
Antes de criar seu primeiro projeto, crie uma pasta organizada no seu computador para guardar todos os projetos da Consolatio.
mkdir "$env:USERPROFILE\Projetos\entidade-consolatio" -Force
Isso cria a pasta C:\Users\seu-nome\Projetos\entidade-consolatio\ automaticamente.
mkdir -p ~/Projetos/entidade-consolatio
Peça para o agente criar o projeto
Agora é só digitar o que você quer. Escreva no chat do agente:
Cria um novo projeto chamado meu-projeto
Cria um novo projeto chamado meu-projeto
Cria um novo projeto chamado meu-projeto na minha pasta Projetos/entidade-consolatio (NÃO usar a pasta scratch)
landing-consolatio, blog-consolatio, api-financeiroUse letras minúsculas, sem espaços, separando palavras com hífen.
O agente faz tudo automaticamente
Depois que você pede, o agente vai executar tudo sozinho. Você só precisa acompanhar e aprovar quando ele pedir permissão. Ele vai:
- 1. Criar o repositório no GitHub -- o espaço online onde o código fica guardado
- 2. Clonar o repositório localmente -- baixar uma cópia para o seu computador
- 3. Criar toda a estrutura do projeto -- incluindo CLAUDE.md, Dockerfile, docker-compose, e os arquivos iniciais
- 4. Fazer o primeiro commit -- salvar tudo no histórico do Git
Ele pode pedir "Permitir?" em alguns momentos -- basta aceitar (aperte Enter ou digite "yes").
Rodar o projeto localmente
Depois que o agente terminar de criar tudo, você pode ver o projeto funcionando no seu computador:
docker compose up
Para parar o projeto, aperte Ctrl + C no Terminal.
Para parar o projeto, aperte Ctrl + C no PowerShell.
Ver o projeto no navegador
Com o projeto rodando, abra o navegador e digite na barra de endereço:
http://localhost:3000
localhost:3000 é local. Ninguém de fora consegue ver. Para colocar na internet, você precisa solicitar um deploy (seção 03).
Conceito Importante: Push vs Deploy
Quando você faz push no GitHub (salvar o código online), isso é apenas um backup. O código fica guardado com segurança, mas NÃO vai para a internet. Para o projeto ficar acessível ao público (ex: meusite.consolatio.com.br), você precisa solicitar um deploy -- que é a próxima seção.
Salvar seu trabalho (Push)
Quando quiser salvar o que fez, é só pedir ao agente. Escreva no chat:
Salva o que fizemos e faz push para o GitHub
O agente vai criar um commit (um "ponto de salvamento") e enviar para o GitHub. Isso serve como backup e permite que outros membros da equipe vejam o código.
2. Abra o agente de IA
3. Peça para criar o projeto
4. Rode com
docker compose up (Docker Desktop precisa estar aberto)5. Veja no navegador em
localhost:30006. Salve com push quando estiver satisfeito
Seção 03 de 05
Como Solicitar Deploy
Deploy é o ato de colocar seu projeto na internet para que qualquer pessoa possa acessar. Quando você solicita deploy, seu projeto ganha um endereço real como meuprojeto.consolatio.com.br.
docker compose up) antes de solicitar deploy. Se ainda não fez isso, volte para a seção anterior.
Verifique que o projeto funciona localmente
Antes de tudo, confirme que seu projeto está rodando sem erros no seu computador.
docker compose up
Abra o navegador e acesse http://localhost:3000. Se o projeto aparecer normalmente, você pode solicitar o deploy. Pare o projeto com Ctrl + C.
Abra o agente na pasta do projeto
No terminal, navegue até a pasta do seu projeto e abra o Claude Code.
cd ~/Projetos/entidade-consolatio/meu-projeto
claude
cd ~\Projetos\entidade-consolatio\meu-projeto
claude
ls ~/Projetos/entidade-consolatio/
dir ~\Projetos\entidade-consolatio\
Abra o Claude Code Desktop, clique em "Open Project" e selecione a pasta do seu projeto.
Abra o Antigravity IDE e use "Open Folder" para abrir a pasta do seu projeto. Depois abra o painel de chat de IA na lateral.
Peça o deploy ao agente
No chat do agente, escreva:
Quero fazer deploy deste projeto
O que o agente vai fazer
O agente vai criar e configurar tudo automaticamente:
- 1. Criar o workflow de deploy -- um arquivo que ensina o GitHub a publicar seu projeto automaticamente
- 2. Pedir para configurar secrets -- senhas necessárias para o deploy (veja o próximo passo)
- 3. Definir o subdomínio -- escolher o endereço do seu projeto (ex: meuprojeto.consolatio.com.br)
- 4. Fazer o primeiro deploy -- publicar o projeto na internet
Configurar Secrets no GitHub
O agente vai te dizer quais secrets (senhas/chaves) você precisa adicionar no GitHub. Siga este passo a passo para cada secret:
https://github.com/entidade-consolatio/meu-projeto
DEPLOY_KEY)Após o deploy: como funciona
Deploy automático a partir de agora
Depois do primeiro deploy, toda vez que você fizer push para a branch main, o projeto será atualizado automaticamente na internet. Ou seja: salvou e fez push = o site atualiza sozinho.
Seu projeto estará disponível no endereço:
https://meu-projeto.consolatio.com.br
(substitua "meu-projeto" pelo nome real do seu projeto)
Verificar se o deploy funcionou
Duas formas de verificar:
Abra o navegador e acesse o endereço do seu projeto (ex: https://meu-projeto.consolatio.com.br). Se a página carregar, o deploy funcionou.
- Abra o repositório no GitHub
- Clique na aba Actions
- O deploy mais recente deve ter um ícone verde (sucesso)
O deploy falhou, pode verificar o que aconteceu?O agente vai analisar os logs e corrigir o problema.
docker compose up (Docker Desktop aberto)2. Abra o agente na pasta do projeto
3. Peça "Quero fazer deploy deste projeto"
4. Configure os secrets no github.com (navegador)
5. Depois disso, todo push no main = deploy automatico
Seção 04 de 05
Banco de Dados (PostgreSQL)
Todos os projetos da Consolatio usam um banco de dados PostgreSQL 16 compartilhado. Você pode visualizar os dados de qualquer projeto pelo navegador usando o pgAdmin.
Acessar o pgAdmin
O pgAdmin é a interface web para visualizar os dados do banco de dados. Abra o navegador e acesse:
https://pgadmin.consolatio.com.br
Fazer login
Na tela de login, use as seguintes credenciais:
admin@consolatio.com.br |
|
| Senha | Peça ao Thiago |
Preencha e clique em "Login".
Registrar o servidor (apenas primeira vez)
Na primeira vez que acessar o pgAdmin, você precisa registrar o servidor do banco de dados. Você só precisa fazer isso uma vez -- depois, ele fica salvo.
Host name/address: consolatio-postgres
Port: 5432
Maintenance database: consolatio
Username: consolatio_readonly
Password: peça ao Thiago
Navegar pelos dados
Para encontrar os dados de um projeto, siga esta estrutura no painel esquerdo:
Para ver os dados de uma tabela:
- Clique com o botão direito na tabela desejada
- Clique em View/Edit Data
- Clique em All Rows
Você pode rolar, ordenar colunas e filtrar dados.
Exportar dados para CSV/Excel
Você pode exportar os dados de qualquer tabela para usar no Excel ou Google Sheets:
- Abra os dados da tabela (passo anterior)
- Clique no botão de download/export na barra de ferramentas (ícone de seta para baixo)
- Escolha o formato CSV
- Clique em Download
Você também pode rodar consultas personalizadas pelo Query Tool (ícone de raio na barra de ferramentas) para filtrar dados antes de exportar.
O que você pode e não pode fazer
- Visualizar todos os dados em todas as tabelas
- Rodar consultas simples pelo Query Tool
- Exportar dados para CSV/Excel
- Ordenar e filtrar dados na interface
- Modificar, criar ou deletar dados (acesso somente leitura)
- Criar ou alterar tabelas
- Alterar configurações do banco
Acesso avançado (DBeaver, opcional)
Se você prefere usar o DBeaver (aplicativo desktop para banco de dados), é possível conectar via SSH tunnel. Essa opção é para usuários mais avançados.
| Host | 187.77.51.2 |
| Porta SSH | 22 |
| Usuario | root |
| Autenticação | Chave ED25519 (peça ao Thiago) |
| Host | 127.0.0.1 (via tunnel) |
| Porta | 5432 |
| Usuario | consolatio_readonly |
| Senha | Peça ao Thiago |
Perguntas Frequentes
| Não consigo fazer login | Verifique se o endereço está correto (https://pgadmin.consolatio.com.br), se o email é admin@consolatio.com.br e se a senha está certa. Peça ao Thiago se não lembra. |
| Não vejo nenhum banco de dados | Você precisa registrar o servidor (passo 3 acima). Isso só precisa ser feito uma vez. |
| Quero editar dados | O acesso é somente leitura. Solicite permissão ao Thiago para editar, criar ou excluir dados. |
| O pgAdmin está fora do ar | Espere alguns minutos e tente novamente. Se continuar fora, avise o Thiago. |
Seção 05 de 05
Como Pedir Status ao CTO
O CTO virtual da Consolatio pode gerar relatórios completos sobre todos os projetos. Você pode pedir um relatório de status ou uma auditoria técnica a qualquer momento, de duas formas.
Via Slack
A forma mais rápida. Você pode pedir status direto no Slack sem sair do que está fazendo. Funciona em qualquer computador e independe da ferramenta de desenvolvimento.
No Slack, mande uma mensagem mencionando o assistente:
@assistente-consolatio cto status
A auditoria é mais detalhada -- analisa problemas, riscos e sugestões de melhoria:
@assistente-consolatio cto audit
Pode demorar 1-2 minutos enquanto ele analisa todos os repositórios.
Via Agente de IA
Se você já está trabalhando, pode pedir o relatório diretamente pelo seu agente. Esse método gera relatórios mais detalhados.
cd ~/Projetos/entidade-consolatio/cto-consolatio
claude
cd ~\Projetos\entidade-consolatio\cto-consolatio
claude
Gera um status report de todos os projetos da Consolatio
Ou, para uma auditoria técnica completa:
Faz uma auditoria técnica completa de todos os projetos
Abra o Claude Code Desktop, clique em "Open Project" e selecione a pasta cto-consolatio.
Gera um status report de todos os projetos da Consolatio
Ou, para uma auditoria técnica completa:
Faz uma auditoria técnica completa de todos os projetos
Abra o Antigravity IDE, use "Open Folder" para abrir a pasta cto-consolatio e abra o painel de chat de IA.
Gera um status report de todos os projetos da Consolatio
Ou, para uma auditoria técnica completa:
Faz uma auditoria técnica completa de todos os projetos
O que o Status Report mostra
O relatório de status lista o estado atual de cada projeto:
O que a Auditoria Técnica mostra
A auditoria vai mais fundo e analisa a qualidade de cada projeto:
Exemplo de relatório de status
Quando pedir um relatório?
Você pode pedir a qualquer momento, mas é especialmente útil:
-- No início da semana, para ver o estado geral
-- Antes de uma reunião, para ter dados atualizados
-- Depois de um deploy, para confirmar que tudo está funcionando
-- Quando algo parece errado, para diagnosticar problemas
1. Configurar sua máquina
2. Criar novos projetos
3. Solicitar deploys
4. Acessar o banco de dados pelo pgAdmin
5. Acompanhar o status dos projetos
Se tiver dúvidas, pergunte ao seu agente de IA ou mande uma mensagem no Slack para @assistente-consolatio.