Para saber como o loop agentic principal funciona, consulte Como Claude Code funciona.
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
- MCP conecta Claude a serviços e ferramentas externas
- Subagents executam seus próprios loops em contexto isolado, retornando resumos
- Agent teams coordenam múltiplas sessões independentes com tarefas compartilhadas e mensagens ponto a ponto
- Hooks executam fora do loop inteiramente como scripts determinísticos
- Plugins e marketplaces empacotam e distribuem esses recursos
/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 |
| Agent teams | Coordenar múltiplas sessões independentes do Claude Code | Pesquisa paralela, desenvolvimento de novos recursos, depuração com hipóteses concorrentes | Gerar revisores para verificar segurança, desempenho e testes simultaneamente |
| MCP | Conectar a serviços externos | Dados ou ações externas | Consultar seu banco de dados, postar no Slack, controlar um navegador |
| Hook | Script determinístico que é executado em eventos | Automação previsível, sem envolvimento de LLM | Executar ESLint após cada edição de arquivo |
/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.
Comparar recursos similares
Alguns recursos podem parecer similares. Aqui está como diferenciá-los.- Skill vs Subagent
- CLAUDE.md vs Skill
- CLAUDE.md vs Rules vs Skills
- Subagent vs Agent team
- MCP vs Skill
Skills e subagents resolvem problemas diferentes:
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
- 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 |
| Melhor para | Material de referência, fluxos de trabalho invocáveis | Tarefas que leem muitos arquivos, trabalho paralelo, trabalhadores especializados |
/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.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 | Todas as definições de ferramentas e esquemas | A cada requisição |
| Subagents | Quando gerado | Contexto fresco com skills especificadas | Isolado da sessão principal |
| Hooks | No disparo | Nada (executa externamente) | Zero, a menos que hook retorne contexto adicional |
disable-model-invocation: true no frontmatter de uma skill para ocultá-la de Claude inteiramente até que você a invoque manualmente. Isso reduz o custo de contexto para zero para skills que você só dispara você mesmo.
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.
- CLAUDE.md
- Skills
- Servidores MCP
- Subagents
- Hooks
Quando: Início da sessãoO 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.CLAUDE.md
Armazenar contexto de projeto, convenções e instruções
Skills
Dar a Claude expertise de domínio e fluxos de trabalho reutilizáveis
Subagents
Descarregar trabalho para contexto isolado
Agent teams
Coordenar múltiplas sessões trabalhando em paralelo
MCP
Conectar Claude a serviços externos
Hooks
Automatizar fluxos de trabalho com hooks
Plugins
Empacotar e compartilhar conjuntos de recursos
Marketplaces
Hospedar e distribuir coleções de plugins