Pular para o conteúdo principal

Fase 1 — Fundamentos: entendendo Claude Code

Duração: 3 semanas · Dedicação: 6–8h/semana · Trilhas: 🟢🔵🟣 (todos os módulos são essenciais) Pré-requisito: Fase 0 (LLMs, tool use, taxonomia) ou conhecimento equivalente. Foco principal: Claude Code · Conceitos transferíveis: marcados explicitamente em cada módulo.

Objetivo da fase​

Sair da posição de "ouvi falar de Claude Code" para a posição de ter Claude Code instalado, autenticado e produzindo código real em pelo menos um projeto seu. Você vai entender o ecossistema de agentes de código apenas o suficiente para justificar a escolha por Claude Code, e depois mergulhar fundo na ferramenta.

Ao final desta fase você consegue:

  • Explicar o que é Claude Code e em que se diferencia das alternativas (em 2 minutos)
  • Instalar, autenticar e configurar Claude Code do zero em uma máquina nova
  • Usar modos interativo e plan, comandos básicos e o arquivo CLAUDE.md
  • Escrever prompts e contextos eficazes para tarefas de programação
  • Entregar um projeto pequeno no GitHub feito com Claude Code

Convenções de marcação​

Cada material está marcado com:

  • Tipo: 📚 Doc oficial · 📖 Artigo/Paper · 🎓 Curso · 🎬 Vídeo/Podcast · 🛠️ Hands-on/Repositório
  • Idioma: [PT] português · [EN] inglês
  • Custo: [Grátis] · [Pago] · [Freemium]
  • Nível: iniciante · intermediário · avançado

Materiais marcados com ⭐ são os essenciais — se tempo for curto, cubra apenas os ⭐. Materiais marcados com 🌐 são conceituais universais (transferíveis para qualquer agente).

M1 · Panorama do mercado e por que Claude Code

Por que este módulo​

Antes de mergulhar em uma ferramenta, você precisa entender onde ela se encaixa no mapa. Este módulo é deliberadamente curto (1–2 dias): só o suficiente para você ter referência das alternativas e justificar a escolha por Claude Code. Sem isso, você fica inseguro quando alguém perguntar "por que não Cursor?".

Tópicos​

  • 🌐 As 4 categorias de agentes de código em 2026:
    • IDE extension (GitHub Copilot, Cline, Continue)
    • Dedicated AI IDE (Cursor, Windsurf, Zed)
    • CLI/terminal agent (Claude Code, Aider, Codex CLI)
    • Cloud autonomous platform (Devin, OpenHands, Jules)
  • Onde Claude Code se posiciona (CLI/terminal-first) e suas forças:
    • Agnóstico de IDE — funciona em qualquer editor
    • MCP de primeira classe (foi um dos pioneiros)
    • Subagentes, hooks, slash commands, skills, plugins
    • SDK próprio (Claude Agent SDK)
    • Modelos Anthropic top-of-rank em SWE-bench Verified
  • Mapa muito breve das alternativas — só para reconhecer os nomes
  • Justificativa pessoal: "por que Claude Code para mim/meu time"

Materiais​

Conceitual fundamental ⭐​

  • ⭐ 🌐 📖 Building Effective AI Agents — Anthropic Engineering · [EN] [Grátis] intermediário Paper fundador. Define a diferença entre workflows e agentes e os 5 padrões básicos. Universal — leia mesmo sendo usuário Claude Code.

  • 🌐 🛠️ Anthropic Cookbook — Agent Patterns · [EN] [Grátis] intermediário Implementações Python dos 5 padrões. Ver o conceito em código solidifica.

  • 🌐 📖 Building agents with the Claude Agent SDK — Anthropic Engineering · [EN] [Grátis] intermediário Continuação prática. Bom para entender que Claude Code (produto) e Claude Agent SDK (biblioteca) são coisas diferentes — distinção que vai aparecer ao longo do plano.

Comparativos rápidos (para skim, não leitura linear)​

Específico Claude Code​

Exercício prático​

Em uma página única (markdown ou Notion), responda:

  1. Em qual das 4 categorias de agentes Claude Code se encaixa? Cite uma alternativa em cada outra categoria.
  2. Quais 3 forças do Claude Code mais te atraem para o seu contexto?
  3. Em que cenário do seu trabalho atual você imagina Claude Code agregando mais valor nas próximas semanas?

Esse documento curto vai ser referência sua quando alguém perguntar "por que escolheu Claude Code?".

Definition of Done​

  • Você consegue, em 2 minutos sem consultar nada, responder:
    • O que é um workflow agentic e em que difere de um agente
    • As 4 categorias de agentes de código e um exemplo de cada
    • 3 razões pelas quais Claude Code faz sentido para você

M2 · Instalação, autenticação e primeiros passos no Claude Code

Por que este módulo​

Esse é o módulo onde você realmente entra na ferramenta. Resolver setup uma vez bem feito, com CLAUDE.md configurado e gestão de chaves segura, evita atrito por meses.

Tópicos​

Instalação e autenticação​

  • Pré-requisitos: Node.js 20+, terminal moderno (zsh/fish/bash)
  • Instalação via npm install -g @anthropic-ai/claude-code
  • Duas formas de autenticar:
    • Via Console Anthropic (API key — pago por uso, mais flexível)
    • Via Claude.ai subscription (Pro/Max — usa cota do plano)
  • Comandos básicos: claude, /help, /login, /logout, /exit

Modos de operação​

  • Modo interativo (padrão) — conversa estilo REPL
  • Modo plan — Claude apresenta um plano antes de executar (Shift+Tab para alternar)
  • Modo headless (-p ou --print) — execução não-interativa, base para automação

Primeira interação real​

  • Iniciar Claude Code dentro de um repositório seu
  • Pedir uma exploração inicial ("explique este projeto")
  • Pedir uma pequena edição
  • Diferença entre confirmar ações com permissão e usar auto-accept

Estrutura inicial de projeto​

  • Arquivo CLAUDE.md — instruções persistentes para Claude no contexto do projeto
  • Localização: raiz do repositório (project memory) ou ~/.claude/CLAUDE.md (user memory)
  • Memória hierárquica e como Claude lê esses arquivos

Integração com IDE​

  • Plugin oficial para VS Code
  • Plugin oficial para JetBrains (IntelliJ, PyCharm, etc.)
  • Quando usar IDE plugin vs. terminal puro

Gestão segura de chaves de API​

  • macOS Keychain
  • 1Password CLI (op)
  • direnv + .envrc que NÃO entra no Git
  • Boas práticas para times (variáveis no Anthropic Console)

Materiais​

Quickstarts oficiais ⭐​

Cursos guiados ⭐​

  • ⭐ 🎓 Claude Code: A Highly Agentic Coding Assistant — DeepLearning.AI · [EN] [Grátis] iniciante Curso oficial Anthropic + Andrew Ng (Elie Schoppik instrutor). ~2h. Cobre: instalação, primeiros prompts, planejamento, thinking modes, sessões paralelas, memória, integração com GitHub, subagentes, Playwright via MCP. Faça este curso inteiro durante esta fase — vai puxar você para frente.

  • ⭐ 🎓 Claude Code in Action — Anthropic Skilljar · [EN] [Grátis] iniciante Curso oficial da Anthropic Academy. Complementar ao da DeepLearning.AI, com foco mais hands-on.

  • 🎓 Anthropic Academy — catálogo · [EN] [Grátis] Veja o que tem disponível — vários cursos curtos serão usados nas próximas fases.

Em português ⭐​

Vídeos curtos / referência​

Exercício prático​

Configure no seu computador:

  1. Claude Code instalado e autenticado — claude --version deve retornar versão válida
  2. Plugin de IDE configurado (VS Code ou JetBrains) — Claude rodando ao lado do código
  3. Primeira sessão real: abra Claude Code em um projeto seu existente, peça explique a arquitetura deste projeto, e leia a resposta
  4. Crie um CLAUDE.md no projeto com:
    • Linguagens e frameworks usados
    • Convenções do time (estilo de commit, padrões de teste)
    • Comandos importantes (build, test, lint)
    • O que Claude NÃO deve fazer (ex: nunca alterar migrations/, nunca tocar em secrets/)
  5. Faça uma edição real com Claude Code (uma função pequena, melhorar um teste, ajustar README)
  6. Tente o modo plan (Shift+Tab) numa tarefa de média complexidade e veja a diferença
  7. Suas chaves de API estão em local seguro (macOS Keychain, 1Password ou direnv com .envrc no .gitignore)
  8. Documente os passos do seu setup em um README pessoal meu-setup-claude-code.md

Definition of Done​

  • claude --version retorna versão válida
  • Você consegue abrir Claude Code em um projeto e pedir uma edição que ele executa corretamente
  • Tem CLAUDE.md configurado em pelo menos 1 projeto seu
  • Sabe alternar entre modo interativo e modo plan
  • Sabe quanto está gastando por dia (Anthropic Console ou plano)
  • Suas chaves de API não estão em arquivos versionados

M3 · Engenharia de prompts e context engineering com Claude

Por que este módulo​

O Claude Code é tão bom quanto o contexto que recebe. A maior diferença entre devs que ganham 5x produtividade e devs que dizem "esses agentes são meio bobos" está aqui.

Atenção ao termo: em 2025/2026 a comunidade migrou de "prompt engineering" para "context engineering" — porque o que importa não é o prompt isolado, mas todo o contexto (instruções, exemplos, ferramentas, memória, CLAUDE.md, MCP servers) que o agente recebe. Vamos cobrir os dois lados.

🌐 Os conceitos deste módulo são universais — funcionam em Claude, GPT, Gemini, Cursor, Aider. A diferença está em como você materializa o contexto em cada ferramenta.

Tópicos​

Universais (qualquer LLM/agente) 🌐​

  • Anatomia de um bom prompt: papel, contexto, restrições, exemplos, formato esperado, critério de aceitação
  • Chain-of-thought aplicado a tarefas de programação (e quando NÃO usar)
  • Few-shot prompting com exemplos de código
  • Iteração: follow-ups, correções, refinamento
  • Anti-padrões comuns: prompts vagos, falta de critério de aceitação, "faça melhor", scope-creep

Específicos do Claude​

  • XML tags — Claude responde particularmente bem a <contexto>, <exemplo>, <regras>
  • Thinking modes do Claude Code (think, think hard, think harder, ultrathink) e quando ativar
  • Extended thinking — quando o modelo "pensa" antes de responder

Context engineering específico do Claude Code​

  • CLAUDE.md como contexto persistente (project memory)
  • Como anexar arquivos no contexto da sessão
  • Quando pedir para Claude ler primeiro vs. assumir que ele sabe
  • Sinais de que o contexto está saturado (e o que fazer)

Materiais​

Documentação oficial ⭐​

Cursos gratuitos ⭐​

Cursos pagos (opcional)​

Artigos / context engineering ⭐​

Livros (opcional, intermediário)​

  • 🌐 📖 Prompt Engineering for Generative AI — O'Reilly (Phoenix & Taylor) · [EN] [Pago] intermediário

  • ⭐ 🌐 📖 AI Engineering — Chip Huyen, O'Reilly · [EN] [Pago] intermediário a avançado Livro de referência mais amplo sobre engenharia em torno de LLMs. Capítulos sobre prompts e context são excelentes. Investimento que vale para os anos seguintes.

Em português​

  • 🎬 Canais YouTube PT-BR sobre prompt engineering: Filipe Deschamps, Asimov Academy, Códigos Fonte TV — busque por "prompt engineering" + nome. Nível misto, qualidade variável; use como complemento, não como base.

Exercício prático​

Pegue uma tarefa de código de média complexidade do seu trabalho real (refatorar uma função, escrever testes para um módulo, debugar um bug não trivial). Faça três versões do mesmo prompt no Claude Code:

  1. Versão "preguiçosa": "ajuda aqui" + abre o arquivo
  2. Versão estruturada: com papel, contexto, restrições, formato (use XML tags do Claude: <contexto>, <regras>, <formato>)
  3. Versão estruturada com CLAUDE.md melhorado: versão 2 + atualize o CLAUDE.md do projeto com convenções relevantes antes

Compare as três saídas. Documente as diferenças em learnings-prompt.md. Esse é o exercício mais valioso da fase inteira.

Bônus: rode a mesma versão 3 com claude --think hard e compare com a saída sem thinking estendido.

Definition of Done​

  • Você tem um template pessoal de prompt para 3 tarefas que faz toda semana
  • Sabe quando usar chain-of-thought / thinking modes e quando NÃO usar
  • Consegue identificar e corrigir um prompt vago em 1 minuto
  • Tem CLAUDE.md rico em pelo menos 1 projeto seu

M4 · Primeiros workflows hands-on com Claude Code

Por que este módulo​

Conhecimento sem prática evapora em 2 semanas. Este módulo é onde você consolida tudo da Fase 1 num projeto pequeno, real e seu — que vai virar referência para o resto do plano.

Tópicos​

  • Iniciar um projeto do zero usando Claude Code como par de programação
  • Refatorar um pedaço de código existente seu com Claude Code
  • Adicionar testes a um módulo sem testes
  • Usar modo plan antes de executar tarefas grandes
  • Versionar tudo no Git e documentar o processo
  • Aprender a dar feedback para Claude (corrigir, refinar, replanejar)

Materiais​

Práticos ⭐​

Inspiração / casos reais​

Projeto da Fase 1 (entregável)​

Construa um pequeno projeto pessoal e original (não copie de tutorial) usando Claude Code como par de programação principal. Sugestões:

  • CLI simples em Python ou Node.js que faça algo útil para você (ex: organizador de PDFs por tema, contador de horas trabalhadas, gerador de changelog)
  • Pequena API REST com 3 endpoints e testes
  • Script de migração ou ETL de algum dado seu
  • Pequena ferramenta interna (ex: gerador de slides a partir de markdown)

Requisitos do entregável​

  • Repositório público no GitHub com README
  • CLAUDE.md completo na raiz, descrevendo: contexto do projeto, convenções, comandos, restrições
  • Pelo menos um uso documentado de modo plan (screenshot ou cópia da sessão)
  • Cobertura de testes mínima (≥60%)
  • Histórico Git limpo com mensagens semânticas (podem ser geradas por Claude Code)
  • Um arquivo LEARNINGS.md documentando:
    • 3 prompts que funcionaram bem (com a saída de Claude)
    • 1 prompt que falhou e como você corrigiu
    • O que você aprendeu sobre Claude Code que não estava em nenhum tutorial

Tempo estimado: 6–10h ao longo da última semana da fase.

Definition of Done​

  • Projeto público no GitHub
  • CLAUDE.md configurado e útil
  • LEARNINGS.md com 5+ observações concretas
  • Você consegue, em uma reunião de 5 minutos, explicar para outro dev como Claude Code te ajudou neste projeto e o que ele NÃO conseguiu fazer

Auto-avaliação ao final da Fase 1

Marque ✅ no que você consegue fazer agora sem ajuda:

  • Explicar a diferença entre LLM, copiloto e agente autônomo
  • Citar as 4 categorias de agentes de código e onde Claude Code se encaixa
  • Justificar a escolha por Claude Code em 2 minutos
  • Instalar e autenticar Claude Code do zero em uma máquina nova
  • Configurar CLAUDE.md rico em um projeto
  • Alternar entre modo interativo e modo plan
  • Escrever um prompt estruturado (papel, contexto, restrições, formato) usando XML tags
  • Identificar quando NÃO usar Claude Code (ou ativar thinking mode)
  • Apontar 3 anti-padrões comuns em prompts de código
  • Explicar o paper Building Effective Agents da Anthropic em 2 minutos

Se você marcou 7+ itens, está pronto para a Fase 2. Se marcou menos de 6, considere refazer o módulo correspondente antes de avançar — a Fase 2 assume essas bases.

Próxima fase​

Fase 2 — Fluência: usando Claude Code no dia a dia (4 semanas) cobre os módulos M5 a M11: automação de tarefas, spec-driven development com Claude Code, TDD, Git/PR/code review, debugging, documentação automatizada e codebases grandes.

Será expandida quando você concluir e validar a Fase 1.