SpyBara
Go Premium

features-overview.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 79 additions and 83 deletions.

2026
Wed 9 22:58 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58

Estender Claude Code

Entenda quando usar CLAUDE.md, Skills, subagents, hooks, MCP e plugins.

Claude Code combina um modelo que raciocina sobre seu código com ferramentas integradas para operações de arquivo, busca, execução e acesso à web. As ferramentas integradas cobrem a maioria das tarefas de codificação. Este guia cobre a camada de extensão: recursos que você adiciona para personalizar o que Claude sabe, conectá-lo a serviços externos e automatizar fluxos de trabalho.

Novo no Claude Code? Comece com CLAUDE.md para convenções de projeto, depois adicione outras extensões conforme gatilhos específicos surgirem.

Visão geral

As extensões se conectam a diferentes partes do loop agentic:

  • CLAUDE.md adiciona contexto persistente que Claude vê a cada sessão
  • Skills adicionam conhecimento reutilizável e fluxos de trabalho invocáveis
  • Code intelligence conecta Claude a um language server para navegação em nível de símbolo e erros de tipo em tempo real
  • MCP conecta Claude a serviços e ferramentas externas
  • Subagents executam seus próprios loops em contexto isolado, retornando resumos
  • Dynamic workflows executam muitos subagents a partir de um script que Claude escreve, retornando um resultado
  • Cross-session messaging permite que Claude passe uma mensagem de uma de suas sessões para outra
  • Hooks executam seu script, solicitação HTTP, chamada de ferramenta MCP, prompt ou subagent quando Claude Code atinge um evento de ciclo de vida
  • Plugins e marketplaces empacotam e distribuem esses recursos

Skills são a extensão mais flexível. Uma skill é um arquivo markdown contendo conhecimento, fluxos de trabalho ou instruções. Você pode invocar skills com um comando como /deploy, ou Claude pode carregá-las automaticamente quando relevante. Skills podem ser executadas em sua conversa atual ou em contexto isolado via subagents.

Corresponder recursos ao seu objetivo

Os recursos variam de contexto sempre ativo que Claude vê a cada sessão, a capacidades sob demanda que você ou Claude podem invocar, a automação em segundo plano que é executada em eventos específicos. A tabela abaixo mostra o que está disponível e quando cada um faz sentido.

Recurso O que faz Quando usar Exemplo
CLAUDE.md Contexto persistente carregado a cada conversa Convenções de projeto, regras "sempre faça X" "Use pnpm, não npm. Execute testes antes de fazer commit."
Skill Instruções, conhecimento e fluxos de trabalho que Claude pode usar Conteúdo reutilizável, documentos de referência, tarefas repetíveis /deploy executa sua lista de verificação de implantação; skill de documentação de API com padrões de endpoint
Subagent Contexto de execução isolado que retorna resultados resumidos Isolamento de contexto, tarefas paralelas, trabalhadores especializados Tarefa de pesquisa que lê muitos arquivos mas retorna apenas descobertas principais
Dynamic workflow Script que Claude escreve que executa muitos subagents em segundo plano Trabalho que cresce além de um punhado de subagents, ou descobertas que você quer verificadas Auditar uma base de código inteira, com um segundo conjunto de agentes verificando cada descoberta
Cross-session messaging Claude entrega uma mensagem de uma de suas sessões para outra Sessões que você executa por conta própria que precisam das descobertas uma da outra no meio da tarefa Uma sessão avisa outra que uma mudança que fez quebra o que a outra está construindo
Code intelligence Navegação e diagnósticos do language server Linguagens tipadas, grandes bases de código onde grep é lento ou impreciso Ir para a definição de um símbolo em vez de ler o arquivo inteiro
MCP Conectar a serviços externos Dados ou ações externas Consultar seu banco de dados, postar no Slack, controlar um navegador
Hook Script, solicitação HTTP, chamada de ferramenta MCP, prompt ou subagent disparado por eventos Automação que deve ser executada em cada evento correspondente Executar ESLint após cada edição de arquivo
Artifact Publicar saída de sessão como uma página web privada e interativa Saída que você quer ver ou compartilhar visualmente em vez de como texto de terminal Uma linha do tempo de incidente que se atualiza conforme Claude investiga

Plugins são a camada de empacotamento. Um plugin agrupa skills, hooks, subagents e servidores MCP em uma única unidade instalável. Skills de plugin são nomeadas (como /my-plugin:review) para que múltiplos plugins possam coexistir. Use plugins quando quiser reutilizar a mesma configuração em múltiplos repositórios ou distribuir para outros via um marketplace.

Construir sua configuração ao longo do tempo

Você não precisa configurar tudo antecipadamente. Cada recurso tem um gatilho reconhecível, e a maioria das equipes os adiciona aproximadamente nesta ordem:

Gatilho Adicionar
Claude erra uma convenção ou comando duas vezes Adicione a CLAUDE.md
Você continua digitando o mesmo prompt para iniciar uma tarefa Salve como uma skill invocável pelo usuário
Você cola o mesmo playbook ou procedimento de múltiplas etapas no chat pela terceira vez Capture como uma skill
Você continua copiando dados de uma aba do navegador que Claude não consegue ver Conecte esse sistema como um servidor MCP
Claude lê muitos arquivos para encontrar onde um símbolo é definido ou usado Instale um plugin de code intelligence para sua linguagem
Uma tarefa secundária inunda sua conversa com saída que você não consultará novamente Encaminhe através de um subagent
Você quer que algo aconteça toda vez sem pedir Escreva um hook
Um segundo repositório precisa da mesma configuração Empacote como um plugin

Os mesmos gatilhos dizem quando atualizar o que você já tem. Um erro repetido ou um comentário de revisão recorrente é uma edição de CLAUDE.md, não uma correção única no chat. Um fluxo de trabalho que você continua ajustando manualmente é uma skill que precisa de outra revisão.

Comparar recursos similares

Alguns recursos podem parecer similares. Para uma análise mais profunda sobre como escolher entre eles, consulte Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents no blog. Aqui está como diferenciá-los.

Skills e subagents resolvem problemas diferentes:

  • Skills são conteúdo reutilizável que você pode carregar em qualquer contexto
  • Subagents são trabalhadores isolados que são executados separadamente de sua conversa principal
Aspecto Skill Subagent
O que é Instruções, conhecimento ou fluxos de trabalho reutilizáveis Trabalhador isolado com seu próprio contexto
Benefício principal Compartilhar conteúdo entre contextos Isolamento de contexto. O trabalho acontece separadamente, apenas o resumo retorna
Impacto da janela de contexto Adiciona à sua janela principal Usa uma janela separada com seus próprios tokens de entrada e saída
Melhor para Material de referência, fluxos de trabalho invocáveis Tarefas que leem muitos arquivos, trabalho paralelo, trabalhadores especializados

Skills podem ser referência ou ação. Skills de referência fornecem conhecimento que Claude usa ao longo de sua sessão (como seu guia de estilo de API). Skills de ação dizem a Claude para fazer algo específico (como /deploy que executa seu fluxo de trabalho de implantação).

Use um subagent quando você precisar de isolamento de contexto ou quando sua janela de contexto estiver ficando cheia. O subagent pode ler dezenas de arquivos ou executar buscas extensas, mas sua conversa principal recebe apenas um resumo. Como o trabalho do subagent não consome seu contexto principal, isso também é útil quando você não precisa que o trabalho intermediário permaneça visível. Subagents personalizados podem ter suas próprias instruções e podem pré-carregar skills.

Eles podem se combinar. Um subagent pode pré-carregar skills específicas (campo skills:). Uma skill pode ser executada em contexto isolado usando context: fork. Consulte Skills para detalhes.

Entender como os recursos se sobrepõem

Os recursos podem ser definidos em múltiplos níveis: em toda a máquina, por projeto, via plugins ou através de políticas gerenciadas. Você também pode aninhar arquivos CLAUDE.md em subdiretórios ou colocar skills em pacotes específicos de um monorepo. Quando o mesmo recurso existe em múltiplos níveis, aqui está como eles se sobrepõem:

  • Arquivos CLAUDE.md são aditivos: todos os níveis contribuem conteúdo ao contexto de Claude simultaneamente. Arquivos do seu diretório de trabalho e acima carregam no lançamento; subdiretórios carregam conforme você trabalha neles. Quando as instruções entram em conflito, Claude usa julgamento para reconciliá-las, com instruções mais específicas tipicamente tendo precedência. Consulte como arquivos CLAUDE.md carregam.
  • Skills e subagents substituem por nome: quando o mesmo nome existe em múltiplos níveis, uma definição vence com base na prioridade (gerenciado > usuário > projeto para skills; gerenciado > sinalizador CLI > projeto > usuário > plugin para subagents). Skills de plugin são nomeadas para evitar conflitos. Consulte descoberta de skill e escopo de subagent.
  • Servidores MCP substituem por nome: local > projeto > usuário. Consulte escopo MCP.
  • Hooks se mesclam: todos os hooks registrados disparam para seus eventos correspondentes independentemente da fonte. Consulte hooks.

Combinar recursos

Cada extensão resolve um problema diferente: CLAUDE.md lida com contexto sempre ativo, skills lidam com conhecimento sob demanda e fluxos de trabalho, MCP lida com conexões externas, subagents lidam com isolamento e hooks lidam com automação. Configurações reais combinam eles com base em seu fluxo de trabalho.

Por exemplo, você pode usar CLAUDE.md para convenções de projeto, uma skill para seu fluxo de trabalho de implantação, MCP para conectar ao seu banco de dados e um hook para executar linting após cada edição. Cada recurso lida com o que é melhor.

Padrão Como funciona Exemplo
Skill + MCP MCP fornece a conexão; uma skill ensina a Claude como usá-la bem MCP conecta ao seu banco de dados, uma skill documenta seu esquema e padrões de consulta
Skill + Subagent Uma skill gera subagents para trabalho paralelo Skill /audit inicia subagents de segurança, desempenho e estilo que trabalham em contexto isolado
CLAUDE.md + Skills CLAUDE.md contém regras sempre ativas; skills contêm material de referência carregado sob demanda CLAUDE.md diz "siga nossas convenções de API," uma skill contém o guia de estilo de API completo
Hook + MCP Um hook dispara ações externas através de MCP Hook pós-edição envia uma notificação Slack quando Claude modifica arquivos críticos

Entender custos de contexto

Cada recurso que você adiciona consome algum contexto de Claude. Muito pode preencher sua janela de contexto, mas também pode adicionar ruído que torna Claude menos eficaz; skills podem não disparar corretamente, ou Claude pode perder o controle de suas convenções. Entender esses trade-offs ajuda você a construir uma configuração eficaz. Para uma visualização interativa de como esses recursos se combinam em uma sessão em execução, consulte Explorar a janela de contexto.

Custo de contexto por recurso

Cada recurso tem uma estratégia de carregamento e custo de contexto diferentes:

Recurso Quando carrega O que carrega Custo de contexto
CLAUDE.md Início da sessão Conteúdo completo A cada requisição
Skills Início da sessão + quando usado Descrições no início, conteúdo completo quando usado Baixo (descrições a cada requisição)*
Servidores MCP Início da sessão Nomes de ferramentas; esquemas completos sob demanda Baixo até uma ferramenta ser usada
Code intelligence Após edições de arquivo e sob demanda Diagnósticos após edições; localizações de símbolos sob consulta Baixo; reduz leituras de arquivo em outro lugar
Subagents Quando gerado Contexto fresco com skills especificadas, ou a conversa pai para um fork Isolado da sessão principal
Hooks No disparo Nada (executa externamente) Zero, a menos que hook retorne contexto adicional

*Por padrão, descrições de skill carregam no início da sessão para que Claude possa decidir quando usá-las. Defina disable-model-invocation: true no frontmatter de uma skill para ocultá-la de Claude inteiramente até que você a invoque manualmente. Para uma skill que você não escreveu, defina skillOverrides em configurações para fazer o mesmo sem editar seu arquivo.

Entender como os recursos carregam

Cada recurso carrega em diferentes pontos em sua sessão. As abas abaixo explicam quando cada um carrega e o que entra em contexto.

Carregamento de contexto: CLAUDE.md carrega no início da sessão e permanece em cada requisição. Nomes de ferramentas MCP carregam no início com esquemas completos adiados até o uso. Skills carregam descrições no início, conteúdo completo na invocação. Subagents obtêm contexto isolado. Hooks são executados externamente. Carregamento de contexto: CLAUDE.md carrega no início da sessão e permanece em cada requisição. Nomes de ferramentas MCP carregam no início com esquemas completos adiados até o uso. Skills carregam descrições no início, conteúdo completo na invocação. Subagents obtêm contexto isolado. Hooks são executados externamente.

Quando: Início da sessão

O que carrega: Conteúdo completo de todos os arquivos CLAUDE.md (níveis gerenciado, usuário e projeto).

Herança: Claude lê arquivos CLAUDE.md do seu diretório de trabalho até a raiz e descobre aninhados em subdiretórios conforme acessa esses arquivos. Consulte Como arquivos CLAUDE.md carregam para detalhes.

Saiba mais

Cada recurso tem seu próprio guia com instruções de configuração, exemplos e opções de configuração.

file-lines CLAUDE.md

Armazenar contexto de projeto, convenções e instruções
brain Skills

Dar a Claude expertise de domínio e fluxos de trabalho reutilizáveis
users Subagents

Descarregar trabalho para contexto isolado
network Dynamic workflows

Executar muitos subagents a partir de um script
terminal Cross-session messaging

Permitir que Claude envie mensagens para suas outras sessões
plug MCP

Conectar Claude a serviços externos
bolt Hooks

Automatizar ações com hooks
puzzle-piece Plugins

Empacotar e compartilhar conjuntos de recursos
store Marketplaces

Hospedar e distribuir coleções de plugins