Aula 1. Como Comandar a IA — Fundamentos do Vibe Coding

Dicas de Ouro — Saiba Isso e Ja Pode Comecar

Instalar o Claude Code e uma linha.

Abra o terminal (tela preta) e cole a linha abaixo. So isso.

Para o agente: “curl -fsSL https://claude.ai/install.sh | bash”

Usuarios Windows precisam instalar o WSL (ambiente Linux) primeiro. Execute “wsl –install” no PowerShell e reinicie.

5 palavras-chave essenciais para dar ordens

1. API — protocolo de comunicacao entre programas. “Crie uma API”
2. Frontend — a tela visivel. “Crie a tela com React”
3. Banco de dados (DB) — onde os dados sao armazenados. “Salve no DB”
4. Commit — ponto de salvamento do estado atual. “Faca o commit”
5. Deploy — colocar na internet. “Faca o deploy”

Essas cinco palavras sao suficientes para apontar a direcao. A IA entende o resto.

A memoria da IA e gerenciada com 3 arquivos

• CLAUDE.md — regras do projeto. A IA le automaticamente no inicio de cada sessao. Escreva “assim e que nosso time trabalha”
• requisitos.md — registro das suas decisoes. Escreva decisoes de negocio como “desconto VIP 10%” com data
• progresso.md — ate onde chegou. Faz “continue de onde parou” funcionar na sessao nova

Todos os arquivos sao Markdown. Quem nao sabe programar pode ler e escrever.

Dicas de conversa com o agente

• De uma ordem por vez. “Crie a API de login primeiro” e melhor que “Crie login, cadastro e dashboard tudo junto”
• Quando da erro, o Claude Code detecta e corrige automaticamente. Nao precisa copiar
• Quando a conversa passa de 100 turnos, a qualidade da IA cai. Comece sessao nova atualizando os 3 arquivos

Experiencia Rapida

Instale o Claude Code e faca a primeira conversa. 5 minutos bastam.

1. Crie a pasta do projeto no terminal e execute o Claude Code

Para o agente: “mkdir -p ~/projects/my-first-app && cd ~/projects/my-first-app && claude”

2. Faca login no navegador (so uma vez)

3. Comece a primeira conversa

Para o agente: “Crie nesta pasta um servidor Go Gin. Uma API que retorna Hello, World na porta 8080.”

A IA cria os arquivos, sobe o servidor e verifica. Abra http://localhost:8080 no navegador.

Por Que Dar Ordens Assim

Voce ja experimentou pedir para a IA criar algo por fala. A tela apareceu, os botoes funcionaram, os dados foram salvos. Mas uma pergunta ficou:

“Posso continuar desenvolvendo isso?”

Para responder, precisamos ver exatamente onde estamos. Quais ferramentas existem, que termos sao usados, quais padroes de trabalho. A Aula 1 e o momento de abrir o mapa. A partir da Aula 2, tracamos caminhos nele.

Mapa de Ferramentas de Programacao com IA

Ha varias ferramentas que escrevem codigo quando voce fala. Dividem-se em duas categorias.

Ferramentas de editor — IA embutida no editor de codigo.

Agentes de terminal — IA que decide e executa sozinha no terminal.

Agentes de terminal nao se limitam a editar codigo — decidem sozinhos executar comandos, verificar testes e criar arquivos. O loop de verificacao autonoma e a diferenca decisiva.

Por Que Claude Code

Este curso usa Claude Code como referencia.

Claude Code e atualmente o agente de terminal mais capaz em lidar autonomamente com tarefas complexas de multiplos arquivos. Tokens sao unidades de texto que a IA le. 200K equivalem a um romance, 1M a cinco romances. Claude Code suporta 200K tokens de contexto basico, e o modelo Opus 4.6 suporta ate 1M tokens.

Instalando o Claude Code

Metodo 1: Instalacao nativa (recomendado)

curl -fsSL https://claude.ai/install.sh | bash

Verifique:

claude --version

Se aparecer o numero da versao, sucesso.

Palavras-Chave para Ordens — Dicionario Completo

Nao precisa decorar agora. A tabela abaixo e um dicionario. De uma olhada e volte quando a IA disser algo que voce nao entende.

Backend — o motor invisivel

Frontend — a tela visivel

Banco de Dados — dispositivo de memoria

Deploy — lancar ao mundo

Gerenciamento de Contexto — Lidando com a Memoria da IA

O mais importante para a IA nao e ser inteligente. E o contexto.

Contexto e toda informacao que a IA lembra agora. O que voce disse, o que ela disse, arquivos do projeto, regras — tudo isso. O problema: essa memoria tem limite.

CLAUDE.md — Constituicao do projeto

CLAUDE.md e um arquivo especial na pasta do projeto. Claude Code le automaticamente no inicio de cada sessao.

# CLAUDE.md

## Visao Geral do Projeto
App de lista de tarefas. Backend Go Gin + Frontend React + SQLite.

## Comandos
- `go run main.go` — executar servidor (porta 8080)
- `cd frontend && npm run dev` — executar frontend

## Regras
- Respostas da API sempre em JSON
- Mensagens de erro em portugues
- Ao adicionar funcionalidade, verificar que as existentes nao quebraram

A caracteristica mais importante: quem nao sabe programar pode ler e escrever.

Padrao de Vibe Coding

Vibe coding — termo cunhado por Andrej Karpathy. Programar pelo feeling. Nao le o codigo. Verifica clicando na tela. Quando da erro, copia a mensagem e joga para a IA. (Claude Code faz isso automaticamente.)

Fluxo basico

Ideia → Pede para IA → Verifica resultado → Pede ajuste → Repete

Limite deste padrao

Vibe coding e incrivelmente rapido. Mas apos 5 funcionalidades coisas estranhas comecam. Adiciona funcionalidade nova e uma antiga quebra. Pede para a IA consertar e outra quebra. Comeca o jogo de bater toupeira.

Por que? A resposta esta na Aula 2.

Pratica: Criando App de Lista de Tarefas

Objetivo

Criar um app de lista de tarefas em uma sessao do Claude Code e adicionar 3 funcionalidades. Tempo total 30-60 minutos.

Step 1: Criar o app basico

Crie um app web de lista de tarefas.

Stack:
- Backend: Go + Gin
- Frontend: React
- Banco de dados: SQLite (arquivo DB, sem necessidade de instalacao)

Funcionalidades:
- Adicionar tarefa (titulo, conteudo)
- Listar tarefas
- Marcar como concluida
- Deletar tarefa

Frontend simples. Tudo em uma pagina.
Um unico servidor que serve o frontend tambem.

Step 2-4: Adicionar Prioridade, Prazo, Busca

(Mesma sequencia do conteudo original — adicionar prioridade, prazo, busca, verificando cada passo.)

Step 5: Criar CLAUDE.md

Crie o arquivo CLAUDE.md deste projeto. Inclua visao geral, comandos de execucao, estrutura de diretorios e lista de funcionalidades.

Step 6: Criar requisitos.md

Crie voce mesmo. Nao peca ao Claude Code.

Resumo da Aula 1

1. Mapa de ferramentas: Divide-se em editores (Cursor, Copilot) e agentes de terminal (Claude Code, Codex CLI)
2. Claude Code: Loop de verificacao autonoma, contexto amplo, edicao multi-arquivo
3. Instalacao: curl -fsSL https://claude.ai/install.sh | bash uma linha basta
4. Palavras-chave: Backend, frontend, DB, deploy — basta saber o suficiente para apontar a direcao
5. Gerenciamento de contexto: CLAUDE.md (regras), requisitos.md (decisoes), progresso.md (estado) para externalizar a memoria da IA
6. Padrao de vibe coding: Excel → design DB → API → tela → adicionar funcionalidades. Ate 3 e magico, a partir de 5 comeca a rachar

Proximo: “Por que desmorona em 5 funcionalidades.”

Tarefa

1. Adicione mais 2 funcionalidades: Qualquer coisa. Observe ate onde vai bem e onde comeca a estranhar.
2. Melhore o CLAUDE.md: Abra e leia. Ha algo que nao entende? Informacao faltando? Edite voce mesmo.
3. Tente continuar em sessao nova: Feche e reabra Claude Code. Diga “continue a funcionalidade em andamento”. Observe a diferenca com e sem CLAUDE.md.

Curso Completo de Reins Engineering