A formação nasceu de uma diferença simples: existe um abismo entre conversar com uma IA e construir uma forma de trabalho com ela. Muita gente já usa IA para escrever um texto ou tirar uma dúvida — e para por aí. Esta formação organiza o caminho até usar o Claude como uma verdadeira estrutura de trabalho.

A premissa central, que atravessa toda a formação:

O Claude acelera e padroniza. Quem pensa, decide e entrega continua sendo você.

O Claude não substitui conhecimento de automação, tráfego pago, marketing, atendimento, estratégia ou negócios. Quem não conhece o problema do cliente não vira especialista só por usar IA — mas quem já tem conhecimento e aprende a organizá-lo dentro do Claude passa a trabalhar com mais velocidade, consistência e capacidade de entrega.

Como a formação está organizada: começa pelo ecossistema e o uso do Chat, avança para tarefas mais completas no Cowork, e chega ao Claude Code com base sólida — contexto, arquivos, memória, instruções persistentes, skills, plugins, conectores, MCPs e agentes. Você também vai entender quando usar navegador, app Desktop, terminal ou IDE.

Como estudar: se está começando, siga a ordem das aulas — conceitos iniciais são reaproveitados nas partes avançadas. Se já usa o Claude Code, ainda vale passar pelas aulas iniciais: existem diferenças entre Chat, Cowork e Claude Code, e formas de memória e modos de trabalho que muita gente usa sem entender direito. Nas aulas práticas, deixe a ferramenta aberta e faça junto — não é curso para só assistir.

Você não precisa ser programador. Em alguns momentos vamos entrar no terminal e mexer em arquivos e configurações — tudo explicado passo a passo. O objetivo é dar autonomia, não te transformar em programador.

Essas respostas serão reaproveitadas ao longo do curso — a ideia é você construir uma estrutura para a sua realidade, não só copiar os exemplos.

A Anthropic é a empresa que criou o Claude — a mesma relação que a OpenAI tem com o ChatGPT. Dentro do ecossistema Claude existem diferentes formas de usar essa IA: Chat, Cowork e Claude Code (a próxima aula compara os três).

Como funcionam os limites: não existe uma quantidade universal de mensagens igual para todo mundo — o consumo varia com o tamanho da conversa, arquivos anexados, modelo escolhido e complexidade da tarefa. Existe diferença entre o limite de contexto de uma conversa e o limite de uso da assinatura (aprofundado no Módulo 2). Nas configurações da conta (Configurações → Uso) dá para acompanhar o consumo — cuidado com a ativação de limite extra, ela pode gerar cobrança surpresa; recomendo deixar desativado.

Regra para escolher: comece pelo menor plano que atende sua necessidade atual. Comece pelo Pro; migre para o Max só quando os limites do Pro começarem a te interromper de verdade.

Os três resolvem tipos diferentes de tarefa. Exemplo usado na aula: organizar depoimentos de clientes.

Claude Chat — você conduz o trabalho pela conversa. "Analise estes depoimentos, identifique os resultados mais relevantes e selecione os melhores trechos para uma página de vendas." Você revisa, pergunta, ajusta.

Claude Cowork — você delega uma tarefa com começo, meio e fim. "Analise os depoimentos desta pasta. Organize os arquivos por tipo de resultado, identifique os trechos mais relevantes e crie uma planilha com o nome do cliente, o resultado alcançado e onde esse depoimento pode ser utilizado." O Cowork cria um plano e executa. Funciona pelo navegador, app Desktop e celular (acompanhar tarefas na nuvem); para acessar arquivos do seu computador, precisa do Claude Desktop aberto com permissão.

Claude Code — você constrói algo reaproveitável. No exemplo dos depoimentos: uma biblioteca interna pesquisável, com instruções para que novos depoimentos sejam sempre organizados no mesmo padrão. Funciona pelo Desktop, terminal, web e dentro de uma IDE como o VS Code.

Regra prática:

• Quer conversar, analisar ou criar com orientação da IA → Chat
• Quer delegar uma tarefa com várias etapas e receber pronto → Cowork
• Quer construir uma estrutura de arquivos ou um processo reutilizável → Claude Code

Não existe ferramenta melhor para tudo — existe a mais adequada para o trabalho. Em muitos processos você vai usar as três juntas: organiza a ideia no Chat, delega a execução no Cowork, e transforma em estrutura reutilizável no Claude Code.

Os 5 elementos de um prompt que funciona:

1. Objetivo — o que você quer que o Claude produza
2. Contexto — quem é a empresa, o produto, o público, a situação
3. Informações — os dados concretos que a tarefa depende
4. Critérios — o que pode e o que não pode (tom, restrições, o que evitar)
5. Formato de entrega — como o resultado deve ser organizado

Exemplo aplicando os 5 elementos:

Crie três mensagens de acompanhamento para potenciais clientes
que receberam uma proposta comercial e não responderam.

Somos uma empresa que presta serviços de automação. As mensagens
serão enviadas pelo WhatsApp para pessoas que participaram de uma
reunião e receberam uma proposta.

Nosso serviço ajuda empresas a organizar o atendimento, responder
leads com mais velocidade e reduzir tarefas manuais.

As mensagens devem ser curtas, profissionais e naturais. Não
utilize pressão, urgência falsa ou promessas de resultado. Cada
mensagem deve ter uma abordagem diferente.

Organize a resposta em uma tabela com o momento do envio, o
objetivo da mensagem e o texto completo.

Mais contexto nem sempre é melhor. Antes de adicionar algo ao prompt, pergunte: "essa informação ajuda o Claude a decidir ou produzir o resultado?" Se não ajuda, corte.

Refinamento iterativo — não precisa acertar tudo de primeira:

• "Deixe a segunda mensagem mais curta."
• "Retire as expressões que parecem comerciais demais."
• "Antes de executar, faça até três perguntas para entender melhor a tarefa." (evita que o Claude preencha lacunas com suposições)

Escolhendo o modelo — a lógica importa mais que decorar nomes (eles mudam):

• Sonnet — melhor ponto de partida para a maioria das tarefas: criação de conteúdo, análise de documentos, planejamento, pesquisa
• Opus — trabalhos mais complexos, que exigem mais raciocínio e precisão
• Regra prática: comece com o Sonnet; se a tarefa for muito complexa ou o resultado não chegar no nível esperado, teste o Opus

Três conceitos relacionados, mas diferentes:

• Token — a unidade que o Claude usa para processar texto (palavra, parte de palavra, número, pontuação). Tudo o que entra e sai da conversa usa tokens: mensagens, respostas, histórico, arquivos.
• Janela de contexto — quanto o Claude consegue considerar de uma vez dentro de uma conversa. Em planos pagos com execução de código ativada, conversas longas podem ser resumidas automaticamente para liberar espaço.
• Limite de uso — a capacidade do seu plano num período. Depende do modelo, tamanho da conversa, arquivos e complexidade — não só da quantidade de mensagens.

6 formas de fazer o limite render mais:

1. Abra uma conversa nova para cada assunto diferente
2. Envie só o que for relevante (não a pasta inteira se a tarefa depende de 2 arquivos)
3. Escolha o modelo pela tarefa (Sonnet resolve a maioria)
4. Defina o formato da resposta (resumo de 1 página ≠ análise completa)
5. Não repita informação já enviada — diga "utilize o documento que enviei anteriormente"
6. Se o chat ficou longo, peça um resumo de continuidade e comece uma conversa nova a partir dele

Crie um resumo de continuidade com o objetivo, as decisões
tomadas, as informações importantes e os próximos passos.

Anexar um arquivo não explica o que você quer. "Analise este documento" força o Claude a adivinhar o que observar.

Estrutura para pedir análise de qualquer arquivo:

Analise este arquivo com o objetivo de [objetivo].
Considere principalmente [o que deve ser observado].
Apresente o resultado em [formato].
Quando encontrar uma informação importante, indique onde ela
aparece no arquivo.

PDF: resumir, encontrar informação específica, comparar seções, montar checklist ou tabela. Se o documento for grande, indique quais páginas analisar.

Imagem: print de ferramenta, foto de processo, fluxo desenhado. A qualidade interfere — texto pequeno ou desfocado pode ser interpretado errado.

Planilha: organizar dados, calcular, achar padrões, gerar gráfico. Confira se as colunas têm títulos claros e explique o que cada dado representa (uma coluna "valor" pode ser faturamento, custo ou parcela). Sempre confira os cálculos antes de usar em uma decisão.

Busca na web: útil para preços, notícias e atualizações de plataforma. "Pesquise essa informação na web, priorize fontes oficiais e apresente os links utilizados."

Um Projeto reúne conversas, arquivos e instruções de um mesmo assunto — evita reexplicar tudo a cada conversa nova. Bom para: uma empresa, um cliente, um curso, uma pesquisa contínua.

Instruções do projeto (contexto permanente) ≠ prompt no chat (tarefa do momento):

[Instrução do projeto]
Este projeto será utilizado para criar conteúdos de uma empresa
que presta serviços de automação. O público é formado por donos
de pequenas e médias empresas que querem organizar o atendimento
e reduzir tarefas manuais. Utilize uma linguagem simples,
profissional e direta. Evite termos técnicos sem explicação,
promessas de resultado e frases exageradas. Sempre que faltar uma
informação importante, faça perguntas antes de concluir a tarefa.

Arquivos do projeto ficam disponíveis para todas as conversas dali — diferente de anexar num chat só (vale só naquela conversa). Adicione apenas o que for realmente relevante.

Exemplo real: um gestor de automação pode criar um Projeto por cliente, reunindo diagnóstico, reuniões, documentação das automações, relatórios e próximos passos.

Um Artifact é um conteúdo mais completo que aparece numa área separada da conversa — dashboard, calculadora, fluxograma, página, checklist, ferramenta interativa. Você não precisa pedir "crie um Artifact" — basta explicar o resultado que quer.

Exemplo real usado na aula — dashboard de Instagram com dados fictícios:

Crie um dashboard interativo para acompanhar as métricas e as
metas de um perfil do Instagram. Utilize dados fictícios dos
últimos seis meses. Mostre o total de seguidores, os novos
seguidores, o alcance, as visualizações, as interações, as
visitas ao perfil e os cliques no link. Calcule a taxa de
engajamento dividindo o total de interações pelo alcance e
multiplicando por 100. Crie um gráfico com a evolução mensal do
alcance e dos seguidores. Mostre o desempenho por formato (Reels,
carrosséis, posts estáticos). Inclua uma tabela com os conteúdos
publicados. Adicione metas mensais e mostre visualmente o quanto
já foi alcançado. Inclua filtros por mês e formato. Utilize um
visual moderno, profissional e organizado.

Repare: nenhuma palavra técnica, nenhuma menção a HTML ou código — só o resultado, as informações e como deveria funcionar. Se o Claude entregar só uma explicação: "Transforme isso em uma versão visual e interativa para que eu possa testar." Confira se a execução de código e criação de arquivos estão ativadas em Configurações → Capacidades.

Outros exemplos: calculadora de orçamento, simulador de preços, checklist de onboarding, fluxograma de atendimento, painel de clientes, quiz interativo.

A diferença entre subir um arquivo e conectar uma fonte. O Claude só acessa as contas e informações que você autorizou, respeitando as permissões que já existem na ferramenta conectada. Exemplos: Google Calendar, Gmail, Google Drive, Slack, Notion, ferramentas de análise de dados e plataformas de marketing.

Exemplo 1 — Google Calendar:

Utilize o Google Calendar e liste todos os meus compromissos
desta semana. Organize por dia, informe os horários e destaque
possíveis conflitos de agenda.

Exemplo 2 — Analisando o YouTube com a Windsor.ai: a Windsor conecta diferentes fontes de dados ao Claude, incluindo o YouTube Analytics. Depois de conectar o canal à Windsor e a Windsor ao Claude:

Utilize o Conector da Windsor para analisar o desempenho do meu
canal do YouTube nos últimos 90 dias. Mostre as visualizações, o
tempo de exibição, os inscritos ganhos, as impressões e a taxa de
cliques, quando essas informações estiverem disponíveis. Liste os
dez vídeos com mais visualizações e os cinco que mais contribuíram
para o crescimento de inscritos. Compare temas e formatos dos
vídeos com melhor desempenho e sugira cinco temas para os próximos
vídeos. Informe o período analisado e não invente dados que não
estejam disponíveis.

O conector entrega acesso aos dados — mas você ainda precisa explicar o que quer descobrir. Existe diferença grande entre "Analise meu canal" e um pedido que informa fonte, período, indicadores, comparação e resultado esperado. Quanto mais clara a pergunta, mais útil a análise.

Links oficiais desta aula: Artifacts — como usar

Além dos conectores prontos, existem os conectores personalizados via MCP — um padrão que permite ao Claude se comunicar com sistemas e fontes de dados externas que não estão na lista padrão. Um exemplo citado na aula: o MCP do Meta Ads, para consultar e analisar campanhas de anúncios (aprofundado no Módulo 6, junto com o MCP dentro do Claude Code).

No Chat, você conduz uma conversa. No Cowork, você delega um resultado: define objetivo, critérios e limites, e o Claude planeja e executa as etapas. Ótimo para tarefas que não são difíceis mas consomem tempo — organizar arquivos, padronizar nomes, montar planilha, criar apresentação.

O ciclo do Cowork:

1. Você delega — objetivo, critérios e limites
2. Ele apresenta o plano antes de executar
3. Você acompanha a execução (pode interromper e corrigir)
4. Você revisa o resultado — ele executa, você continua responsável pela decisão final

Exemplo real da aula — organizar uma pasta com PDFs, vídeos e imagens misturados:

Organize os arquivos desta pasta por tipo. Crie três subpastas:
Vídeos, Imagens, PDFs. Mova cada arquivo para a pasta
correspondente. Padronize os arquivos que ainda não possuem o
tipo no início do nome, usando os prefixos video-, imagem-,
pdf-. Não altere os arquivos que já seguem esse padrão. Mantenha
a extensão original e não altere o conteúdo. Se o nome
padronizado já estiver em uso por outro arquivo, não substitua,
não exclua e não una — mantenha os dois, sinalize o conflito e
espere minha orientação. Não exclua nenhum arquivo. Antes de
executar, apresente o plano e espere minha aprovação.

Onde acessar: ao lado do Chat, no app Claude Desktop (para acessar arquivos/apps do seu computador), e também na web e no celular. Link oficial: Claude Cowork

Com a extensão do Claude no navegador, o Cowork acessa e analisa arquivos direto do Google Drive — útil para organizar, categorizar ou extrair informação de arquivos espalhados, sem baixar nada manualmente.

Exemplo real da aula — depoimentos de alunos espalhados numa pasta, sem padrão nenhum, virando planilha categorizada:

Acesse a pasta "Depoimentos" no Google Drive e analise cada
arquivo. Para cada um, identifique: do que se trata o depoimento,
uma transcrição resumida, o nome do aluno (se disponível), o tipo
de ganho relatado (financeiro, qualidade de vida, tempo) e o
tempo até o resultado. Organize tudo em uma planilha nova, com
uma linha por depoimento e uma coluna com o link do arquivo
original. Não invente informações que não estejam no arquivo.

Isso resolve um problema comum: na hora de montar uma página de vendas ou campanha, encontrar o depoimento certo deixa de consumir tempo fazendo tudo manualmente.

Alternativa: em vez da extensão do navegador, vale testar conectar o Drive como um Conector (Configurações → Conectores) — ele permite buscar e ler arquivos direto (Docs, Sheets, Slides), sem precisar navegar manualmente pelo Drive. Doc oficial do conector.

Quando um trabalho tem continuidade (não é uma tarefa isolada), cria-se um Projeto — igual ao conceito do Módulo 2, aplicado ao Cowork. Exemplo: "Biblioteca de Depoimentos", com a planilha da aula anterior adicionada.

Instruções permanentes do projeto:

Este Projeto reúne depoimentos autorizados de alunos e clientes.
Utilize os materiais disponíveis para localizar provas
relacionadas a resultados, transformações, dificuldades e
objeções. Sempre informe qual depoimento ou arquivo foi utilizado
como fonte. Não invente nomes, valores, resultados, prazos ou
informações ausentes. Não exponha dados de contato ou informações
pessoais desnecessárias. Antes de utilizar um depoimento em um
material público, apresente a sugestão e espere minha aprovação.

Com isso definido, as tarefas ficam curtas: "Encontre três depoimentos relacionados à conquista do primeiro cliente. Priorize depoimentos com resultados claros e nota igual ou superior a quatro."

Cuidado com a memória: nem todo arquivo criado durante uma tarefa entra automaticamente no contexto permanente do projeto — confira se o material que você quer reaproveitar foi realmente adicionado.

Links oficiais: Projetos no Cowork · Cowork no Desktop, web e celular

Com a extensão do navegador, o Claude consegue visualizar páginas abertas, navegar, clicar, preencher campos e executar etapas dentro de um site — pesquisar produtos, comparar fornecedores, preencher sistemas, comparar resultados de diferentes páginas. Sempre acompanhe o trabalho e revise antes de autorizar qualquer alteração importante.

Exemplo real da aula — pesquisar imóvel para alugar num site de imobiliária, dentro de critérios definidos:

Acesse o site [nome do site] e pesquise imóveis para alugar com
os seguintes critérios: até R$ 3.000, 2 quartos, próximo ao
metrô, aceita pet. Aplique os filtros disponíveis no site. Liste
os cinco melhores resultados com endereço, valor, metragem e link
do anúncio. Não entre em contato com nenhum anunciante nem
preencha formulários de contato — apenas pesquise e apresente os
resultados.

Tarefas programadas rodam automaticamente na frequência que você definir (diária, semanal, dias úteis). Cada execução acontece numa nova sessão. Tarefas que dependem de pasta local ou app instalado exigem o Claude Desktop aberto e o computador ligado (não hibernando).

Exemplo real — atualizar depoimentos toda semana:

Crie uma tarefa programada chamada 'Atualizar depoimentos'.
Execute toda segunda-feira, às 9h (fuso de Brasília). Acesse a
pasta 'Depoimentos' no Google Drive e utilize a planilha
'Depoimentos Categorizados' como referência. Identifique arquivos
adicionados desde a última execução que ainda não aparecem na
planilha. Para cada novo depoimento: identifique tipo, nome do
arquivo, nome do aluno (se disponível), transcreva o conteúdo
relevante, resuma o resultado, classifique por assunto, atribua
nota de qualidade de 1 a 5, inclua o link original. Não invente
informações ausentes — preencha como 'Não identificado'. Não
processe arquivos já registrados. Se encontrar possível duplicado,
não inclua automaticamente — sinalize para minha revisão. Não
exclua nem substitua arquivos. Se não houver novidade, apenas
informe que nenhuma atualização foi necessária.

Antes de esperar a próxima execução automática, rode a tarefa manualmente uma vez para testar — inclusive resolve pendências de permissão antes que travem a execução programada.

Um Artefato ao vivo é uma página visual e interativa que pode consultar novamente as fontes conectadas toda vez que é aberta — você cria uma vez e volta para usar ou atualizar depois. Disponível no app Claude Desktop.

Exemplo real — painel de depoimentos a partir da planilha:

Utilize a planilha 'Depoimentos Categorizados' e crie um Artefato
ao vivo chamado 'Painel de Depoimentos'. O painel deve mostrar: a
quantidade total de depoimentos, a quantidade por categoria, os
depoimentos com nota igual ou superior a quatro, e uma tabela com
nome do aluno, resultado, categoria, nota e link do arquivo
original. Inclua filtros por categoria e por nota. Utilize um
visual simples, organizado e fácil de consultar. Quando o
Artefato for aberto novamente, consulte a fonte conectada para
usar os dados mais recentes. Não altere a planilha original.

Depois de criado, o painel continua editável pela conversa: "Adicione um filtro para mostrar somente depoimentos com resultados financeiros." Fica salvo na área de Artefatos do Cowork.

Assim como o Cowork, o Claude Code é uma ferramenta agêntica: em vez de só responder, ele analisa o ambiente, identifica as etapas necessárias e executa ações até o resultado. A diferença é o ambiente — o Cowork foi pensado para tarefas de conhecimento (documentos, planilhas, sites); o Claude Code trabalha num ambiente mais técnico, acessando a estrutura de um projeto inteiro, editando arquivos e executando comandos no computador.

O que o Claude Code consegue fazer: ler, criar e editar arquivos; entender como os arquivos se relacionam; trabalhar com vários arquivos ao mesmo tempo; executar comandos; instalar recursos; encontrar e corrigir erros; realizar testes; criar documentação; trabalhar em várias etapas até concluir.

Exemplos de pedido: "Analise este projeto e explique como ele está organizado." · "Encontre a causa deste erro." · "Crie uma nova página seguindo o padrão visual das páginas existentes."

Um gestor de automação pode usar o Claude Code para criar um fluxo do n8n em JSON e importar na ferramenta — ou, com MCP configurado, trabalhar diretamente no n8n (módulo específico mais à frente).

O Claude Code pode alterar meus arquivos? Sim — cria e edita dentro da pasta usada, e pode executar comandos que modificam o projeto. Comece com uma pasta de teste, evite arquivos importantes ou de clientes na primeira experiência, e use o Git para poder recuperar versões anteriores.

Links oficiais: Visão geral do Claude Code · Fluxos de trabalho comuns

O Claude Code também tem versão via navegador (claude.ai/code, roda na nuvem) — mas o foco da formação é trabalhar direto com projetos e arquivos no computador, usando estas três formas:

Não existe resposta única — a formação usa as três, para você escolher a que fizer mais sentido em cada situação. Desktop quando quer algo direto e visual; Terminal quando quer contato direto com os comandos; VS Code quando quer visualizar e editar arquivos enquanto usa o Claude Code.

Links oficiais: Claude Code no Desktop · Claude Code no VS Code · Referência do Terminal

A lista é pequena:

• Plano do Claude — Pro, Max, Team ou Enterprise (o Free não dá acesso ao Claude Code) + conexão com internet
• Git — não é obrigatório, mas recomendado (registra histórico de alterações — se algo sair diferente do esperado, ajuda a recuperar uma versão anterior). No Mac costuma já vir disponível; no Windows habilita o Git Bash
• Node.js — não é obrigatório para o método nativo de instalação. Só instale quando um projeto ou ferramenta específica precisar
• VS Code — também não obrigatório (dá pra usar só Desktop ou Terminal), mas facilita a visualização; vamos instalar a extensão oficial nele

Links oficiais: Planos do Claude · Requisitos e instalação · Download do Git · Download do Node.js · Download do VS Code

Siga a documentação oficial, copie o comando do seu sistema operacional e cole no terminal. Depois, confirme:

claude --version

Abra no terminal a pasta do projeto e inicie com claude — no primeiro acesso, ele pede login pelo navegador.

Comandos essenciais (digite / sozinho para ver a lista completa a qualquer momento):

Links oficiais: Instalação oficial · Primeiros passos · Comandos do Claude Code · Referência do Terminal

Baixe em code.visualstudio.com/download, abra a pasta do projeto (File → Open Folder), e instale a extensão oficial (publicada pela Anthropic) na área de extensões. O ícone do Claude Code aparece como uma pequena estrela — se não aparecer, feche e reabra o VS Code.

No primeiro acesso, clique em "Sign in" e conclua a autorização pelo navegador. O terminal integrado (Terminal → New Terminal) também funciona com o comando claude, já que o CLI foi instalado na aula anterior.

Links oficiais: Claude Code no VS Code · Extensão oficial (Marketplace)

O fluxo básico: abrir uma pasta → explicar o resultado desejado → revisar o plano → autorizar → acompanhar → testar → pedir ajustes pela conversa.

Exemplo real — gerador de orçamentos:

Crie um gerador de orçamentos para uma empresa. A ferramenta deve
permitir preencher: nome da empresa, nome do cliente, produto ou
serviço, quantidade, valor de cada item, desconto, observações.
Também deve permitir adicionar vários itens, excluir um item e
calcular automaticamente o valor total. Inclua um botão para
imprimir ou salvar em PDF. Quero uma aparência limpa, organizada
e fácil de usar tanto no computador quanto no celular. Crie de
forma simples, para abrir e usar direto no navegador — não
instale nada nem use recursos que exijam configurações
adicionais. Antes de começar, apresente um resumo curto do que
será criado e aguarde minha aprovação. Quando terminar, explique
de forma simples para que serve cada arquivo criado.

Depois do primeiro resultado, continue lapidando pela própria conversa: "Deixe o título maior e utilize tons de azul." · "O valor do desconto não está sendo calculado corretamente. Analise e corrija." Teste, volte, peça ajuste, teste de novo.

Pense no CLAUDE.md como um manual de orientações para o Claude — parecido com o que você entregaria a alguém novo na equipe: qual o objetivo do projeto, como os arquivos estão organizados, o que não pode ser alterado sem autorização, como verificar se o trabalho está correto. É um arquivo de texto simples (Markdown, daí o .md) carregado automaticamente no início de cada sessão naquela pasta.

A hierarquia — 4 níveis que se somam (evite instruções contraditórias entre eles):

Projetos maiores podem ter um CLAUDE.md principal e outros dentro de subpastas específicas — mas comece simples e adicione só quando surgir necessidade real. Recomendação da Anthropic: manter cada CLAUDE.md com menos de 200 linhas. Nunca coloque senhas ou chaves de acesso nele.

Links oficiais: Memória e CLAUDE.md · Diretório .claude · Boas práticas

Análise de um CLAUDE.md real em produção — o que ele ensina:

# Sistema de Entrega — Gestora de Automação

Você está auxiliando uma gestora de automação solo. Ferramenta
principal: n8n. Documentos para o cliente vão para o Notion.
Organização profissional por projeto.

## Regras de Trabalho
1. Cada projeto vive em projetos/CLIENTE-NOMEPROJETO/ — nunca
   misture arquivos de clientes diferentes.
2. Os arquivos em _templates/ são modelos — nunca edite direto.
   Copie para a pasta do projeto antes de preencher.
3. Documentos para o cliente: linguagem clara, sem jargões
   técnicos, foco em valor de negócio.

## Sobre o n8n
JSONs exportados ficam em 04_execucao/workflows/
Nomeie os arquivos como workflow-NOME-vN.json

## Princípios de Entrega
Documentação: deve ser lida por alguém não técnico.
Relatório mensal: foco em impacto de negócio, não em detalhes
técnicos.

O que dá para aprender daqui:

• Instrução específica > instrução genérica. "Organize bem os arquivos" vs "Cada projeto deve ficar em sua própria pasta. Nunca misture arquivos de clientes diferentes" — a segunda reduz interpretação errada.
• O CLAUDE.md pode apontar para outros documentos em vez de guardar tudo: "Consulte FLUXO_DE_TRABALHO.md para saber quando usar cada template, skill e agente." Isso evita um arquivo gigante — pense nele como uma porta de entrada.
• Processos repetitivos podem ser documentados (ex: "Como Criar um Novo Projeto", passo a passo) em vez de reexplicados toda vez.
• Padrões técnicos objetivos (onde salvar, como nomear) convivem com princípios gerais (como escrever para o cliente) — os dois tipos são úteis.

O Claude Code tem um comando que gera uma versão inicial analisando os arquivos do projeto:

/init

Trate o resultado como um rascunho — ele identifica o que está visível no código (tecnologias usadas, por exemplo), mas não sabe decisões que não estão escritas em lugar nenhum. Personalize pedindo ao próprio Claude:

Quero personalizar o CLAUDE.md deste projeto. Atualize somente o
arquivo CLAUDE.md. Mantenha o documento curto, claro e organizado.
Inclua estas informações:
- Este projeto é um gerador de orçamentos para pequenos negócios.
- Deve continuar funcionando diretamente no navegador.
- Não instale bibliotecas ou ferramentas sem autorização.
- Não remova o campo de desconto sem autorização.
- Após alterações nos cálculos, teste a soma dos itens, o
  desconto e o valor final.
- Não altere os outros arquivos do projeto neste momento.

Confirme que o arquivo foi carregado:

/context

Esse comando mostra o que está ocupando o contexto da sessão, incluindo os arquivos de instruções carregados. Para testar se as orientações estão sendo consideradas, pergunte diretamente: "Sem modificar os arquivos, explique quais cuidados você deve tomar ao trabalhar neste projeto."

O arquivo não precisa nascer completo — atualize quando surgir uma decisão nova ou quando precisar repetir a mesma correção em sessões diferentes.

Não crie pastas vazias só para "parecer organizado" — a estrutura cresce quando surge necessidade real. Quando um projeto acumula regras detalhadas demais para caber no CLAUDE.md, crie uma base de conhecimento separada (ex: pasta documentacao/) e aponte para ela:

## Referências
Antes de alterar os cálculos, leia
`documentacao/REGRAS_DO_ORCAMENTO.md`.

Diferença entre indicar (` `, crases — só o caminho, lido quando necessário) e importar (@ — o conteúdo é carregado junto em toda sessão, ocupando contexto sempre). Use @ só para o que precisa estar disponível o tempo todo.

A pasta .claude/ reúne configurações do projeto, diferente de uma pasta de documentação comum:

.claude/
├── settings.json        ← configurações compartilháveis com a equipe
└── settings.local.json  ← configurações pessoais (não compartilhado)

Nunca guarde senhas, tokens ou chaves de acesso em documentação ou no CLAUDE.md — registre onde a configuração é usada, não o valor sigiloso em si.

Link oficial: Configurações do Claude Code

Rode /memory para ver o painel completo de memória: se a auto-memory está ativada, o caminho do CLAUDE.md do usuário (~/.claude/CLAUDE.md) e do projeto (./CLAUDE.md), e a opção de abrir a pasta de auto memory.

A diferença central: quem escreve. No CLAUDE.md, você registra as orientações. Na auto memory, o próprio Claude salva aprendizados que surgem durante o trabalho — a causa de um erro recorrente, um comando necessário para rodar o projeto, uma preferência que você repetiu várias vezes. Ele não salva tudo, só o que considera útil para sessões futuras (por isso a pasta pode estar vazia num projeto recente).

Dentro da pasta de auto memory, um arquivo MEMORY.md funciona como índice; tudo é Markdown, então dá pra abrir, revisar, editar ou apagar uma memória que não faça mais sentido. Ela não depende do Git nem é enviada para o GitHub — fica fora do repositório, diferente do CLAUDE.md.

Onde guardar cada tipo de informação:

• Preferência pessoal para todos os projetos → ~/.claude/CLAUDE.md
• Orientação permanente do projeto → ./CLAUDE.md
• Informação detalhada → pasta de documentação
• Aprendizado descoberto durante o trabalho → auto memory (pode pedir: "Guarde este aprendizado na memória do projeto")

Quatro nomes que aparecem com frequência e não cumprem a mesma função — eles se relacionam, mas resolvem problemas diferentes.

Como eles trabalham juntos: a skill ensina um processo, o plugin organiza e distribui recursos, o MCP fornece acesso a ferramentas externas, o conector facilita essa conexão. Não são concorrentes — imagine usar o Claude para construir automações no n8n: o MCP cria a conexão com o n8n, uma skill ensina o Claude a seguir os padrões da empresa ao montar os fluxos, e tudo isso pode ser empacotado num plugin para reutilizar em outros projetos.

Qual devo utilizar — regra simples:

• Repete sempre as mesmas instruções ou o mesmo processo? → Skill
• Quer agrupar, reutilizar ou compartilhar vários recursos? → Plugin
• O Claude precisa acessar dados ou executar ações em outra ferramenta? → MCP
• Já existe uma integração pronta para aquele serviço? → Conector

Links oficiais: Visão geral dos recursos · Skills no Claude Code · Plugins no Claude Code · Conectores e MCP

Onde encontrar skills prontas: no skills.sh (diretório que reúne skills publicadas em diferentes repositórios), em repositórios no GitHub, dentro de plugins, ou compartilhadas por outros desenvolvedores.

Na página de cada skill no skills.sh você encontra o que ela faz, quem publicou, o repositório de origem, os arquivos e instruções, e o comando de instalação — confira essas informações antes de instalar.

Ativando a skill instalada — inicie (ou reinicie) o Claude Code:

claude

Para executar diretamente:

/nome-da-skill

Dependendo da configuração, o Claude também pode utilizá-la automaticamente quando identificar uma tarefa relacionada. Se ela aparecer entre as opções do Claude Code, está pronta para ser usada.

Links oficiais: Diretório de skills · Repositório de skills da Anthropic · Documentação de skills · Padrão aberto Agent Skills

Em vez de escrever um SKILL.md do zero, dá pra usar a própria skill-creator da Anthropic — ela orienta o Claude durante a criação e a melhoria de outras skills.

Instalando a skill-creator:

npx skills add https://github.com/anthropics/skills --skill skill-creator

Depois, inicie (ou reinicie) o Claude Code e rode:

/skill-creator

Exemplo real — skill para revisar mensagens de WhatsApp:

Crie uma skill para revisar mensagens de WhatsApp enviadas por
empresas aos seus clientes.
Nome da skill: revisar-whatsapp.
A skill deve:
- Escrever em português do Brasil.
- Deixar a mensagem clara, curta e natural.
- Corrigir erros de português.
- Manter nomes, datas, valores, links e outras informações
  importantes.
- Não inventar informações.
- Entregar somente a mensagem revisada.
Crie como uma skill deste projeto.

A skill-creator pode fazer algumas perguntas antes de criar os arquivos — responda conforme as opções apresentadas.

Testando:

/revisar-whatsapp

Depois envie uma mensagem qualquer para revisão, por exemplo:

oi maria passando pra avisar que sua reunião ficou pra amanhã as
15 horas qualquer coisa me avisa

Lapidando: uma skill não precisa ficar perfeita na primeira versão. Depois de testar, peça ajustes:

Atualize a skill revisar-whatsapp.
A partir de agora:
- Não utilize linguagem formal demais.
- Evite textos longos.
- Preserve emojis existentes.
- Não adicione novos emojis.
- Não inclua explicações antes ou depois da mensagem.
Mantenha as outras orientações.

Criar, testar e lapidar — repita esse processo sempre que encontrar um comportamento que quiser melhorar. Crie a skill que fizer sentido pro seu negócio.

Links oficiais: Skill Creator · Repositório de skills da Anthropic · Como criar skills

Um plugin é um pacote que pode reunir skills, agentes especializados, hooks (automações que rodam em eventos do Claude Code, como editar um arquivo ou iniciar uma sessão) e servidores MCP — em vez de instalar e configurar cada recurso separadamente.

Quando faz sentido: imagine montar um time de agentes de marketing — um agente de conteúdo, um de análise de campanhas, um de pesquisa de concorrentes, skills com os processos da empresa, uma conexão MCP e hooks de verificação. Tudo isso pode virar um único plugin instalável (aprofundamos isso no módulo de times de agentes).

Abrindo o marketplace:

/plugin

Na aba Discover, você encontra os plugins disponíveis nos marketplaces adicionados ao Claude Code. Escolha um, instale e depois ative:

/reload-plugins

Esse comando recarrega os plugins sem precisar reiniciar o Claude Code. Para conferir, volte em /plugin → aba Installed — lá dá pra conferir os plugins instalados, ativar/desativar ou desinstalar.

Como utilizar: depende dos recursos incluídos. Se o plugin tiver uma skill, ela aparece como /nome-do-plugin:nome-da-skill. Se incluir agentes, hooks ou MCPs, confira a descrição do plugin para entender como funciona.

Links oficiais: Como encontrar e instalar plugins · Como funcionam os plugins · Marketplace oficial da Anthropic

Por que transformar uma skill em plugin: a skill revisar-whatsapp (criada na Aula 3) já funciona no projeto, mas se você quer usá-la em outros projetos, compartilhar com a equipe, controlar versões ou adicionar novas skills/agentes no futuro, faz sentido colocá-la dentro de um plugin. A skill continua fazendo a mesma tarefa — o plugin só organiza, amplia e distribui.

Pedindo ao Claude para criar a estrutura:

Analise a skill revisar-whatsapp criada neste projeto.
Crie um plugin chamado atendimento-whatsapp.
O plugin deve conter:
- O arquivo .claude-plugin/plugin.json.
- Uma pasta skills.
- A skill revisar-whatsapp dentro dessa pasta.
Copie as instruções atuais da skill sem alterar seu
comportamento. Não apague a skill original. Por enquanto, não
adicione agentes, hooks ou conexões MCP.

O resultado é uma estrutura parecida com esta:

atendimento-whatsapp/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    └── revisar-whatsapp/
        └── SKILL.md

O plugin.json reúne as informações principais — name identifica o plugin, description explica sua função, version indica a versão atual:

{
  "name": "atendimento-whatsapp",
  "description": "Recursos para melhorar o atendimento pelo WhatsApp",
  "version": "1.0.0"
}

Validando a estrutura:

claude plugin validate ./atendimento-whatsapp

Se aparecer erro, copie a mensagem e peça: "Analise o erro apresentado na validação do plugin atendimento-whatsapp. Corrija somente os arquivos necessários e preserve o comportamento da skill."

Testando localmente, carregando o plugin direto da pasta:

claude --plugin-dir ./atendimento-whatsapp

Como a skill agora está dentro de um plugin, o comando ganha o nome do plugin antes do nome da skill:

/atendimento-whatsapp:revisar-whatsapp

O comportamento não muda — o que muda é a forma de organizar e carregar o recurso. Continue lapidando normalmente: atualize o SKILL.md, teste de novo e recarregue com /reload-plugins.

Links oficiais: Como criar plugins · Referência técnica de plugins · Como distribuir plugins por marketplaces

MCP (Model Context Protocol) é o padrão que conecta o Claude a ferramentas e fontes de dados externas — documentação, bancos de dados, ferramentas de automação, sistemas de gestão. O servidor MCP disponibiliza ferramentas, e o Claude as utiliza para consultar informações ou executar ações, de acordo com as permissões disponíveis.

Exemplo prático — conectando o Claude Code à própria documentação:

claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

claude mcp add adiciona um servidor; --transport http informa que ele está disponível num endereço na internet; claude-code-docs é o nome dado à conexão; a URL é o endereço do servidor.

Conferindo a conexão:

claude mcp list

Cada servidor mostra um status: Connected (pronto), Needs authentication (precisa autenticar) ou Failed to connect. Dentro de uma sessão do Claude Code, /mcp mostra os servidores disponíveis e permite autenticar.

Testando:

Utilize o servidor claude-code-docs para consultar na
documentação oficial o que o comando /context faz. Responda em
português e inclua o link da página consultada.

Na primeira utilização, o Claude Code pode pedir autorização para executar a ferramenta do servidor — confira qual ferramenta será usada, qual servidor a disponibilizou e qual ação será executada antes de autorizar.

Os escopos do MCP:

claude mcp add --scope user --transport http claude-code-docs https://code.claude.com/docs/mcp

Gerenciando servidores:

claude mcp list
claude mcp get claude-code-docs
claude mcp remove claude-code-docs

Remover servidores que não são mais usados evita ferramentas desnecessárias ocupando espaço no contexto.

E os conectores? Os conectores do Claude Chat usam a mesma infraestrutura de MCP — a diferença está principalmente na forma de adicionar a conexão. O conector já vem pronto; um servidor MCP também pode ser configurado por endereço ou por um processo rodando no computador.

Links oficiais: MCP no Claude Code · Primeiros passos com servidores MCP · Diretório de conectores