Claude Code abre a porta para mods e transforma o jeito de trabalhar com agentes

Principais destaques

• agents.md chegou ao Claude Code: a partir da versão 2.1.277, o agente pode reaproveitar instruções compartilhadas com outras ferramentas de programação.
• Mods são a novidade mais estratégica: o suporte ao arquivo foi construído como um plugin capaz de alterar o comportamento do próprio harness do Claude Code.
• Um ecossistema começa a tomar forma: diff panel, telemetria, segurança, Projects e novas ferramentas de plugins apontam para um Claude Code cada vez mais modular.

O Claude Code ganhou uma novidade que, à primeira vista, parece pequena: suporte ao arquivo agents.md.

Na prática, porém, a mudança mexe em uma questão recorrente para equipes que usam mais de um agente de programação. Em vez de manter instruções separadas para cada ferramenta, o mesmo arquivo pode servir como uma espécie de manual compartilhado do projeto.

E tem um detalhe ainda mais interessante nessa história.

O suporte a agents.md foi construído como um mod, uma extensão capaz de interferir no funcionamento do próprio Claude Code.

É aí que a coisa deixa de ser apenas sobre um arquivo de configuração.

Um arquivo para falar com vários agentes 🧩

O agents.md costuma concentrar informações como comandos para rodar testes, gerenciador de pacotes utilizado pelo projeto e diretórios que não devem ser alterados.

A partir da versão 2.1.277, lançada em 18 de setembro, o Claude Code consegue ler esse arquivo automaticamente quando não existe um claude.md específico no projeto.

Por padrão, portanto, a hierarquia fica assim:

Arquivo	Comportamento
claude.md	Tem prioridade quando existe
agents.md	É usado quando não há claude.md
Ambos	Podem ser carregados via configuração

A opção de carregar os dois arquivos pode ser configurada em /config, nas instruções do projeto.

💡 O ganho aqui é menos glamour e mais manutenção: uma equipe que já mantém regras para outro agente não precisa necessariamente duplicar tudo para começar a usar Claude Code.

Isso não significa, claro, que o agente obedecerá perfeitamente a cada linha. Instruções precisam continuar sendo específicas, testadas e ajustadas conforme o comportamento observado.

E o que é esse tal de “mod”? 🔧

Para entender por que a novidade chamou atenção, é preciso separar duas coisas.

Existe o modelo de IA.

E existe o harness, a camada de software que fica ao redor dele.

É o harness que organiza o contexto, chama ferramentas, processa informações e monta a experiência da sessão. Ele não é o modelo em si.

Um mod funciona justamente nessa camada.

🧠 A ideia é mexer no entorno do modelo: usando function hooks, um mod pode alterar determinados comportamentos do Claude Code sem precisar modificar os pesos ou o treinamento do modelo.

Isso abre possibilidades bem maiores que simplesmente escolher qual arquivo de instruções será lido.

Um mod pode, por exemplo, interferir na interface ou filtrar informações antes que uma saída de ferramenta chegue ao modelo.

E o próprio agents.md já é um exemplo disso.

O suporte a agents.md não é apenas uma nova opção de configuração. É uma demonstração prática de que partes do Claude Code podem ser estendidas por plugins.

Quatro mods já estão no repositório 👀

O suporte ainda está começando, mas já existem quatro mods disponíveis publicamente:

• Loader de agents.md, responsável pela lógica de carregamento das instruções.

• Diff panel, que acrescenta uma visualização das alterações feitas durante a sessão.

• Telemetria, voltada ao acompanhamento de informações de uso.

• Segurança organizacional, com controles relacionados ao ambiente da organização.

O fato de esses componentes estarem disponíveis no repositório também muda a conversa.

Em vez de apenas anunciar uma funcionalidade, a Anthropic permite que desenvolvedores examinem como essas extensões foram implementadas.

🔎 O sinal mais importante: a empresa está mostrando um mecanismo que pode ser reutilizado, não apenas uma função isolada.

Por que isso pode importar mais que o agents.md?

O problema resolvido pelo agents.md é relativamente específico.

Evitar arquivos duplicados é útil, mas não muda sozinho a maneira como equipes desenvolvem software.

Os mods podem mudar isso.

Imagine um projeto grande com diferentes fluxos de trabalho. Uma tarefa pode exigir determinadas instruções, ferramentas e filtros de saída, enquanto outra precisa de um conjunto completamente diferente.

Em vez de colocar todas as regras em um único pacote gigantesco de contexto, extensões poderiam ajudar a determinar o que entra, quando entra e como o sistema se comporta.

Essa possibilidade ainda não está madura.

Mas é justamente por isso que o movimento merece atenção.

O ecossistema ainda está engatinhando 🐣

Desenvolvedores já podem experimentar mods personalizados, mas o recurso ainda está em acesso antecipado.

É necessário habilitar os function hooks, e a própria Anthropic avisa que a API pode mudar entre versões.

Isso coloca uma placa de “obra em andamento” no caminho de quem quiser construir uma infraestrutura inteira sobre esses recursos agora.

Por enquanto, há uma diferença importante entre os mods internos e um ecossistema aberto de terceiros.

Os primeiros já existem e são inspecionáveis. O segundo ainda está se formando.

Para quem desenvolve ferramentas especializadas em cima do Claude Code, essa distinção pode ser decisiva.

Enquanto isso, o Claude Code está ficando mais parecido com uma plataforma 🚧

O suporte a mods não chegou sozinho.

Nas últimas semanas, uma série de atualizações começou a empurrar o Claude Code para além do modelo tradicional de “agente que recebe uma tarefa e escreve código”.

O diff panel colocou as mudanças na frente dos olhos

Lançado na versão 2.1.260, em 3 de setembro, o painel mostra arquivos alterados e contagem de linhas enquanto o Claude trabalha.

Também permite selecionar linhas específicas para referenciá-las na próxima mensagem.

A exigência é relativamente simples: projeto em Git e terminal com pelo menos 110 colunas de largura.

O efeito prático é interessante. Em vez de explicar novamente qual trecho precisa ser corrigido, o desenvolvedor pode apontar diretamente para a mudança.

Projects começou a coordenar vários fios de trabalho 🧠

O Projects redesenhado, ainda em beta, vai além de uma sessão individual.

A proposta é ter um coordenador que divide um projeto em threads, distribui tarefas e revisa os resultados.

Cada thread roda como uma sessão de Claude Code na nuvem, com sua própria branch e cópia do repositório. As threads também compartilham a memória do projeto.

Isso permite que o trabalho continue mesmo depois que o computador é fechado.

Mas há limites de disponibilidade.

No lançamento, o recurso está restrito a determinados usuários Pro e Max utilizando sessões na nuvem. A execução local, além do acesso para equipes e empresas, ficou planejada para etapas posteriores.

💸 Existe também uma conta a pagar: executar várias threads em paralelo consome a franquia de uso mais rapidamente.

Ou seja, coordenar mais agentes não significa simplesmente multiplicar capacidade sem custo.

Claude também ganhou um “modo de continuar trabalhando” 🖥️

Outra atualização permite que o Claude use o computador em segundo plano no desktop.

O recurso começou a ser distribuído para usuários de macOS 15 ou posterior e está em beta para assinantes Pro e Max.

A lógica é voltada principalmente para tarefas realizadas dentro de aplicativos nativos que não oferecem uma boa interface de linha de comando.

O usuário autoriza quais aplicativos podem ser acessados.

E há uma condição pouco glamourosa, mas importante: o aplicativo desktop precisa continuar aberto e o computador precisa permanecer acordado enquanto o trabalho acontece.

É automação, mas ainda não é mágica.

Terminal e desktop começaram a conversar melhor 🔄

Também entrou em cena um handoff entre terminal e desktop.

Com um comando de barra no aplicativo desktop, uma sessão iniciada no terminal pode ser continuada preservando a conversa e o contexto.

Parece detalhe.

Para quem alterna entre ambientes durante o desenvolvimento, é justamente o tipo de detalhe que reduz atrito.

E o modelo também ganhou espaço para respirar

Em 4 de setembro, chegou um novo modelo identificado como “5.1”, com janela de contexto de 1 milhão de tokens.

O Claude Code passou a oferecer suporte a ele a partir da versão 2.1.257.

Há, porém, uma pegadinha para quem utiliza gateways de API.

Alguns gateways fazem alias automático de nomes antigos para modelos novos. Esse comportamento não cobre o 5.1, que precisa ser especificado explicitamente quando o gateway o disponibiliza.

Dependendo do plano, o consumo também pode utilizar créditos separados.

Plugins agora podem ser testados de verdade 🧪

Outra peça desse quebra-cabeça apareceu nas ferramentas de skills e plugins.

O /skill doctor, adicionado no início de setembro, mostra o custo de contexto e o uso das skills.

Isso é relevante porque até skills que não estão sendo utilizadas podem ocupar espaço no contexto simplesmente por estarem listadas.

Depois, na versão 2.1.269, lançada em 11 de setembro, chegou o claude plugin eval.

1️⃣ Execute os testes: o plugin é avaliado em casos definidos.

2️⃣ Compare os resultados: os testes podem ser executados com e sem o plugin habilitado.

3️⃣ Meça o efeito: a ideia é verificar se a extensão realmente melhora o resultado.

Como o processo utiliza chamadas reais ao modelo, também consome uso.

Mas oferece algo que costuma faltar em sistemas de agentes: uma maneira mais objetiva de perguntar se determinada extensão está ajudando ou apenas ocupando contexto.

Então o Claude Code está virando um “sistema operacional” para agentes? 🤔

Ainda seria cedo para dizer isso.

Mas a direção das peças é clara.

agents.md trabalha com instruções compartilhadas.

Mods mexem no comportamento do harness.

Skills adicionam capacidades reutilizáveis.

Plugins podem ser avaliados de forma mais sistemática.

Projects começa a coordenar múltiplas sessões.

E o uso do computador amplia o espaço em que o agente consegue executar tarefas.

A diferença está na arquitetura.

Um agente de código tradicional recebe uma tarefa e trabalha nela. O modelo que começa a aparecer aqui é mais distribuído: diferentes componentes podem orientar, executar, coordenar, revisar e modificar o ambiente de trabalho.

🧩 O código continua sendo o produto final. Mas o sistema ao redor dele está ficando tão importante quanto o agente que escreve cada linha.

Ainda existem algumas portas fechadas 🚪

A expansão não é universal.

O suporte a agents.md, por exemplo, não estava disponível no lançamento para implantações via Bedrock, Vertex ou Foundry.

Os Projects redesenhados também tinham acesso limitado.

E os mods personalizados continuam em uma fase experimental, com uma API sujeita a alterações.

Portanto, existe uma diferença considerável entre o que já está disponível no Claude Code público e aquilo que pode se transformar em uma plataforma aberta de extensões.

Essa fronteira provavelmente será uma das partes mais interessantes para acompanhar.

No fim, o arquivo é pequeno. A mudança é maior.

O agents.md resolve um problema bastante concreto: equipes que usam diferentes agentes podem compartilhar instruções sem precisar manter uma coleção de arquivos quase idênticos.

Mas o verdadeiro movimento está por baixo.

A Anthropic mostrou que uma funcionalidade importante do próprio Claude Code pode ser construída como um mod. Ao mesmo tempo, colocou no mesmo ecossistema ferramentas para skills, plugins, avaliações, múltiplas sessões e automação no desktop.

É como trocar uma bancada de ferramentas por uma oficina modular.

O agents.md é só uma das primeiras peças que encaixaram.

A pergunta agora é o que os desenvolvedores vão construir quando os encaixes deixarem de ser experimentais e começarem a formar um ecossistema estável.