HüberClaude

Open source · Linux · feito para o OpenRouter

Duas contas, OpenRouter e z.ai, para gastar menos tokens e ter muito mais poder computacional.

O HüberClaude é um CLI de agente de código no seu terminal. A ideia central não é usar uma chave só: é combinar uma conta OpenRouter (o cérebro, com milhares de modelos) com uma conta z.ai (o enxame de workers baratos que faz o trabalho braçal).

huberclaude
Tela inicial do HüberClaude no terminal
huberclaude
Menu do modo Enxame
huberclaude
Saldo do OpenRouter como marcador de combustível
huberclaude
Seletor de modelos do OpenRouter com preços

# A ideia por trás

A ideia central não é usar uma chave só: é usar duas contas, OpenRouter e z.ai, ao mesmo tempo. Uma conta paga o cérebro e a outra paga o braço, e assim você economiza tokens e ganha muito mais poder computacional. O CLI fala só com esses dois serviços, sem camadas para dezenas de provedores, e por isso é enxuto e fácil de manter.

OpenRouter: o cérebro

Uma única integração dá acesso a milhares de modelos. O seu modelo principal planeja, raciocina e decide.

z.ai: o enxame

Em paralelo, você cadastra a sua segunda conta, a chave de API da z.ai, e ganha um enxame de agentes rápidos e baratos, que trabalham em vários modos: Ferramenta, Agente ou Ambos.

Menos tokens, mais força

Combinar as duas contas economiza os tokens do modelo caro e multiplica o poder de processamento, com até 10 workers trabalhando ao mesmo tempo.

# O que ele faz

Só OpenRouter, sem configurar provedor

Rode /login, cole sua chave e pronto. Sem perfis de provedor, URLs base para ajustar ou comportamentos específicos para aprender.

Todos os modelos, uma chave

Claude, GPT, Gemini, DeepSeek, Qwen, GLM, Kimi e o resto do catálogo, escolhidos no /model com os preços à vista.

Modo Enxame

Até 10 workers baratos da z.ai fazem o trabalho braçal. Seu modelo principal só planeja e decide.

Gasto à vista

O /usage mostra seu saldo no OpenRouter como um marcador de combustível, na escala da sua última recarga.

Um agente completo

Bash, leitura e edição de arquivos, grep, subagentes, tarefas, MCP, skills, hooks e busca na web.

Feito para o terminal Linux

Streaming, comandos de barra, sessões em segundo plano e um visual verde com o mascote H em blocos.

# Como começar

Três comandos e você já está programando com o modelo que quiser.

/login

Cole sua chave

Crie uma chave no OpenRouter e cole no /login. Ela fica salva só para o seu usuário.

huberclaude
Tela de configuração da chave do OpenRouter
/model

Escolha o modelo

Navegue pelo catálogo, filtre por nome e compare contexto e preço por 1M de tokens.

huberclaude
Seletor de modelos do OpenRouter com preços
/enxame

Ligue o enxame (opcional)

Cadastre uma chave da z.ai, escolha o modo e quantos workers rodam ao mesmo tempo.

huberclaude
Menu do modo Enxame

# Enxame: gaste menos tokens

O modelo caro do OpenRouter é o gerente; os workers da z.ai são o enxame. O gerente fica com o planejamento e as decisões finais e distribui o trabalho barato e bem delimitado para modelos GLM flash, lendo de volta só resultados curtos.

  • FerramentaO mais barato: o gerente dispara vários prompts sem estado em paralelo e lê só respostas curtas. Ideal para resumir, extrair, classificar e traduzir.
  • AgenteSubagentes na z.ai com ferramentas: leem e buscam arquivos, rodam um comando ou fazem uma edição pequena.
  • AmbosAs duas opções ficam disponíveis e o gerente escolhe a cada tarefa. É o padrão.

Workers são modelos mais fracos: o gerente confere a saída antes de confiar nela. Nunca coloque segredos no prompt de um worker.

Ilustração: o gerente no OpenRouter distribui prompts para 10 workers da z.ai e recebe resultados curtos
huberclaude
Menu do modo Enxame
/enxame: escolha o modo e quantos workers rodam
huberclaude
Saldo do OpenRouter como marcador de combustível
/usage: seu saldo como um marcador de combustível

# Download para Linux

Já dá para baixar o .deb e o .rpm (v0.31.0). Os demais pacotes estão a caminho; enquanto isso, dá para compilar direto do código-fonte.

.deb Debian · Ubuntu · Mint baixar v0.31.0 .rpm Fedora · openSUSE · RHEL baixar v0.31.0
AppImage Qualquer distro, sem instalar em breve
.tar.gz Binário portátil em breve
Compilar do código-fonte
git clone https://github.com/Leandrodasilvahuber/huberclaude
cd huberclaude
bun install && bun run build
npm install -g .

Precisa de Node.js 22 ou mais novo para rodar e de Bun 1.3.13 ou mais novo para compilar. Depois é só rodar huberclaude dentro do seu projeto.

Acompanhar os lançamentos no GitHub →

Um projeto sem fins lucrativos 💚

O HüberClaude é uma iniciativa sem fins lucrativos, criada para tornar o uso de inteligência artificial mais acessível. Ele é gratuito e open source. Se ele te ajuda, considere apoiar o projeto com uma doação via PIX.

Chave PIX807.998.920-68