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.

🛠 Prática guiada: antes de seguir, responda e anote:

• Qual tarefa repetitiva você mais gostaria de acelerar?
• Qual processo do seu trabalho precisa ficar mais organizado?
• O que você gostaria de ter funcionando ao final desta formação?

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.

Na interface: a caixa de conversa central, a barra lateral (conversas, projetos, recursos) e o botão "+" para anexar arquivos e conectores.

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

Os 5 elementos de um prompt que funciona (objetivo, contexto, informações, critérios, formato de entrega):

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)

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).

🛠 Prática guiada de fechamento do módulo: escolha um conector para testar — Google Calendar ("Liste os meus compromissos dos próximos sete dias e destaque possíveis conflitos") ou uma fonte via Windsor para análise de desempenho. Comece com uma consulta simples, confira as informações, e quando o conector permitir alterar algo, revise antes de autorizar.

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.

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

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.

O ciclo do Cowork: você delega → ele apresenta o plano → você acompanha a execução (pode interromper e corrigir) → você revisa o resultado. Ele executa; você continua responsável pela decisão final.

Link oficial: Claude Cowork

Exemplo real: depoimentos de alunos espalhados numa pasta do Google Drive, alguns renomeados, sem classificação nenhuma. Usando a extensão do Claude no navegador, o Cowork analisa os arquivos e monta uma planilha categorizada — do que se trata o depoimento, transcrição, nome do aluno, tipo de ganho (financeiro, qualidade de vida), tempo até o resultado, link do Drive.

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

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 da aula: pesquisar imóvel para alugar num site de imobiliária, pedindo para o Cowork encontrar opções dentro de critérios definidos (valor, características), em vez de aplicar os filtros e comparar manualmente.

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

🛠 Prática guiada: crie uma pasta de teste vazia no computador, por exemplo projeto-claude-code. Evite começar com arquivos importantes ou projetos de clientes.

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")

Não. A formação é para profissionais digitais, não desenvolvedores. Os comandos de terminal necessários são poucos e estão todos neste portal, prontos para copiar. Termos técnicos estão explicados no dicionário de sobrevivência.

No mínimo o Pro. Preços e limites mudam com frequência — confira a página oficial de planos antes de assinar.

Não. O instalador nativo (recomendado) não depende de nenhum dos dois. Node só é necessário no método npm; Git é apenas recomendado no Windows.

Sim — é o mesmo fluxo de instalação Linux padrão, aplicado via SSH. Qualquer servidor com Ubuntu 20.04+, Debian 10+ ou Alpine 3.19+ funciona.

Não. O underscore é só convenção visual. Quem protege é a instrução escrita no CLAUDE.md ("nunca edite direto"). Sem essa frase, o Claude edita normalmente.

Não há confirmação oficial. Conectores confirmados incluem Notion, Google Calendar, Slack, GitHub e Linear. Para WhatsApp, o caminho é um MCP customizado.

Podem ficar — planos, limites e comandos mudam. Sempre que algo divergir da documentação oficial, a doc oficial vence. Os links oficiais estão sempre atualizados.