# Claude Code lento: como escolher Skills, subagentes, MCP e plugins > Skills, subagentes, MCP e plugins no Claude Code: diferenças, consumo de contexto, sete erros comuns e uma configuração mínima com exemplos técnicos. Source: https://ailoot.ai/blog/pt-pt/claude-code-skills-subagents-mcp-plugins/ Canonical: https://ailoot.ai/blog/pt-pt/claude-code-skills-subagents-mcp-plugins/ Language: pt-PT Publisher: Ailoot (https://ailoot.ai/) Translation: guide-038 Revision: sha256-27fc2a2e913a684a8dd21fc76dc7d68a4c61113709479a0a250ee6c937e9caf0
Ideia principal Uma skill é uma instrução recorrente carregada por um acionador (~100 tokens enquanto está inativa). Um subagente é um contexto isolado de 200K, com as suas próprias permissões. O MCP liga-se a dados e APIs externos. Um plugin é um pacote pronto a usar dos três primeiros. A fórmula principal para 2026: um subagente Haiku + uma skill pré-carregada para convenções + um MCP de âmbito restrito para dados em tempo real. Tudo o resto ou alucina ou enche demasiado o contexto.
As instruções práticas para trabalhar com o Ailoot estão na [documentação](https://ailoot.ai/docs/).
## Porque é que «Encher o Claude Code» se tornou o maior problema em 2026?
Ideia principal Em junho de 2026, o Claude Code tem quatro mecanismos de extensão: skill, subagent, MCP e plugin. O registo oficial tem 101 plugins; os catálogos da comunidade têm milhares. A tentação de instalar tudo faz com que o Claude fique mais lento, confunda funções semelhantes e consuma os limites em cada mensagem. A principal pergunta do público é: que mecanismo deve ser usado para cada tarefa, sem transformar o agente num ferro-velho?
Nem sequer a documentação oficial tinha uma resposta abrangente já preparada para «quando se deve escolher cada opção?». A experiência de um mês descrita neste artigo inclui os quatro mecanismos em projetos funcionais: um conjunto de subagentes para uma tarefa complexa, um pequeno grupo de skills para procedimentos recorrentes, alguns servidores MCP para dados em tempo real e uma seleção de alguns entre cerca de duas dezenas de plugins. Este guia reúne o exemplo numa matriz de seleção com uma árvore de decisão pronta a usar, citações da Anthropic e sete antipadrões que tornam o Claude inutilizável. ## Em que difere uma skill de um subagente, do MCP e de um plugin? Uma tabela
Ideia principal Os quatro mecanismos são quatro camadas de uma arquitetura. Uma skill ensina um procedimento ao Claude. Um subagente isola uma tarefa num contexto separado. O MCP liga dados externos. Um plugin reúne os três primeiros num pacote. Cada mecanismo tem a sua própria classe de tarefas, utilização de tokens e risco de sobrecarregar o contexto. Só entram em conflito quando se escolhe a camada errada.
Matriz de seleção: | Propriedade | Skill | Subagent | Servidor MCP | Plugin | |----|----|----|----|----| | Contexto isolado | Não | **Sim** (200K novo) | Não | Através dos seus próprios subagentes | | Dados e APIs externos | Não | Apenas através do MCP atribuído | **Sim** | Através dos seus próprios servidores MCP | | Poupança de tokens | 70–90% (divulgação progressiva) | Até 70% em tarefas complexas | Depende da pesquisa de ferramentas | Depende do conteúdo do pacote | | Restrições das ferramentas | Através de `allowed-tools` | Estritamente no frontmatter | Através do subagente ou de políticas | Parte do pacote | | Escolher um modelo mais barato | Através do campo `model` | **Sim**, no frontmatter | N/A | Através dos seus próprios subagentes | | Rapidez de configuração | Minutos | Minutos | Horas a dias | 1 clique no marketplace | | Principal caso de utilização | Listas de verificação, convenções, estilo | Tarefa delegada com resultados ruidosos | Base de dados, API, dados em tempo real | Fluxo de trabalho da comunidade pronto a usar | | Principal armadilha | SKILL.md demasiado extenso \> 500 linhas | Subagente com permissões ao nível do agente principal | Mais de 3 servidores MCP | Pacote com conteúdo não consultado | Uma analogia simples para um empresário: imagine-se como CEO de uma empresa com dez pessoas: - **CLAUDE.md** — o estatuto da empresa. Está sempre afixado na parede; todos o leem; ninguém discute. - **Skill** — um procedimento interno. «Como fazemos revisões», «como escrevemos notas de lançamento», «como aceitamos pagamentos». - **Subagent** — um especialista com um gabinete separado e uma lista restrita de permissões. Dê-lhe as chaves de tudo e terá um segundo CEO, não um funcionário. - **Servidor MCP** — os sistemas da empresa: CRM, banco, armazém. Isto não é conhecimento; é uma ligação. - **Plugin** — uma solução pronta a usar, comprada numa loja. Um pacote de procedimentos, especialistas e integrações, tudo na mesma caixa. Quando perceber que são quatro camadas de um sistema, em vez de quatro concorrentes, a pergunta «qual é melhor?» desaparece. A pergunta que fica é «o que vai para onde?» ## O que é uma skill no Claude Code e quando deve instalar uma?
Ideia principal Uma skill é uma pasta que contém um ficheiro `SKILL.md` (frontmatter YAML + instruções em Markdown) dentro de `~/.claude/skills//` ou de `.claude/skills//` num projeto. Funciona através da divulgação progressiva: no arranque, só são carregados o nome e a descrição (~100 tokens); o corpo completo só é obtido quando uma tarefa corresponde ao acionador. É o mecanismo mais barato dos quatro enquanto está inativo.
Definição oficial da Anthropic:

As skills são recursos de ficheiros reutilizáveis que dão ao Claude conhecimento especializado de um domínio: fluxos de trabalho, contexto e boas práticas que transformam um agente de finalidade geral num especialista.

— Anthropic Docs, https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
Uma skill tem três níveis: 1. **Metadados.** São sempre carregados no arranque da sessão: o nome e a descrição do frontmatter. Uma skill utiliza cerca de 100 tokens no arranque. 2. **Instruções.** São carregadas apenas quando o Claude deteta um pedido que as aciona. Até 5,000 tokens — o corpo do SKILL.md. 3. **Recursos.** São carregados apenas quando as instruções o pedem explicitamente. Ficheiros incluídos no pacote, scripts em `scripts/`, materiais de referência em `references/`. Os scripts são executados através de `bash`; o próprio código não entra no contexto. A Anthropic chama a este princípio divulgação progressiva:

A divulgação progressiva é um princípio de conceção fundamental que torna as Agent Skills flexíveis e escaláveis.

— Anthropic Engineering, https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
E, no mesmo artigo, uma metáfora que explica a ideia melhor do que qualquer outra:

Criar uma skill para um agente é como escrever um guia de integração para um novo funcionário.

— Anthropic Engineering, https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
**Quando usar uma skill:** - Um procedimento padrão que repete vezes sem conta: revisões de PR, notas de lançamento, revisão de código de acordo com o seu guia de estilo. - Quando uma secção de `CLAUDE.md` deixa de ser um facto e passa a ser um procedimento, começa a crescer e interfere com tudo o resto. - Quando quer que a mesma instrução seja seguida de forma consistente em projetos diferentes. Uma fórmula prática: **se fizer algo mais do que algumas vezes, passe essa tarefa para o sistema**. Da primeira vez, use um prompt manual. Da segunda, é um potencial candidato a skill. **Quando NÃO usar uma skill:** - Se a tarefa exigir **dados em tempo real** (base de dados, API, pesquisa, dados atuais da bolsa). Isso é MCP, não uma skill. Uma skill que tente «obter o preço atual» vai alucinar. - Se a tarefa exigir **contexto isolado**. Isso é um subagente. - Se precisar de uma **verificação imposta** («bloquear um commit que contenha .env»), use um hook no percurso de commit abrangido, em vez de depender de uma skill. Reveja e teste a cobertura real: um hook não restringe todas as formas de ler, copiar ou publicar o ficheiro. Limites a conhecer de antemão: - Nome da skill: até 64 caracteres, apenas letras minúsculas, algarismos e hífenes. As palavras `anthropic` e `claude` estão reservadas. - Descrição: até 1,024 caracteres. A combinação de `description` + `when_to_use` é truncada aos 1,536 caracteres na lista. - Corpo do SKILL.md: recomenda-se um máximo de 500 linhas. Passe o que exceder para `references/` e `scripts/`. - Durante a compactação automática do contexto (compactação automática), os primeiros 5,000 tokens de cada skill ativa são anexados novamente. O orçamento total para todas as skills é de 25,000. ## O que é um subagente e porque existem 5 níveis de aninhamento?
Ideia principal Um subagente é um Claude filho com o seu próprio contexto de 200K tokens, prompt de sistema, lista restrita de ferramentas e permissões independentes. O seu principal objetivo é o isolamento: pesquisas ruidosas, registos extensos e trabalho exploratório ficam dentro do subagente, enquanto só o resumo final regressa ao contexto principal. Desde 10 de junho de 2026, os subagentes podem aninhar-se até 5 níveis de recursão.
Da documentação oficial:

Os subagentes são assistentes de IA especializados que tratam de classes específicas de tarefas. Use um quando uma tarefa secundária puder encher a conversa principal com resultados de pesquisa, registos ou conteúdos de ficheiros que não irá consultar. O subagente executa este trabalho no seu próprio contexto e devolve apenas um resumo.

— Claude Code Docs, https://code.claude.com/docs/en/sub-agents
O Claude Code tem três subagentes integrados que já utiliza sem saber: | Subagente | Modelo | Acesso | Onde trabalha | |----|----|----|----| | **Explore** | Haiku | Só de leitura | Pesquisa de código; poupa contexto ao ignorar o CLAUDE.md e o estado do git | | **Plan** | Haiku | Só de leitura | Modo de planeamento — pensa antes de escrever código | | **General-purpose** | Sonnet/Opus | Todas as ferramentas | Tarefas complexas com várias etapas | Em 10 de junho de 2026, a Anthropic lançou o Claude Code v2.1.172 e removeu uma restrição que existia desde o lançamento dos subagentes: os agentes filhos podem agora criar os seus próprios subagentes até 5 níveis de profundidade. O número 5 é um limite máximo de segurança, não um objetivo de otimização. Uma explicação detalhada das funcionalidades, com modelos YAML para orquestradores, está no [guia sobre subagentes aninhados](https://ailoot.ai/blog/pt-pt/claude-code-nested-subagents/). **Quando usar um subagente:** - Uma passagem exploratória pelo código ou pelos registos, após a qual só precisa de uma conclusão breve. - Tarefas em paralelo que podem correr lado a lado. - Delegação por especialização: backend / frontend / testes / revisão — cada um trata de uma funcionalidade. - Controlo de custos: um subagente Haiku em vez de Sonnet ou Opus. Isto reduz a fatura 5–7 vezes. **Quando NÃO usar um subagente:** - Uma tarefa trivial feita uma única vez ou uma chamada simples a uma ferramenta. Um subagente tem um custo de arranque. - Quando as tarefas precisam de partilhar estado. Os subagentes não conseguem ver o contexto uns dos outros; o trabalho relacionado deve ficar na conversa principal. O principal antipadrão: Dar Opus e todas as ferramentas a um subagente só faz dele outra sessão principal. Se a lista de ferramentas corresponder à do agente principal, o subagente não está devidamente restringido. Por outras palavras, um subagente com as mesmas permissões do agente principal é apenas um segundo CEO. Sem utilidade e dispendioso. ## O que é um servidor MCP e quando deve ligá-lo ao Claude Code?
Ideia principal MCP (Model Context Protocol) é uma norma aberta da Anthropic para ligar a IA a sistemas externos: bases de dados, APIs, sistemas de ficheiros e SaaS. Em junho de 2026, Claude, ChatGPT, Cursor, VS Code e dezenas de outros clientes suportam-no. O site modelcontextprotocol.io propõe uma metáfora útil: o MCP é uma porta USB-C para aplicações de IA.
A definição oficial:

Pense no MCP como uma porta USB-C para aplicações de IA. Tal como o USB-C padronizou a forma de ligar dispositivos eletrónicos, o MCP oferece uma forma normalizada de ligar aplicações de IA a sistemas externos.

— modelcontextprotocol.io, https://modelcontextprotocol.io/introduction
O que o MCP permite realmente fazer na prática: - Ligar o Claude ao Google Calendar e ao Notion para obter um assistente pessoal. - Ligar ao Figma para que o Claude gere um projeto web pronto a usar a partir de um design. - Ligar um chatbot empresarial a várias bases de dados ao mesmo tempo. - Ligar ao Blender e a uma impressora 3D para criar modelos e imprimi-los de imediato. Os servidores MCP mais conhecidos que as pessoas instalam primeiro: | Servidor MCP | O que liga | Onde o obter | |----|----|----| | **Context7** | Documentação atualizada para qualquer biblioteca | Plugin de claude-plugins-official | | **GitHub** | Issues, PRs, repositórios | claude-plugins-official | | **Filesystem** | Ficheiros em pastas autorizadas (no Claude Code, apenas as pastas de trabalho) | O servidor de referência do projeto MCP, repositório modelcontextprotocol/servers | | **Postgres** | Acesso direto à base de dados | O servidor de referência foi descontinuado; o substituto ativo é o DBHub da Bytebase | | **Magic MCP by 21st.dev** | Animações e componentes de interface | Catálogo MCP | | **Slack / Linear / Jira / Notion** | Integrações de trabalho | claude-plugins-official | As ligações e os comandos de instalação estão reunidos no catálogo MCP. **Quando usar MCP:** - Qualquer ligação a dados ou ações externas: «obter linhas da base de dados», «ler tickets do Jira», «publicar no Slack». - Quando o mesmo serviço é necessário em vários projetos ou agentes, é mais fácil manter um único servidor centralizado. **Quando NÃO usar MCP:** - Conhecimento estático ou um procedimento. Isso é uma skill, não MCP. «Instruções sobre como fazer uma revisão de código» é uma skill. «Ler o PR mais recente do GitHub e revê-lo» é MCP. - Um comando CLI usado uma única vez. É mais simples usar `Bash` do que configurar um servidor. - Quando quiser criar MCP «só para ter uma arquitetura correta». Isso é estética, não uma tarefa. A principal armadilha do MCP é uma das maiores fontes, em 2026, das queixas de que «o Claude Code está estúpido»: Quando instala todos estes MCP de uma só vez, acaba por sufocar a janela de contexto do LLM: todas as ferramentas disponíveis são carregadas para o contexto. Uma regra prática: mantenha no máximo 2–3 servidores MCP ativos, orientados para tarefas específicas. Na experiência descrita com muitos servidores, o arranque era mais lento e os erros ocorriam com maior frequência. A **pesquisa de ferramentas MCP** foi adicionada no Claude Code v2.1.x: as ferramentas deixaram de ser carregadas de forma gananciosa para o contexto e passaram a ser indexadas e obtidas a pedido. Isto reduz o custo de «muitos MCP num projeto», mas não o elimina por completo. ## Em que difere um plugin de uma skill e porque se esbateu a fronteira?
Ideia principal Um plugin é um pacote de componentes. Pode conter uma skill, um subagente, um servidor MCP e um hook, em qualquer combinação. A Anthropic reuniu tudo num único formato para que possa ser instalado com um só comando `/plugin install` e atualizado automaticamente. O marketplace `claude-plugins-official` foi lançado em fevereiro de 2026; em junho já tinha 101 plugins. A fronteira entre «uma skill autónoma» e «um plugin composto por uma skill» diz respeito apenas ao empacotamento.
A formulação oficial:

Os plugins ampliam o Claude Code com skills, agentes, hooks e servidores MCP. Os marketplaces de plugins são catálogos que ajudam a encontrar e instalar estas extensões sem ter de as reunir manualmente. Imagine que se liga a uma loja de aplicações: depois de adicionar uma loja, tem acesso a uma coleção, mas cabe-lhe decidir que aplicações descarregar.

— Claude Code Docs, https://code.claude.com/docs/en/discover-plugins
Os mais instalados em junho de 2026: | Posição | Plugin | Instalações | Conteúdo | |----|----|----|----| | 1 | **Frontend Design** (Anthropic) | 829 316 | Skills + subagentes para design | | 2 | **Context7** (Upstash) | 348 660 | Wrapper MCP para documentação | | 3 | **Code Review** (Anthropic) | 347 221 | 5 subagentes paralelos para revisões | | 4 | **Code Simplifier** | 284 632 | Skill + hook para simplificação | | 5 | **TypeScript LSP** | 177 136 | Plugin LSP | | 6 | **Pyright LSP** | 91 225 | Plugin LSP | A análise completa da seleção está no guia dos 10 melhores plugins entre 101. **Quando usar um plugin:** - Um pacote comunitário pronto a usar que cobre grande parte de um fluxo de trabalho, como design ou revisão. - Se não quiser montar manualmente uma configuração de «skill + subagente + MCP + hook», pode usar uma já pronta. - Distribuição empresarial: um administrador cria um marketplace de equipa e os programadores instalam tudo a partir de um prefixo único. **Quando NÃO usar um plugin:** - A tarefa resolve-se com uma skill, mas o pacote traz mais cinco MCP «por precaução». Isso é pura desorganização do contexto. - Um plugin de código fechado sem auditoria. É executado com as suas permissões — leia o conteúdo antes de o instalar. - Já tem o seu próprio plugin sobre o mesmo tema. Um duplicado no contexto significa o dobro do incómodo. Antes da instalação, o Claude Code v2.1.143+ mostra o **Context cost**, uma estimativa dos tokens que o plugin acrescentará a cada mensagem. Desde o v2.1.145+, mostra o campo **Will install** com uma lista completa dos comandos, agentes, skills, hooks, MCP e LSP do pacote. Antes de clicar em instalar, é o primeiro ecrã a abrir. ## Que matriz de seleção funciona em 2026?
Ideia principal O principal elemento deste guia é uma árvore de decisão com seis perguntas. Siga-a de cima para baixo e pare na primeira resposta aplicável. Este algoritmo abrange 95% das tarefas. Os 5% restantes são cenários complexos que exigem uma combinação de um subagente Haiku, uma skill pré-carregada para convenções e um servidor MCP de âmbito restrito para dados em tempo real. Esta é a «fórmula de 2026» que compensa.
Seis perguntas, por ordem de prioridade: 1. **É um procedimento recorrente, um estilo ou uma lista de verificação?** Se sim — **skill**. 2. **Precisa de dados ou ações externos** (base de dados, API, Slack, GitHub, Figma)? Se sim — **servidor MCP**. 3. **Quero um contexto separado** para não encher o principal? Se sim — **subagente**. 4. **Quero uma verificação ou uma etapa automática num evento definido?** Se sim — **hook**, com cobertura testada; para limites mais amplos de acesso, use permissões ou isolamento do ambiente. 5. **Quero um pacote pronto a usar que reúna 1–4 num só clique?** Se sim — **plugin** do marketplace. 6. **É uma tarefa complexa que precisa de dados, contexto e estilo?** Então use uma **combinação**: subagente Haiku + skill pré-carregada + um MCP de âmbito restrito. Fórmula da combinação: Um subagente Haiku com uma skill pré-carregada para convenções e um servidor MCP de âmbito restrito para dados em tempo real é um padrão que realmente compensa. E a principal regra sobre a direção da dependência: Os subagentes podem usar servidores MCP. Os servidores MCP não podem usar subagentes. Por outras palavras, o MCP serve sempre para dados e ações, não para agentes. Se quiser delegar uma tarefa, será um subagente que chama o MCP, e não o inverso. Um exemplo concreto aqui descrito: o motor editorial de uma agência digital que escreve um artigo SEO em 60 minutos. Inclui **25 subagentes e 14 etapas de revisão** — executadas sequencialmente, cada uma com o seu próprio contexto, permissões e skill para convenções editoriais. Um subagente liga-se a um servidor MCP com uma base de dados de etiquetas prontas a usar e artigos antigos. O agente orquestrador principal funciona com Opus; os agentes filhos funcionam com Haiku, mantendo o orçamento razoável. Isto não é uma «fábrica de artigos»; é um exemplo de como os quatro mecanismos se combinam num único sistema quando a tarefa exige profundidade e qualidade, em vez de rapidez. ## Que 7 erros deve eliminar já do Claude Code?
Ideia principal Estes são os sete principais erros abordados no artigo. Cada um reduz a qualidade das respostas e consome tokens. Cada um pode ser corrigido em 5–15 minutos. Se instalou mais de dez plugins no último mês, quase de certeza tem pelo menos três destes problemas.
1. **Instalou os 10 melhores plugins porque «estão na moda».** Cada um acrescenta tokens a todas as mensagens. Abra `/plugin list` e verifique o Context cost de cada um. Remova os que não utilizou nas últimas duas semanas. 2. **Copiou 15 servidores MCP do `.mcp.json` de outra pessoa.** A configuração de outra pessoa serve os projetos e as tarefas dessa pessoa. Mantenha no máximo 2–3 MCP ativos para o projeto atual. Mova os restantes para uma configuração separada de outro projeto ou elimine-os agora. 3. **A skill e o plugin MCP fazem a mesma coisa.** A skill diz «faça uma revisão de código», enquanto o plugin `pr-review-toolkit` executa o seu próprio fluxo de revisão. Começam a competir pela prioridade. Sintoma: «Claude, porque é que estás sempre a mudar de ideias?» Solução: mantenha uma única fonte de verdade. Na configuração descrita, foi escolhida a skill para manter o controlo sobre as instruções. 4. **Usa uma skill para impor uma regra quando precisa de um hook.** Uma skill, por si só, não impõe esse limite. Para «bloquear `.env` num commit», um **hook de pre-commit** pode verificar esse percurso. Teste separadamente o conteúdo preparado para commit e os percursos alternativos; o hook não impede toda a leitura nem outras formas de publicação. 5. **Um subagente com as mesmas permissões do agente principal.** Deu-lhe Opus e todas as ferramentas e obteve outra sessão principal. O prompt de sistema da documentação oficial recomenda dar ao subagente uma lista restrita de ferramentas e uma tarefa própria e limitada. Caso contrário, é apenas um clone dispendioso. 6. **Não verificou o Will install antes de instalar um plugin.** No Claude Code v2.1.145+, este campo mostra todo o conteúdo do pacote. Muitas vezes, um plugin «para uma coisinha» contém três servidores MCP, dois subagentes e cinco hooks. Passam todos a viver no seu contexto. 7. **A antiga pasta `.claude/commands/` duplica skills novas.** A Anthropic afirma na documentação:

Os comandos personalizados foram integrados nas skills. O ficheiro .claude/commands/deploy.md e a skill .claude/skills/deploy/SKILL.md criam ambos /deploy e funcionam da mesma forma.

— Claude Code Docs, https://code.claude.com/docs/en/skills
A antiga pasta `commands/` continua a funcionar, mas as skills são agora o padrão. No exemplo descrito, ambas as pastas estavam a ser usadas; a pasta `commands/` foi removida e ficaram as skills com ficheiros e acionadores incluídos. Sinais de que o Claude Code ficou «desorganizado»: - Cada mensagem começa por mencionar as ferramentas disponíveis em mais de 200 linhas. - As tarefas simples demoram mais do que há um mês. - O Claude confunde duas skills ou dois plugins semelhantes. - Surgem avisos de colisão de nomes quando começa uma sessão. - O Claude chama a ferramenta errada — uma skill A em vez do MCP B de que precisava. Se reconhecer pelo menos dois destes sintomas, abra já `/plugin list` e `/skill list`. Primeiro, remova o que não usou nas últimas duas semanas. Depois, verifique o Context cost de cada item. Por fim, resolva os antipadrões acima. ## Quantas skills e MCP pode manter sem esgotar o contexto?
Ideia principal Não há limites rígidos, mas há limiares práticos. Mantenha até 10–12 skills ativas; caso contrário, os limites globais da Anthropic começam a reduzir o espaço disponível para cada uma durante a compactação automática. Mantenha no máximo 2–3 servidores MCP ativos num projeto. Use plugins apenas quando o seu Context cost for inferior a 1,000 tokens por mensagem. Estes limiares baseiam-se na prática, não na teoria.
O que o Claude Code mostra diretamente: - `/skill list` — todas as skills ativas e o respetivo tamanho em tokens. - `/plugin list` — todos os plugins e o respetivo Context cost. - `/mcp list` — servidores MCP e o número de ferramentas. Orçamento de tokens em valores concretos: | Mecanismo | Custo enquanto está inativo | Custo quando é acionado | Capacidade de contexto | |----|----|----|----| | **Skill** | ~100 tokens (apenas metadados) | Instruções e recursos efetivamente lidos | Utiliza o contexto de quem a invoca | | **Subagent** | ~50 tokens (nome e descrição) | Entrada, saída, resultados de ferramentas e turnos efetivamente processados | Janela separada; o exemplo de 200K é capacidade, não um custo fixo por delegação | | **Servidor MCP** | Descrições de ferramentas carregadas pelo cliente | Argumentos e resultados carregados; a execução do serviço pode ter um custo próprio | Utiliza o contexto de quem o invoca | | **Plugin** | Soma dos componentes internos carregados | Utilização efetiva dos componentes internos | Depende dos componentes | Uma janela de contexto é o espaço de trabalho máximo, não a quantidade de tokens consumida em cada tarefa. Compare a entrada, a entrada em cache, a saída e os turnos repetidos medidos para o mesmo resultado. O isolamento pode reduzir o contexto principal, mas o subagente continua a gerar utilização própria. No seu blogue técnico, a Anthropic indica os valores da compactação automática para as skills: os primeiros 5,000 tokens de cada skill ativa são anexados novamente, com um orçamento total de 25,000. Isto significa que, com mais de 5 skills «pesadas» ativas ao mesmo tempo, o Claude começa a perder algumas instruções. Uma regra prática simples: - **Skills:** no máximo 5–7 ativas no projeto atual. Coloque as restantes em `~/.claude/skills/disabled/`; se precisar delas, pode voltar a movê-las. - **MCP:** no máximo 2–3 por projeto. O Context7 para documentação quase sempre compensa; mantenha os restantes específicos para cada tarefa. - **Plugins:** instale rigorosamente um de cada vez e, ao fim de duas semanas, verifique se o utilizou. Se não, remova-o. Uma análise detalhada do Agentic Coding Trends Report de 2026 da Anthropic e das razões por que 80% dos programadores não conseguem delegar uma tarefa inteiramente ao Claude está num guia separado. O principal valor desse relatório: as pessoas usam IA em 60% do seu trabalho, mas só delegam por completo 0–20% das tarefas. A principal razão é a sobrecarga do contexto e a perda de controlo sobre as ferramentas. ## Por onde deve começar um principiante: a configuração mínima funcional?
Ideia principal Se está agora a começar e não sabe o que escolher, não instale nenhum dos elementos aqui apresentados. Primeiro, construa uma base: CLAUDE.md, uma pasta separada com o contexto do projeto e uma estrutura básica para as tarefas. Passe duas semanas a fazer tarefas reais com o Claude Code básico. Depois, ficará claro onde tem um procedimento recorrente (isso é uma skill), onde lhe faltam dados em tempo real (isso é MCP) e onde uma tarefa começa a encher o contexto (isso é um subagente).
Configuração mínima após duas semanas de trabalho: 1. **CLAUDE.md** na raiz, com as regras do projeto. 2. **AGENTS.md** para compatibilidade com outras ferramentas, se tenciona trabalhar também fora do Claude Code. Mais detalhes em [«Como criar um único ficheiro de instruções para Claude Code, Codex e Cursor»](https://ailoot.ai/blog/pt-pt/agents-md-claude-md-one-instruction-file/). 3. **1 skill** para a principal tarefa recorrente. Por exemplo, comece por `code-review`, de acordo com o seu guia de estilo. 4. **1 servidor MCP**: Context7 para documentação atualizada. Sem ele, o Claude continua a alucinar APIs inexistentes. 5. **0 plugins e 0 subagentes** no primeiro mês. A questão não é poupar dinheiro; é ter controlo. Até compreender o básico, os pacotes vão confundi-lo. A partir daí, siga as tarefas. Surgiu um procedimento recorrente? Transforme-o numa skill. Precisa de dados em tempo real de um serviço específico? Adicione MCP. Uma tarefa grande começa a encher o contexto principal? Delegue-a a um subagente. Esse é o mapa em três níveis: **primeiro o contexto**, depois **passe para o sistema aquilo que faz mais do que algumas vezes** e, por fim, **verificações automáticas para que o sistema não cometa erros por si próprio**. Acrescente cada nível apenas quando o anterior já estiver a funcionar.
### Fontes - [Agent Skills Overview - Anthropic Docs](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) - [Skills - Claude Code Docs](https://code.claude.com/docs/en/skills) - [Subagents - Claude Code Docs](https://code.claude.com/docs/en/sub-agents) - [Plugins - Claude Code Docs](https://code.claude.com/docs/en/discover-plugins) - [Equipping Agents for the Real World with Agent Skills - Anthropic Engineering](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) - [MCP Introduction - modelcontextprotocol.io](https://modelcontextprotocol.io/introduction) - [GitHub anthropics/skills - open repository](https://github.com/anthropics/skills) - [Anthropic 2026 Agentic Coding Trends Report](https://resources.anthropic.com/2026-agentic-coding-trends-report)
Pode continuar a explorar o Ailoot em [ailoot.ai](https://ailoot.ai/).
## Perguntas frequentes ### Delegar um subagente consome automaticamente 200K tokens? Não. A janela de contexto indica capacidade. A utilização resulta da entrada e saída processadas, dos resultados de ferramentas e dos turnos seguintes. Compare a utilização total medida, incluindo a entrada em cache, em vez de tratar a janela máxima como uma taxa fixa por delegação. ### Quando devo escolher uma skill, um servidor MCP ou um subagente? Use uma skill para um procedimento recorrente, MCP para aceder a sistemas em tempo real e um subagente para uma tarefa delimitada cujos pormenores encheriam a conversa principal. Um plugin reúne estes componentes; examine o conteúdo antes de o instalar. ## Ailoot · A empresa e a sua carteira de projetos A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI. A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.