Gateway de LLM self-hosted para ferramentas de programação com IA, como Claude Code e Cursor, que encaminha solicitações entre provedores e comprime resultados de ferramentas para reduzir o uso de tokens.
NadirRouter/NadirClaw
Roteador de LLM self-hosted e com código disponível que direciona prompts simples para modelos baratos ou locais e os complexos para modelos premium, por meio de um proxy compatível com OpenAI.
- Estrelas
- 661
- Forks
- 80
- Issues abertas
- 1
- Último commit
- há 4 horas
O que é?
NadirClaw é um proxy local que fica entre ferramentas de programação com IA e provedores de modelos. Cada prompt recebido é classificado em cerca de 10 ms, enviado para a faixa de modelos mais barata com maior probabilidade de respondê-lo e avaliado por um verificador heurístico que detecta recusas, truncamentos e JSON malformado. Se a resposta não passar na verificação, a solicitação é encaminhada para um modelo mais potente. O projeto informa a economia por solicitação em comparação com uma configuração que usa apenas modelos premium.
Ele oferece endpoints compatíveis com OpenAI (/v1/chat/completions) e Anthropic (/v1/messages), para que clientes como Claude Code, Codex, Cursor, Aider, Continue e OpenClaw possam usá-lo alterando a URL base. O Gemini é chamado nativamente pelo Google GenAI SDK, enquanto os demais provedores são acessados pelo LiteLLM. Também há suporte a Ollama e servidores personalizados compatíveis com OpenAI, como vLLM e LM Studio, para modelos locais.
Além do roteamento, o projeto inclui cadeias de fallback para erros 429 e 5xx, fixação do modelo por sessão, filtragem por janela de contexto, compactação de contexto, cache de prompts em memória, alertas de orçamento, dashboards no terminal e na web, exportação de logs em CSV/JSONL e métricas Prometheus. A licença é PolyForm Noncommercial, portanto o código está disponível, mas não é open source.
Recursos principais
- 01Classifica cada prompt em cerca de 10 ms e o direciona para faixas de modelos simples, intermediários ou complexos.
- 02Verifica respostas de modelos baratos com checagens heurísticas e as encaminha para um modelo mais potente quando não passam na validação.
- 03Oferece endpoints compatíveis com OpenAI e Anthropic para ferramentas de programação existentes.
- 04Acessa o Gemini nativamente e outros provedores pelo LiteLLM, incluindo Ollama.
- 05Percorre uma cadeia configurável de modelos quando um provedor retorna erros de limite de requisições ou do servidor.
- 06Informa a economia por solicitação e oferece dashboards no terminal e na web, além de alertas de orçamento.
Casos de uso
- Reduzir os gastos mensais com API de desenvolvedores que usam Claude Code, Cursor ou Codex com prompts de diferentes níveis de dificuldade.
- Executar solicitações simples em um modelo local do Ollama e enviar tarefas difíceis para um modelo na nuvem.
- Oferecer a uma equipe pequena um gateway self-hosted que monitora o uso de modelos e os custos.
- Direcionar uma ferramenta compatível com OpenAI para um endpoint personalizado do vLLM ou LM Studio, junto com modelos na nuvem.
Tópicos
Perguntas frequentes
- O que é NadirClaw?
- Roteador de LLM self-hosted e com código disponível que direciona prompts simples para modelos baratos ou locais e os complexos para modelos premium, por meio de um proxy compatível com OpenAI. NadirClaw é um proxy local que fica entre ferramentas de programação com IA e provedores de modelos. Cada prompt recebido é classificado em cerca de 10 ms, enviado para a faixa de modelos mais barata com maior probabilidade de respondê-lo e avaliado por um verificador heurístico que detecta recusas, truncamentos e JSON malformado. Se a resposta não passar na verificação, a solicitação é encaminhada para um modelo mais potente. O projeto informa a economia por solicitação em comparação com uma configuração que usa apenas modelos premium.
- NadirClaw é gratuito? Qual é a licença?
- NadirClaw é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
- NadirClaw ainda é mantido?
- Manutenção ativa. O último commit de NadirClaw foi em 22 de out. de 2026.
- Para que posso usar NadirClaw?
- Reduzir os gastos mensais com API de desenvolvedores que usam Claude Code, Cursor ou Codex com prompts de diferentes níveis de dificuldade. Executar solicitações simples em um modelo local do Ollama e enviar tarefas difíceis para um modelo na nuvem. Oferecer a uma equipe pequena um gateway self-hosted que monitora o uso de modelos e os custos. Direcionar uma ferramenta compatível com OpenAI para um endpoint personalizado do vLLM ou LM Studio, junto com modelos na nuvem.
- Onde consigo NadirClaw?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/NadirRouter/NadirClaw
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Um roteador de LLM para agentes autônomos que escolhe localmente o modelo mais barato capaz de atender a cada solicitação, com pagamento via carteira cripto em USDC ou chave de API vinculada a cartão de crédito.
Um gateway local de modelos que permite que Claude Code, Codex, OpenCode e outros agentes de programação compartilhem um endpoint e encaminhem solicitações a vários provedores de modelos.
Um gateway local e app de barra de menus que permite usar qualquer modelo de qualquer provedor ou assinatura com Claude Code, Codex, Gemini CLI e outros agentes de programação.
Gateway de LLM open source que encaminha solicitações de agentes e apps de IA para vários provedores de modelos por um único endpoint compatível com a OpenAI.
Gateway em Go que disponibiliza modelos OpenCode Zen e Zen Go pelas APIs Chat Completions, Responses e Anthropic Messages, com pools de chaves e proxies e uma WebUI.