Os 12 Conceitos do Claude Code,
Explicados sem Jargão
Esse guia é o complemento profundo do vídeo #01 da série "Simplificando o Claude Code para Não Programadores". O vídeo te dá a visão geral em 9 minutos; aqui você tem cada conceito explicado em detalhe, com exemplos práticos pra marketers e perguntas frequentes que vão te poupar horas de pesquisa.
📖 Antes dos 12 conceitos: o que é o Claude Code, em 30 segundos
O Claude Code é uma ferramenta da Anthropic (a empresa que faz o Claude) que roda no terminal do seu computador (aquela tela preta de comandos). Por trás dela tá o mesmo modelo de IA do Claude que você conversa no site, mas aqui ele tem poderes que o Claude do site não tem:
- Pode ler arquivos da sua pasta
- Pode escrever e editar arquivos direto no seu disco
- Pode rodar comandos no seu computador (criar pastas, instalar coisas, executar scripts)
- Pode fazer várias coisas em sequência sozinho — tipo "cria uma landing page com 3 seções, formulário e CSS responsivo"
Os 12 conceitos que você vai ver aqui são as ferramentas e mecânicas internas que fazem isso tudo funcionar — e que você precisa conhecer pra usar bem.
Pensa como um carro: você não precisa saber consertar motor pra dirigir, mas saber o que é freio, embreagem, marcha, painel, ajuda muito. Os 12 conceitos são os "instrumentos" do Claude Code.
🧠 Cérebro e Memória
Context
🔧Como funciona de verdade
O Claude é um modelo de linguagem (LLM). Pra responder qualquer coisa, ele precisa "ler" tudo que tá na conversa atual. Isso inclui: sua mensagem agora, mensagens anteriores, arquivos que ele leu, resultados de comandos que rodou, e o conteúdo do CLAUDE.md.
Tudo isso junto é o context. E tem um limite — medido em tokens (que são pedacinhos de palavras; ~1 token = 0,75 palavra em português).
O Claude Opus 4.7 com modo 1M context tem 1 milhão de tokens — gigante, dá pra carregar livros inteiros. Modelos menores (Haiku, Sonnet padrão) têm contexts menores (200k tokens).
Quando o context fica perto do limite, o Claude precisa "esquecer" coisas mais antigas pra caber novas. É aí que entra o Compaction.
💡Por que existe
Modelos de IA são poderosos, mas processam informação por "janela" — eles não têm memória infinita. O context define quanto eles "veem" de cada vez. Quanto maior, melhor a continuidade da conversa, mas mais caro de processar.
🎪Exemplo prático
Você abre o Claude Code, cola um briefing de cliente de 5.000 palavras, conversa por 2 horas, edita 30 arquivos. Tudo isso ocupa context. Em algum momento, o briefing inicial pode ser comprimido ou "sair" da memória ativa quando a conversa cresce.
Pegadinhas comuns
- Context NÃO é memória permanente. Quando você fecha a sessão, o context vai embora. Próxima sessão começa do zero (exceto o que tá no CLAUDE.md).
- Token ≠ palavra. 1.000 tokens ≈ 750 palavras em português.
- Modelos diferentes têm tamanhos diferentes de context — não dá pra "aumentar" — você escolhe o modelo certo pro caso.
💬 Perguntas frequentes
"Qual o tamanho do context do Claude Code?"
Depende do modelo. O Opus 4.7 em modo 1M tem 1 milhão de tokens (≈ 750.000 palavras — dá pra carregar a obra completa de Machado de Assis). O Sonnet 4.6 padrão tem 200k tokens. Modelos Haiku, ainda menos.
"Como vejo quanto context já gastei?"
O comando /context mostra um diagnóstico do context atual — quanto tá cheio, quanto cada parte (CLAUDE.md, mensagens, arquivos) ocupa.
"Se acabar o context, perco a conversa?"
Não exatamente. Acontece o Compaction automático: o Claude resume as partes antigas e libera espaço. A conversa continua, mas detalhes específicos do começo podem ter virado um resumo.
CLAUDE.md
🔧Como funciona de verdade
Você cria um arquivo chamado CLAUDE.md (com .md mesmo, é markdown) na pasta raiz do seu projeto. Toda vez que você abre o Claude Code naquele projeto, antes mesmo da sua primeira mensagem, ele LÊ esse arquivo e absorve o conteúdo direto no context.
Você pode escrever qualquer coisa lá: regras do projeto, vocabulário, atalhos, preferências de formato, contexto do negócio, exemplos. É como dar um briefing permanente pro Claude antes da conversa começar.
Existem CLAUDE.md em 3 níveis hierárquicos:
- Global do usuário (em
~/.claude/CLAUDE.md) — vale pra todos os seus projetos - Do projeto (na raiz do projeto) — vale só pra aquele projeto
- De subpasta (em pastas internas) — adicional, só quando você tá nessa subpasta
Todos os 3 são lidos quando aplicáveis. O do projeto e subpasta são geralmente os mais úteis.
💡Por que existe
Sem isso, você teria que repetir as mesmas instruções toda vez que abrisse o Claude no projeto. CLAUDE.md torna o setup persistente. É a forma de dar "personalidade" e "regras" permanentes pra um projeto.
🎪Exemplo prático
Imagina um projeto de canal no YouTube. Você cria um CLAUDE.md com:
"Sou gestor de canal sobre marketing digital. Tom: didático e despojado, em português brasileiro. Vídeos vão na pasta docs/canal/videos/[NN-slug]/. Slides em fundo escuro, paleta laranja/azul. Roteiros em markdown."
Pronto. Toda nova sessão, você não precisa explicar nada disso — o Claude já vem alinhado.
Pegadinhas comuns
- CLAUDE.md vai pro context — então também ocupa tokens. Não escreva um livro lá, ou vai gastar muita memória logo de cara.
- Mudou o CLAUDE.md? Geralmente precisa abrir nova sessão pra ele recarregar (ou usar
/initpra forçar leitura). - Não confunda CLAUDE.md com prompt — CLAUDE.md é persistente (vale sempre); prompt é o que você manda na hora.
💬 Perguntas frequentes
"Como crio um CLAUDE.md?"
Cria um arquivo de texto com o nome CLAUDE.md (exatamente assim, maiúsculo) na pasta raiz do projeto. Pode usar qualquer editor de texto (VSCode, Notepad, Cursor). Escreve em markdown — mas pode ser texto simples também, funciona.
"O que devo colocar lá?"
O básico: quem você é, o que o projeto faz, regras de tom/formato, vocabulário, preferências, atalhos. Quanto mais específico e útil pro trabalho, melhor. Evite informação genérica que o Claude já saberia sozinho.
"Tem limite de tamanho?"
Tecnicamente não, mas como ele entra no context, quanto maior, mais tokens consome do início. Mantém enxuto — 200-500 palavras geralmente já resolve. Se ficar gigante, vale dividir em CLAUDE.md por subpasta.
Compaction
🔧Como funciona de verdade
Quando o context tá perto do limite (geralmente ~80% cheio), o Claude Code faz uma operação chamada compaction:
- Pega as partes mais antigas da conversa (mensagens, leituras de arquivo, outputs antigos)
- Resume tudo isso usando o próprio modelo (cria um sumário que captura a essência)
- Substitui o conteúdo antigo pelo resumo, liberando espaço pra continuar a conversa
Acontece de duas formas:
- Automaticamente — quando o context atinge o threshold, sem você precisar pedir
- Manualmente — você digita
/compactpra forçar antes do automático rodar
💡Por que existe
Sem compaction, sessões longas quebrariam quando o context enchesse — o Claude não conseguiria responder mais nada novo. Compaction permite continuidade indefinida da conversa, sacrificando detalhes antigos em troca da continuidade.
🎪Exemplo prático
Você passou 3 horas trabalhando numa estratégia de canal com o Claude. Discutiu posicionamento, definiu pilares, refinou títulos, escreveu roteiros. Em algum momento, o Claude faz compaction — pega as primeiras 2 horas, resume em algo como "definimos posicionamento como X, 4 pilares (A/B/C/D), big idea Y..." e libera espaço pra continuar refinando.
A direção estratégica fica preservada no resumo, mas detalhes como "exatamente que palavra você sugeriu no draft #3 do título" podem ter sumido.
Pegadinhas comuns
- Compaction perde detalhe granular — o que era "qual era exatamente a 7ª opção de título" vira "discutimos opções de títulos". Por isso, em sessões longas, salve em arquivo o que for crítico.
- Quando rola compaction, você vê uma notificação no Claude Code. Nada some sem você saber.
- Não dá pra "desfazer" uma compaction. Por isso vale forçar
/compactem momentos onde você sabe que tá fechando um assunto e abrindo outro.
💬 Perguntas frequentes
"Como sei que aconteceu uma compaction?"
O Claude Code mostra uma mensagem clara no terminal quando rola — algo como "Compacting context..." e depois "Context compacted. X tokens freed". Não acontece silenciosamente.
"Quando devo forçar /compact manualmente?"
Quando você tá fechando um assunto e vai abrir outro completamente diferente. Exemplo: passou 1 hora discutindo estratégia, agora vai mexer em código de site. Forçar /compact antes deixa o context "fresco" pro novo assunto sem desperdiçar memória com o anterior.
"E se eu precisar lembrar de algo que foi compactado?"
Se o detalhe foi pro resumo, ele tá lá em forma resumida. Se você precisa do detalhe exato, não dá pra recuperar. Por isso a recomendação: durante sessões longas, salve em arquivos (.md, .txt) os outputs importantes — o Claude pode ler dos arquivos depois mesmo se a memória esqueceu.
🛡️ Controle e Segurança
Permissions
🔧Como funciona de verdade
O Claude Code consegue rodar "ferramentas" (tools) — coisas como ler arquivo, escrever arquivo, executar comando bash, fazer requisição HTTP. Cada vez que ele quer usar uma dessas ferramentas, antes de executar, ele PEDE sua autorização no terminal.
Você tem 3 opções de resposta pra cada pedido:
- Allow once — permite só essa vez
- Allow always — permite sempre, sem perguntar de novo (pra essa ferramenta com esses parâmetros)
- Deny — nega e o Claude muda de plano
Tudo isso é configurável no settings.json — você pode definir antecipadamente quais ferramentas o Claude pode usar livremente, quais sempre devem perguntar, e quais são bloqueadas.
Algumas ações são read-only (só leitura — tipo ler arquivo) e geralmente são liberadas sem perguntar. Ações que modificam o sistema (escrever, deletar, rodar comando) sempre exigem autorização explícita por padrão.
💡Por que existe
Por segurança. O Claude Code tem poder real sobre o seu computador — sem permissions, ele poderia deletar a pasta errada, rodar comandos perigosos, ou acessar coisas sensíveis sem você saber. Permissions é o controle humano sobre o agente IA.
🎪Exemplo prático
Você pede pro Claude "limpa a pasta de arquivos antigos do projeto". Antes de deletar qualquer coisa, ele te mostra:
"Quero rodar: rm -rf old-files/ — Permite?"
Você pode revisar exatamente o que vai ser deletado, e só então aprovar.
Pegadinhas comuns
- "Allow always" é perigoso se você der pra ferramenta errada. Sempre pensa duas vezes antes de marcar "always" pra ações destrutivas.
- Permissions são por máquina (ficam salvas no settings local). Se você troca de computador, configura tudo de novo.
- Em Plan Mode, o Claude propõe ações antes de executar — então o Plan Mode pode ser visto como uma camada EXTRA de segurança em cima de Permissions.
💬 Perguntas frequentes
"Onde configuro essas permissões?"
No arquivo ~/.claude/settings.json (global) ou .claude/settings.json dentro do projeto. Você lista as ferramentas e define a regra: allow, deny, ou ask.
"Posso deixar tudo liberado pra ele agir sozinho?"
Tecnicamente sim, mas não recomendo. Mesmo com Claude bem comportado, deixar permissions abertas pode causar acidentes (deletar pasta errada, sobrescrever arquivo importante). Configure só as ferramentas seguras como "always allow" e mantenha as destrutivas como "ask".
"O Claude pode burlar permissions?"
Não. Permissions são impostas pelo sistema — não pelo modelo. O Claude pede, você decide. Se você nega, ele simplesmente não consegue executar aquela ação, fim.
Plan Mode
🔧Como funciona de verdade
Por padrão, o Claude Code é "reativo" — você pede algo, ele já começa a executar (passo a passo, pedindo permissões quando precisa). Em tarefas pequenas, isso é ótimo.
Mas em tarefas grandes ou arriscadas, esse modo "ação imediata" pode causar problema: o Claude pode tomar uma direção que você não queria, e quando percebe, ele já mexeu em 30 arquivos.
O Plan Mode resolve isso. Quando ativado, o Claude:
- Analisa o que você pediu
- Pesquisa contexto (lê arquivos relevantes pra entender o estado atual)
- Te apresenta um plano completo em texto: "vou fazer 1, 2, 3, 4, 5..."
- Espera sua aprovação antes de mover qualquer coisa
Você pode aceitar, rejeitar, ou pedir ajustes no plano. Só depois de aprovar, ele executa.
Plan Mode geralmente é ativado com Shift+Tab — você toggle entre os modos durante uma sessão.
💡Por que existe
Pra dar visibilidade e controle em tarefas onde você não quer surpresa. Especialmente útil quando o resultado de uma ação afeta vários arquivos ou tem consequências difíceis de reverter.
🎪Exemplo prático
Você pede: "Refaz toda a estrutura de pastas do meu canal pra ficar mais organizada."
Sem Plan Mode: ele já começa a renomear pastas, mover arquivos, atualizar links — você só vê o estrago depois.
Com Plan Mode: ele te apresenta:
- "1. Renomear 'docs' para 'documentação'"
- "2. Criar subpastas: brand, video, planos"
- "3. Mover X.md de Y para Z..."
- "4. Atualizar links em 12 arquivos..."
Você lê, vê que ele errou em algum passo (ex: a pasta "documentação" deveria continuar "docs"), pede ajuste, e só depois libera execução.
Pegadinhas comuns
- Plan Mode NÃO substitui Permissions. Mesmo aprovando o plano, ainda pode aparecer pedidos de permissão durante a execução.
- Plan Mode gasta mais tokens — porque o Claude precisa pesquisar contexto e escrever o plano todo. Pra tarefas pequenas, é overkill.
- Use Plan Mode pra tarefas multi-arquivo, multi-passo, ou irreversíveis. Pra "edita esse título aqui", não precisa.
💬 Perguntas frequentes
"Como ativo o Plan Mode?"
Geralmente com Shift+Tab dentro do Claude Code — você "toggla" o modo. Pode também iniciar a sessão diretamente em Plan Mode com flag específica (verifica a doc da versão atual).
"Plan Mode é melhor que o modo normal?"
Não — é diferente. Plan Mode é melhor pra tarefas grandes ou arriscadas; modo normal é melhor pra trabalho rápido e iterativo. Use o certo pra cada situação.
"Posso editar o plano que ele propõe?"
Sim. Você responde pedindo ajustes ("muda o passo 3 pra X", "remove o passo 5", "adiciona Y antes do 4"), ele te apresenta o plano revisado, e o ciclo continua até você aprovar.
Checkpoints
🔧Como funciona de verdade
Conforme o Claude Code mexe em arquivos do seu projeto, ele vai salvando "fotos" (snapshots) do estado dos arquivos antes de mudanças significativas. Esses snapshots são os checkpoints.
Se em algum momento você não gostou do resultado de uma sequência de alterações, pode usar /rewind pra voltar pra um checkpoint anterior. Os arquivos retornam ao estado em que estavam naquele ponto.
Pensa como um "undo histórico" mas mais robusto que Ctrl+Z — em vez de desfazer 1 mudança, você volta pra um momento específico.
Funciona independente de git (você não precisa ter feito commit). Os checkpoints são gerenciados pelo próprio Claude Code.
💡Por que existe
Porque o Claude pode cometer erros em cascata — fazer 15 mudanças coordenadas, e você só perceber no fim que a direção tava errada. Sem checkpoints, você teria que desfazer cada mudança individualmente (ou git reset, se tinha commitado). Checkpoints simplificam o "voltar atrás".
🎪Exemplo prático
Você pede: "Refatora todos os roteiros pra incluir tags de SEO."
Claude mexe em 12 arquivos de roteiro. Você lê o resultado e percebe: as tags ficaram boas, mas ele alterou também o tom dos roteiros sem você pedir. Você não quer perder as tags, mas quer o tom de volta.
Comando: /rewind
Claude te mostra os checkpoints disponíveis. Você escolhe o checkpoint anterior à mudança. Os arquivos voltam pro estado original — sem tags, mas com tom correto. Aí você pede de novo, dessa vez sendo mais específico ("adiciona só tags, não mexe em mais nada").
Pegadinhas comuns
- Checkpoints não substituem git. São complementares. Pra histórico de longo prazo e colaboração, git ainda é o padrão.
- Checkpoints não acompanham forever — eles são limpos depois de um tempo ou quando atingem certo número. Pra estado importante, faz
git commit. - Voltar pra um checkpoint perde todas as mudanças posteriores. Não dá pra "voltar só esse arquivo" — é o snapshot inteiro.
💬 Perguntas frequentes
"Como uso checkpoints?"
Comando /rewind dentro do Claude Code. Ele lista os checkpoints disponíveis e você escolhe qual quer voltar. Confirma e os arquivos retornam pro estado daquele momento.
"Quando o Claude cria checkpoints?"
Automaticamente em pontos-chave — antes de operações que mexem em vários arquivos, ou periodicamente em sessões longas. Você não precisa pedir.
"E se eu der git commit no meio? Os checkpoints somem?"
Não. Checkpoints e git são sistemas independentes. Você pode ter ambos rodando em paralelo — checkpoints pra "undo rápido" durante a sessão, git pra histórico permanente.
⚡ Superpoderes
Skills
🔧Como funciona de verdade
Uma skill é um arquivo chamado SKILL.md com instruções estruturadas pro Claude. Quando você instala uma skill, o arquivo fica na sua pasta ~/.claude/skills/[nome-da-skill]/.
O conteúdo de uma skill geralmente inclui:
- Nome e descrição da habilidade
- Quando ativar (que tipo de tarefa ela resolve)
- Workflow passo a passo que o Claude deve seguir
- Templates, exemplos, referências que ajudam na execução
Quando você pede algo que combina com a descrição de uma skill, o Claude automaticamente carrega a skill no context e segue as instruções dela. Você também pode invocar manualmente com /nome-da-skill.
Skills são instaladas via Skills CLI: npx skills add owner/repo@nome. Existem milhares publicadas (muitas no skills.sh).
💡Por que existe
Pra especializar o Claude em tarefas específicas sem precisar repetir as mesmas instruções toda vez. Uma skill encapsula o "know-how" de fazer algo bem. Como ter especialistas instaláveis.
Outro motivo: compartilhamento. Uma pessoa cria uma skill ótima pra "escrever roteiro de YouTube"; outras pessoas instalam e usam. Vira um ecossistema.
🎪Exemplo prático
Você instala a skill frontend-slides. A partir daí, sempre que você pedir "cria slides em HTML pra apresentação X", o Claude automaticamente carrega essa skill e segue as instruções dela — gerando slides com viewport-fit, animações, presets de estilo prontos. Você não precisou explicar nada disso na hora.
Pegadinhas comuns
- Skill ≠ plugin. Skill é uma habilidade individual; plugin é um pacote de várias skills + outros recursos.
- Skills ocupam context quando ativadas. Não instala 200 skills achando que tudo fica disponível "de graça".
- Você mesmo pode criar skills — basta escrever um SKILL.md com a estrutura certa. Sem programar.
💬 Perguntas frequentes
"Como instalo uma skill?"
Comando npx skills add owner/repo@nome-da-skill no terminal. Exemplo: npx skills add affaan-m/everything-claude-code@frontend-slides.
"Onde encontro skills disponíveis?"
O catálogo principal é skills.sh. Tem busca, ranking por instalações, etc. Também dá pra buscar via CLI: npx skills find [palavra].
"Como crio minha própria skill?"
Cria uma pasta com SKILL.md dentro, escreve as instruções, e publica num repositório git (GitHub geralmente). Aí qualquer pessoa pode instalar via npx skills add. Não precisa programar — é tudo markdown.
Plugins
🔧Como funciona de verdade
Plugin é uma "caixa" que pode conter:
- Várias skills relacionadas
- Vários slash commands customizados
- Configurações de hooks, permissions, etc.
- Eventualmente: servidores MCP, agentes, templates
Você instala 1 plugin e ganha tudo isso de uma vez. É a forma de distribuir um "kit completo" pra um caso de uso específico.
Exemplo conceitual: um plugin "Marketing Toolkit" pode vir com skills de SEO, copy, análise de concorrente, gerador de pauta, comando /brief, hooks que rodam revisão ortográfica automática, etc. Tudo num único pacote.
💡Por que existe
Pra simplificar a distribuição de conjuntos integrados. Em vez do usuário ter que instalar 8 skills separadas e configurar 5 hooks na mão, ele instala um plugin e tá tudo configurado e funcionando junto.
🎪Exemplo prático
Você quer turbinar o Claude pra trabalho de marketing. Em vez de pesquisar e instalar 8 skills separadas, você instala um plugin único — tipo "creator-kit" — e já vem com: skill de roteiro YouTube, skill de thumb brief, skill de SEO, comando /pauta, hooks de revisão, configurações de tom, tudo conectado.
Pegadinhas comuns
- Plugins são uma feature mais nova. Nem todo "kit" no mercado é plugin formal — alguns são repositórios com várias skills que você instala separadamente.
- Como contém várias coisas, plugin pode "encher" sua configuração rápido. Vale revisar o que veio na instalação.
- Plugins podem ter dependências entre componentes — uma skill do plugin pode depender de um hook configurado pelo mesmo plugin.
💬 Perguntas frequentes
"Qual a diferença prática entre skill e plugin?"
Skill = uma habilidade. Plugin = um pacote de várias coisas, geralmente skills relacionadas + comandos + configs. Se skill é um app, plugin é uma "suíte" tipo Microsoft Office.
"Tem catálogo de plugins?"
O ecossistema de plugins ainda tá crescendo. A Anthropic tem alguns oficiais (claude.com/plugins/...), e a comunidade tá começando a criar os seus. Skills.sh inclui tanto skills individuais quanto plugins.
"Como sei se algo é skill ou plugin?"
Pelo nome do repositório e pela documentação. Geralmente fica claro: "Plugin: marketing toolkit (8 skills + 4 commands)" vs "Skill: gerador-titulos".
Hooks
🔧Como funciona de verdade
Hooks são configurados no settings.json do Claude Code. Você define:
- Qual evento dispara o hook (ex:
PostToolUse= depois de usar uma ferramenta,SessionStart= ao abrir o Claude Code,UserPromptSubmit= depois que você manda uma mensagem) - Qual comando ou script deve rodar quando o evento acontece
- Filtros opcionais (ex: rodar só se a ferramenta foi "Edit", ou só se o arquivo modificado for .md)
Quando o evento acontece, o Claude Code roda o comando configurado automaticamente, sem você pedir. O hook pode até modificar o comportamento do Claude — bloquear uma ação, adicionar contexto, validar input.
É a forma de injetar lógica programática no fluxo do Claude — automatizando tarefas repetitivas que aconteceriam toda vez de qualquer jeito.
💡Por que existe
Pra tornar o Claude proativo, não só reativo. Sem hooks, ele só faz o que você pede. Com hooks, ele faz coisas automaticamente em resposta a eventos — sem você precisar lembrar de pedir.
🎪Exemplo prático
Você configura um hook: "toda vez que o Claude editar um arquivo .md, rodar um linter de markdown automaticamente". Você nunca precisa lembrar — sempre que ele mexer num markdown, o linter roda sozinho, te avisa de erros, e o Claude pode até corrigir antes de continuar.
Outro exemplo: hook no SessionStart que carrega automaticamente o status do projeto no context — Claude começa cada sessão já sabendo "ah, tá no meio da Tarefa 3, vídeo #05 em produção, etc.".
Pegadinhas comuns
- Hooks são poderosos mas complexos. Mal configurados, podem deixar o Claude lento ou comportamento estranho.
- Como hooks rodam comandos do sistema, eles precisam permissões pra executar. Cuidado ao instalar plugins de terceiros que adicionam hooks — eles podem rodar qualquer coisa no seu computador.
- Hooks não substituem skills. Skill = "como fazer algo bem". Hook = "quando algo acontecer, faça X automático".
💬 Perguntas frequentes
"Como configuro um hook?"
Edita o settings.json do Claude Code (~/.claude/settings.json ou .claude/settings.json do projeto). Adiciona uma seção hooks definindo evento + comando + filtros. A documentação oficial tem exemplos de cada tipo de hook.
"Quais eventos disponíveis?"
Os principais: SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop, e mais. Cada um tem um momento específico no ciclo de vida da sessão.
"Hook pode bloquear o Claude de fazer algo?"
Sim. Hooks PreToolUse podem retornar um código de bloqueio — impedindo a ferramenta de rodar. Útil pra validações ("não permite rm -rf", "não permite mexer em arquivos sensíveis").
MCP
🔧Como funciona de verdade
MCP = Model Context Protocol. É um padrão aberto criado pela Anthropic (mas adotado por outras ferramentas também). Pensa assim: é o "padrão de tomada universal" que permite plugar qualquer aparelho.
Pra cada serviço externo que você quer integrar, existe (ou você cria) um MCP server — um pequeno programa que expõe as funcionalidades daquele serviço pro Claude. Por exemplo:
- MCP server do Google Drive → expõe ferramentas tipo "buscar arquivo", "ler conteúdo", "criar documento"
- MCP server do Notion → expõe "ler página", "atualizar bloco", "criar database"
- MCP server do Slack → expõe "ler mensagens", "postar em canal"
Você "conecta" um MCP server no Claude Code (configurando no settings), e a partir daí o Claude consegue usar aquelas ferramentas direto na conversa, sem você precisar copiar/colar dados.
Existem MCP servers oficiais (Anthropic e parceiros) e da comunidade. Você também pode criar o seu — geralmente em Python ou TypeScript.
💡Por que existe
Antes do MCP, conectar Claude a serviços externos era tudo manual — você exportava dados, colava na conversa, ou criava integrações customizadas pra cada caso. MCP padroniza isso. Cria uma "linguagem comum" pra ferramentas conversarem com modelos de IA.
Outro motivo: portabilidade. Um MCP server feito pro Claude também funciona pra outros agentes IA que adotam o mesmo protocolo (Cursor, etc.).
🎪Exemplo prático
Você gerencia o canal de um cliente no YouTube e precisa puxar métricas mensalmente. Sem MCP: você abre o YouTube Studio, exporta CSV, cola no Claude pra analisar, etc.
Com MCP: você instala o MCP server do YouTube (ou cria um). Configura no Claude Code. A partir daí, fala: "Pega as métricas do canal X dos últimos 30 dias e me dá uma análise." O Claude busca direto na API do YouTube via MCP, recebe os dados, analisa. Zero passo manual seu.
Pegadinhas comuns
- MCP não é mágico. Pra cada serviço, alguém precisa ter criado o MCP server. Servidores ainda estão sendo construídos pra muitos serviços (especialmente nichos).
- MCP servers geralmente precisam autenticação (token, credentials) — você configura uma vez no setup.
- Cada MCP server adiciona ferramentas no context, então tem custo de tokens. Não conecta 50 servers se vai usar só 2.
💬 Perguntas frequentes
"Como instalo um MCP server?"
Depende do server. Geralmente: instala o pacote (via npm/pip), pega as credenciais do serviço (API key etc.), e adiciona configuração no settings.json do Claude Code apontando pra o server. A doc de cada server tem o passo a passo.
"Qualquer serviço tem MCP server?"
Não — só quem foi construído. Existem dezenas oficiais (Anthropic, Stripe, GitHub, Notion, Slack, etc.) e centenas da comunidade. Pra serviços sem MCP, você pode criar o seu (mas exige programação).
"MCP é seguro? Tô dando acesso a dados sensíveis."
Sim, mas com responsabilidade. MCP server roda local (geralmente) e usa as credenciais que você configurou. Permissions ainda valem — antes de cada uso de ferramenta MCP, o Claude pede autorização (a menos que você libere "always"). Não instale MCP server de fonte desconhecida em sistemas que tem dados sensíveis.
🎯 Organização e Produtividade
Slash Commands
/nome que executam tarefas pré-configuradas — tanto built-in (já vêm prontos) quanto customizáveis (você cria os seus).🔧Como funciona de verdade
Slash commands são palavras precedidas por / que você digita no Claude Code pra disparar uma ação específica. Existem dois tipos:
- Built-in (já incluídos no Claude Code):
/compact,/clear,/help,/context,/rewind,/init, etc. - Customizados (você cria): qualquer coisa que você queira virar atalho. Configurados em arquivos no diretório
.claude/commands/do projeto (ou~/.claude/commands/global).
Pra criar um command customizado, você cria um arquivo nome-do-comando.md com instruções pro Claude. Quando você digita /nome-do-comando, ele lê o arquivo e executa o que tá lá.
Skills geralmente vêm com slash commands embutidos (ex: a skill frontend-slides pode ter /slides). Plugins frequentemente adicionam vários commands.
💡Por que existe
Pra encurtar tarefas repetitivas. Se você sempre pede a mesma coisa (com pequenas variações), em vez de digitar tudo de novo, cria um command. Vira atalho de produtividade.
🎪Exemplo prático
Você sempre quer gerar um roteiro com a mesma estrutura: hook, intro, 3 pontos principais, CTA. Em vez de explicar isso toda vez, você cria um arquivo .claude/commands/roteiro.md com:
"Quando invocado, gere um roteiro pra YouTube com a estrutura: 1. Hook de 10s, 2. Intro de 30s..., 3. Três pontos principais detalhados, 4. CTA pra inscrever. Use o tom didático e despojado do canal."
Agora basta digitar /roteiro [tema do vídeo] e ele já entrega no formato certo, sem precisar re-explicar.
Pegadinhas comuns
- Comandos case-sensitive em alguns sistemas.
/Roteiroe/roteiropodem ser diferentes — usa minúsculo por padrão. - Não confunde slash command com slash do bash (
/de pasta). Aqui é a primeira coisa da mensagem. - Built-in commands têm prioridade sobre customizados com o mesmo nome — não cria um
/helpcustomizado, vai conflitar.
💬 Perguntas frequentes
"Quais são os comandos built-in mais úteis?"
/compact (limpa context manualmente), /clear (zera a conversa), /help (lista comandos), /context (mostra uso de context), /rewind (volta pra checkpoint), /init (recarrega CLAUDE.md). Tem mais — usa /help pra ver todos.
"Como crio um comando customizado?"
Cria um arquivo nome-do-comando.md dentro de .claude/commands/ (no projeto) ou ~/.claude/commands/ (global). O conteúdo é simplesmente as instruções que você quer que o Claude execute quando você invocar.
"Posso passar argumentos pro comando?"
Sim. /comando argumento1 argumento2. Os argumentos viram parte do prompt que o Claude recebe e pode usar nas instruções.
Subagents
🔧Como funciona de verdade
O Claude principal (que você tá conversando) pode "chamar" subagents pra executar partes específicas de uma tarefa complexa. Cada subagent é uma instância separada do modelo, com:
- Seu próprio context (limpo, separado do principal — não polui a conversa principal)
- Sua própria especialidade (definida por instruções específicas)
- Acesso a ferramentas específicas (você pode dar ferramentas diferentes pra cada subagent)
- Tarefa específica (não fica lendo a conversa toda — só recebe a missão dele)
O Claude principal orquestra — define a tarefa, dispara os subagents, recebe os resultados, integra tudo. Você (usuário) só vê o resultado final.
Subagents podem rodar em paralelo — o Claude pode disparar 4 subagents ao mesmo tempo pra trabalhar em coisas diferentes simultaneamente.
São configurados via skills/plugins ou definidos diretamente no CLAUDE.md ou settings.
💡Por que existe
Por 3 motivos principais:
- Escala — tarefas grandes ficam mais rápidas com paralelismo
- Especialização — cada subagent é "expert" em uma coisa só, performa melhor que um generalista
- Limpeza de context — o context do Claude principal não fica entupido com detalhes das sub-tarefas; só recebe os resultados
🎪Exemplo prático
Você pede: "Cria uma landing page completa com headline, copy, 3 sessões, CTA e CSS responsivo."
Sem subagents: o Claude principal faz tudo sequencialmente, ocupa muito context, demora.
Com subagents: o Claude principal dispara em paralelo:
- Subagent 1 → escreve a headline (especialista em copy)
- Subagent 2 → escreve copy das 3 sessões (especialista em narrativa)
- Subagent 3 → cria o CSS (especialista em frontend)
- Subagent 4 → faz o CTA (especialista em conversão)
Todos rodam ao mesmo tempo. Em poucos segundos o Claude principal recebe os 4 outputs e integra tudo num arquivo final. Resultado: 3-4x mais rápido + cada parte feita por um "especialista".
Pegadinhas comuns
- Subagents gastam mais tokens (cada um é uma chamada ao modelo). Custo maior, mas geralmente vale pelo paralelismo.
- Subagents não compartilham context entre si. Se subagent 1 precisa do output do subagent 2, o principal precisa intermediar passando o resultado.
- Pra tarefas pequenas, subagents são overhead desnecessário. Use só pra trabalho real-multi-passo onde paralelismo ajuda.
💬 Perguntas frequentes
"Como invoco subagents?"
Geralmente o Claude decide automaticamente quando vale usar subagents — você não precisa pedir explicitamente. Mas pode pedir: "usa subagents pra fazer X em paralelo". Existem skills e configurações que controlam isso.
"Subagents podem chamar outros subagents?"
Em teoria sim (é recursivo), mas na prática geralmente é só 1 nível (principal → subs). Mais que isso costuma ser ineficiente.
"Onde configuro o que cada subagent faz?"
Via skills (uma skill pode definir subagents internos), via plugins, ou diretamente no CLAUDE.md/settings com instruções tipo "quando fizer X, dispare subagents Y e Z". Skills tipo subagent-driven-development são exemplos prontos de uso.
Sobre o Junhão
Sou YouTube Manager há 3+ anos, com trajetória em marketing digital, design e estratégia. Não sou programador — e exatamente por isso criei o canal "Não Codei": pra mostrar pra outros profissionais de marketing como usar o Claude Code pra ficar 10x mais produtivo, sem precisar escrever uma linha de código. Se esse guia te ajudou, considera se inscrever no canal — a comunidade tá começando agora.