Claude Code Limiter: Limitador de Taxa Auto-Hospedado para Assinaturas Compartilhadas do Claude Code

O Que Resolve

Quando vários desenvolvedores compartilham uma assinatura do Claude Code Max sem controles de uso, um único usuário pode esgotar os limites de taxa da Anthropic enviando muitos prompts (como 50 prompts em uma hora), bloqueando todos os outros pelo dia. Não há uma maneira integrada de evitar isso.

Recursos

• Cotas por modelo — ex.: opus: 5/dia, sonnet: 25/dia, haiku: 50/dia por usuário
• Orçamentos de crédito — orçamento diário único para todos os modelos (opus = 10 créditos, sonnet = 3, haiku = 1). Os usuários decidem como gastá-lo.
• Janelas deslizantes de 24h — sem jogadas de reinício à meia-noite
• Regras por horário do dia — restringe modelos caros para horários de trabalho
• Painel em tempo real — feed de uso ao vivo, detalhamentos por usuário, gráficos de uso
• Interruptor de emergência — revoga instantaneamente o acesso de um usuário e força logout, remotamente
• À prova de adulteração — 6 camadas de segurança incluindo aplicação de managed-settings.json, permissões de arquivo, watchdog de verificação de integridade e rastreamento do lado do servidor

Como Funciona

Configuração:

1. Auto-hospede o servidor — comando único do Docker em qualquer VPS, nuvem ou sua rede
2. Adicione usuários no painel — defina nome, limites, orçamento de crédito → obtenha um código de instalação
3. Instale em cada máquina — sudo npx @howincodes/claude-code-limiter setup --code CLM-xxx --server https://your-server
4. Pronto — o hook verifica limites em cada prompt via managed-settings.json do Claude Code (configuração de maior prioridade, não pode ser sobrescrita por usuários)

Experiência do usuário: Quando um usuário excede seu limite, ele vê: "Limite diário de opus atingido. Usados 5/5 prompts hoje. Todo o uso hoje: opus: 5/5 (0 restantes) sonnet: 12/25 (13 restantes) haiku: 3/50 (47 restantes) Saldo de crédito: 15/100 Mude para outro modelo ou tente novamente mais tarde."

Detalhes Técnicos

• Hook do cliente: zero dependências npm, apenas built-ins do Node.js. Instala no managed-settings.json com allowManagedHooksOnly: true para que usuários não possam adicionar hooks de bypass.
• Servidor: Express + SQLite + painel JS vanilla. Contêiner Docker único, montagem de volume único.
• Capacidade offline: hook armazena limites localmente, funciona quando o servidor está inacessível, sincroniza quando volta online.
• Falha-fechada: se alguém excluir os arquivos de configuração, todos os prompts são bloqueados (não permitidos).

Links

• GitHub: github.com/howincodes/claude-code-limiter
• npm (cliente): @howincodes/claude-code-limiter
• npm (servidor): @howincodes/claude-code-limiter-server
• Docker: ghcr.io/howincodes/claude-code-limiter:latest

Código aberto. Auto-hospedável. Licença MIT.