O que é o arquivo CLAUDE.md e por que ele é tão importante?

O CLAUDE.md é o arquivo de identidade que o Claude Code lê automaticamente no início de cada conversa. Ele define as regras do projeto, público-alvo, tom de voz e aponta para arquivos de referência. A regra de ouro é mantê-lo abaixo de 150 linhas para economizar tokens e garantir respostas cirúrgicas.

Qual a diferença entre uma Skill e um prompt comum no Claude Code?

Um prompt comum é uma instrução livre que gera saídas imprevisíveis. Uma Skill é um arquivo Markdown salvo em .claude/commands/ (acionado por /nome-do-comando) que define um fluxo passo a passo rigoroso com pré-requisitos e formato de saída padronizado.

O que são Sound Hooks e como eles ajudam na produtividade?

Sound Hooks são comandos no settings.json do Claude Code que tocam um aviso sonoro (chime) assim que uma tarefa longa é concluída ou quando o Claude precisa de permissão. Isso permite que você trabalhe em outras tarefas sem ficar preso olhando para o terminal.

Claude Code para Iniciantes: Guia Completo, CLAUDE.md, Skills & Agentes

school Trilha de Aprendizado Completa (7 Módulos & 34 Aulas)

Clique nos módulos para expandir as aulas, conceitos-chave, comandos de terminal e exemplos reais.

Comece Aqui — O Que é o Claude Code e o Que Você Irá Construir

8 min

Visão geral de como transformar a IA de um simples chatbot de navegador em um colaborador que opera diretamente nos arquivos do seu computador.

Conceitos-Chave:

› Diferença entre usar IA na web (1% do potencial) vs. direto na sua máquina (100% de automação)
› Os 7 pilares do domínio: Ambiente, Arquivos, Identidade (CLAUDE.md), Skills, Ferramentas (MCP), Agentes e Comandos Avançados
› Como transformar tarefas de 15 minutos em comandos únicos de 20 segundos

Ação / Comando Prático:

claude --version

Planos & Escolha da Assinatura (Pro vs Max)

6 min

Análise clara dos limites de uso e qual plano atende suas necessidades reais de trabalho e automação.

Conceitos-Chave:

› Plano Gratuito: útil apenas para testes rápidos, atinge limite de uso rapidamente
› Plano Pro ($20/mês): ideal para redação, pesquisas, códigos simples e quem está começando
› Plano Max ($100 a $200/mês): essencial para builders, automações pesadas e sessões contínuas no Claude Code
› Equipes (Teams): para empresas que precisam centralizar membros e faturamento

Ação / Comando Prático:

https://claude.ai/settings/billing

Instalação do Claude Desktop no Windows e Mac

7 min

Passo a passo visual para baixar, instalar e autenticar o aplicativo oficial no seu sistema operacional.

Conceitos-Chave:

› Download oficial em claude.ai/download
› Instalação no Windows (.exe) e no macOS (.dmg)
› Autenticação e configuração inicial de preferências
› Como arrastar pastas locais diretamente para o Claude Desktop

Ação / Comando Prático:

winget install Anthropic.Claude # No Windows via terminal

Claude Code no Terminal & Integração com Cursor / VS Code

10 min

Como operar o Claude Code via linha de comando e integrá-lo ao seu editor de código favorito para fluxo de trabalho de alta velocidade.

Conceitos-Chave:

› Instalação global do Claude Code via NPM
› Abertura do Claude Code diretamente na raiz do seu projeto
› Trabalhando lado a lado com Cursor ou VS Code
› Permissões de execução segura e leitura de diretórios

Ação / Comando Prático:

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

O Sistema de Arquivos Explicado — Claude Vive no Seu Computador

12 min

Prova prática de que o Claude pode criar pastas, mover arquivos desorganizados e renomeá-los fisicamente no seu disco.

Conceitos-Chave:

› O conceito de diretório de trabalho (Working Directory)
› Como pedir para o Claude organizar pastas bagunçadas de downloads ou documentos
› Permissões de escrita e visualização antes de confirmar alterações
› Casos de uso para empresas: organização de faturas, contratos e relatórios

Ação / Comando Prático:

claude -p 'Organize os arquivos desta pasta em subpastas por tipo e renomeie-os de forma padronizada.'

Quais Arquivos o Claude Consegue Ler e Interpretar

9 min

Guia de compatibilidade de formatos: textos, markdowns, PDFs, planilhas CSV/XLSX, imagens e códigos-fonte.

Conceitos-Chave:

› Arquivos de texto (.txt, .md, .json, .csv): leitura 100% nativa e veloz
› Documentos e PDFs (.pdf, .docx): extração de tabelas, cláusulas e resumos
› Imagens (.png, .jpg, .webp): leitura OCR de capturas de tela e gráficos de métricas
› O que NÃO funciona direto: áudio e vídeo brutos (.mp4, .mp3) e arquivos compactados (.zip) sem descompactar primeiro

Ação / Comando Prático:

claude -p 'Analise o arquivo relatorio.csv e me dê os 5 maiores destaques.'

Arquitetura Multi-Projetos & Organização de Espaços de Trabalho

11 min

Como estruturar pastas de múltiplos clientes ou negócios sem misturar contextos ou vazar dados.

Conceitos-Chave:

› Estrutura recomendada: pasta raiz por projeto/empresa
› Configuração global (~/.claude) vs. Configuração local do projeto (./.claude)
› Isolamento de contexto e segurança de dados entre clientes
› Padronização de diretórios: `docs/`, `src/`, `reference/` e `scripts/`

Ação / Comando Prático:

mkdir -p meu-projeto/{reference,scripts,docs,.claude/commands}

Versionamento Seguro com Git & Backup no GitHub

10 min

Conectando seu projeto ao Git para rastrear todas as alterações feitas pela IA e restaurar versões a qualquer momento.

Conceitos-Chave:

› Inicialização do repositório Git com `git init`
› Configuração do `.gitignore` para não enviar senhas ou arquivos pesados
› Como pedir para o Claude criar commits semânticos e branches de teste
› Trabalho colaborativo em equipe com histórico protegido

Ação / Comando Prático:

git init && git add . && git commit -m 'feat: estrutura inicial do projeto'

O Que é o CLAUDE.md — O Arquivo Mais Poderoso do Seu Setup

14 min

Aprenda como duas frases no CLAUDE.md transformam o Claude de um robô genérico em um sócio estratégico que conhece sua empresa.

Conceitos-Chave:

› Por que prompts normais geram respostas genéricas e repetitivas
› O arquivo `CLAUDE.md` é carregado automaticamente no início de cada conversa
› A Regra de Ouro: mantenha o CLAUDE.md abaixo de 150 linhas (enxuto e cirúrgico)
› A Tabela de Arquivos-Chave (Key Files) que aponta para o diretório `reference/`

Ação / Comando Prático:

touch CLAUDE.md

Business Brain Dump — A Entrevista em 8 Etapas

15 min

Método guiado para extrair todos os detalhes do seu negócio: identidade, público-alvo, ofertas, jornada, marketing e regras.

Conceitos-Chave:

› Etapa 1: Identidade e Proposta de Valor única
› Etapa 2: Quem você serve (Cliente Ideal e dores resolvidas)
› Etapa 3: Ofertas, produtos e esteira de preços
› Etapa 4: Jornada do Cliente (Descoberta -> Compra -> Entrega -> Indicação)
› Etapa 5 a 8: Canais de aquisição, Stack de ferramentas, Tom de voz e Regras inegociáveis

Ação / Comando Prático:

cat reference/business-context.md

Carregamento Inteligente de Contexto: Menos é Mais

10 min

Entenda a arquitetura de memória lazy-loading para não queimar tokens desnecessários e manter o Claude rápido.

Conceitos-Chave:

› CLAUDE.md: carregamento permanente (Resumo executivo, regras e mapa de arquivos)
› reference/business-context.md: carregado apenas quando solicitado
› reference/voice-guide.md: carregado apenas para tarefas de copywriting e redação
› reference/pricing.md: carregado apenas para propostas e negociações

Ação / Comando Prático:

ls -la reference/

O Que é uma Skill — Um Arquivo Markdown, Não Código Complexo

11 min

Desmistificando as Skills do Claude: são simples arquivos `.md` com instruções estruturadas em linguagem natural.

Conceitos-Chave:

› A diferença entre pedir algo no chat e rodar uma Skill padronizada
› Repetibilidade e consistência: o mesmo resultado de qualidade sempre
› Como disparar skills usando `/nome-da-skill`
› Onde as skills ficam salvas: `.claude/commands/`

Ação / Comando Prático:

mkdir -p .claude/commands

A Anatomia de uma Skill em 4 Blocos Fundamentais

12 min

A fórmula obrigatória para criar skills profissionais e à prova de falhas.

Conceitos-Chave:

› Bloco 1: Descrição (O objetivo da automação em 1 linha)
› Bloco 2: Pré-requisitos (Arquivos e conexões necessárias antes de iniciar)
› Bloco 3: Fluxo de Trabalho (Passo a passo numerado em ordem cronológica)
› Bloco 4: Formato de Saída (Tabela, checklist, arquivo criado ou markdown formatado)

Ação / Comando Prático:

cat .claude/commands/exemplo.md

Construindo uma Skill Real: Assistente de Triagem de E-mails

14 min

Passo a passo da criação de uma skill que lê e-mails não lidos, classifica por urgência e gera respostas rascunhadas.

Conceitos-Chave:

› Estruturação dos filtros de prioridade (Urgente, Comercial, Suporte, Informativo)
› Como aplicar o tom de voz do seu negócio na resposta aos clientes
› Salvando o resumo em markdown para revisão antes do envio
› Testando e aprimorando os critérios de classificação

Ação / Comando Prático:

claude /triage-email

Skills Globais (~/.claude) vs Skills Locais de Projeto

8 min

Quando disponibilizar um comando para qualquer pasta do seu computador versus mantê-lo restrito a um repositório.

Conceitos-Chave:

› Skills Globais (`~/.claude/commands/`): rotinas diárias (/morning, /audit, /standup)
› Skills Locais (`./.claude/commands/`): regras específicas de um cliente ou software
› Compartilhando skills com a equipe via repositório Git
› Precedência de carregamento de comandos

Ação / Comando Prático:

ls ~/.claude/commands/

MCP vs API — Como o Claude se Conecta ao Mundo Exterior

10 min

Entenda a diferença fundamental entre requisições manuais de API e uma ponte permanente e segura via MCP.

Conceitos-Chave:

› O que é o Model Context Protocol (MCP) e por que ele se tornou padrão aberto
› Conexão Permanente (MCP): configura uma vez, o Claude usa com permissão contínua
› Requisição Manual (API): solicita autorização a cada chamada
› Quando usar cada abordagem na arquitetura de automações da sua empresa

Ação / Comando Prático:

claude mcp list

Conectando Sua Primeira Ferramenta Nativa (Google Calendar / Gmail)

12 min

Tutorial de configuração e autenticação para o Claude ler seus compromissos e planejar seu dia.

Conceitos-Chave:

› Ativação do conector de calendário
› Autorização OAuth2 segura
› Testes práticos de consulta: 'Quais reuniões tenho hoje?' e 'Estou livre na sexta à tarde?'
› Criação e edição de eventos diretamente pelo chat

Ação / Comando Prático:

claude -p 'Conecte meu Google Calendar para ler meus eventos desta semana.'

Segurança de Chaves de API, Tokens & Arquivos .env

9 min

Boas práticas inegociáveis para nunca expor suas credenciais em chats ou repositórios públicos.

Conceitos-Chave:

› Uso obrigatório de `.env` e `.gitignore`
› Armazenamento de chaves no keychain seguro do sistema operacional
› Como conceder permissões mínimas necessárias para ferramentas conectadas
› Auditoria periódica de acessos e rotação de tokens

Ação / Comando Prático:

echo '.env' >> .gitignore

O Que São Agentes e Quando Faz Sentido Disparar Equipes

11 min

O modelo mental dos agentes: freelancers digitais autônomos que executam tarefas em paralelo e reportam o resultado.

Conceitos-Chave:

› O problema da execução sequencial (esperar tarefa A acabar para começar B)
› Execução Paralela: 4 agentes trabalhando ao mesmo tempo em 2 minutos em vez de 15
› Regra de ouro: quando vale a pena usar agentes vs quando é exagero
› Isolamento de contexto entre subagentes

Ação / Comando Prático:

claude /agents

Os 5 Padrões Universais de Equipes de Agentes

15 min

Os 5 modelos de orquestração que cobrem 95% das necessidades empresariais.

Conceitos-Chave:

› Padrão 1: Equipe de Pesquisa (4 agentes buscando em fontes diferentes: X, Reddit, Notícias, GitHub)
› Padrão 2: Equipe de Conteúdo (1 escreve carrossel, 1 escreve newsletter, 1 escreve roteiro)
› Padrão 3: Equipe de Concorrentes (análise de preços, redes sociais e reviews em paralelo)
› Padrão 4: Equipe de Repurposing (transforma 1 vídeo longo em 5 formatos diferentes)
› Padrão 5: Equipe de Auditoria (revisa código, confere segurança, checa links e valida dados)

Ação / Comando Prático:

claude -p 'Dispare 4 agentes para pesquisar novidades sobre IA em paralelo.'

Handoffs & Comunicação entre Subagentes

12 min

Como estruturar o fluxo quando o Agente B precisa receber e refinar o resultado produzido pelo Agente A.

Conceitos-Chave:

› Diferença entre paralelismo puro e pipelines de handoff
› O papel do Agente Coordenador (Lead Agent)
› Formatos padronizados de entrega intermediária (JSON, Markdown sintético)
› Como evitar alucinações e perda de contexto em repasses

Ação / Comando Prático:

claude -p 'Execute o pipeline com handoff estruturado.'

Sound Hooks — Notificação Sonora Quando o Claude Termina a Tarefa

9 min

Configure um aviso sonoro (chime) para tocar assim que o Claude concluir um processamento longo ou pedir confirmação.

Conceitos-Chave:

› Como editar o arquivo de configurações `~/.claude/settings.json`
› Configuração do evento `Notification` e do evento `Stop`
› Comando de áudio no macOS (`afplay Glass.aiff`) vs Windows (PowerShell SoundPlayer)
› Trabalhe em outras abas sem ficar olhando para o terminal esperando

Ação / Comando Prático:

cat ~/.claude/settings.json

Comando /rename — Organização de Múltiplas Sessões em Paralelo

7 min

Identifique suas abas de terminal pelo nome do projeto ou cliente em vez de IDs genéricos de sessão.

Conceitos-Chave:

› Como usar `/rename pesquisa-concorrentes` ou `/rename site-cliente`
› Boas práticas de nomenclatura por cliente, tarefa ou ambiente
› Alternando rapidamente entre sessões ativas
› Redução drástica de erros operacionais ao lidar com múltiplos agentes

Ação / Comando Prático:

/rename auditoria-seo

Guia de Sobrevivência: /resume, /compact, /plan-mode e /permissions

13 min

Os comandos nativos mais importantes para gerenciar contexto, retomar conversas e planejar alterações críticas.

Conceitos-Chave:

› `/resume`: retome exatamente de onde parou em sessões anteriores
› `/compact` e `/clear`: limpe o contexto mantendo apenas o essencial para economizar tokens
› `/plan-mode`: force o Claude a criar um plano detalhado antes de tocar em qualquer código
› `/permissions`: configure quais comandos podem rodar sem pedir autorização repetitiva

Ação / Comando Prático:

/compact

description Gerador Interativo de CLAUDE.md & Reference Files

Preencha os dados do seu negócio ou use um modelo pronto para gerar os 3 arquivos essenciais da arquitetura Claude Code.

Passo 1: Escolha um Modelo Base ou Preencha Manualmente

tune Personalize as Informações do Seu Negócio

Nome da Empresa / Projeto:

O que você faz em 1 frase (Proposta de Valor):

Quem é seu cliente ideal e qual a principal dor resolvida:

Oferta Principal & Preço Médio:

Tom de Voz & Estilo de Redação:

Ferramentas & Tecnologias Utilizadas:

Localização: ./CLAUDE.md (Regra dos 150 linhas) 32 linhas

auto_mode Construtor de Skills Customizadas (`.claude/commands/`)

Crie atalhos de barra (`/minha-skill`) que executam rotinas complexas da sua empresa com apenas um comando.

Modelos de Skills Prontas para Usar:

edit_note Estrutura dos 4 Blocos da Skill

Nome do Comando (sem espaços):

Bloco 1: Descrição (O que a skill faz em 1 frase):

Bloco 2: Pré-requisitos necessários:

Bloco 3: Passos do Fluxo de Trabalho (Workflow numerado):

Bloco 4: Formato de Saída (Output esperado):

Arquivo Markdown Pronto para Salvar:

Como instalar: Salve este conteúdo no arquivo .claude/commands/pesquisa-4fontes.md

groups Os 5 Padrões Universais de Equipes de Agentes

Gere prompts de orquestração multi-agente para executar tarefas paralelas e receber relatórios unificados.

search Padrão 1

Equipe de Pesquisa (4 Fontes)

Dispara 4 agentes para buscar em X/Twitter, Reddit, Notícias e GitHub simultaneamente, consolidando em um ranking das 10 maiores tendências.

edit Padrão 2

Equipe de Conteúdo Multi-Formato

3 agentes escrevendo em paralelo: 1 cria carrossel de 7 slides, 1 escreve a newsletter semanal e 1 rascunha o roteiro de vídeo de 60s.

query_stats Padrão 3

Equipe de Análise Competitiva

Múltiplos agentes analisando concorrentes diferentes: preços, propostas de valor, redes sociais e avaliações de clientes para gerar matriz comparativa.

autorenew Padrão 4

Equipe de Repurposing de Conteúdo

Pega a transcrição de 1 vídeo longo e transforma em 4 agentes paralelos: cortes curtos, post de blog SEO, thread para X e e-mail marketing.

verified Padrão 5

Equipe de Auditoria 360°

4 agentes avaliando áreas distintas ao mesmo tempo: segurança e credenciais, qualidade de código, precisão do CLAUDE.md e arquivos desorganizados.

Prompt de Orquestração Multi-Agente

Cole este comando diretamente na sua sessão do Claude Code.

volume_up Sound Hooks: Notificação Sonora Automática

Configure o Claude Code para tocar um aviso sonoro no Windows ou macOS assim que terminar tarefas demoradas.

tune Personalize seu Sound Hook

Sistema Operacional:

Som de Notificação (Quando precisa de você):

Som de Conclusão (Quando a tarefa termina):

📍 Onde colar este arquivo:

Abra o arquivo ~/.claude/settings.json no seu editor ou rode no terminal:

claude config

settings.json Formatado:

terminal Biblioteca de Super Comandos da CLI do Claude Code

Comandos de barra indispensáveis para economizar tokens, gerenciar histórico e executar fluxos seguros.

/rename Organização

Nomear Sessões em Paralelo

Renomeia a sessão do terminal para você saber exatamente o que cada Claude está fazendo sem se perder nas abas.

/rename pesquisa-concorrentes

/compact Economia

Comprimir Histórico de Conversa

Resume toda a conversa atual em pontos-chave, liberando até 80% do espaço de contexto e reduzindo custos de tokens.

/compact

/plan-mode Estratégia

Modo Planejamento Obrigatório

Força o Claude a montar um plano detalhado e aguardar sua aprovação explícita antes de fazer qualquer modificação no código.

/plan-mode

/resume Continuidade

Retomar Conversas Anteriores

Abre um seletor interativo com suas últimas sessões para você continuar o raciocínio exatamente de onde parou.

/resume

/permissions Segurança

Gestão de Permissões de Ferramentas

Define quais comandos podem rodar silenciosamente e quais exigem sua confirmação manual para cada execução.

/permissions

/clear Reset

Limpar Histórico da Janela

Reseta a conversa imediatamente, mantendo apenas os arquivos carregados do seu projeto (CLAUDE.md).

/clear

help Perguntas Frequentes sobre o Claude Code

Respostas diretas para as principais dúvidas de quem está começando a usar a CLI e automações.

1. O que acontece se meu arquivo CLAUDE.md passar de 150 linhas? expand_more

Quando o CLAUDE.md fica muito longo, duas coisas ruins acontecem: 1) Você queima tokens preciosos de contexto logo no início de cada conversa; 2) O Claude começa a sofrer com diluição de atenção e ignora instruções críticas. Mantenha o CLAUDE.md com menos de 150 linhas e mova o histórico longo para a pasta reference/.

2. Qual a diferença entre MCP (Model Context Protocol) e chamadas normais de API? expand_more

O MCP cria uma ponte de comunicação permanente entre o Claude e suas ferramentas locais ou em nuvem (como Calendar, Gmail, Airtable ou banco SQLite). Você autoriza uma única vez e o Claude opera nativamente. Chamadas de API exigem scripts avulsos e autorizações repetitivas.

3. Preciso saber programar para criar e usar Skills no Claude Code? expand_more

Não! As Skills são arquivos Markdown escritos em Português comum. Se você sabe escrever um checklist ou uma receita de bolo passo a passo, você já sabe criar uma Skill do Claude Code.

4. Como evitar que o Claude Code gaste todas as minhas mensagens rapidamente? expand_more

Use o comando /compact com frequência para comprimir sessões longas, inicie novas conversas para novas tarefas e utilize o modo /plan-mode antes de tarefas complexas para evitar tentativas e erros desnecessários.

Claude Code para Iniciantes: Da Instalação aos Agentes de IA

school Trilha de Aprendizado Completa (7 Módulos & 34 Aulas)

Primeiros Passos & Configuração do Ambiente

Comece Aqui — O Que é o Claude Code e o Que Você Irá Construir

Planos & Escolha da Assinatura (Pro vs Max)

Instalação do Claude Desktop no Windows e Mac

Claude Code no Terminal & Integração com Cursor / VS Code

Sistema de Arquivos, Pastas & Git / GitHub

O Sistema de Arquivos Explicado — Claude Vive no Seu Computador

Quais Arquivos o Claude Consegue Ler e Interpretar

Arquitetura Multi-Projetos & Organização de Espaços de Trabalho

Versionamento Seguro com Git & Backup no GitHub

Ensinando Seu Negócio ao Claude (CLAUDE.md & Referências)

O Que é o CLAUDE.md — O Arquivo Mais Poderoso do Seu Setup

Business Brain Dump — A Entrevista em 8 Etapas

Carregamento Inteligente de Contexto: Menos é Mais

Skills & Comandos Personalizados (Automação de Rotinas)

O Que é uma Skill — Um Arquivo Markdown, Não Código Complexo

A Anatomia de uma Skill em 4 Blocos Fundamentais

Construindo uma Skill Real: Assistente de Triagem de E-mails

Skills Globais (~/.claude) vs Skills Locais de Projeto

Conectando Ferramentas & Protocolo MCP

MCP vs API — Como o Claude se Conecta ao Mundo Exterior

Conectando Sua Primeira Ferramenta Nativa (Google Calendar / Gmail)

Segurança de Chaves de API, Tokens & Arquivos .env

Agentes de IA & Equipes Autônomas em Paralelo

O Que São Agentes e Quando Faz Sentido Disparar Equipes

Os 5 Padrões Universais de Equipes de Agentes

Handoffs & Comunicação entre Subagentes

Biblioteca de Super Comandos, Hooks de Áudio & Produtividade

Sound Hooks — Notificação Sonora Quando o Claude Termina a Tarefa

Comando /rename — Organização de Múltiplas Sessões em Paralelo

Guia de Sobrevivência: /resume, /compact, /plan-mode e /permissions

description Gerador Interativo de CLAUDE.md & Reference Files

tune Personalize as Informações do Seu Negócio

auto_mode Construtor de Skills Customizadas (`.claude/commands/`)

edit_note Estrutura dos 4 Blocos da Skill

groups Os 5 Padrões Universais de Equipes de Agentes

Equipe de Pesquisa (4 Fontes)

Equipe de Conteúdo Multi-Formato

Equipe de Análise Competitiva

Equipe de Repurposing de Conteúdo

Equipe de Auditoria 360°

Prompt de Orquestração Multi-Agente

volume_up Sound Hooks: Notificação Sonora Automática

tune Personalize seu Sound Hook

terminal Biblioteca de Super Comandos da CLI do Claude Code

Nomear Sessões em Paralelo

Comprimir Histórico de Conversa

Modo Planejamento Obrigatório

Retomar Conversas Anteriores

Gestão de Permissões de Ferramentas

Limpar Histórico da Janela

help Perguntas Frequentes sobre o Claude Code