O que é o Caveman e como essa skill corta tokens no Claude Code?

Tem muita gente pagando token pra ler "Claro! Vou te ajudar com isso, vamos lá:" umas cinquenta vezes por dia

Aí alguém teve a ideia mais absurda possível: e se o agente falasse igual homem das cavernas?

É literalmente isso que o caveman faz, e ele virou assunto no ecossistema do Claude Code por causa de uma promessa bem direta: menos palavra de enrolação, menos token queimado, mesma resposta útil. Se você já esbarrou nesse estilo de prompt que viralizou e ficou só na piada, bora entender o que a skill é de verdade, o que ela faz com a resposta do agente e o que mais vem junto no pacote 🙂

Como o Caveman corta tokens na prática:

O Caveman é um projeto open source criado e mantido por Julius Brussee, e a descrição oficial do repositório não deixa dúvida do tom: "why use many token when few token do trick", uma skill de Claude Code que corta 65% dos tokens fazendo o agente falar como homem das cavernas

Esse número tem uma letra miúda importante: os 65% são sobre tokens de SAÍDA, não sobre o total da sessão

Ou seja, a primeira frente de economia é a resposta do modelo. Seu prompt continua do jeito que você escreveu, o que encolhe é o que volta

E a segunda frente? A compressão de entrada:

O Caveman 2 acrescentou um motor de compressão que ataca o outro lado: ele reduz o que o modelo LÊ (saídas de ferramenta, logs, código, JSON) antes da chamada ao provedor, com recuperação byte-exact

É aqui que a coisa fica interessante pra quem roda sessão longa, porque em refatoração o volume não está no seu texto, está no despejo das ferramentas

O projeto publica um benchmark fixado de 54 execuções no Claude Code: o caveman usou 33,2% menos tokens de entrada reportados pelo provedor que o Claude Code direto, passando nas 18 checagens de resposta exata (18/18)

E se o agente cortar justo o que eu precisava ler?

Boa pergunta, e o projeto pensou nisso

Código, comandos e mensagens de erro são preservados exatamente, byte-for-byte. A compressão mexe no texto em volta, não no que você vai copiar e colar

Além disso a skill volta sozinha pra prosa normal em quatro situações de risco:

• avisos de segurança
• confirmação de ação irreversível
• sequências de vários passos, onde fragmento gera ambiguidade
• quando o usuário está confuso ou repete a pergunta

Esse último é MUITO bom: se você perguntou de novo, o agente entende que o telegrama não colou e destrava o modo normal

Os seis níveis do Caveman: lite, full, ultra e os modos wenyan

Não é liga e desliga, é um dial. São seis níveis de intensidade, com o full como padrão

A troca de nível é por comando ou por frase natural mesmo:

/caveman lite|full|ultra|wenyan-lite|wenyan-full|wenyan-ultra|off

E pra desligar você também pode simplesmente falar stop caveman ou normal mode, sem decorar sintaxe

Repara na lógica: o lite é o modo "tira a gordura", o full é o modo "fala comigo como adulto ocupado" e o ultra é o modo "não quero ler, quero o resultado"

Quais comandos e subagentes vêm junto com a skill

Aqui está a parte que quase ninguém comenta: o caveman não é UMA skill, é um pacote

Além da principal, o plugin traz caveman-commit, caveman-review, caveman-compress, caveman-stats e caveman-help

• caveman-commit: gera mensagem de commit ultracomprimida em Conventional Commits, com assunto de no máximo 50 caracteres e corpo só quando o "porquê" não é óbvio
• caveman-review: devolve comentário de revisão de código em uma linha cada, no formato local, problema, correção
• caveman-compress: comprime arquivos de memória em linguagem natural (o clássico CLAUDE.md) pro formato caveman, preservando substância técnica, código, URLs e estrutura, e salvando um backup legível como FILE.original.md
• caveman-stats: mostra uso real de tokens e economia estimada da sessão atual
• caveman-help: cartão de referência rápida dos modos, skills e comandos

Esse caveman-compress conversa direto com uma dor bem conhecida de quem deixou o arquivo de instruções virar enciclopédia. Se o seu caso é aquele de skill grande demais no Claude Code, a lógica é a mesma: o custo é fixo e ele te cobra em TODO turno

E os subagentes?

O repositório inclui uma pasta de skills chamada skills/cavecrew, com presets comprimidos de subagentes

Tem também o caveman learn, que abre o próprio agente com a skill caveman-learn: ele propõe cada correção como diff, aplica só com o seu "sim", remede depois e reverte automaticamente o que não baixou token por turno

Gostei bastante dessa parte, porque é o oposto do "confia em mim": se a mudança não mediu melhor, ela volta atrás

O relatório do caveman mostra o Cave Score, os sinks de token ranqueados com uma correção por linha, a profundidade de uso da janela de contexto por sessão e uma ilustração de custo a preço de tabela em 30 dias

E ainda existe o caveman wrap, que embrulha o agente e roteia o tráfego do provedor por um proxy local movido pelo Caveman Engine, com recuperação byte-exact

Como instalar o Caveman no Claude Code

No Claude Code a instalação é pelo marketplace de plugins, em dois comandos

1. Adicione o marketplace do projeto:

/plugin marketplace add JuliusBrussee/caveman

2. Instale o plugin:

/plugin install caveman@caveman

3. Se preferir fazer tudo pelo terminal, os equivalentes são estes:

claude plugin marketplace add JuliusBrussee/caveman
claude plugin install caveman@caveman

4. Tome cuidado com o erro mais comum daqui: achar que o marketplace do Claude Code serve pra qualquer agente. Não serve. Pra Codex, Cursor, Windsurf e Cline a rota é via npx, trocando o perfil do agente no final:

npx skills add JuliusBrussee/caveman --skill '*' -a codex --yes

5. E pro Gemini CLI a instalação é por extensão:

gemini extensions install https://github.com/JuliusBrussee/caveman

A versão mais recente publicada é a v2.1.0, de 16/08/2026, então você não está instalando um protótipo de fim de semana

O que aparece quando você liga o Caveman de verdade

Quando testei, instalei escolhendo quais skills do repositório eu queria e mandei copiar pra todos os agentes, com opção de instalar no projeto ou global (fui de global, faz mais sentido pro meu uso)

Pra comparar direito eu fiz o mesmo pedido várias vezes trocando o nível: explicar função recursiva em JavaScript

No nível mais leve a resposta veio só um pouco mais enxuta que o normal, e totalmente compreensível

No intermediário a coisa mudou de cara: a mesma definição saiu cortada em telegrama, sem frase completa

No mais agressivo virou quase abreviatura, com palavra cortada no meio. Esse nível eu não usaria pra pedir EXPLICAÇÃO, só pra mandar o modelo programar

Testei o modo wenyan também e o contraponto se confirmou na hora: o código continuou legível, mas a explicação ficou incompreensível pra quem não lê chinês haha

Outra coisa que reparei: conforme eu aumentava a intensidade, as respostas foram ficando mais rápidas

Aí fui pro teste que importa. Pedi pro Claude Code criar um projeto de notas no modo mais agressivo que eu ainda entendo, mandei executar e testei a aplicação criando uma nota

Funcionou, sem bug e sem erro no prompt inicial

Durante a execução, até as microinterações e os comentários do agente saíram no estilo cortado, o que pra mim é a skill agindo na prática e não só uma frase bonita no README

E o que importa ficou de pé: código e URLs seguiram intactos, ela mexe só no texto de enrolação em volta

Agora a parte honesta: eu tentei fechar a conta ali mesmo, comparando consumo antes e depois, e não consegui. Por estar na assinatura, o consumo não apareceu pra mim, então NÃO fechei a comparação de economia

O caminho pra medir existe dentro do próprio pacote (o caveman-stats mostra tokens da sessão e economia estimada), mas o número eu deixo como dever de casa pra quem for testar

No vídeo abaixo eu mostro isso em movimento: as respostas mudando de forma nível por nível, o modo wenyan quebrando a explicação e o projeto de notas sendo criado e rodado no modo agressivo

Para quem o Caveman vale a pena (e em que sessão a economia aparece)

O ganho não é igual pra todo mundo, e vale ser sincero sobre isso

Sessão longa de refatoração: é onde mais aparece. Muita saída de ferramenta, muito log, muito JSON passando pelo contexto, e é exatamente esse tráfego que o motor de compressão de entrada ataca antes da chamada ao provedor

Quem paga por token via API ou esbarra em limite de uso: aqui cada bloco de gentileza cortado é dinheiro ou tempo de espera. O corte de saída declarado pelo projeto é de 65%

Repositório grande com CLAUDE.md inchado: o caveman-compress existe justamente pra isso, e o backup em FILE.original.md te deixa voltar atrás sem drama

Quem usa vários agentes: além do Claude Code, o caveman instala em Codex, Cursor, Windsurf, Cline e Gemini CLI. Você não amarra o hábito a uma ferramenta só

E quando NÃO vale?

Quando o texto é o produto

Se você está APRENDENDO um conceito, quer explicação passo a passo ou vai colar aquela resposta num PR pra outra pessoa ler, a prosa completa ajuda mais do que atrapalha

Nesses casos o lite já resolve, ou você simplesmente manda normal mode e segue a vida =)

Conclusão

O caveman é uma troca bem definida: você entrega verbosidade e recebe token de volta

O que segura a barra são as salvaguardas, que não são detalhe: código, comandos e mensagens de erro ficam byte-for-byte exatos, e a skill volta pra prosa normal em aviso de segurança, confirmação de ação irreversível, sequência de vários passos e quando você repete a pergunta

Se for testar, sugiro o caminho mais simples: instale, rode uma sessão inteira no full, olhe o caveman-stats e só depois decida se puxa pro lite ou pro ultra conforme o incômodo

E se você desconfia que é só meme de internet, olha a tração: o repositório segue em manutenção ativa em agosto de 2026, com versão publicada recente. Não é experimento abandonado

A parte que ninguém fecha por você é quanto economiza no SEU fluxo. Faça o teste e me conta…

até o próximo post!