Aula · Claude Code & Agentes de IA

A Evolução da IA

De um único neurônio artificial à arquitetura que deu origem ao Claude Code — uma jornada por décadas de inovação em Machine Learning.

← arraste para navegar pelos capítulos →

① Capítulo 1 O Primeiro Salto A máquina aprende a separar, empilhar e corrigir os próprios erros — sem regras explícitas.
1958 · O Neurônio Artificial
🔵
Perceptron
x₁ x₂ w₁ w₂ Σ+θ 0 ou 1 grupo A grupo B

A primeira rede neural treinável. Recebe entradas, aplica pesos e decide: 0 ou 1. Só funciona quando os grupos têm uma fronteira reta entre eles. O neurônio artificial em si é de 1943 (McCulloch-Pitts).

BinárioPesos wRosenblatt 1958
▶ Visualizar Classificação
1960–80s · Camadas e Poder
🟣
MLP — Múltiplas Camadas
Entrada Oculta Saída

Empilha neurônios em camadas. Cada camada aprende algo mais abstrato — bordas → formas → objetos. Quebra a limitação de "só linha reta".

Camadas ocultasNão-linearRepresentações
▶ Brincar com Redes Neurais
1986 · A Rede Aprende a Aprender
⬅️
Backpropagation
→ Forward: faz previsão Input x Rede f(x) Erro L ← Backward: corrige pesos ∂L/∂w w ← w − η·∂L/∂w

Calcula onde a rede errou e propaga a correção de trás para frente, ajustando cada peso. Sem ele, a rede não aprende — é o motor do treinamento.

GradienteCorreção de erroHinton 1986
② Capítulo 2 A IA se Especializa Cada problema difícil ganhou sua própria arquitetura — visão, sequência e memória.
1989–1998 · A IA Aprende a Ver
🖼️
CNN — Visão
Imagem H×W×C filtro Feat Maps Pool Max borda·textura forma·objeto pixels Conv ReLU Pooling

Filtros deslizam pela imagem detectando bordas, texturas e formas. Não analisa pixels separados — enxerga hierarquicamente, como o cérebro visual humano.

ConvoluçãoFiltros locaisLeCun 1998
1986–90s · A IA Aprende a Ouvir
🔄
RNN — Sequências
RNN t-1 RNN t RNN t+1 xₜ₋₁ xₜ xₜ₊₁ yₜ₋₁ yₜ yₜ₊₁ hₜ→ hₜ→

Processa dados em sequência — texto, áudio, séries de tempo. Passa um estado interno hₜ a cada passo. Problema: "esquece" o que aconteceu muito antes.

SequencialEstado hₜNLP · Áudio
1997 · A IA Aprende a Lembrar
🧠
LSTM — Memória Longa
Cell State — memória de longo prazo 🚪f Esquecer 🚪i Guardar 🚪o Usar hₜ₋₁ hₜ

Três portas de controle decidem o que esquecer, guardar e usar. Resolve o esquecimento de longo prazo da RNN — e abriu o caminho para NLP moderno.

Forget gateInput gateHochreiter 1997
③ Capítulo 3 O Grande Salto Em vez de ler em série, o modelo aprende onde focar — e isso muda a história.
2014–2015 · Foco Dinâmico
🔍
Mecanismo de Atenção
O gato sentou no tapete vermelho Scores ao gerar "tapete" 0.05 0.10 0.08 0.55 0.22

O modelo aprende onde prestar atenção. Para gerar "tapete", foca em "tapete" e "vermelho" — não em "no". Não é programado: descobre as relações durante o treinamento.

AlinhamentoFoco dinâmicoBahdanau 2015
2017 · "Attention is All You Need"
Transformer
Encoder Multi-Head Self-Attention Feed-Forward + Add&Norm Decoder Cross-Attn + Self-Attn Linear→Softmax→Token ⚡ Sem recorrência — tudo em paralelo

Abandona leitura em série. Processa tudo em paralelo com atenção em múltiplas "cabeças". Google publicou em 2017 — base de todos os LLMs modernos.

ParalelismoMulti-Head AttnQ · K · VGoogle 2017
④ Capítulo 4 Linguagem como Interface O modelo não apenas entende — ele raciocina, escreve código e opera sistemas.
2020–2023 · Escala Muda o Jogo
🌐
LLM — Grande Modelo
Transformer × N camadas 100B–1T+ params RLHF · Instrução Texto → Ação 📝 "crie uma API" 📁 repo + docs 💻 código + testes 🚀 review + deploy Prompt + Contexto → Resultado

Transformer em escala enorme + RLHF. O modelo passa a compreender intenção. O "chat" que você usa é esse LLM respondendo prompts com bilhões de parâmetros.

EscalaRLHFGPT · Claude
▶ Visualizar um LLM
2024–hoje · Agentes de IA (Claude Code)
🤖
Agente de IA
Sistema Agente de IA 👁 PERCEBE arquivos · terminal · APIs · BD 🧠 RACIOCINA raciocínio e planejamento AGE decide e executa com ferramentas 💾 LEMBRA memória curta e longa ↩ loop agêntico

Um agente não só percebe o ambiente — ele raciocina, age e lembra. Esses 4 pilares formam o loop agêntico que dá autonomia real ao Claude Code.

PercebeRaciocinaAgeLembra

"Agentes de IA, como o Claude Code, não nasceram do nada. São a consequência de 70 anos de evolução em como máquinas representam, aprendem e agem."

🧩 O Quebra-Cabeça Completo

Cada avanço resolveu uma limitação específica do anterior. Perceptron → MLP → Backprop → CNN → RNN → LSTM → Attention → Transformer → LLM → Agente. Décadas de pesquisa convergindo em um assistente que lê, escreve, raciocina e age no seu computador.

Perceptron → MLP → Backprop → CNN → RNN → LSTM → Attention → Transformer → 🤖 Claude
Parte 2 · DevAIOps na Prática

⚡ Claude Code

Agora que você entende como chegamos aqui — veja o que fazer com isso. Claude Code é o destino prático de toda essa evolução.

Crie sua conta no Claude aqui →
🤖 IA Agêntica — O Modelo Completo

Como um Agente de IA Funciona

Diferente de um chat comum, um agente conecta o LLM ao mundo real: ele tem memória, busca informação, executa ações e edita arquivos — tudo em um loop autônomo.

LLM Aumentado 🤖 Agente 💾 Short Memory Contexto da sessão 🗄️ Long Memory Files · CLAUDE.md 🔍 RAG Retrieval Busca semântica 🌐 Busca na Web Internet Data 🔧 MCP & Tools GitHub · Slack · DB 💻 Exec de Ações Terminal · Bash ✏️ Edição & Auto Read · Write · Edit 🌍 Mundo Real Output · Deploy
Mas o que é um Agente de IA, de verdade?

Um LLM aumentado com ferramentas ainda responde a um prompt. Um Agente de IA vai além: ele percebe, planeja, age e lembra — em loop contínuo e autônomo.

Ciclo dos 4 componentes de um Agente de IA 🤖 AGENTE DE IA LLM + Ferramentas + Memória loop contínuo e autônomo 👁 PERCEBE ① Observa o ambiente texto · APIs · arquivos terminal · sensores 🧠 PLANEJA ② Raciocina e decide chain-of-thought reflexão · priorização ⚡ AGE ③ Executa no ambiente ferramentas · código arquivos · APIs externas 💾 LEMBRA ④ Armazena e recupera contexto · histórico CLAUDE.md · memória
⚖️ O Problema e a Solução

❌ O Problema: Vibe Coding

Uso de IA baseado em prompts vagos e conversas soltas
Código inconsistente, decisões implícitas e arquitetura instável
A IA "interpreta", "inventa" e muda o comportamento a cada interação
Funciona no curto prazo — quebra no médio/longo
"My AI just wrote 10000 lines of code in 2 minutes. Now I will spend 2 days debugging it."

✅ A Solução: Claude Code + Skills + Plan Mode

Desenvolver a partir de especificações claras nos prompts, skills e verificáveis
Plan mode — revise o plano antes de qualquer execução
Skills definem como fazer; CLAUDE.md define o contexto do projeto
Use multi-agents para tarefas paralelas complexas
Agentes de IA amplificam a qualidade — ou o caos — dependendo de como você especifica, guia e fornece contexto.

🔔 Por Que Claude Code?

Junior usa Claude. Intermediário testa tudo. Expert volta pro Claude. Círculo completo.
Bell curve Claude Code meme
Existem outras ferramentas excelentes — Gemini CLI, Cursor, Codex CLI, Copilot — mas a Anthropic e o Claude estão consistentemente na vanguarda da IA neste momento: melhor modelo de linguagem e melhor ferramenta de desenvolvimento integrada. O meme resume bem: nos dois extremos do espectro, a escolha converge para Claude Code.
💪 Claude Code com Esteróides
Claude Code pixel art robot
🔌 Plugins Pacotes instaláveis que estendem as capacidades do Claude
📋 Skills Instruções reutilizáveis sobre como fazer tarefas específicas
⌨️ Commands Slash commands que disparam ações específicas instantaneamente
🔗 MCPs Model Context Protocol — conecta ao GitHub, Slack, bancos de dados...
🤖 Sub Agents Mini Claudes em paralelo — divide e conquista tarefas complexas
Claude Code como Neo de Matrix

Assim como o Neo aprende uma skill nova instantaneamente ao plugar o cabo, cada plugin, skill ou MCP adicionado ao Claude expande suas capacidades em segundos — sem reescrever nada.

🎯 12 Features que Todo Dev Deve Conhecer
1
CLAUDE.md
Memória do projeto — regras customizadas, stack info e comandos que Claude lê em toda sessão.
2
Permissions
Controle o que Claude pode ou não tocar — whitelist ou bloqueio de ferramentas por sessão.
3
Plan Mode
Revise o plano antes de Claude agir — aprove, edite ou rejeite cada step primeiro.
4
Checkpoints
Snapshots automáticos via git — reverta para qualquer ponto no tempo sem perder trabalho.
5
Skills
Instruções reutilizáveis que Claude segue automaticamente — armazenadas em .claude/skills/.
6
Hooks
Scripts customizados que rodam em PreToolUse, PostToolUse e Notification — controle determinístico.
7
MCP
Conecta Claude a qualquer ferramenta externa — bases de dados, APIs e serviços via Model Context Protocol.
8
Plugins
Estende Claude com integrações de terceiros — adiciona tools sem escrever código customizado.
9
Context
Alimenta Claude com o que importa — arquivos, histórico, tools e regras do projeto atual.
10
Slash Commands
Atalhos de um único comando — disparam ações salvas nas .claude/commands/.
11
Compaction
Comprime conversas longas para economizar tokens — mantém contexto fresco sem perder o essencial.
12
Subagents
Agentes paralelos para tarefas complexas — divide e conquista workflows multi-step.
🧭 Quando Usar o Quê
📄 CLAUDE.md
Memória persistente do projeto — contexto de arquitetura, convenções e regras que ficam sempre ativas.
📋 Skills
Workflows repetíveis — quando você precisa que Claude siga o mesmo processo toda vez (criar PR, escrever testes, etc).
🔗 MCPs
Integrações externas — quando Claude precisa ler/escrever em sistemas fora do filesystem local.
🤖 Subagents
Execução paralela — múltiplas tarefas independentes rodando ao mesmo tempo, cada uma com contexto isolado.
🔌 Plugins
Reutilização e distribuição — empacote skills + commands + agents para compartilhar entre projetos ou times.
🎯 Hooks
Controle determinístico — quando você quer garantir que certos scripts sempre rodem em pontos específicos.
📋 SDD — Specification-Driven Development

SDD inverte o fluxo usual com IA: em vez de prompts diretos, você primeiro define uma especificação — constituição de engenharia, requisitos e plano — e só então a IA implementa a partir desse artefato. O resultado é código previsível, auditável e versionável. É o antídoto para o vibe coding.

SDD — Specification-Driven Development com IA Agêntica e SpecKit CLARO E VERSIONADO Specs /specs/user-stories data-model.md plan.md tasks.md research contracts/ api.md component.md spec-kit plan-template.md spec-template.md tasks-template.md 🤖 IA AGÊNTICA Claude Code 💾 Memory 🔧 MCP & Tools ⚡ Execução PROPÓSITO E CONTEXTO Memory Bank Memory constitution.md Templates plan-template.md spec-template.md tasks-template.md spec-kit — Via Command Prompts /speckit.specify · /speckit.plan · /speckit.implement Instanciado via CLI

Arquitetura SDD: especificações versionáveis (esquerda) alimentam a IA Agêntica, que usa memória e ferramentas para gerar código a partir da spec — orquestrado pelo spec-kit via CLI.

SDD em ação no VS Code com GitHub SpecKit

GitHub SpecKit em ação no VS Code: o CLI inicializa o projeto, cria a constituição de engenharia e prepara os templates — tudo em .md versionáveis no repo.

🎯 Previsibilidade
Spec aprovada antes de implementar — sem surpresas no output nem retrabalho de última hora.
🗂️ Artefatos versionáveis
Spec, plano e tarefas ficam no repositório como documentação viva — revisável por qualquer membro do time.
🔄 Iteração controlada
Feedback em linguagem natural retorna ao ciclo SDD; nada é ad-hoc. O processo é o mesmo a cada iteração.
🤝 Agnóstico de ferramenta
Funciona com Copilot, Cursor, Windsurf e outros — nesta aula vamos usar com Claude Code.

Fluxo GitHub SpecKit:

/speckit.constitution /speckit.specify /speckit.plan /speckit.clarify /speckit.tasks ⛔ Gate obrigatório /speckit.implement
⚖ Quando Usar Cada Abordagem

Não existe bala de prata. A escolha da metodologia depende do tamanho, risco e longevidade do projeto.

NÍVEL 1
Vibe Coding puro
✓ Aceitável quando
  • PoCs e MVPs descartáveis
  • Laboratórios e experimentos
  • Scripts pessoais de uso único
  • Projetos pequenos sem continuidade
⚠ Nunca em produção — você entrega código que não entende e não domina. Vai te dar problema.
NÍVEL 2
Context Engineering
✓ Aceitável quando
  • Projetos médios com equipe pequena
  • Funcionalidades isoladas em codebase conhecida
  • Quando há bons prompts com detalhes técnicos
  • Skills + CLAUDE.md + MCPs configurados
  • RAG ou busca na web como contexto adicional
Você já especifica sem perceber — bons prompts, arquivos .md e context engineering são SDD informal.
NÍVEL 3
SDD com SpecKit
✓ Recomendado quando
  • Projetos grandes ou codebases complexas
  • Times com múltiplos desenvolvedores
  • Código de produção com requisitos de qualidade
  • Arquitetura difícil de entender ou documentar
  • Auditoria e rastreabilidade são exigências
✓ Reduz o ritmo, mas entrega código mais seguro, detalhado e previsível — com spec e plano versionáveis no repo.
🧪 Lab Time — Hora de Praticar

Os laboratórios foram desenhados para exercitar progressivamente os conceitos — do fracasso do Vibe Coding até o nirvana do desenvolvimento com Claude Code. Todos no repositório da ToolBoX.

📁
Repositório Completo — AI Labs
github.com/toolbox-playground/aulas-cloud-devops-exercicios-labs → artificial-intelligence-labs
GitHubTodos os Labs
01
Lab 001 — Introdução a IA Generativa
Primeiros passos com LLMs. Entender prompts, contexto e as bases do uso de modelos de linguagem na prática.
LLMPromptsBásico
02
Lab 002 — Gaming Startup com Vibe Coding ❌
Fracasso intencional. One-shot prompts sem contexto para desenvolver jogos complexos. Evidencia que a IA sem especificações inventa arquitetura e quebra no médio prazo.
Vibe CodingOne-shotAprender com o erro
03
Lab 003 — Context Engineering & Plan Mode
Usar CLAUDE.md, plan-mode e especificações claras para guiar o agente. A diferença entre dar um destino e dar um mapa completo.
CLAUDE.mdPlan ModeContext Eng.
04⭐
Lab 004 — Gaming Startup com Claude Code ✓ ← Principal desta aula
Sucesso real. Jogo totalmente funcional usando Claude Code com as melhores práticas: SDD, context engineering, MCPs — ao invés do vibe-coding do Lab 002. Evidencia que as IAs são limitadas só se você não souber usá-las.
🎯 Objetivo: o nirvana do dev com IA — Claude Code + Skills + Plan Mode + MCPs em ação.
Claude CodeSkillsMCPsSDDPlan ModeGaming
05🪮
Lab 005 — Gaming Startup com SDD SpecKit
Mesmo desafio do Lab 004, agora com Specification-Driven Development via GitHub SpecKit + Claude Code. Governança real: constituição → spec → plano → gate → implementação. Artefatos versionáveis no repo.
🪮 Diferencial: spec, plano e tarefas auditáveis — o código vira consequência da especificação, não o contrário.
Claude CodeSDDSpecKitPlan ModeGaming
🔗 Recursos para Explorar

Links essenciais para quem quer ir além — marketplaces, cheatsheets e tutoriais da comunidade.

📄
Claude Code Cheatsheet
Referência rápida de comandos, flags e dicas de uso do Claude Code.
awesomeclaude.ai ↗
🏪
Claude Marketplaces
Diretório de plugins, MCPs e integrações disponíveis para o Claude.
claudemarketplaces.com ↗
🔌
Claude Plugins Oficiais
Loja oficial de plugins da Anthropic — extensões verificadas para o Claude.
claude.com/plugins ↗
📖
Claude How-To
Guia prático da comunidade com exemplos de uso avançado do Claude.
github.com ↗

🚀 Você Chegou ao Nirvana do Dev com IA

A diferença entre Vibe Coding e desenvolvimento profissional com IA está no contexto, nas especificações e nas ferramentas certas. Claude Code + Skills + Plan Mode + MCPs = o atual estado da arte.

CLAUDE.md Plan Mode Skills MCPs Hooks Subagents Plugins context engineering