Curso 3: Desenvolvimento Agêntico

Encontro 1

Claude Code Básico
Do chat ao terminal

3 horasBloom: Analisar / Criar

Instrutor: Rodrigo Pinto

Slide titulo. Esperar todos entrarem (10 min acomodação). Energia alta. Público técnico: desenvolvedores ou servidores com perfil técnico. Pré-requisito: Cursos 1+2 ou experiência técnica equivalente.

A Jornada até Aqui

4 Níveis de Uso de IA

Nível 4 — VOCÊS ESTÃO AQUI

Desenvolvimento Agêntico

"Construo com IA" — Este curso!

Nível 3

Context Engineering

"Projeto com IA"

Nível 2

Wrappers e Automação

"Configuro IA" — Curso 2

Nível 1

Engenharia de Prompt

"Converso com IA" — Curso 1

Recap da progressão. "No Curso 1 aprendemos a CONVERSAR com IA. No Curso 2, a CONFIGURAR. Agora vamos CONSTRUIR." Mostrar de baixo para cima. Público técnico já domina níveis 1-2.

De configurar
para construir

Curso 1

Chat web

1 prompt → 1 resposta

Curso 2

Wrappers + n8n

1 workflow → automação

Curso 3

Terminal (CLI)

Sistema completo → agentes

A IA deixa de ser uma ferramenta de texto e vira um parceiro de desenvolvimento.

Transição clara entre cursos. Enfatizar: "Aqui a IA não responde perguntas. Ela lê arquivos, edita código, executa comandos." O salto é grande mas construído sobre o que já sabem.

Abertura Interativa

Quem aqui já
usou o terminal?

E quem já usou IA dentro do terminal?

Hoje vamos juntar as duas coisas.

Levantar mãos. Calibrar o nível da turma. A maioria deve conhecer terminal. Poucos devem ter usado IA no terminal. "E se a IA pudesse navegar pelo seu projeto inteiro, ler arquivos, editar código, e rodar testes?"

Objetivo do Encontro 1

Ao final de hoje, você vai saber:

1. O que é Claude Code e por que usar o terminal para desenvolvimento

2. Como criar e estruturar um CLAUDE.md — o DNA do seu projeto

3. Os comandos básicos e como usar Claude Code para construir

Mostrar os 3 objetivos. Cada um será um Ciclo. Total: 3h com intervalo de 20 min. Ciclo 1: O que e + setup. Ciclo 2: CLAUDE.md. Ciclo 3: Comandos + exercício prático.

Mapa do Encontro

3 Horas, 3 Ciclos

30 min

Ciclo 1

O que é Claude Code
Instalação + Setup

30 min

Ciclo 2

CLAUDE.md
O DNA do Projeto

20 min

Intervalo

Café
 

30 min

Ciclo 3

Primeiros Comandos
Exercício Prático

20 min

Recap

Recap em Duplas
+ Fechamento

Visão geral do encontro. "Formato prático: teoria curta, demo ao vivo, e prática imediata." Tempo: min 15-20 de acomodação + abertura.
Ciclo 1

O que e
Claude Code?

CLI vs Interfaces Gráficas

Início do Ciclo 1. Tempo: min 30. Tom: empolgante, técnico mas acessível. "Até agora vocês usaram IA numa caixa de texto. Agora ela vai morar no seu terminal."

Duas formas de usar Claude

Claude.ai (Chat)

  • Interface web gráfica
  • Você digita, ele responde
  • Sem acesso ao seu computador
  • Não lê seus arquivos
  • Não edita seu código

Ótimo para perguntas e texto

Claude Code (CLI)

  • Roda no seu terminal
  • Acessa seu sistema de arquivos
  • Le, edita e cria código
  • Executa comandos bash
  • Navega seu projeto inteiro

Agente de desenvolvimento completo

Comparação lado a lado. "Claude.ai é um chatbot. Claude Code é um AGENTE. A diferença? Agente AGE. Não apenas responde: ele executa." Demo: abrir ambos e mostrar a diferença.

Por que o terminal?

Acesso total ao projeto — Lê qualquer arquivo, entende a estrutura

Loop de feedback — Edita, roda, vê o erro, corrige. Sozinho.

Contexto real — Não precisa copiar/colar. Ele vê o que você vê.

Ferramentas nativas — Git, npm, pip, testes... tudo integrado.

Copiar/colar código no chat ficou no passado.

"Lembram de copiar 200 linhas de código no ChatGPT? E ele responder com código que não funciona porque não tem contexto do resto? Isso acabou." O terminal dá ao agente o contexto completo.

Como Claude Code funciona

ComponenteDescrição
VocêDescreve a tarefa em linguagem natural
Claude CodePlaneja, lê arquivos, escreve código, executa
FerramentasRead, Edit, Write, Bash, Grep, Glob...
Seu projetoArquivos, git, configs — o agente navega tudo

O fluxo: você pede → agente planeja → lê contexto → executa → verifica → repete até concluir.

Explicar o loop agêntico. "Diferente do chat onde você pergunta e ele responde UMA VEZ, aqui o agente ITERA. Ele tenta, erra, corrige, e tenta de novo. Como um desenvolvedor de verdade."

Setup

Instalação em 3 passos

# 1. Instalar via npm (Node.js 18+ necessário)

$ npm install -g @anthropic-ai/claude-code

 

# 2. Navegar até o projeto

$ cd meu-projeto/

 

# 3. Iniciar Claude Code

$ claude

Claude Code v1.x.x

? How can I help you?

Pré-requisito: Node.js 18+, conta Anthropic com API key ou plano Max/Pro.

DEMO AO VIVO. Abrir terminal, rodar a instalação. Mostrar que é simples. Se alguém não tiver Node, ajudar no intervalo. "A magia começa com um único comando: claude."

Demo ao Vivo

Primeiro contato

claude> o que tem nesse projeto?

 

Vou analisar a estrutura do projeto...

# Claude lê arquivos, analisa package.json,

# README, estrutura de pastas...

 

Este é um projeto React com TypeScript que...

Percebam: ele não "imaginou" o projeto.

Ele LEU os arquivos. Contexto real, não alucinação.

Demo real: abrir um projeto e perguntar. Mostrar como ele usa as tools (Read, Glob) para explorar. "Vejam no log: ele leu 8 arquivos antes de responder. Isso é Context Engineering na prática." Comparar com chat onde você precisaria colar tudo.

Chat vs Agente: a diferença fundamental

Chat (Claude.ai)

Você: "Corrija o bug no login"
IA: "Tente trocar a linha 42 por..."
Você: *copia, cola, testa*
Você: "Não funcionou"
IA: "Então tente..."
→ 10 ciclos manuais

Agente (Claude Code)

Você: "Corrija o bug no login"
Agente: *lê o código*
Agente: *encontra o bug*
Agente: *edita o arquivo*
Agente: *roda os testes*
→ 1 comando, pronto

"Essa é a revolução. De copiar/colar para delegação real." O agente faz o loop inteiro: ler, entender, corrigir, testar, verificar. Tempo economizado: 10x em muitos cenários.
Exercício 1 — 10 min

Setup + Primeiro Comando

1. Abram o terminal (VS Code ou sistema)

2. Verifiquem: node --version (precisa ser 18+)

3. Instalem: npm install -g @anthropic-ai/claude-code

4. Naveguem até qualquer pasta com código e rodem: claude

5. Perguntem: "O que tem nesse projeto?" — Observem o que ele faz!

Circular pela sala. Ajudar quem tiver problemas de instalação. Se alguém não tiver Node, sugerir nvm. O importante é que todos consigam rodar 'claude' e fazer a primeira pergunta. Quem já tem instalado: explore! Pergunte coisas sobre o projeto.
Ciclo 2

CLAUDE.md

O DNA do Projeto

Transição para Ciclo 2. Tempo: min 60. "Instalar é fácil. O segredo de VERDADE é dar contexto ao agente. E isso começa com um arquivo: CLAUDE.md"

O que é CLAUDE.md?

CLAUDE.md é o system prompt do seu projeto. Tudo que o agente precisa saber para trabalhar bem, num único arquivo.

O que colocar

  • Visão geral do projeto
  • Stack tecnológica
  • Convenções de código
  • Comandos para rodar/testar
  • Decisões arquiteturais

O que NÃO colocar

  • Secrets ou API keys
  • Dados pessoais
  • Informações que mudam todo dia
  • Texto genérico sem valor
  • Conteúdo duplicado do README
"Pensem assim: se um dev novo entrasse no projeto, o que você diria primeiro? Isso é o CLAUDE.md." Ele é lido AUTOMATICAMENTE toda vez que você inicia o Claude Code na pasta.

Hierarquia: 3 níveis de contexto

~/.claude/CLAUDE.md — Global

Suas preferências pessoais. Linguagem, estilo, convenções que você usa em TODOS os projetos.

./CLAUDE.md — Projeto (raiz)

Informações do projeto: stack, comandos, arquitetura, convenções do time.

./pasta/CLAUDE.md — Subpasta

Instruções específicas daquela área. Ex: ./api/CLAUDE.md com regras de endpoints.

Claude Code le todos os níveis e combina. Mais específico prevalece.

"É como herança em programação. O global define defaults, o projeto customiza, e a subpasta sobrescreve o que precisa." Exemplo real: global diz 'use TypeScript', projeto diz 'use React', subpasta diz 'aqui é a API, use Express'.

Exemplo Real

Um CLAUDE.md bem escrito

# Projeto: API de Gestão de Documentos

 

## Stack

- Python 3.12, FastAPI, SQLAlchemy, PostgreSQL

- Testes: pytest + httpx

 

## Comandos

- Rodar: uvicorn app.main:app --reload

- Testes: pytest -x --tb=short

- Lint: ruff check .

 

## Convenções

- Endpoints retornam Pydantic models, nunca dicts

- Toda rota tem docstring com exemplo

- Nomes de variáveis em português (snake_case)

 

## Arquitetura

- app/routers/ — endpoints por domínio

- app/models/ — SQLAlchemy models

- app/schemas/ — Pydantic schemas

Exemplo concreto. "Vejam: direto, prático, sem enrolação. Cada seção responde uma pergunta que o agente teria." Mostrar como isso muda a qualidade das respostas do agente.

Boas instruções vs más instruções

CLAUDE.md ruim

"Este é um projeto legal.
Use boas práticas.
Faça código bonito.
Siga os padrões."

Vago, genérico, inútil

CLAUDE.md bom

"Stack: React 18 + TypeScript 5
Testes: vitest, cobertura min 80%
CSS: Tailwind, nunca CSS inline
Rodar: npm run dev (porta 3000)
Testar: npm test"

Específico, acionável, mensurável

Regra: se um humano novo no time não entenderia, o agente também não vai.

"Lembram do Curso 1? Prompts vagos geram respostas vagas. CLAUDE.md é o mesmo princípio, aplicado ao projeto inteiro." A qualidade do CLAUDE.md determina a qualidade do trabalho do agente.
Exercício 2 — 15 min

Crie seu CLAUDE.md

1. Escolham um projeto pessoal (ou criem uma pasta nova)

2. Criem um arquivo CLAUDE.md na raiz

3. Incluam: Stack, Comandos, Convenções, Arquitetura

4. Iniciem Claude Code nessa pasta e perguntem algo sobre o projeto

5. Comparem: resposta COM CLAUDE.md vs SEM. Qual é mais precisa?

Dica: podem pedir ao próprio Claude Code para AJUDAR a criar o CLAUDE.md!

Circular pela sala. Ajudar quem estiver travado. Dica: quem não tem projeto pode criar um com 'mkdir meu-projeto && cd meu-projeto && npm init -y'. O ponto é sentir a diferença que o CLAUDE.md faz. Tempo: 15 min. Pedir 1-2 exemplos bons para compartilhar.

Debrief — Exercício 2

O que mudou com o CLAUDE.md?

Sem CLAUDE.md

Respostas genéricas, suposições erradas, estilo inconsistente

CLAUDE.md básico

Respostas alinhadas com a stack, comandos corretos

CLAUDE.md completo

Agente segue convenções, testa, e entrega código production-ready

CLAUDE.md é Context Engineering aplicado ao nível de projeto.

Pedir exemplos da turma. "Quem sentiu diferença?" (todos). Transição: "Agora que o agente sabe QUEM ele é e ONDE está, vamos aprender a COMANDAR ele." Tempo: min 85. Intervalo a seguir.

☕

Intervalo

20 minutos

Voltamos para colocar a mão no código — primeiros comandos reais.

Intervalo REAL de 20 minutos. Tempo: min 90-110. Quem tiver problemas de instalação: ajudar agora. Garantir que todos voltam no horário.
Ciclo 3

Primeiros
Comandos

Como dar tarefas ao agente

Início do Ciclo 3. Tempo: min 110. "Agora vem a parte divertida. Vamos fazer o agente TRABALHAR." Tom: hands-on, prático, empolgante.

As ferramentas do agente

Ler

  • Read — lê arquivos
  • Glob — busca por padrão
  • Grep — busca em conteúdo

Escrever

  • Write — cria arquivos
  • Edit — edita trechos
  • NotebookEdit — Jupyter

Executar

  • Bash — comandos shell
  • WebFetch — busca web
  • WebSearch — pesquisa

Você não precisa chamar as ferramentas. O agente escolhe sozinho qual usar.

"Você diz 'encontre todos os arquivos que importam a função X'. O agente decide: primeiro Glob para achar arquivos, depois Grep para buscar a função, depois Read para ler o contexto." Tudo automático.

Dicas Práticas

Como dar boas tarefas

Seja específico: "Crie um endpoint GET /users que retorna lista páginada" — não "faz a API"

Dê contexto: "Olhe o arquivo routes/auth.py como referência de estilo"

Peça verificação: "Depois de implementar, rode os testes e corrija se falhar"

Itere: "Agora refatore para usar async/await" — o contexto persiste na sessão

"Mesmos princípios do Curso 1: clareza, contexto, especificidade. Mas agora o impacto é MULTIPLICADO porque o agente age, não apenas responde." Demo: mostrar uma tarefa boa vs uma vaga.

Permission Modes: segurança no agente

Claude Code pede permissão antes de agir. Você controla o nível.

Leitura — Sempre permitido

Read, Glob, Grep: o agente sempre pode ler. Sem risco.

Escrita — Pede confirmação

Write, Edit: mostra o diff antes de aplicar. Você aprova ou rejeita.

Execução — Pede confirmação

Bash: mostra o comando antes de rodar. Você decide se executa.

Dica: --dangerously-skip-permissions existe, mas nunca use em produção.

"Segurança por design. Lembram da Portaria 227 do Curso 1? Aqui é o mesmo princípio: supervisão humana obrigatória." Mostrar o fluxo: agente propõe, você aprova, agente executa. Modo allowlist também existe para automação segura.

Referência Rápida

Comandos que você vai usar todo dia

# Iniciar conversa

$ claude

 

# Comando direto (sem modo interativo)

$ claude -p "liste todos os TODOs neste projeto"

 

# Continuar sessão anterior

$ claude --continue

 

# Dentro do Claude Code:

claude> /help # ver comandos disponíveis

claude> /clear # limpar contexto

claude> /cost # ver custo da sessão

Referência rápida. "Não precisam decorar. Mas esses são os que vocês vão usar 90% do tempo." Demo: mostrar cada um rapidamente no terminal.
Exercício 3 — 20 min

Construa algo com Claude Code

Escolham UMA das opções:

Opção A: Script Python

"Crie um script que le um CSV, calcula estatísticas básicas, e gera um relatório em Markdown"

Opção B: Página HTML

"Crie uma página HTML responsiva com um formulário de contato bonito, usando apenas HTML e CSS"

Opção C: Seu próprio projeto

"Peça algo útil para o SEU trabalho: script de automação, template, ferramenta interna"

Lembrem: o CLAUDE.md que vocês criaram está lá. O agente vai usá-lo!

Exercício principal do encontro. 20 min. Circular MUITO. Observar como cada um interage com o agente. Anotar exemplos bons e problemas comuns para o debrief. Encorajar a iterar: "Não ficou bom? Peça para melhorar! O agente mantém o contexto."

Debrief — Exercício 3

O que observaram?

O agente leu arquivos existentes antes de criar novos?

Ele seguiu as convenções do CLAUDE.md?

Quando deu erro, ele tentou corrigir sozinho?

Isso é o loop agêntico: planejar → executar → verificar → corrigir → repetir

Você não está mais usando IA. Você está colaborando com um agente.

Pedir 2-3 exemplos da turma. Perguntar: "Quem ficou surpreso com algo que o agente fez?" Enfatizar o loop agêntico e a diferença para o chat simples. Tempo: min 135.
Atividade Final — 15 min

Recap em Duplas

1. Formem duplas

2. Mostrem ao colega: seu CLAUDE.md é o que construíram no Exercício 3

3. Expliquem: qual a diferença entre usar chat e usar Claude Code?

4. Discutam: como poderiam usar isso no trabalho do dia-a-dia?

15 min. Circular e ouvir. Nos últimos 5 min, pedir 2-3 duplas para compartilhar com a turma. Foco em aplicações práticas no trabalho. Tempo: min 140-155.

3 Perguntas para as Duplas

1

Qual a diferença entre Claude.ai (chat) e Claude Code (agente)?

2

O que deve conter um bom CLAUDE.md e por que ele importa?

3

De um exemplo de tarefa que é melhor para o agente do que para o chat.

Projetar as perguntas. Ajuda as duplas a focar. Circular e ouvir respostas. Tempo: min 145-155.

Fechamento

O que levar do Encontro 1

Claude Code é um agente, não um chatbot — ele age, não apenas responde

CLAUDE.md é o system prompt do projeto — quanto melhor, melhor o resultado

O loop agêntico: planejar → ler → executar → verificar → corrigir

Permission modes garantem que você está no controle

Recap rápido dos 4 pontos principais. Enfatizar: "Hoje foi o básico. No próximo encontro vamos aprender a MAXIMIZAR o contexto que o agente recebe."

Próximo Encontro

Encontro 2:
Engenharia de Contexto
em Repositórios

Hoje aprenderam a usar a ferramenta. Na próxima, vão aprender a maximizar o contexto que o agente recebe.

CLAUDE.md hierárquico

Contexto por camadas

Skills

Ferramentas reutilizáveis

Memory files

Persistência entre sessões

Criar expectativa. "Se hoje com um CLAUDE.md simples já deu resultado, imaginem com Context Engineering completo." Tarefa de casa a seguir.

Tarefa para o Próximo Encontro

Pratiquem esta semana

1. Usem Claude Code em pelo menos 1 tarefa real do trabalho

2. Refinem o CLAUDE.md do projeto — adicionem mais detalhes

3. Anotem: 1 coisa que o agente fez melhor que você esperava, e 1 que fez pior

Tarefa prática. "Não adianta só ver aqui. Usem no dia-a-dia. Tragam as experiências para o próximo encontro." A prática é o que fixa o aprendizado.

Até o próximo
encontro!

Curso 3: Desenvolvimento Agêntico

Rodrigo Pinto

Método Tempo para o que Importa

Encerrar no horário. Agradecer a participacao. Lembrar da tarefa de casa e dos pre-requisitos do próximo encontro (trazer projeto com CLAUDE.md).
1 / 35