Claude Code
Mini tutorial
Como usar o Claude Code para ser 100x mais produtivo. Guia completo do sistema para profissionais do conhecimento.
Quem está te ensinando isso
Iwo Szapar
Cofundei o AI Maturity Index (adquirido pela ISG, Nasdaq: III em janeiro de 2026). Ajudei mais de 3.000 empresas a transformar a forma como trabalham. Apareci no Financial Times e na Forbes — e toco todo o meu negócio com o sistema que você está prestes a aprender.
Credenciais:
- • Mais de 1.164 dias de uso diário de IA
- • Mais de 30 agentes próprios em produção
- • 3 produtos movidos a IA criados
- • Consultor de times da Fortune 500
O que me diferencia:
- • Engenharia de contexto, não truques de prompt
- • Um sistema real com mais de 30 agentes (não teoria)
- • Foco em quem não é técnico
Como percorrer este tutorial
Este guia está estruturado em 6 etapas progressivas, mais uma nova camada de engenharia de harness para um trabalho com IA confiável.
Etapas 1-2: Fundamentos (15 min)
Entenda o que é o Claude Code e deixe-o instalado
Etapas 3-4: O poder essencial (30 min)
Divulgação progressiva, hooks, agentes, skills e aprendizado cumulativo
Etapa 5: Avançado (20 min)
Integrações MCP para conectar suas ferramentas de negócio
Etapa 6: Implementação (10 min)
Seu caminho a seguir com templates prontos
Dica: Clique nos títulos das seções para expandir ou recolher. Economize tempo focando no que você mais precisa.
Início rápido: seus primeiros 10 minutos
Quer ver a mágica antes de ler a teoria? Escolha sua configuração e faça isso agora mesmo.
Instale o Claude Code (2 min)
curl -fsSL https://claude.ai/install.sh | bashAbra o terminal, autentique-se e inicie
claude login
claudeDiga isto (copie e cole literalmente):
"Research the top 3 competitors in my space and
summarize their pricing models. Run them in parallel
with subagents."Veja o Claude iniciar vários agentes automaticamente
Você acabou de rodar um fluxo de trabalho multiagente. Três trabalhadores de IA pesquisaram em paralelo enquanto você descansava. Essa é a ideia central — agora siga lendo para ver como construir um sistema completo ao redor dela.
Já usa o Claude Code? Pule direto para Etapa 4: Agentes, skills, hooks e harnesses para ver os padrões avançados de orquestração.
Entendimento: a virada do chat para a IA baseada em repositório
Introdução em 30 segundos
O Claude Code é um agente de programação com IA da Anthropic que funciona no seu terminal, na IDE, no app de desktop e no navegador. As sessões ainda começam do zero, mas o seu repositório pode carregar um contexto duradouro por meio de arquivos como CLAUDE.md, .claude/rules/, skills, agentes e documentação do projeto.
"O Claude Code é a ferramenta de IA mais subestimada para quem não é técnico."
Três formas de trabalhar com o Claude
A nomenclatura confunde porque o app de desktop agora tem várias abas. Separe a superfície do produto do fluxo de trabalho que você quer.
Aba Chat · Navegador ou app
Claude Chat
- • Ideal para perguntas, rascunhos, brainstorming
- • Não exige fluxo de trabalho com repositório
- • Arquivos são anexos, não um cérebro de projeto
- • Use quando a tarefa é pontual
Ideal para: pensar rápido, não para sistemas reutilizáveis
Aba Cowork · App de desktop
Claude Cowork
- • Agente autônomo em segundo plano em uma VM na nuvem
- • Bom para tarefas de conhecimento mais longas
- • Menos configuração que os fluxos de terminal
- • Ótimo ponto de partida se você quer resultados, não infraestrutura
Ideal para: consultores, analistas, operadores
Aba Code, CLI, IDE, web
Claude Code (este guia)
- • Agente de programação para arquivos, repos, GitHub e automação
- • Roda no terminal, em IDEs, no app de desktop, no navegador, no Slack e em CI/CD
- • Skills, subagentes, hooks, MCP, rotinas e sessões em segundo plano
- • Mais poderoso quando o seu trabalho vive em um repositório estruturado
Ideal para: usuários avançados que constroem um sistema operacional reutilizável
Você está lendo o guia disto ↗Em dúvida? Use o Chat para pensar de forma pontual, o Cowork para trabalho em segundo plano com pouca configuração e o Claude Code quando quiser memória de projeto, fluxos personalizados, hooks, MCP e sistemas repetíveis.
Qualquer profissional do conhecimento que:
- Faz trabalho repetitivo que segue padrões (relatórios, e-mails, propostas, conteúdo)
- Gerencia projetos contínuos em que o contexto importa ao longo de semanas e meses
- Faz malabarismo com várias ferramentas (CRM, e-mail, agenda, analytics, plataformas de conteúdo)
- Quer uma IA que fica mais inteligente com o tempo, em vez de uma que esquece tudo depois de cada chat
Consultores
Relatórios de clientes, propostas, frameworks
Gerentes de produto
PRDs, roadmaps, histórias de usuário
Profissionais de marketing
Calendários de conteúdo, campanhas
Fundadores
Estratégia, updates para investidores, operações
Vendas e receita
Pipeline, prospecção, automação de CRM
Pesquisadores e analistas
Síntese de dados, inteligência competitiva
Não é ideal para:
Perguntas pontuais sem continuidade, sessões simples de brainstorming ou tarefas que nunca se repetem. Para isso, o chat normal do Claude funciona bem.
"Eu não sou programador. Não escrevo código. Então é incrível que esse tipo de coisa esteja disponível e possa acontecer."
— Dominic, consultor de cloud • Construiu uma plataforma de assinaturas com o Claude Code sem nenhuma base em programação
Antes de mergulharmos
Veja para onde você está construindo
Este tutorial ensina cada conceito passo a passo. Mas se você quer ver como um sistema completo se parece na prática, aqui está um clipe de 3 minutos de uma sessão ao vivo.
Um comando. A IA lê seus e-mails, mensagens de WhatsApp, tarefas e CRM — e então te diz no que focar hoje. Tudo o que você vê aqui, você vai aprender a construir nas etapas a seguir.
Problema nº 1: memória zero persistente
IA tradicional (ChatGPT, Claude Chat): Cada conversa começa do zero. Você reexplica seu projeto mais de 10 vezes por semana.
Solução do Claude Code: O repositório como memória persistente. O arquivo CLAUDE.md carrega no início de cada sessão. Dev docs (plan.md, context.md, tasks.md) para projetos de várias semanas.
Sessão de IA tradicional:
Session 1:
You: "I'm building a SaaS product..."
[Explain project for 10 minutes]
Session 2 (next day):
You: "Remember my SaaS product?"
AI: "What product? Please explain."
[Re-explain AGAIN]Sessão do Claude Code:
Session 1:
Claude reads CLAUDE.md
"I see you're building a SaaS
product. What would you like?"
Session 2 (next day):
Claude reads CLAUDE.md
"Back to the SaaS project.
What's next?"Ponto-chave: A memória persistente elimina o custo de trocar de contexto
Impacto real: Richard (consultor de gestão, Austrália) passou uma semana configurando o Claude Code sozinho. Depois de uma única sessão de 2 horas com os templates do Second Brain: "Você resolveu nesta call o que eu ainda estava fazendo errado — eu prompteava como se fosse um chatbot. Mas usando comandos e agentes, você consegue fazê-lo gerenciar seu fluxo de trabalho diário por você. Isso é enorme. Vale cada centavo por me poupar três ou quatro meses de ficar me virando na marra."
Problema nº 2: o gargalo sequencial
IA tradicional: Só consegue trabalhar em UMA coisa por vez. Analisar 10 arquivos? Esperar cada um na sequência.
Solução do Claude Code: Os subagentes executam várias tarefas em paralelo dentro da sessão. Para trabalho independente e de longa duração, use sessões em segundo plano a partir do Claude Code na web, no desktop, no Slack ou na Agent View.
SEQUENTIAL (ChatGPT Way):
[Agent 1: Research] → [Agent 2: Content] → [Agent 3: Analysis]
15 min 20 min 10 min
Total: 45 minutes
PARALLEL (Claude Code Way):
[Agent 1: Research] ─┐
[Agent 2: Content] ─┼─ All running simultaneously
[Agent 3: Analysis] ─┘
Total: MAX(15, 20, 10) = 20 minutes
Speedup: 45 min → 20 min = 2.25x fasterImpacto real: Um consultor analisou 5 concorrentes (Asana, Monday, ClickUp, Notion, Airtable). O ChatGPT levou 45 min e completou só 3. O Claude Code com subagentes levou 20 min e completou os 5 ao mesmo tempo.
Ponto-chave: Agentes em segundo plano permitem processamento verdadeiramente paralelo
Impacto real: Damian (consultor de IA, Suíça) construiu um fluxo completo de conteúdo para redes sociais em 2 dias — algo que uma ferramenta SaaS comercial vende por centenas por mês. O fluxo dele: capturar ideias → extrair o DNA da voz no LinkedIn → gerar PDFs de carrossel → agendar posts. "Um amigo acabou de me falar dessa nova solução super maneira que ele comprou. Era o que eu tinha construído em dois dias com o Second Brain. Pura mágica."
Problema nº 3: o imposto da troca de contexto
IA tradicional: Copiar docs → Colar → Esperar. Copiar código → Colar → Esperar. Mais de 30 minutos perdidos por sessão.
Solução do Claude Code: O MCP (Model Context Protocol) conecta diretamente ao Gmail, à Agenda, ao CRM e ao Analytics. Acabou o copia e cola entre apps.
Processo manual:
- 1. Abrir o HubSpot
- 2. Exportar 200 participantes do webinar
- 3. Baixar o CSV
- 4. Copiar a lista de e-mails
- 5. Colar no ChatGPT
- 6. Pedir a análise
- 7. Copiar os resultados de volta
- 8. Subir para o HubSpot
Tempo: 35 minutos
Processo com MCP:
- 1. "Marque os participantes do webinar"
- 2. O Claude conecta ao HubSpot
- 3. Pronto.
Tempo: 3 minutos
Impacto real: Um gerente de Sales Ops foi de 2 horas por semana atualizando o CRM manualmente para zero. Tudo automatizado via MCP.
Problema nº 4: o isolamento das ferramentas
IA tradicional: A IA não consegue acessar as suas ferramentas de negócio reais. Transferência manual de dados por toda parte.
Solução do Claude Code: As skills se ativam sozinhas com base em palavras-chave. Os hooks executam scripts automaticamente. Construa uma vez, reutilize para sempre.
Traditional AI:
You: "Generate weekly sales report"
AI: "Please provide data..."
You: [Copy sales from HubSpot]
You: [Copy traffic from Analytics]
You: [Copy revenue from Stripe]
AI: [Generates report]
You: [Format manually]
You: [Send to team]
Time: 45 minutes
Claude Code with Skills:
You: "Generate weekly sales report"
Skill auto-loads:
├─ MCP: Fetch HubSpot deals
├─ MCP: Fetch GA4 traffic
├─ MCP: Fetch Stripe revenue
└─ Generate formatted report
└─ Save to reports/weekly-2025-01-11.md
Time: 2 minutesImpacto real: Uma gerente de marketing automatizou 5 relatórios semanais. Foi de 3,5 horas por semana para 10 minutos por semana. Isso é 21x mais rápido.
O que uma ferramenta + contexto estruturado realmente substituiu
Isso não é teórico. São páginas de administração reais rodando em produção agora mesmo.
| Categoria SaaS | Custo mensal típico | Agora integrado ao Second Brain |
|---|---|---|
| CRM (HubSpot/Pipedrive) | $45-100/mo | Pipeline de vendas + acompanhamento de prospects |
| E-mail marketing (Mailchimp) | $30-60/mo | Sequências automatizadas + newsletter |
| Agendamento de conteúdo (Buffer) | $15-30/mo | Calendário de conteúdo + gestão de fila |
| Gestão de tarefas (Asana/Linear) | $10-25/mo | Acompanhamento de tarefas + fluxo de sessões |
| Painel de analytics | $20-50/mo | Business intelligence + relatórios |
| Portal de entrega ao cliente | Sob medida | Gerador de repositórios + onboarding |
$120-265/mês antes
$20/mês depois (Claude Pro)
Isto não é uma comparação entre o Claude e o HubSpot. O HubSpot é melhor em ser um CRM. Mas para um solopreneur ou um time pequeno, o Claude Code + contexto estruturado dá conta de 80% do que você de fato usa dessas ferramentas — a 10% do custo.
Checklist da etapa 1
Quer o atalho?
Pule 2-3 semanas de tentativa e erro. Tudo abaixo já vem pronto no Second Brain.
Ver pacotesConfiguração: primeiros passos
Assinatura do Claude ou cobrança via API
A maioria deve começar com um plano Claude Pro ou Max para um uso mensal previsível. A cobrança via API também está disponível para fluxos programáticos ou de time.
Escolha como usar o Claude Code
Escolha a superfície que combina com o seu nível de conforto e seu sistema operacional
Claude Code na web
Research preview. Conecte o GitHub em claude.ai/code. Roda em uma VM na nuvem gerenciada pela Anthropic.
Aba Code do app de desktop
App nativo para macOS e Windows. Interface gráfica para o Claude Code com barra lateral, terminal, editor de arquivos, diffs, previews e monitoramento de PRs.
CLI do terminal (a mais poderosa)
Controle total sobre arquivos locais, shell, MCP, hooks, scripts, CI e automação.
Extensão para IDE
VS Code, Cursor e IDEs da família JetBrains. O Claude Code roda dentro do seu editor, ao lado dos seus arquivos.
Conta no GitHub (opcional, mas recomendada)
Pense nela como "o Google Drive para o cérebro da sua IA" — faz backup do seu repositório e sincroniza entre dispositivos.
Checklist da etapa 2
A melhor forma de adotar o Claude Code
Não tente construir o sistema inteiro de uma vez. O maior erro que as pessoas cometem é tentar automatizar tudo no primeiro dia. Isso nunca funciona.
Escolha um caso de uso por dia. Só isso.
Dia 1
"Me ajude a pesquisar esta empresa."
Dia 2
"Escreva um post de LinkedIn pra mim sobre X."
Dia 3
"Faça uma auditoria desta landing page."
Dia 4
"Crie uma skill para o meu relatório semanal."
Pouco a pouco, o seu repo vai se preenchendo. Suas skills, agentes, regras e o CLAUDE.md ficam mais inteligentes. Depois de algumas semanas, você olha para trás e percebe que construiu um sistema inteiro — uma pequena peça de cada vez.
Seu roadmap de adoção de 4 semanas
Subagentes (zero configuração necessária)
Peça ao Claude Code para usar subagentes em 2-3 tarefas de pesquisa independentes. Repare em como a sua conversa principal fica limpa enquanto os especialistas trabalham em paralelo.
Sua primeira skill
Escolha o seu fluxo de trabalho mais repetido (criação de conteúdo, code review, análise de dados). Crie .claude/skills/my-workflow/SKILL.md com uma descrição clara e instruções passo a passo. Teste pedindo de forma natural ou invocando /my-workflow, e então itere.
Skills + subagentes combinados
Dentro da sua skill, adicione passos que usam subagentes para pesquisa. Encadeie duas skills. Configure o seu CLAUDE.md com o contexto e as preferências do projeto.
Harness + MCP + avançado (opcional)
Adicione gates de plano, teste, revisão e aprovação ao redor dos seus fluxos mais importantes. Depois conecte ferramentas de negócio via MCP. A maioria deve construir o harness antes de dar mais autonomia.
Sistema de memória: CLAUDE.md e estrutura do repositório
Observação: O CLAUDE.md é opcional, mas fortemente recomendado para um contexto persistente. Ele elimina a necessidade de reexplicar o seu projeto a cada sessão.
Um arquivo Markdown especial que o Claude Code carrega no início de cada sessão. Pense nele como o manual de instruções do seu projeto — mas para a IA, não para humanos.
Sem o CLAUDE.md:
- • Cada sessão: "Este é o meu projeto..."
- • Reexplicar o contexto mais de 10 vezes/semana
- • O Claude esquece as suas preferências
- • Resultados inconsistentes
Com o CLAUDE.md:
- • O Claude lê uma vez por sessão
- • Contexto instantâneo sobre o seu projeto
- • Lembra do estilo e dos requisitos
- • Qualidade consistente
# CLAUDE.md
## Project Overview
[One sentence: What you're building]
**Mission**: [Your project's goal]
**Target Users**: [Who uses this]
## Repository Structure
- `company-brain/`: Business knowledge
- `agents/`: AI agent templates
- `data/`: Datasets and analysis
## Key Guidelines
- [Important fact #1 Claude should always know]
- [Important fact #2]
- [Important fact #3]
## Output Standards
- [How you want deliverables formatted]
- [Your writing style preferences]
## Guardrails
- [Things Claude should NEVER do]
- [Data privacy rules]Veja na prática
Como um Second Brain real se parece no GitHub
Esqueça a teoria por um momento. Aqui está um repositório Second Brain de verdade com mais de 30 agentes, skills, comandos e arquivos de conhecimento — a estrutura que faz tudo neste tutorial funcionar.
"Eu colocava tudo no CLAUDE.md — 500 linhas. O Claude começou a ignorar metade. Aí aprendi sobre divulgação progressiva e tudo se encaixou."
— Andrew, diretor de produto
O erro nº 1 que todo mundo comete
As pessoas enfiam tudo no CLAUDE.md — contexto de negócio, docs de API, guias de estilo, gotchas, templates. Passando das 500 linhas, o Claude começa a ignorar instruções. Pesquisas mostram que o cumprimento de instruções degrada além de cerca de 300 linhas e cerca de 50 regras. Mais instruções levam, paradoxalmente, a um pior cumprimento de instruções.
A solução é a divulgação progressiva: mantenha o CLAUDE.md curto (menos de 200 linhas) com tabelas de ponteiros que carregam docs detalhados sob demanda. Pense nele como um sumário, não como uma enciclopédia.
Monolítico (quebra em escala):
CLAUDE.md (972 lines)
├─ Business context (50 lines)
├─ API documentation (200 lines)
├─ Database schema (150 lines)
├─ Style guide (100 lines)
├─ Email templates (120 lines)
├─ Gotchas list (80 lines)
├─ MCP configs (150 lines)
└─ ... Claude ignores half of itEm camadas (escala infinitamente):
CLAUDE.md (200 lines)
├─ Business context (always loaded)
├─ Tech stack (always loaded)
├─ Pointer table → docs/
├─ Critical gotchas (3-5 rules)
└─ Self-improvement protocol
.claude/docs/ (loaded on demand)
├─ api-guide.md
├─ database-ops.md
├─ email-system.md
└─ gotchas.mdAs três camadas
Camada 1: CLAUDE.md (sempre carregada — menos de 200 linhas)
Só contexto de aplicação universal vai aqui. Contexto de negócio, stack tecnológica, gotchas críticos e uma tabela de ponteiros para todo o resto.
## Architecture & Patterns
| Area | Read This File |
|-------------------|----------------------------|
| Writing API code | .claude/docs/api-guide.md |
| Database work | .claude/docs/database.md |
| Email system | docs/EMAIL_SYSTEM.md |
| Known gotchas | .claude/docs/gotchas.md |
| Troubleshooting | docs/TROUBLESHOOTING.md |
Read the relevant file BEFORE making changes
in that area.Quando o Claude precisa trabalhar no sistema de e-mail, ele lê o CLAUDE.md, vê o ponteiro e carrega docs/EMAIL_SYSTEM.md sob demanda. Os outros docs ficam fora do contexto.
Camada 2: .claude/docs/ (carregada sob demanda)
Documentação detalhada que o Claude lê apenas quando trabalha em uma área específica. Cada arquivo começa com um gatilho de "quando ler".
# API Development Guide
> When to read: Before writing or modifying
> any API endpoint
## Pattern: Legacy Request/Response
All endpoints MUST use VercelRequest/
VercelResponse pattern. Web API pattern
causes 30-second timeouts.
## Required: .js Extensions
All imports in API files MUST include .js
extension. Missing extensions cause silent
build failures in production.
## Template
export default async function handler(
req: VercelRequest,
res: VercelResponse
) { ... }Camada 3: knowledge/ (contexto específico de agentes)
Material de referência profundo que só agentes ou skills específicos precisam. Nunca carregado em sessões gerais.
.claude/knowledge/
├─ content-creator/ # Voice DNA, templates
│ ├─ brand-voice.md
│ └─ content-types.md
├─ sales/ # CRM context, scripts
│ ├─ objection-handling.md
│ └─ email-sequences.md
└─ data-analysis/ # Schema, query patterns
└─ common-queries.mdPor que isso funciona:
Eficiência de contexto
Um CLAUDE.md enxuto com ponteiros usa muito menos tokens que um arquivo gigante. Deixa espaço para o trabalho de verdade.
Melhor cumprimento de instruções
50 regras em um arquivo focado vencem 200 regras em um arquivo inchado. Sempre.
Escala infinitamente
Adicione novos docs sem tocar no CLAUDE.md. Basta adicionar uma linha à tabela de ponteiros.
Início rápido: divulgação progressiva em 3 passos
- 1. Crie o diretório .claude/docs/
Tire do CLAUDE.md qualquer seção com mais de 20 linhas para o seu próprio arquivo.
- 2. Adicione uma tabela de ponteiros ao CLAUDE.md
Mapeie cada área de trabalho ao arquivo que o Claude deve ler antes de começar.
- 3. Adicione gatilhos de "quando ler"
Comece cada arquivo de docs com um gatilho de uma linha: "Quando ler: antes de trabalhar em [X]"
Construir esta arquitetura leva de 4 a 6 horas
Escrever tabelas de ponteiros, organizar docs com gatilhos de "quando ler", testar se o Claude carrega o arquivo certo na hora certa. O Second Brain já vem com mais de 10 docs pré-configurados, tabelas de gatilhos e a arquitetura completa de divulgação progressiva pronta para usar.
Pule a configuraçãoChecklist da etapa 3
Automação: agentes, skills, hooks, harnesses e aprendizado
"Essa é a real vantagem do Claude Code. Programação em paralelo. Você dispara 3 agentes de pesquisa e todos voltam com resultados enquanto você continua trabalhando na thread principal."
— Wytze, membro da comunidade
Subagentes são trabalhadores de IA especializados com contexto isolado. Como ter um analista de pesquisa E um redator no seu time trabalhando ao mesmo tempo.
Quando usar subagentes:
- ✅ Análise em paralelo (10 concorrentes de uma vez)
- ✅ É necessária expertise especializada
- ✅ Subtarefas independentes
- ✅ Projetos grandes com fases distintas
Quando NÃO usar:
- ❌ Tarefas únicas e simples
- ❌ Dependências sequenciais
- ❌ Tarefas que exigem contexto compartilhado
Exemplo real: análise competitiva
Tarefa: analisar 5 concorrentes (Asana, Monday, ClickUp, Notion, Airtable)
Sequencial (ChatGPT): 45 minutos
Analisar um → próximo → próximo... 3 mal feitos, 2 pulados por cansaço
Em paralelo (Claude Code): 8 minutos
5 subagentes rodam ao mesmo tempo. Os 5 completos, alta qualidade, formato consistente
USER PROMPT:
"Analyze these 5 competitors: Asana, Monday, ClickUp,
Notion, Airtable. For each, analyze pricing, features,
target market."
CLAUDE CODE SPAWNS 5 SUBAGENTS:
┌─────────────────────────────────────────────┐
│ Main Claude │
│ ├─ Subagent 1: Analyze Asana │
│ ├─ Subagent 2: Analyze Monday │
│ ├─ Subagent 3: Analyze ClickUp │
│ ├─ Subagent 4: Analyze Notion │
│ └─ Subagent 5: Analyze Airtable │
│ │
│ [All run in parallel] │
│ │
│ After 8 min: Aggregate results → │
│ Generate comparison table │
└─────────────────────────────────────────────┘Um banho de realidade sobre os custos
Subagentes consomem as próprias janelas de contexto. Uma tarefa em paralelo com 3 agentes usa cerca de 3x os tokens de fazê-la na sequência. Times de agentes (5 ou mais) podem chegar a 7x ou mais. Isso importa se você paga via API.
| Estratégia | Como | Economia |
|---|---|---|
| Modelos menores para os trabalhadores | Use o Haiku para tarefas simples e o Opus para decisões | 60-80% |
| Limite o escopo do agente | Restrinja ferramentas e acesso a arquivos por agente | 30-50% |
| Use agentes Explore para buscar | Apenas leitura, rápidos, uso mínimo de tokens | ~70% |
| Faça cache no CLAUDE.md | Guarde resultados para que os agentes não pesquisem de novo | Considerável |
| Configure max_turns | Evite loops descontrolados de agentes | Limite rígido |
Em uma assinatura Claude Pro/Max (US$ 20-200/mês), os subagentes rodam dentro dos limites do seu plano — sem custo extra por token. Quem usa chave de API deve monitorar o uso com mais cuidado.
Veja na prática
O que realmente tem dentro de um arquivo de agente
Você acabou de ler sobre as configurações de agentes. Aqui está uma sendo aberta ao vivo — um agente criador de conteúdo com acesso a ferramentas, uma árvore de decisão, configurações de voz e referências a arquivos de conhecimento. É um arquivo de texto, não código.
"Notei conteúdo melhor quando tenho um agente central e depois um conjunto de skills que ele pode invocar por conta própria. Em vez de eu lembrar o fluxo exato toda vez, eu só digo 'escreve um post de LinkedIn' e ele puxa a skill certa."
— Shaun, especialista em marketing e growth
Agente = Modelo + Harness
A maioria fica atualizando o modelo. Usuários avançados atualizam o harness em torno do modelo. Um harness é o sistema operacional do trabalho com IA: ele define o plano, dá ao agente ferramentas seguras, verifica a saída, pede revisão, captura lições e só então deixa o trabalho ser entregue.
O modelo é apenas uma entrada. O harness é todo o resto: prompts, CLAUDE.md, regras, ferramentas, servidores MCP, sistema de arquivos, Git, sandboxes, hooks, subagentes, políticas de contexto, logs, avaliadores, caminhos de recuperação e gates de release. Claude Code, Cursor, Codex, Aider, Cline e os Managed Agents são todos harnesses em torno de modelos.
A catraca: cada falha vira uma correção permanente
A engenharia de harness começa quando você para de culpar o modelo por padrão. Se o agente repete um erro, o trabalho é mudar o harness para que aquela falha específica fique mais difícil ou impossível da próxima vez.
| Falha observada | Correção do harness | Onde fica |
|---|---|---|
| Ignorou uma convenção do projeto | Adicione uma regra curta e conquistada na prática | CLAUDE.md ou .claude/rules/ |
| Rodou um comando destrutivo | Bloqueie-o antes da execução | Hook PreToolUse |
| Se perdeu em uma tarefa longa | Separe os papéis de planejador, executor e revisor | Skill + subagentes |
| Terminou com a saída quebrada | Rode verificações objetivas e realimente as falhas | Hook de verificação ou avaliador |
| Repetiu o mesmo rascunho fraco | Adicione exemplos, rubrica e perguntas de revisão | Arquivos de referência da skill |
Adicione restrições só quando elas remetem a uma falha real. Remova-as quando ficarem obsoletas. Um bom harness é um artefato vivo, não um cemitério de prompts.
1. Gate de plano
Antes de agir, o Claude deve reformular o objetivo, as suposições, os arquivos ou fontes que vai tocar e o que significa "feito".
2. Fronteira de trabalho
O agente recebe apenas as ferramentas e o escopo de que precisa. Apenas leitura para pesquisa. Aprovação antes de enviar, deletar, publicar ou alterar registros.
3. Gate de verificação
A saída é checada contra critérios objetivos: fontes citadas, números reconciliados, checklist completo, campos obrigatórios presentes.
4. Gate de revisão
Uma passada à parte procura o que a automação deixa passar: diagnóstico errado, sobre-engenharia, tom inadequado, suposições ocultas.
5. Gate de acúmulo
Cada erro vira uma regra, template, exemplo ou item de checklist. O sistema melhora porque o harness aprende.
6. Gate de entrega
Nada sai do sistema até que os artefatos de plano, verificação, revisão e aprovação existam. O Claude pode propor; o harness decide.
As partes estruturais de um harness
Estado
Sistema de arquivos, Git, arquivos de tarefas, arquivos de memória e pastas de saída. É aqui que o trabalho sobrevive além da janela de contexto atual.
Ferramentas
Bash, execução de código, automação de navegador, servidores MCP e APIs. Mantenha as ferramentas focadas; ferramentas que se sobrepõem confundem o modelo e inflam o contexto.
Política de contexto
O que é carregado, compactado, descarregado ou recuperado depois. Isso decide o que cruza a fronteira de contexto do modelo.
Imposição
Hooks, permissões, sandboxes, comandos de teste e gates de aprovação. Eles transformam preferências em restrições.
Avaliação
Rubricas, avaliadores, agentes de revisão e critérios de aceitação. Avalie o resultado, não o caminho estranho que o agente tomou.
Observabilidade
Logs, traces, uso de tokens, custo, latência e agrupamentos de falhas. Uma pontuação sem ticket não passa de arte de dashboard.
Gestão de contexto é design de harness
O modelo não consegue pensar sobre tokens que nunca recebe. Quando a janela de contexto enche, o harness precisa decidir o que fica, o que é comprimido, o que vai para o disco e o que é recuperado depois. Essa decisão muitas vezes importa mais que a escolha do modelo.
Truncar
Descarte saída de baixo valor ou transcrição antiga quando a continuidade não importa.
Compactar
Resuma a sessão e continue com o estado comprimido.
Descarregar
Salve logs longos, resultados de ferramentas e rascunhos em arquivos; mantenha apenas o preview útil no contexto.
Divulgar
Carregue docs detalhados, skills e ferramentas só quando a tarefa de fato precisar.
Regra prática: mantenha curto o contexto sempre carregado, percorra arquivos grandes com offset/limit, use a busca antes de ler arquivos inteiros e guarde as saídas longas de ferramentas no disco em vez de colá-las de volta na conversa.
Rubricas de resultado: defina como é o "feito"
A API de Managed Agents da Anthropic torna esse padrão explícito: defina um resultado, anexe uma rubrica, deixe um avaliador à parte avaliar o artefato e então realimente as lacunas ao agente para outra iteração. Você pode usar a mesma ideia manualmente no Claude Code.
Outcome:
Create a competitor pricing report for the 5 named companies.
Rubric:
- Includes all 5 companies
- Every price claim has a source URL
- Pricing tiers are normalized into one table
- Unknown prices are marked "not published" instead of invented
- Final section recommends what we should change
Iteration rule:
If any rubric item fails, revise once before showing me the final.O movimento importante é a separação: um loop cria o artefato, outro o avalia contra a rubrica. Isso reduz a autocomplacência e detecta as lacunas mais rápido.
O template de harness para o profissional do conhecimento
1. Track
Capture the request in a task, client folder, or project log.
2. Plan
Ask Claude: "Before doing the work, give me the plan,
assumptions, sources/tools needed, and acceptance criteria."
3. Work
Let Claude execute inside clear boundaries:
read-only research, draft-only writing, no external sends.
4. Verify
Run a checklist that matches the work type:
sources, calculations, brand voice, missing fields, risks.
5. Review
Ask a second pass: "Find what is wrong, overbuilt,
unsupported, or not how we do things here."
6. Learn
Capture one reusable rule or template improvement.
7. Ship
Only publish, send, update CRM, or hand off after approval.Prompt para copiar e colar: transforme qualquer fluxo em um harness
I want to turn this repeated workflow into a reliable AI harness:
[describe the workflow]
Create:
1. The planning questions Claude must answer before starting
2. The tool and permission boundaries
3. The verification checklist
4. The review questions a second pass should ask
5. The human approval points
6. The learning rule to update after each run
Keep it practical for a non-technical knowledge worker.Auditoria semanal do harness: corte o overhead invisível
Se o Claude parece mais lento, mais burro ou come os seus limites, audite o harness antes de culpar o modelo. A maior parte do desperdício se esconde no contexto sempre carregado.
| Verificação | O que procurar | Correção |
|---|---|---|
CLAUDE.md tamanho | Regras que não importam mais ou que pertencem a docs mais específicos | Mantenha o contexto raiz curto; mova as especificidades para regras, docs ou skills |
| Hooks | Hooks de UserPromptSubmit ou SessionStart que injetam contexto toda vez | Desative tudo que não tenha uma função específica |
| Servidores MCP | Schemas de ferramentas carregados para ferramentas que você raramente usa | Mantenha sempre ativas só as ferramentas do dia a dia; ative as outras por sessão |
| Skills | Descrições amplas que fazem skills irrelevantes carregarem | Aperte as descrições ou desative as skills sem uso |
| Tamanho da conversa | Sessões longas relendo histórico obsoleto | Compacte, resuma ou comece do zero com uma nota de transição |
Exemplos por papel
| Fluxo de trabalho | Gate de verificação | Gate humano |
|---|---|---|
| Relatório de consultoria | Afirmações ligadas aos dados do cliente, recomendações mapeadas ao escopo, nenhum nome confidencial vazado | O sócio revisa a qualidade dos insights antes de enviar |
| Prospecção de vendas | Histórico de CRM verificado, fonte de personalização citada, nenhum evento gatilho inventado | Você aprova antes de enviar por e-mail, LinkedIn ou WhatsApp |
| Análise financeira | Totais reconciliam, suposições listadas, anomalias sinalizadas, arquivos de origem nomeados | Você aprova a interpretação antes de compartilhar |
| Publicação de conteúdo | Verificação de voz, frases proibidas removidas, fatos com fonte, CTA presente | Você aprova a versão final antes da fila ou da publicação |
O que nenhum harness pega de forma confiável
- • Diagnóstico errado: resolver a causa raiz errada
- • Sobre-engenharia: adicionar complexidade que ninguém pediu
- • Instruções mal interpretadas: fazer a tarefa vizinha
- • Normas de time do tipo "aqui a gente não faz assim"
- • Bom gosto, julgamento e trade-offs executivos
- • Responsabilidade social pelo resultado final
A regra: automatize a digitação, a pesquisa, a verificação e a formatação. Mantenha a responsabilidade, o julgamento final e os compromissos externos com uma pessoa.
"Estou APAIXONADO por esse novo sistema. Fiz cerca de 10 dias de trabalho em um único dia."
— Shaun, especialista em marketing e growth • Construiu uma automação de áudio para post social na primeira semana
É por isso que 5.475 pessoas comentaram "BRAIN"
A maioria usa o Claude como um único assistente. Faz uma pergunta, recebe uma resposta. Mas o Claude Code te deixa construir um time inteiro de especialistas que passam o trabalho entre si — enquanto você revisa.
Distinção importante: subagentes vs. agentes em segundo plano
Subagentes são especialistas dentro de uma sessão do Claude Code. Eles têm o próprio contexto e as próprias permissões de ferramentas, e depois reportam de volta à sessão principal. Agentes em segundo plano são sessões na nuvem separadas que você gerencia pelo Claude Code na web, no desktop, no Slack ou na Agent View.
Use subagentes quando:
Um fluxo principal precisa de várias análises, revisões ou rascunhos focados em paralelo.
Use agentes em segundo plano quando:
Você quer sessões independentes de longa duração em repos, branches, PRs ou jobs agendados diferentes.
Três níveis de coordenação de agentes
Nível 1: agente solo
Uma sessão do Claude fazendo tudo. Como trabalhar com um único generalista muito capaz. É aqui que a maioria para.
Nível 2: líder que delega (subagentes)
A sua sessão principal do Claude atua como líder. Ela despacha especialistas para fazer trabalho focado — pesquisa, rascunho, análise — em paralelo. Cada especialista reporta de volta ao líder, que sintetiza os resultados. Isso está pronto para produção e é o que a maioria dos usuários avançados constrói.
Nível 3: sessões em segundo plano + Agent View
Várias sessões do Claude Code rodando de forma independente. Use claude agents ou as superfícies web/desktop para despachar, monitorar e retomar o trabalho. Terreno de research preview — poderoso, mas ainda em evolução.
Exemplo real: pipeline de prospecção de vendas
Eis o que de fato acontece quando eu digo "redija a prospecção para este prospect":
Lead Agent orchestrates the pipeline:
│
├─ Research Agent
│ → Pulls LinkedIn profile + company intel
│ → Returns: role, company size, recent posts
│
├─ CRM Agent
│ → Checks prospect history, stage, past notes
│ → Returns: last contact, deal stage, context
│
├─ Draft Agent
│ → Writes personalized email using research
│ → Uses voice guidelines from knowledge files
│
├─ Quality Agent
│ → Scores draft against brand voice rubric
│ → Flags generic phrases, suggests improvements
│
└─ Lead Agent
→ Reviews final draft
→ I approve → sends via email MCP
5 agents. 3 minutes.
What used to take 45 minutes of tab-switching
between LinkedIn, CRM, email, and style guides.Revisão multiagente: quando especialistas desafiam uns aos outros
No nível 2, toda a comunicação flui pela sessão líder. Você ainda pode pedir ao Claude para rodar passadas independentes de especialistas, comparar os achados e sintetizar as divergências. Para fluxos de trabalho separados e de longa duração, use sessões em segundo plano e a Agent View.
"Our conversion rate dropped 15% last week.
Use three specialist subagents to investigate:
- One analyzes traffic sources
- One reviews checkout funnel
- One checks pricing page changes
Then compare their findings and challenge contradictions."
What happens:
Traffic Agent: "Paid traffic quality dropped"
Checkout Agent: "But checkout completion is
stable. The issue is upstream."
Pricing Agent: "New pricing page went live
Tuesday. Bounce rate up 40%."
Traffic Agent: "That explains the drop—
the traffic was fine, the page wasn't."
→ Root cause found in minutes, not hours.A estrutura de debate evita o viés de ancoragem. A investigação sequencial tende a encontrar uma teoria e parar. Vários investigadores independentes desafiando uns aos outros trazem à tona a verdadeira resposta.
Construir mais de 30 agentes especializados com as personas, permissões de ferramentas, arquivos de conhecimento e a lógica de coordenação certos levou meses de iteração. Cada agente precisa saber o que pode acessar, em que formato produzir e quando passar o trabalho ao próximo. O Second Brain já vem com a biblioteca de agentes completa — pré-configurada para criação de conteúdo, prospecção de vendas, gestão de clientes, análise de dados e operações diárias.
O Claude Code trabalha lado a lado com outras ferramentas
As configurações mais eficazes não são "só Claude Code". Usuários avançados combinam ferramentas de forma estratégica: ChatGPT para brainstorming criativo, Claude Code para execução estruturada, Gemini para revisão. O Claude Code vira a camada de orquestração que amarra tudo — não a única ferramenta da sua stack.
1. Brainstorm with ChatGPT (creative, divergent thinking)
2. Hand the brief to Claude Code (precise execution)
3. Review output with Gemini (catching edge cases)
4. Final polish back in Claude Code
Why: Each model has different strengths.
Claude Code orchestrates the whole thing
through skills and sub-agents.Checklist da etapa 4
É assim que um sistema completo se parece
Mais de 30 agentes, mais de 50 skills, mais de 6 hooks, gates de harness, aprendizado cumulativo, divulgação progressiva, coordenação de agentes — tudo configurado e funcionando junto. Este sistema levou meses de iteração. O Second Brain entrega uma versão personalizada em horas.
Veja o que está incluídoIntegração: conexões MCP
MCP (Model Context Protocol) é uma forma padrão de conectar o Claude Code a ferramentas externas. Pense nele como o USB-C da IA — um protocolo conecta a tudo.
┌─────────────────────────────────────────────┐
│ Claude Code │
│ └─ MCP Client (built-in) │
└─────────┬───────────────────────────────────┘
│
├─ MCP Server: Gmail
│ └─ Functions: send_email, search, read
│
├─ MCP Server: HubSpot
│ └─ Functions: create_contact, update_deal
│
├─ MCP Server: PostgreSQL
│ └─ Functions: query, insert, update
│
└─ MCP Server: Google Calendar
└─ Functions: create_event, list_eventsFerramentas de negócio
- • HubSpot (CRM)
- • Gmail
- • Google Calendar
- • Notion
- • Slack
Ferramentas de dev
- • GitHub
- • Linear
- • PostgreSQL
- • Jira
Analytics
- • Google Analytics
- • Stripe
- • Mixpanel
Exemplo real: operações de vendas
Tarefa: marcar 200 participantes do webinar no HubSpot
Sem MCP: 35 minutos
- 1. Exportar participantes do Zoom
- 2. Abrir o HubSpot
- 3. Cruzar e-mails manualmente
- 4. Importação em massa com tags
- 5. Corrigir erros
Com MCP: 3 minutos
- 1. "Marque os participantes de webinar.csv"
- 2. O Claude conecta ao HubSpot
- 3. Pronto.
Ponto-chave: A configuração do MCP pode ser a maior barreira de tempo
Andrew (diretor de produto, Holanda) construiu um sistema automatizado de acompanhamento de busca de emprego — scraper do LinkedIn → banco de dados → agendador de follow-ups. Configuração de MCP por conta própria: 6-8 horas depurando OAuth. Com os templates do Second Brain: 20 minutos.
Veja na prática
Um MCP, três plataformas, 96 segundos
Diagramas abstratos são legais. Eis o que um MCP de fato faz: um único comando puxa 20 posts de cada um do Reddit, X e LinkedIn — 60 pontos de dados analisados em menos de 2 minutos. Sem copia e cola entre abas.
Depurar o OAuth do MCP leva, em média, 6-8 horas
O pacote Done-With-You inclui uma sessão de configuração ao vivo em que conectamos as suas ferramentas de Gmail, Calendar, CRM e banco de dados — além de templates que você pode reutilizar em futuras conexões de ferramentas.
Ver Done-With-YouChecklist da etapa 5
O que os clientes realmente construíram (primeiro mês)
Semana 1: Damian (consultor de IA, Suíça)
Sistema de automação de conteúdo para redes sociais. Capturar ideias → Extrair o DNA da voz no LinkedIn → Gerar PDFs de carrossel → Agendar posts. "Um amigo acabou de me falar dessa nova solução super maneira que ele comprou. Era o que eu tinha construído em dois dias com o Second Brain."
Semana 2: Andrew (diretor de produto, Holanda)
Sistema automatizado de acompanhamento de busca de emprego. Scraper do LinkedIn, banco de dados de candidaturas, agendador de follow-ups. Substituiu uma ferramenta SaaS comercial que ele pagava mensalmente — construído em dois dias com o Second Brain.
Semana 3: Dominic (consultor de cloud)
Relatórios semanais automatizados de status de clientes. Integração MCP com o Salesforce puxando dados de deals, Microsoft Graph para o contexto de agenda/e-mail. Economizou 3 horas por semana em trabalho administrativo.
Semana 4: Richard (consultor de gestão, Austrália)
Depois de se virar sozinho por uma semana: "Você resolveu nesta call o que eu ainda estava fazendo errado — eu prompteava como se fosse um chatbot. Mas usando comandos e agentes, você consegue fazê-lo gerenciar seu fluxo de trabalho diário por você. Vale cada centavo por me poupar três ou quatro meses de ficar me virando na marra."
Próximos passos: o seu caminho a seguir
Você viu como um sistema completo se parece: arquitetura de divulgação progressiva, hooks obrigatórios, aprendizado cumulativo, o framework de skills vs. agentes, integrações MCP. Construir isso do zero leva 3-4 semanas de tentativa e erro— depurar estruturas de arquivos, escrever hooks, testar gatilhos de skills, configurar fluxos OAuth de MCP, projetar schemas de memória...
Ou você pode pular tudo isso e ter uma versão personalizada em horas.
"Esse foi um dos melhores investimentos para mim e para o meu negócio. Abriu o mundo do trabalho com agentes facilmente configurável. As ferramentas de IA comuns agora parecem brincadeira de criança."
— Damian, consultor de IA • Cliente Done-With-You que construiu um sistema completo de automação de conteúdo em 2 dias
O quadro completo
5 tarefas. 20 minutos. Um sistema.
Triagem de e-mail, respostas a clientes, análise financeira, conteúdo de LinkedIn e uma landing page — tudo iniciado do mesmo terminal em uma única sessão. É isso que o sistema completo entrega.
Escolha o seu caminho
$197
Pacote DIY
Repositório Second Brain completo com agentes, comandos e skills. Você cuida da configuração.
- ✅ Repositório Second Brain completo
- ✅ Sistema de hooks pré-configurado
- ✅ Guias de configuração de MCP
- ✅ Suporte baseado em documentação
Prazo: 1-2 semanas de configuração
$597
Pacote Kickstart
Tudo do DIY + um agente de IA configura o seu sistema a partir das respostas do questionário.
- ✅ Tudo do DIY, personalizado para você
- ✅ Um agente de IA constrói o sistema a partir das suas respostas
- ✅ Suporte assíncrono prioritário em 48 horas
- ✅ Primeiro ano de MemoryOS Pro incluído (valor de US$ 349)
Prazo: funcionando em minutos, não em semanas
$2,497
Done-With-You
Tudo do Kickstart + uma call de onboarding de 2 horas com o Iwo. Implantação completa da infraestrutura.
- ✅ Tudo do Kickstart
- ✅ Call de onboarding de 2 horas com o Iwo
- ✅ Implantação completa da infraestrutura (Vercel + Supabase)
- ✅ Atualizações mensais do Second Brain
- ✅ 12 meses de MemoryOS incluídos
Prazo: produtivo em 2 horas
Apêndice: padrões avançados
Continue aprendendo
Gravação da sessão de coworking
Sessão ao vivo de 60 minutos com mais de 10 demos — planejamento diário, criação de conteúdo, pesquisa com MCP, agentes de WhatsApp e mais.
Template do AI Chief of Staff
Template de agente gratuito com configuração completa, estrutura de base de conhecimento e guia de personalização para o seu papel.
Documentação oficial
Estas são as fontes canônicas. Este tutorial adiciona o "como" e o "quando" práticos que a documentação oficial não cobre.
Pronto para construir o seu próprio Second Brain?
Três pacotes disponíveis — de templates DIY à implementação done-with-you.
Ver pacotesGarantia de devolução do dinheiro em 30 dias • Economize mais de 10 horas no primeiro mês ou reembolso total