Skills@joaoguirunas

5 Plugins do Claude Code: OmniRoute, Headroom e Mais, com os Riscos

Q: As cinco ferramentas são plugins?

Não. Só o Claude Code Setup e o Claude Mem são plugins do Claude Code. O OmniRoute é um gateway, o Headroom é uma CLI com proxy local e o Task Observer é uma skill.

Q: Dá para usar o Claude de graça com o OmniRoute?

Não é isso que o projeto promete. O README descreve uma estimativa agregada de planos gratuitos de terceiros, que você obtém com contas próprias, e que sobe e desce conforme os provedores mudam. Com o Claude Code apontado para o gateway, o modelo que responde pode não ser o Claude.

Q: O Claude Code Setup apaga algo do meu projeto?

Não. O README descreve a skill como somente leitura: ela analisa e recomenda, sem modificar arquivos.

Q: O Task Observer melhora as minhas skills sozinho?

Ele propõe melhorias. Segundo o README, em revisão interativa você aprova cada mudança, e uma revisão agendada aplica as alterações só em cópias separadas.

Instale OmniRoute, Claude Mem, Headroom, Claude Code Setup e Task Observer com os comandos dos READMEs, sabendo o que cada um é e o risco de cada.

Quero ser Gestor de IA Ver o OmniRoute no GitHub Voltar ao catálogo

OmniRoute

$ git clone https://github.com/diegosouzapw/OmniRoute

✓ repositório pronto para uso local

O que é

5 Plugins do Claude Code: OmniRoute, Headroom e Mais, com os Riscos

Cinco ferramentas que o reel chama de plugins para o Claude Code: OmniRoute (um gateway que junta provedores de IA num endereço local), Claude Mem (memória entre sessões), Headroom (proxy local que comprime o que vai para o modelo), Claude Code Setup (plugin oficial da Anthropic que recomenda automações) e Task Observer (uma skill que registra suas correções e propõe melhorias). Nesta página cada uma tem link, comando de instalação conferido no README e o risco que o vídeo não cabe explicar.

É para quem já usa o Claude Code e quer gastar menos tokens, lembrar de projetos entre sessões e configurar melhor o ambiente. Você sai sabendo instalar cada ferramenta, o que ela é de fato (nem tudo aqui é plugin) e como desfazer o que ela muda.

A ressalva principal é o OmniRoute: com o Claude Code apontado para ele, o modelo que responde pode não ser o Claude, e os planos gratuitos que ele junta são de terceiros, cada um com seus termos. Use só com código e dados que você pode enviar a esses provedores.

OmniRoute: um endereço, vários provedores

Gateway local com troca de modelo quando a cota de um provedor acaba. Risco alto: modelo de terceiros, termos e dados.

Claude Mem: memória entre sessões

Plugin que lembra de projetos e arquivos. Pede login por e-mail e oferece um observer hospedado, com trial de 30 dias.

Headroom: menos tokens no caminho

Proxy local que comprime saída de ferramenta, logs e JSON antes de chegar ao modelo. Registra um servidor MCP extra ao rodar.

Claude Code Setup: só leitura

Plugin oficial da Anthropic que analisa o projeto e recomenda hooks, skills, subagentes e MCPs, sem alterar arquivos.

Task Observer: você aprova

Skill que registra correções e propõe melhorias nas suas outras skills. Nada muda sem a sua revisão.

Nível: intermediário · Tempo estimado: ~40 min para instalar e conferir as cinco, com tempo extra se o npm pedir ajustes

Risco alto no OmniRoute. Ele roteia o seu Claude Code para provedores de terceiros: (1) o modelo que responde pode não ser o Claude, e a Anthropic diz que não suporta rotear o Claude Code para modelos não-Claude por gateway; (2) o que você digita e o código aberto na sessão passam por esses provedores, cada um com política de dados própria; (3) a documentação do projeto marca 16 provedores com cláusula de uso pessoal ou de proxy que vale conferir (classificação caution), e diz que esse sinal é informativo e não bloqueia o roteamento; (4) é um pacote npm global com script de instalação e dependências nativas, ou seja, uma cadeia de suprimentos que você passa a confiar: leia o repositório e os avisos de segurança antes de instalar. Não use com código ou dados de cliente.

Efeitos colaterais das outras ferramentas. Claude Mem: depois do login por e-mail, a instalação oferece o observer hospedado do claude-mem (trial de 30 dias; depois a memória volta ao seu plano Anthropic, a menos que você assine). Headroom: o headroom wrap claude inicia um proxy local, instala o Serena e registra um servidor MCP no seu ~/.claude.json. Task Observer: grava logs de observação no disco, que podem conter trechos do seu trabalho.

Não testado. Os comandos abaixo foram conferidos nos READMEs e na documentação oficial em 20/10/2026, mas esta página não executou as cinco instalações. Também não foram reproduzidos: a troca automática de modelo do OmniRoute com a cota estourando e uma medição real de tokens do Headroom. Os percentuais de compressão do vídeo dependem do tipo de conteúdo (o README cita ganhos grandes em JSON e logs repetidos, e pouco em texto já denso). O vídeo fala em tudo gratuito: o código das cinco é aberto, mas cada provedor conectado ao OmniRoute tem seus limites e o Claude Mem tem o trial descrito acima.

Pré-requisitos

Claude Code instalado e logado, com plano pago ou conta Console (o plano gratuito do claude.ai não inclui Claude Code). Instalação e planos na documentação oficial: https://code.claude.com/docs
Node.js: o OmniRoute 3.8.52 declara engines >=22.22.2 <23 ou >=24.0.0 <27 (npm, 20/10/2026) e o Claude Mem pede Node 20 ou mais novo
Python com uv ou pip, só para o Headroom (o pacote npm headroom-ai é só o SDK em TypeScript e não traz o comando)
Terminal e permissão para editar o ~/.claude/settings.json. Faça uma cópia dele antes de qualquer alteração
Conta própria em cada provedor que você conectar ao OmniRoute, com os limites e termos de cada um. Custo: nenhuma chave paga é exigida pelas cinco ferramentas, mas conferir os termos de cada provedor é por sua conta

Conceitos-chave

01
Plugin
Pacote do Claude Code que pode trazer skills, comandos, hooks e MCPs de uma vez, instalado pelo comando /plugin. Dos cinco, só o Claude Code Setup (marketplace oficial) e o Claude Mem (marketplace próprio) são plugins.
02
Skill
Uma pasta com um SKILL.md que o Claude lê e aplica quando o assunto bate. O Task Observer é uma skill, instalada com npx skills ou copiando a pasta para .claude/skills.
03
MCP
Um servidor que dá ferramentas ao Claude, como ler código por símbolos. O Headroom registra um (o Serena) no seu ~/.claude.json quando você roda o wrap.
04
Gateway e CLI
O OmniRoute é um gateway: um servidor local que recebe o pedido do Claude Code e o encaminha a vários provedores. O Headroom é uma CLI em Python com proxy local. Nenhum dos dois é plugin, e o reel chama tudo de plugin só por conveniência.

Passo a passo

A ordem abaixo é a do vídeo. Instale uma por vez e confira antes de passar à próxima, porque o OmniRoute e o Headroom mexem no caminho do Claude Code e vale saber qual deles causou um problema.

As 5 ferramentas: link e instalação

Nome	Para que serve	Link	Instalação	Testado?
OmniRoute (gateway, MIT)	Um endereço local que encaminha o Claude Code a vários provedores e troca quando um falha	https://github.com/diegosouzapw/OmniRoute	npm install -g omniroute	Comando conferido no README em 20/10/2026. Não executado nesta página
Claude Mem (plugin, Apache-2.0)	Memória entre sessões do Claude Code	https://github.com/thedotmack/claude-mem	npx claude-mem install	Comando conferido no README em 20/10/2026. Não executado nesta página
Headroom (CLI e proxy, Apache-2.0)	Comprime saída de ferramenta, logs e JSON antes do modelo	https://github.com/headroomlabs-ai/headroom	uv tool install --python 3.13 "headroom-ai[all]"	Comando conferido no README em 20/10/2026. Não executado nesta página
Claude Code Setup (plugin oficial, Apache-2.0)	Recomenda hooks, skills, subagentes e MCPs para o seu projeto, só lendo	https://github.com/anthropics/claude-plugins-official/tree/main/plugins/claude-code-setup	/plugin install claude-code-setup@claude-plugins-official	Comando conferido no README em 20/10/2026. Não executado nesta página
Task Observer (skill, CC BY 4.0)	Registra correções e propõe melhorias nas suas skills; você aprova	https://github.com/rebelytics/one-skill-to-rule-them-all	npx skills add rebelytics/one-skill-to-rule-them-all --skill task-observer	Comando conferido no README em 20/10/2026. Não executado nesta página

01
Confirme que o Claude Code funciona antes de tudo
Abra um terminal e confira a versão. Se o comando não existir, instale pelo guia oficial (link em Fontes oficiais) e faça login antes de continuar.
claude --version
02
OmniRoute: instale e suba o servidor local
Autor: diegosouzapw, licença MIT, cerca de 79 mil estrelas no GitHub (out/2026). O comando abaixo instala o pacote global e inicia o servidor, que escuta na porta 20128. Se o npm 11 bloquear o postinstall, o README traz a variante com --allow-scripts. Mantenha o servidor só em localhost: não exponha a porta na rede.
npm install -g omniroute omniroute
03
OmniRoute: conecte um provedor e pegue a chave
Abra o painel em http://localhost:20128/dashboard, conecte ao menos um provedor com a sua própria conta (leia os termos dele antes) e crie ou copie uma chave de API do OmniRoute. O caminho exato de menus não foi conferido nesta página. O painel também tem a tela http://localhost:20128/dashboard/cli-code, onde o README manda escolher a ferramenta, a chave e aplicar a configuração.
http://localhost:20128/dashboard
04
OmniRoute: aponte o Claude Code para ele
Se você já tem ~/.claude/settings.json, não sobrescreva o arquivo: acrescente só a chave env. A URL base não leva /v1 no final. O README da própria ferramenta também descreve a alternativa omniroute run claude, que inicia o Claude Code já apontado. Depois de configurar, teste com uma pergunta simples e confira no painel qual provedor respondeu.
{ "env": { "ANTHROPIC_BASE_URL": "http://localhost:20128", "ANTHROPIC_AUTH_TOKEN": "sk-sua-chave-do-omniroute" } }
05
Claude Mem: instale pelo instalador
Autor: thedotmack, licença Apache-2.0, cerca de 102 mil estrelas (out/2026). O instalador configura tudo e depois pede login por e-mail no navegador (link mágico, sem cartão) e oferece o observer hospedado com trial de 30 dias. Para pular o login, o README diz para passar um --provider explícito ou definir CLAUDE_MEM_ONLINE_OPTIN=false. Não use npm install -g claude-mem: isso instala só a biblioteca, sem os hooks.
npx claude-mem install
06
Claude Mem: alternativa pelo marketplace do Claude Code
Dentro do Claude Code, estes dois comandos fazem a instalação por plugin. Depois, abra uma sessão nova e confira se o plugin aparece em /plugin.
/plugin marketplace add thedotmack/claude-mem /plugin install claude-mem
07
Headroom: instale o comando em Python
Autor: headroomlabs-ai, licença Apache-2.0, cerca de 77 mil estrelas (out/2026). Escolha uma das duas formas do README. O pacote npm headroom-ai é só o SDK em TypeScript e não instala o comando.
uv tool install --python 3.13 "headroom-ai[all]" # ou pip install "headroom-ai[all]"
08
Headroom: rode o Claude Code por dentro do proxy
O wrap inicia o proxy local, instala o Serena e registra o MCP dele só para o projeto atual. Para não registrar o Serena, adicione --code-memory none. Para desfazer, use o headroom unwrap claude, em um comando à parte (veja Como desfazer cada mudança). Em cada sessão, lance o Claude Code pelo wrap para o proxy estar ligado. O comando headroom doctor confere se o roteamento funciona.
headroom wrap claude headroom doctor
09
Claude Code Setup: instale o plugin oficial
Plugin da Anthropic, com licença Apache-2.0 no repositório. Instale dentro do Claude Code e peça as recomendações em uma sessão de um projeto seu. Segundo o README, ele é somente leitura: analisa e recomenda, e não modifica arquivos.
/plugin install claude-code-setup@claude-plugins-official
10
Task Observer: instale a skill e ative
Autor: rebelytics, licença CC BY 4.0 (não é MIT), cerca de 3,5 mil estrelas no repositório (out/2026). Só instalar não basta: o README manda acrescentar ao seu CLAUDE.md a instrução de ativação do arquivo references/environments.md e conferir que a skill roda. Use -g para valer em todos os projetos. Ele não altera as suas skills: em revisão interativa você aprova cada mudança.
npx skills add rebelytics/one-skill-to-rule-them-all --skill task-observer

Como desfazer cada mudança

OmniRoute: apague as chaves ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN do ~/.claude/settings.json (use a cópia que você fez) e pare o servidor. O Claude Code volta a usar o seu login normal
Headroom: rode headroom unwrap claude, que remove o registro do MCP
Claude Mem e Claude Code Setup: gerencie pelo comando /plugin dentro do Claude Code
Task Observer: remova a pasta task-observer de .claude/skills e a instrução de ativação que você acrescentou ao CLAUDE.md

Prompts prontos

Use estes prompts dentro do Claude Code, em um projeto seu. O primeiro é o uso do Claude Code Setup, que o reel mostra: o README traz a frase em inglês, então a versão em inglês vem logo depois, caso a skill não dispare em português. Nenhum prompt tem placeholder para trocar. Todos só leem ou pedem confirmação antes de alterar.

Prompt: recomendar automações para o projeto (Claude Code Setup)

Analise este projeto e recomende de 1 a 2 automações em cada categoria: servidores MCP, skills, hooks, subagentes e slash commands. Só recomende: não altere nenhum arquivo. Para cada item, explique em uma frase por que ele serve para este projeto.

Prompt: recomendar automações (frase do README, em inglês)

recommend automations for this project

Prompt: conferir a memória do Claude Mem

Resuma em até 5 linhas o que você lembra deste projeto de sessões anteriores e diga de onde veio cada lembrança. Se não houver nenhuma memória, diga isso, sem inventar.

Prompt: conferir se o Claude Code está passando pelo OmniRoute

Leia o meu ~/.claude/settings.json e me diga: (1) se ANTHROPIC_BASE_URL e ANTHROPIC_AUTH_TOKEN estão definidos; (2) para qual endereço apontam; (3) como voltar ao login normal. Não edite nenhum arquivo e não mostre o valor completo do token.

Prompt: auditar o que o Headroom registrou

Liste os servidores MCP registrados no meu ~/.claude.json para este projeto e diga quais foram adicionados pelo headroom wrap. Explique como remover cada um. Não altere nada: me mostre o plano e só execute depois do meu ok.

Prompt: revisão de skills com o Task Observer

Ao final desta sessão, liste as correções que eu fiz e as melhorias que você sugere para as minhas skills, uma por item. Não altere nenhuma skill: me mostre cada sugestão e só aplique a que eu aprovar.

Erros comuns

O npm avisa de ERESOLVE ou o postinstall do OmniRoute não roda → o npm 11 pode bloquear scripts de instalação → siga a variante com --allow-scripts do README do OmniRoute e confira o aviso do próprio npm
O Claude Code continua usando o seu login e a cota do plano → o gateway não foi configurado ou o endereço está errado → use http://localhost:20128 sem /v1, confirme que o servidor está de pé e que o token é o do OmniRoute
A resposta não parece vir do Claude → o OmniRoute encaminhou a outro provedor ou modelo → veja no painel qual rota respondeu e remova o gateway se você precisa do Claude
O Claude Mem instalou mas não lembra de nada → foi instalada só a biblioteca com npm install -g, sem os hooks → rode npx claude-mem install ou use os comandos /plugin
O instalador do Claude Mem pediu login e você não queria enviar nada a um serviço hospedado → o fluxo padrão oferece o observer hospedado → reinstale com --provider explícito ou com CLAUDE_MEM_ONLINE_OPTIN=false, conforme o README
Apareceu um MCP novo no ~/.claude.json depois do Headroom → o wrap instala e registra o Serena → use --code-memory none ao rodar o wrap ou desfaça com headroom unwrap claude
O comando headroom não existe depois de npm install headroom-ai → o pacote npm é só o SDK → instale com uv ou pip, como no passo do Headroom
O Task Observer não aparece nas sessões → a skill só com a descrição às vezes não dispara → acrescente ao CLAUDE.md a instrução de ativação do references/environments.md e confira se ela roda

Checklist final

claude --version responde e você está logado
Você fez uma cópia do ~/.claude/settings.json antes de editar
Se usou o OmniRoute: leu os termos do provedor conectado e não envia código ou dados de cliente por ele
O painel do OmniRoute mostra qual provedor respondeu ao seu teste
Você sabe qual é o comando para desfazer cada ferramenta que instalou
O Claude Mem foi instalado com npx claude-mem install ou pelo /plugin, e você decidiu conscientemente entre o observer hospedado e o modo local
O Task Observer tem a instrução de ativação no CLAUDE.md e você revisa cada sugestão antes de aprovar

Perguntas frequentes

As cinco ferramentas são plugins?

Não. Só o Claude Code Setup e o Claude Mem são plugins do Claude Code. O OmniRoute é um gateway, o Headroom é uma CLI com proxy local e o Task Observer é uma skill.

Dá para usar o Claude de graça com o OmniRoute?

Não é isso que o projeto promete. O README descreve uma estimativa agregada de planos gratuitos de terceiros, que você obtém com contas próprias, e que sobe e desce conforme os provedores mudam. Com o Claude Code apontado para o gateway, o modelo que responde pode não ser o Claude.

O Claude Code Setup apaga algo do meu projeto?

Não. O README descreve a skill como somente leitura: ela analisa e recomenda, sem modificar arquivos.

O Task Observer melhora as minhas skills sozinho?

Ele propõe melhorias. Segundo o README, em revisão interativa você aprova cada mudança, e uma revisão agendada aplica as alterações só em cópias separadas.

Fontes oficiais

Próximos passos

Comece agora

Pronto para colocar 5 Plugins do Claude Code: OmniRoute, Headroom e Mais, com os Riscos para rodar?

Ver o OmniRoute no GitHub

Próximo passo

Veja os outros recursos do catálogo

Dezenas de recursos entre squads, skills, apps e integrações — todos usados em produção pelo João.

Voltar ao catálogo

Formação Gestor de IA

Aprenda a montar recursos como este, do zero

Quero ser Gestor de IA

5 Plugins do Claude Code: OmniRoute, Headroom e Mais, com os Riscos

5 Plugins do Claude Code: OmniRoute, Headroom e Mais, com os Riscos

OmniRoute: um endereço, vários provedores

Claude Mem: memória entre sessões

Headroom: menos tokens no caminho

Claude Code Setup: só leitura

Task Observer: você aprova

Pré-requisitos

Conceitos-chave

Plugin

Skill

MCP

Gateway e CLI

Passo a passo

As 5 ferramentas: link e instalação

Confirme que o Claude Code funciona antes de tudo

OmniRoute: instale e suba o servidor local

OmniRoute: conecte um provedor e pegue a chave

OmniRoute: aponte o Claude Code para ele

Claude Mem: instale pelo instalador

Claude Mem: alternativa pelo marketplace do Claude Code

Headroom: instale o comando em Python

Headroom: rode o Claude Code por dentro do proxy

Claude Code Setup: instale o plugin oficial

Task Observer: instale a skill e ative

Como desfazer cada mudança

Prompts prontos

Erros comuns

Perguntas frequentes

Fontes oficiais

Próximos passos

Pronto para colocar 5 Plugins do Claude Code: OmniRoute, Headroom e Mais, com os Riscos para rodar?

Veja os outros recursos do catálogo

Aprenda a montar recursos como este, do zero