Claude Mods: a maior atualização do Claude Code!

Autoria: Prompt Engineering · Assistir no YouTube

Vídeo de autoria do canal indicado, não da IANIA; todos os direitos pertencem ao criador. Transcrição, resumo e tradução gerados automaticamente; o conteúdo no idioma original é preservado na versão em idioma original.

Idioma original: inglês

Vídeo original: Claude Mods - The Biggest Claude Code Upgrade! · Canal: Prompt Engineering · 10:30 · Assistir no YouTube

Tópicos: Agentes de IA, Cibersegurança e segurança de software, Claude Code, Ferramentas de desenvolvimento com IA

Resumo

O vídeo apresenta os mods do Claude Code, extensões que rodam dentro do agent harness e podem alterar ações, respostas e a interface durante uma sessão. Diferentemente de hooks e MCP servers, os mods permanecem ativos e podem manter estado, exibir painéis, pausar comandos e adicionar slash commands. O apresentador demonstra exemplos e mostra como criar mods personalizados com base no histórico de conversas. Como eles podem ler arquivos, executar programas e acessar a rede, o vídeo recomenda validar os mods antes de instalá-los.

Pontos-chave

Mods rodam dentro do Claude Code e podem intervir antes de uma ação ou de uma resposta ser exibida.
Um mod pode permitir uma ação, alterá-la ou bloqueá-la; também pode modificar o que aparece na tela.
Ao contrário de hooks, mods permanecem ativos durante a sessão e podem manter estado, exibir painéis e adicionar slash commands.
A Anthropic já está desenvolvendo alguns recursos do Claude Code como mods e pretende migrar outros.
É possível carregar mods durante uma sessão, e alterações nos arquivos podem ser recarregadas automaticamente.
O apresentador demonstra mods para contar chamadas de ferramentas, mostrar modelos locais, proteger comandos e acompanhar o uso da context window.
O histórico das sessões pode ajudar a identificar mods úteis para os workflows de cada pessoa.
Mods podem ler arquivos, executar programas e usar a rede; o vídeo recomenda validar cada mod antes de instalá-lo.
Use hooks para bloqueios simples com scripts, skills para instruções, MCP servers para conectar serviços e mods para personalizar a experiência do Claude Code.

Capítulos

Início	Capítulo	Resumo
00:00	O que são os mods do Claude Code	O vídeo apresenta os mods como uma forma de personalizar o próprio Claude Code e compara sua arquitetura com plug-ins.
02:05	Como os mods intervêm na sessão	O apresentador explica como um mod pode permitir, alterar ou interromper ações e modificar o conteúdo exibido.
04:46	Instalação e demonstrações	São mostrados o carregamento de mods e exemplos de painéis, contadores, proteções e indicadores de uso da context window.
06:21	Mods personalizados a partir do histórico	O vídeo demonstra mods para necessidades próprias e descreve como identificar ideias úteis nas sessões anteriores.
08:55	Segurança e quando usar mods	O apresentador alerta para os riscos de segurança, recomenda validar os mods e compara seu uso com hooks, skills e MCP servers.

Citações

Mods, por outro lado, ficam dentro do próprio Claude Code. — 00:31

Um mod pode ficar diante do que Claude mostra para você. — 03:09

Agora você pode mudar a própria ferramenta. — 04:46

Mostre-me primeiro as ideias. Não construa nada até eu escolher. — 07:52

Não confie cegamente nos mods que encontra na internet e instale. — 09:25

Conceitos e entidades

Claude Code (ferramenta): Ferramenta da Anthropic cuja experiência e comportamento podem ser personalizados com mods.
Anthropic (empresa): Empresa que desenvolve o Claude Code e introduziu os mods descritos no vídeo.
mod (conceito): Extensão executada dentro do Claude Code que pode intervir no comportamento do agent harness e na interface.
hook (conceito): Script que é executado para um evento e pode responder a ele, mas não permanece ativo durante toda a sessão como um mod.
MCP server (conceito): Componente usado para permitir que o Claude Code acesse outros serviços.
skill (conceito): Recurso indicado no vídeo para orientar Claude a seguir instruções.
DeepSeek (empresa): Referência usada no vídeo para comparar a ideia de componentes substituíveis no harness.
Claude (modelo): Modelo que pode usar ferramentas e cuja interação com o Claude Code pode ser personalizada por mods.

Tradução completa (pt-BR)

00:00 Certo, então a Anthropic acabou de lançar mods no Claude Code, e isso é muito mais importante do que muita gente imagina. Esta é a primeira vez que a Anthropic realmente abre o próprio Claude Code, e agora você pode personalizá-lo de praticamente qualquer maneira que imaginar, incluindo a própria interface. Basicamente, você pode criar seu próprio harness personalizado em cima do Claude Code, o que é bem empolgante. Agora, mods são bem diferentes das coisas que tínhamos antes, como skills, hooks e

00:31 servidores MCP. Tudo isso fica fora do Claude Code, e o Claude Code os aciona quando precisa. Os mods, por outro lado, ficam dentro do próprio Claude Code, o que significa que podem realmente controlar o comportamento do agent harness. Então, eles podem basicamente intervir logo antes de o Claude Code realizar uma ação e alterá-la ou impedi-la. A ideia não é nova. Já vimos isso com o DeepSeek. Quando o DeepSeek lançou seu harness, eles disseram que tudo nele é um plug-in. Coisas como o wrapper do modelo, as ferramentas que você pode usar e até o próprio loop do agent. E o bom é que, se você não gostar de alguma dessas partes, pode simplesmente substituí-la pela sua. Agora, a Anthropic está trazendo uma ideia muito parecida para o Claude Code com os mods. Então, neste vídeo, quero explicar o que são mods, como instalá-los e, depois, mostrar uma maneira bem fácil de criar mods automaticamente a partir do histórico das suas próprias conversas.

01:02 Então, esses mods vão ser realmente úteis para os seus próprios workflows. Primeiro, vamos falar sobre o que é exatamente um mod. Tecnicamente, um mod é um plug-in com algumas configurações extras. Então, ele tem o mesmo arquivo de plug-in e o mesmo arquivo de hook, exceto que agora o arquivo de hooks aponta para um arquivo JavaScript ou TypeScript. Esse novo arquivo é o seu mod, que roda dentro do Claude Code, e não há nenhuma etapa extra de build. Então, quando você carrega isso com essa flag,

01:33 o Claude Code observa essa pasta específica. Assim, toda vez que você salva o arquivo, o mod é recarregado na sessão que já está aberta. Agora, como um mod funciona na prática? Vamos usar um exemplo. Digamos que o Claude esteja prestes a executar um force push. Antes disso, o Claude Code chama sua função e entrega três coisas a ela. A primeira é o próprio evento, ou seja, o que está prestes a acontecer. Neste caso, o comando exato. A segunda é uma forma de se comunicar de volta com o Claude Code.

02:05 Então, se houver alguma etapa interna interessante que o mod precise executar, como desenhar na tela, ler um arquivo ou fazer uma pergunta para você, isso vai fazer parte da segunda coisa. E a terceira é uma função chamada next, que basicamente significa continuar normalmente. Então, sua função tem três opções. Ela pode chamar next e deixar o push acontecer. Talvez registre o que está acontecendo ao longo do caminho. Ou pode primeiro alterar o comando, digamos,

02:37 para fazer push em uma nova branch, e então chamar next. Ou pode não chamar next e responder ao Claude Code. Algo como: “Não, não fazemos force push neste repo específico”. Agora, o ponto é que isso não serve apenas para comandos. Um mod pode ficar diante do que o Claude mostra para você. Por exemplo, talvez você não queira mostrar nenhuma informação de identificação pessoal, como e-mails, nas respostas. Então, usando o mod, o Claude Code pode ocultar os endereços de e-mail na

03:09 resposta. O modelo ainda vê o endereço real. O mod só altera o que aparece na tela. Certo. Agora você talvez esteja pensando: já temos hooks para coisas assim. Então, por que isso é tão importante, se já tínhamos hooks? Um hook é um script de shell. Ele é executado uma vez para um evento, envia as respostas de volta e, depois, basicamente desaparece. Um mod é carregado uma vez e permanece em execução durante toda a sessão. Então, pode se lembrar das coisas. Pode mostrar um painel ao vivo que é atualizado a cada turno. Pode pausar comandos e perguntar a você antes de executá-los.

03:40 Também pode adicionar slash commands que executam seu código imediatamente, sem chamar o modelo. Então, é muito mais do que um hook. E aqui está a parte que considero interessante nessa implementação: a Anthropic já está construindo partes do próprio Claude Code como mods. Por exemplo, a visualização de diff e os recursos do agent. FD são mods. E eles disseram que planejam migrar mais recursos para mods. Então, isso

04:12 dá a você a capacidade de personalizar de verdade toda a experiência do Claude Code. O seu Claude Code talvez nem se pareça mais com o meu. Agora, é o mesmo núcleo, com um conjunto diferente de mods por cima. E é isso que quero dizer quando afirmo que a Anthropic abriu o Claude Code. Até agora, você podia adicionar coisas ao redor dele. Agora, pode mudar a própria coisa. Certo. Então, deixa eu mostrar isso funcionando. A primeira coisa é atualizar sua instalação do Claude Code ou o aplicativo Claude para desktop para ter acesso a isso. Se você estiver na versão mais recente, já tem mods.

04:46 Então, se você digitar /plugin e acessar a aba de instalação, vai encontrar alguns mods integrados. E um deles é a skill que o Claude usa para escrever mods para você. Certo, este é o mod mais simples da documentação. Ele conta quantas ferramentas o Claude usa. Agora, carreguei isso com a flag do diretório de plug-ins e pedi ao Claude para ler alguns arquivos

05:18 para mim. Ele mostra o indicador de carregamento. Agora, mostra a contagem de ferramentas. Neste caso, o código estava sendo executado dentro do Claude Code. Agora, se eu digitar /tally, ele mostra três. Também editei o arquivo enquanto a sessão ainda estava aberta, e o Claude Code o recarregou sozinho. Mas aí a contagem das chamadas de ferramentas voltou a zero. Isso acontece porque uma recarga reinicia o código do zero. Então, tudo o que você quiser manter precisa ficar armazenado no Claude Code, não no seu arquivo. Então, instalar o mod de outra pessoa funciona como instalar qualquer outro plug-in. Neste caso, um marketplace é apenas uma pasta ou um repo do GitHub com um arquivo JSON dentro. Há dois comandos de instalação diferentes. E agora, /plugin mostra que há dois mods ativos.

05:48 A barra acima do prompt que você está vendo é a que criei para o meu laboratório. Ela mostra quais modelos locais estão rodando no meu MacBook e nos meus dois DJX Sparks. No momento, os

06:21 DJX Sparks estão desligados, e a barra me informa isso. Então, é só um mod bacana que consegue acompanhar meu DJX Spark. Agora, aqui vai outro. Este é um mod de proteção. Pedi ao Claude Code para excluir uma pasta com rm -f. Antes de o comando ser executado, o mod o bloqueia e me pergunta. Posso recusar, ou o Claude Code lê o motivo que dei e sugere uma maneira mais segura. E, quando o turno termina, uma pequena janela pop-up me diz quanto tempo levou e

06:51 quantas ferramentas foram usadas. Neste caso, esse único mod está fazendo três coisas diferentes. O bom é que você não precisa escrever esses mods. Eu simplesmente descrevi o que queria. Por exemplo, um indicador que mostra o quanto da minha context window está preenchida. O Claude escreveu o mod, perguntou uma vez se eu queria ativá-lo, recarregou ao vivo e o indicador apareceu acima do prompt. E, conforme continuo trabalhando, ele vai me mostrando quanto da minha context window está preenchida

07:21 até agora. Esses foram apenas alguns exemplos, mas os mods mais úteis são os criados em função de como você trabalha. Aqui está um prompt que uso para isso. Ele instrui o Claude Code a ler suas últimas 20 sessões e procurar três coisas: as perguntas que você continua fazendo, os comandos que deixam você apreensivo e como você verifica o trabalho dele. E a linha mais importante é a última: “Mostre as ideias primeiro. Não crie nada até eu escolher”. Encontrei isso no X. Vou colocar um link para a publicação original. Agora, executei isso nas minhas próprias

07:52 sessões, escolhi as ideias de que gostei e então o Claude criou os mods para mim. Então, este é o meu Claude Code: um painel que mostra tanto os Sparks quanto o meu Mac. Depois, uma prateleira com tudo o que esta sessão produziu. E um mod de proteção que verifica de qual conta estou prestes a publicar. Nada disso veio de um template. Esses mods são baseados no meu próprio histórico de uso do Claude e, essencialmente, estou criando minha própria versão do Claude Code, o que é incrível. Agora, uma

08:24 sessões, escolhi as que gostei, e então o Claude criou aquelas para mim. Então, este é o meu Claude Code. Sabe, um painel que mostra tanto o Sparks quanto o meu Mac. Depois, uma prateleira com tudo o que esta sessão produziu. Uma proteção que verifica de qual conta estou prestes a publicar. Nenhuma dessas coisas veio de um template. Elas se baseiam no meu próprio histórico de uso do Claude e, essencialmente, estou criando minha própria versão do Claude Code, o que é incrível. Agora, um

08:55 Aviso: um mod é executado na sua máquina. Então, ele pode ler seus arquivos, executar programas e usar a rede. Portanto, antes de instalar o mod de outra pessoa, execute o validador de plugins do Claude nele. Ele lista todos os eventos que o mod monitora e todas as chamadas que faz. Por exemplo, meu mod de laboratório faz chamadas de rede, o que faz sentido. Meu mod Guard me faz perguntas, e esse mod da comunidade apenas oculta meus segredos do Claude. Então, se um

09:25 mod que você não conhece estiver fazendo chamadas de rede, você vai querer saber por quê, certo? Assim como acontece com skills e servidores MCP, não confie cegamente nos mods que encontrar na internet e instale-os. Eles representam grandes riscos de segurança. Então, quando você deve usar um mod? Se você só quer bloquear algo com um script que já tem, acho que um hook ainda é suficiente. Se você quer que o Claude siga instruções, deve usar uma skill. E, se o Claude precisar acessar outro serviço, você deve

09:57 usar um servidor MCP para isso. Mas, se você quer algo na sua própria tela, algo que se lembre de coisas ou que possa parar o Claude e perguntar antes, ou se realmente quer personalizar toda a experiência do Claude Code, é aí que você deve usar um mod. Meu palpite é que veremos muitos marketplaces de mods nas próximas semanas e, pouco depois, o primeiro mod que faça algo que não deveria. Agora, me diga nos comentários o que você mudaria primeiro no Claude Code se pudesse usar um mod. Os prompts e os

10:30 mods estão nos links abaixo. Enfim, espero que este vídeo tenha sido útil. Obrigado por assistir e, como sempre, até o próximo.

Transcrição original

[00:00] Okay, so Enthropic just dropped mods in cloud code and this is a much bigger deal than a lot of people realize. This is the first time Enthropic has really opened up clot code itself and you can now customize it in pretty much any way you can imagine including the UI itself. You can basically create your own custom harness on top of cloud code which is pretty exciting. Now mods are very different from things that we have had before. Things like scales, hooks and

[00:31] MCP servers. All of those live outside cloud code and cloud code calls them when it needs them. Mods on the contrary live inside cloud code itself, which means they can really control the behavior of the agent harness. So they can essentially step in right before a cloud code takes an action and change it or stop it. Now the idea is not new. We have seen it with DeepSeek. When Deepseek released their harness, uh they

[01:02] said everything in it is a plug-in. Things like the model wrapper, the tools that you can use, even the agent loop itself. And the nice thing is if you don’t like one of those parts, you can just swap it out with your own. Now, Entropic is bringing a very similar idea to cloud code with mods. So, in this video, I want to explain what mods actually are, how to install them, and then a really easy way to automatically create mods from your own conversation

[01:33] history. That way, those mods are going to be actually useful to your own workflows. First, let’s talk about what exactly is a mod. Technically, a mod shapes as a plug-in with some extra settings. So it has the same plug-in file, same hook file except that the hooks file now points to a JavaScript or TypeScript file and this new file is your mod which runs inside cloud code and there is no extra build step. So when you load that

[02:05] one flag, cloud code watches that specific folder. So every time you save the file, the mod reloads in the session you already have open. Now, how does a mod actually work? So, let’s take an example. Say Claude is about to run a force push. Before it does, cloud code calls your function and it hands it three different things. The first one is the event itself, which is what’s about to happen. In this case, the exact command. The second is a way to talk

[02:37] back to clot. So if you have some interesting internal steps that the mod has to take things like maybe draw on the screen or read a file or ask you a question those are going to be a part of the second thing. And the third is a function called next which basically means carry on as normal. So your function has three choices. It can call next and let the push go through. Maybe it’s going to log it along the way. Or it can change the command first, say

[03:09] push to a new branch instead, and then call next or it can skip next completely and answer it for clawed code. Things like no, we don’t force push in this specific repo. Now, the thing is that it’s not only for commands. A mod can sit in front of what claude shows you. For example, you don’t want to show any PPI or personally identifiable information like emails in the responses. So then cloud using the mod can hide email addresses in the

[03:40] response. Now the model still sees the real address. It just changes the behavior on the screen. Okay. Now you might be thinking we have hooks for things like this. So why is this such a big deal when we already have had hooks? So a hook is a shell script. It runs once for an event, send backs the answers, and then it’s basically gone. A mod gets loaded once and stays running for the whole session. So it can remember things. It can show you a live

[04:12] panel that updates every turn. It can pause commands and ask you before it runs. It can also add slash commands that runs your code instantly without calling the model. So it’s a lot more than a hook. And here’s the part I actually find interesting for this implementation. Entropic is already building parts of the cloud code itself as mods. For example, the diff view and the agent. FD supports are both mods. And they have said that they planned to move more features over as mods. So this

[04:46] gives you the ability to really customize the whole clot code experience for you. Your clot code may not look similar to mine anymore. Now it’s the same core uh with different set of mods on top and that’s what I mean when I say anthropic has opened up cloud code until now. You could add things around it. Now you can change the thing itself. Okay. So let me show you this running. So the first thing is you need to update your cloud code instance or your cloud

[05:18] desktop app to get access to it. If you are on the latest version, you already have mods. So if you type /plugin and go to the install tab, you will see a few built-in ones already there. And one of them is the skill Claude uses to write mods for you. Okay, so here’s the simplest mod from the docs. It counts how many tools Claude uses. Now I loaded this with the uh plug-in directory flag and ask cloth to read a couple of files

[05:48] for me. So it shows the spinner. It now shows the tool count. In this case, the code was drawing inside the clot code. Now if I type /tally, it actually shows three. I also edited the file while the session is still open and clot code reloads it on its own. But then the tally of the tool calls went to zero. That’s because a reload restarts your code fresh. So everything you want to keep has to be stored in clot code, not in your file. So installing uh someone’s

[06:21] else uh’s mod works like any other plug-in. In this case, a marketplace is just a folder or a GitHub repo with one JSON file in it. There are two different install commands. And then /plugin uh now says two mods are active. The bar above the prompt that you see is the one I built for my uh lab. It shows which local models are running on my MacBook and on my two DJX Sparks. Right now, the

[06:51] DJX Sparks are off and it tells me that. So, it’s just a neat little mod that can actually keep track of my DJX Spark. Now, here’s another one. Uh, this one is a guard. So I asked clot to delete a folder with rm-f before the command runs. The mod stops it and asks me I can say refuse or cloud code reads my reason and suggest a safer way and and when the turn ends a little pop-up tells me how long it took and how

[07:21] many tools it used. Now in this case that single mod is doing three different things. Now the beauty is that you don’t have to write these yourself. I just described what I wanted. for example, a gauge that shows how full my context window is. Claude wrote it asked me once if I want to turn it on live on reloading and the gauge basically showed up above the prompt. And as I keep working, it’s going to basically show me how much my contacts window is filled up

[07:52] till now. Now, these were just a few examples, but the most useful mods are the ones built around how you work. Now, here’s a prompt that I use for it. It tells clot to read your last 20 sessions and look for three things. The question you keep asking, the commands that make you nervous and how you check its work, and the most important line is the last one. Show me the ideas first. Don’t build anything until I pick. Now, I found this on X. I’ll put a link to the actual poster. Now, I ran this on my own

[08:24] sessions, picked the ones I liked, and then Claude built those for me. So, this is my Claude code. You know, a panel that shows both Sparks and my Mac. Then a shelf of everything this session produced. A guard that checks which account I am about to publish from. Now none of these came from a template. These are based on my own history of using cloth and essentially I am creating my own version of cloth code which is pretty amazing. Now, one

[08:55] warning, a mods runs on your machine. So, it can read your files, run programs, and use the network. So, before you install anyone’s else’s mod, run cloud plug-in, validate on it, it lists every event that the mod listens to, and every call it makes. So, for example, my lab mod makes network calls, which makes sense. My guard asks me questions and this community mod only hides my secrets from claude. So if a

[09:25] mod you don’t know is making network calls, you want to know why, right? So very similar to skills, the MCP servers, don’t just blindly trust the mods that you find on the internet and install them. These are big security risks. So when should you use a mod? If you just want to block something with a script you already have, I think a hook is still fine. If you want clot to follow instructions, for that you want to use a skill. And if you if claude needs to reach another service, you want

[09:57] to use an MCP server for that. But if you want something on your own screen, something that remembers or something that can stop cloud and ask you first, or you really want to customize the whole experience of cloud code, this is where you want to use a mod. Now, my guess is that we will see a lot of mod marketplaces over the next few weeks and soon after that, the first mod that does something it shouldn’t. Now, let me know uh in the comments what you would change first about your cloud code if you are able to use a mod. The prompts and the

[10:30] mods are linked below. Uh anyways, I hope you found this video useful. Thanks for watching and as always, see you in the next one.