decolua--9router/i18n/README.pt-BR.md

9Router — roteador de IA GRATUITO e economizador de tokens

Nunca pare de codificar. Economize 20-40% de tokens com RTK + fallback automático para modelos de IA GRATUITOS e baratos.

Conecte todas as ferramentas de código de IA (Claude Code, Cursor, Antigravity, Copilot, Codex, Gemini, OpenCode, Cline, OpenClaw...) a mais de 40 provedores de IA e mais de 100 modelos.

🚀 Início rápido • 💡 Recursos • 📖 Configuração • 🌐 Site

🇺🇸 English • 🇻🇳 Tiếng Việt • 🇨🇳 中文 • 🇯🇵 日本語 • 🇷🇺 Русский • 🇹🇭 ไทย • 🇮🇷 فارسی • 🇮🇩 Indonesia

---

🤔 Por que 9Router?

Pare de desperdiçar dinheiro, tokens e atingir limites:

• ❌ A cota de assinatura expira sem ser utilizada todos os meses
• ❌ Os limites de requisições interrompem você durante a programação
• ❌ Saídas de ferramentas (git diff, grep, ls...) consomem tokens rapidamente
• ❌ APIs caras ($20–50/mês por provedor)
• ❌ Troca manual entre provedores

9Router resolve isso:

• ✅ RTK Token Saver - Compactação automática do conteúdo de tool_result, economize 20-40% de tokens por solicitação
• ✅ Maximize as assinaturas - Rastreie a cota, aproveite toda a cota antes da renovação
• ✅ Auto fallback - Assinatura → Econômico → Gratuito, sem tempo de inatividade
• ✅ Múltiplas contas - Round-robin entre contas por provedor
• ✅ Universal - Funciona com Claude Code, Codex, Cursor, Cline, qualquer ferramenta CLI

---

🔄 Como funciona

┌─────────────┐
│  Sua CLI   │  (Claude Code, Codex, OpenClaw, Cursor, Cline...)
│   Ferramenta│
└──────┬──────┘
       │ http://localhost:20128/v1
       ↓
┌─────────────────────────────────────────────┐
│           9Router (Roteador inteligente)            │
│  • RTK Token Saver (reduz tokens de `tool_result`) │
│  • Tradução de formatos (OpenAI ↔ Claude)     │
│  • Acompanhamento de cotas                           │
│  • Renovação automática de token                       │
└──────┬──────────────────────────────────────┘
       │
       ├─→ [Nível 1: ASSINATURA] Claude Code, Codex, GitHub Copilot
       │   ↓ cota esgotada
       ├─→ [Nível 2: ECONÔMICO] GLM ($0.6/1M), MiniMax ($0.2/1M)
       │   ↓ limite de orçamento
       └─→ [Nível 3: GRATUITO] Kiro, OpenCode Free, Vertex ($300 em créditos)

Resultado: programe sem interrupções, com custo mínimo e economia de 20% a 40% dos tokens via RTK

---

⚡ Início rápido

1. Instale globalmente:

npm install -g 9router
9router

🎉 O painel abre em http://localhost:20128

2. Conecte um provedor GRATUITO (sem necessidade de inscrição):

Painel → Provedores → Conecte Kiro AI (~50 créditos/mês grátis: Claude 4.5 + GLM-5 + MiniMax) ou OpenCode Free (sem autenticação) → Pronto!

3. Use em sua ferramenta CLI:

Configurações do Claude Code/Codex/OpenClaw/Cursor/Cline:
  Endpoint: http://localhost:20128/v1
  API Key: [copie do painel]
  Model: kr/claude-sonnet-4.5

É isso aí! Comece a codificar com modelos de IA GRATUITOS.

Alternativa: executar a partir do código-fonte (este repositório):

Este pacote de repositório é privado (9router-app), portanto, a execução pelo código-fonte/Docker é o caminho de desenvolvimento local esperado.

cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev

Modo de produção:

npm run build
PORT=20128 HOSTNAME=0.0.0.0 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run start

URLs padrão:

• Painel: http://localhost:20128/dashboard
• API compatível com OpenAI: http://localhost:20128/v1

---

Guias de vídeo

🇻🇳 Tiếng Việt Tiết kiệm chi phí LLM cho OpenClaw no 9Router por Mì AI	🇵🇰 اردو / हिन्दी 9Router + Claude Code Configuração ilimitada GRATUITA por Construir IA com Hamid	🇺🇸 Inglês 9Router + Claude Code Configuração GRATUITA por Construir IA com Hamid	🇺🇸 Inglês 9Router + Claude Code Configuração GRATUITA por Construir IA com Hamid	🇺🇸 Inglês Claude Code FREE Forever - Modelos ilimitados por Construa IA com Hamid
🇺🇸 Inglês Configuração gratuita Claude CLI com 9Router 🚀 por CodeVerse Soban	🇻🇳 Tiếng Việt Cài Đặt OpenClaw Free Từ A-Z + 9Router por Mai Gia	🇺🇸 Inglês FREE OpenClaw + Claude Opus 4.6 por Construir IA com Hamid	🇮🇩 Indonésia Koding 24 Jam Anti Rate Limit! Hemat Token AI 65% | Tutorial Configuração Rápida 9Router 🚀 por Krisswuh	🇮🇩 Indonésia Cara Implante 9Router no Hugging Face GRATUITAMENTE sem parar! | Alternativa VPS RAM 16GB por Krisswuh
🇮🇷 Persa-فارسی این شکلی از هر API ای استفاده کن برای هوش مصنوعی por Matin SenPai	🇻🇳 Tiếng Việt Hướng Dẫn Setup OpenClaw + 9Router: Tạo Bot Zalo AI Tự Động Từ A-Z por tuanminhhole

🎬 Fez um vídeo sobre o 9Router? Envie um Pull Request adicionando seu vídeo a esta seção - nós o mesclaremos!

---

🛠️ Ferramentas CLI suportadas

9Router funciona perfeitamente com todas as principais ferramentas de codificação de IA:

Código-Claude	OpenClaw	Codex	OpenCode	Cursor	antigravidade
Cline	Continuar	Droid	Roo	Copilot	Código Kilo
OpenDesign	jcódigo	Grok Build	Devin CLI	DeepSeek TUI	Código Qwen

---

🌐 Provedores compatíveis

🔐 Provedores OAuth

Código-Claude

antigravidade

Codex

GitHub

Cursor

Kimchi

🆓 Provedores gratuitos

Kiro AI Claude 4.5 + GLM-5 + MiniMax 50 créditos/mês grátis

OpenCode grátis Sem autenticação • Modelos de busca automática Grátis (a lista de modelos varia)

Vertex AI Gemini 3 Pro + GLM-5 + DeepSeek $300 créditos grátis

Observação: Os níveis gratuitos iFlow, Qwen Code e Gemini CLI foram descontinuados em 2026. Em vez disso, use Kiro / OpenCode Free / Vertex.

Kiro AI mudou para um modelo pago em setembro de 2025 — o nível gratuito agora é limitado a 50 créditos/mês (mais 500 créditos de avaliação para novas contas nos primeiros 30 dias). Camadas pagas: Pro $20/mo (1.000 créditos), Pro+ $40/mo (2.000), Pro Max $100/mo (5.000), Power $200/mo (10.000). A lista de modelos OpenCode Free varia com o tempo (alguns modelos são gratuitos apenas para promoções limitadas) — sujeito a alterações sem aviso prévio. Vertex AI: o crédito gratuito $300 para novas contas do GCP ainda é válido, mas desde março de 2026 o endpoint da API Gemini não consome mais esses créditos. Em vez disso, chame o endpoint Vertex AI Studio.

🔑 Provedores de chaves de API (40+)

OpenRouter	GLM	Kimi	MiniMax	OpenAI	Antrópico
Gemini	DeepSeek	Groq	xAI	Mistral	Perplexidade
Juntos AI	Fogos de artifício	Cerebras	Cohere	NVIDIA	SiliconFlow

...e mais de 20 provedores, incluindo Nebius, Chutes, Hyperbolic e endpoints personalizados compatíveis com OpenAI/Anthropic

🏠 Provedores auto-hospedados

Para fala e incorporações veiculadas em sua própria máquina — whisper.cpp, faster-whisper, Speaches, Kokoro-FastAPI, openai-speech, llama.cpp/llama-server, vLLM, Infinity, text-embeddings-inference ou qualquer outro serviço compatível com o formato OpenAI.

Provedor	Ponto final usado	Servidor típico
STT auto-hospedado	/v1/audio/transcriptions	whisper.cpp, faster-whisper
TTS auto-hospedado	/v1/audio/speech	Kokoro-FastAPI, openedai-speech
Incorporação auto-hospedada	/v1/embeddings	llama-server, vLLM, Infinity

Todos os outros provedores de voz são um serviço de nuvem nomeado com um endpoint fixo. Estes três leem seus endereços de cada conexão, para que um provedor possa apontar para várias máquinas e balanceamento de carga entre elas como qualquer outra.

Defina-o na conexão como providerSpecificData.baseUrl:

Provedor	Informe	Resultado
STT auto-hospedado	o URL completo — http://host:8080/v1/audio/transcriptions	usado como está
TTS auto-hospedado	a raiz do servidor — http://host:8880	+ /v1/audio/speech
Incorporação auto-hospedada	a base OpenAI, /v1 incluída — http://host:8080/v1	+ /embeddings

Cuidado com /v1 em embeddings. O adaptador anexa /embeddings, então http://host:8080 resolve para http://host:8080/embeddings e perde o rota OpenAI – o llama-server responde 501. Dê a ele o mesmo URL base de um OpenAI o cliente usaria. Um .../v1/embeddings completo também é aceito, então um valor colado de um exemplo curl também funciona.

A chave API não é verificada pela maioria dos servidores locais, mas o campo não deve estar vazio: é o que dá à conexão um registro de credenciais, e baseUrl reside lá. Qualquer espaço reservado funciona.

A incorporação auto-hospedada não tem fallback na nuvem por design — uma conexão salva sem um baseUrl é relatado como um erro de configuração, em vez de silenciosamente voltando para api.openai.com, que enviaria seu texto de entrada e chave de API para terceiros por meio de um provedor chamado "Auto-hospedado".

---

💡 Principais recursos

Recurso	O que faz	Por que é importante
🚀 RTK Token Saver (RTK ⭐40K)	Compactar saídas de ferramentas (git diff, grep, ls, tree...) antes de enviar para LLM	Economize 20-40% de tokens de entrada por solicitação
🧠 Headroom Token Saver (Headroom)	Proxy /v1/compress externo opcional antes do roteamento do provedor	Economize mais tokens de contexto sem alterar clientes
🪨 Modo Caveman (Caveman ⭐52K)	Injetar prompt de fala do homem das cavernas → Respostas do LLM concisas, substância técnica preservada	Economize até 65% de tokens de produção
🐴 Ponytail (Ponytail)	Injetar prompt "lazy senior dev" → LLM escreve código mínimo YAGNI primeiro (Lite/Full/Ultra)	Menos tokens de saída, menos refatoração
🎯 Fallback inteligente de 3 camadas	Rota automática: Assinatura → Barato → Grátis	Nunca pare de codificar, tempo de inatividade zero
📊 Acompanhamento de cotas em tempo real	Contagem de tokens ao vivo + contagem regressiva de redefinição	Maximizar o valor da assinatura
🔄 Tradução de formato	OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro ↔ Vertex	Funciona com qualquer ferramenta CLI
👥 Suporte para múltiplas contas	Várias contas por provedor	Balanceamento de carga + redundância
🔄 Atualização automática de token	Os tokens OAuth são atualizados automaticamente	Não é necessário fazer novo login manual
🎨 Combos Personalizados	Crie combinações ilimitadas de modelos	Adapte o fallback às suas necessidades
📝 Registro de requisições	Modo de depuração com logs completos de solicitação/resposta	Solucione problemas facilmente
💾 Sincronização na nuvem	Sincronizar configuração entre dispositivos	Mesma configuração em todos os lugares
📊 Análise de uso	Acompanhe tokens, custos e tendências ao longo do tempo	Otimizar gastos
🌐 Implante em qualquer lugar	Localhost, VPS, Docker, Cloudflare Workers	Opções flexíveis de implantação

Configure X-9Router-Token-Saver: off para ignorar todos os economizadores de tokens para uma solicitação de chat.

📖 Detalhes do recurso

🚀 RTK Token Saver

As saídas da ferramenta (git diff, grep, find, ls, tree, despejos de log...) geralmente consomem de 30 a 50% do seu orçamento de contexto. O RTK os detecta e aplica compactação inteligente e sem perdas antes que a solicitação chegue ao LLM:

• Filtros: git-diff, git-status, grep, find, ls, tree, dedup-log, smart-truncate, read-numbered, search-list
• Detecção automática: Não é necessária configuração — o RTK inspeciona o primeiro 1 KB de cada tool_result e escolhe o filtro correto.
• Seguro por design: Se um filtro falhar, gerar uma exceção ou aumentar a saída, o RTK mantém silenciosamente o texto original. Erros nunca interrompem sua solicitação.
• Universal: Funciona em todos os formatos (OpenAI, Claude, Gemini, Cursor, Kiro, OpenAI Responses) porque é executado antes de qualquer tradução de formato.
• Padrão ATIVADO: Alterne a qualquer momento em Painel → Configurações de endpoint.

Sem RTK: 47 mil tokens enviados ao LLM
Com RTK: 28 mil tokens enviados ao LLM (40% de economia · mesmo contexto · mesma resposta)

🧠 Headroom Token Saver

O headroom é opcional e funciona separadamente. 9Router chama o endpoint /v1/compress local do Headroom e, em seguida, mantém roteamento normal, fallback, autenticação e rastreamento de uso:

Cliente → 9Router → Headroom /v1/compress → 9Router → provedor

Configuração local:

pip install "headroom-ai[proxy]"
headroom proxy --port 8787

Habilite em Painel → Endpoint → Economia de tokens → Headroom. URL padrão: http://localhost:8787.

Exemplos de Docker:

# Serviço Headroom na mesma rede Docker
http://headroom:8787

# Headroom em execução na máquina host
http://host.docker.internal:8787

Se o Headroom estiver inativo ou retornar um erro, o o 9Router seguirá em modo aberto e enviará a solicitação original.

🐴 Ponytail (desenvolvedor sênior preguiçoso)

O Ponytail injeta um prompt do sistema "lazy senior dev" em cada solicitação, direcionando o LLM para o código mínimo, primeiro YAGNI - preferindo exclusão a adição, stdlib sobre novos deps, one-liners sobre abstrações. Adaptado de DietrichGebert/ponytail.

• Lite — Construa o que for solicitado, nomeie a alternativa mais preguiçosa.
• Full — escada YAGNI aplicada: stdlib → nativo → dependências existentes → one-liner → código mínimo.
• Ultra — Extremista YAGNI: exclua primeiro, envie a linha única, desafie o restante do requisito na mesma resposta.

Sem Ponytail: código verboso, abstrações extras e estrutura "por precaução"
Com Ponytail: menor diff funcional, sem abstrações não solicitadas e menos tokens

Nunca negocie: validação de entrada, tratamento de erros que evita perda de dados, segurança, acessibilidade ou qualquer coisa explicitamente solicitada. Ative em Painel → Endpoint → Ponytail. Pode ser combinado com Caveman (concisão de saída) e RTK (compressão de entrada).

🎯 Fallback inteligente de 3 camadas

Crie combos com fallback automático:

Combo: "my-coding-stack"
  1. cc/claude-opus-4-6        (sua assinatura)
  2. glm/glm-4.7               (backup econômico, $0,60/1M)
  3. if/kimi-k2-thinking       (fallback gratuito)

→ Alterna automaticamente quando a cota acaba ou ocorre um erro

📊 Rastreamento de cotas em tempo real

• Consumo de token por provedor
• Redefinir contagem regressiva (5 horas, diariamente, semanalmente)
• Estimativa de custos para níveis pagos
• Relatórios mensais de gastos

🔄 Tradução de formato

Tradução perfeita entre formatos:

• OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro ↔ Vertex ↔ Antigravity ↔ Ollama ↔ OpenAI Responses
• Sua ferramenta CLI envia formato OpenAI → 9Router traduz → Provedor recebe formato nativo
• Funciona com qualquer ferramenta que suporte endpoints OpenAI personalizados

👥 Suporte para múltiplas contas

• Adicione várias contas por provedor
• Round-robin automático ou roteamento baseado em prioridade
• Fallback para a próxima conta quando uma delas atingir a cota

🔄 Atualização automática de token

• Os tokens OAuth são atualizados automaticamente antes da expiração
• Não é necessária reautenticação manual
• Experiência perfeita em todos os provedores

🎨 Combos Personalizados

• Crie combinações ilimitadas de modelos
• Combine níveis de assinatura, baratos e gratuitos
• Nomeie seus combos para facilitar o acesso
• Compartilhe combos entre dispositivos com Cloud Sync

📝 Registro de requisições

• Habilite o modo de depuração para logs completos de solicitação/resposta
• Rastreie chamadas de API, cabeçalhos e payloads
• Solucionar problemas de integração
• Exportar logs para análise

💾 Sincronização na nuvem

• Sincronize provedores, combos e configurações entre dispositivos
• Sincronização automática em segundo plano
• Armazenamento criptografado seguro
• Acesse sua configuração de qualquer lugar

Notas de tempo de execução na nuvem

• Prefira variáveis de nuvem do lado do servidor na produção:
  • BASE_URL (URL interna de callback usado pelo agendador de sincronização)
  • CLOUD_URL (base de endpoint de sincronização em nuvem)
• NEXT_PUBLIC_BASE_URL e NEXT_PUBLIC_CLOUD_URL ainda são suportados para compatibilidade/UI, mas o tempo de execução do servidor agora prioriza BASE_URL/CLOUD_URL.
• As solicitações de sincronização na nuvem agora usam o comportamento de tempo limite + falha rápida para evitar o travamento da interface do usuário quando o DNS/rede da nuvem estiver indisponível.

📊 Análise de uso

• Rastreie o uso de token por provedor e modelo
• Estimativa de custos e tendências de gastos
• Relatórios e insights mensais
• Otimize seus gastos com IA

💡 IMPORTANTE - Compreendendo os custos do painel:

O "custo" exibido no Usage Analytics é apenas para fins de rastreamento e comparação. O próprio 9Router nunca cobra nada. Você paga apenas aos provedores diretamente (se usar serviços pagos).

Exemplo: Se o seu painel mostrar "Custo total $290" ao usar modelos gratuitos do Kiro, isso representa o que você pagaria usando APIs pagas diretamente. Seu custo real = $0 (nível gratuito do Kiro: ~50 créditos/mês).

Pense nisso como um "rastreador de economia" que mostra quanto você está economizando usando modelos gratuitos ou roteamento através do 9Router!

🌐 Implante em qualquer lugar

• 💻 Localhost - Padrão, funciona offline
• ☁️ VPS/Cloud - Compartilhe entre dispositivos
• 🐳 Docker – Implantação com um comando
• 🚀 Cloudflare Workers - Rede global de edge

---

💰 Visão geral dos preços

Nível	Provedor	Custo	Redefinição de cota	Melhor para
🚀 ECONOMIA DE TOKEN	RTK (integrado)	GRÁTIS	Sempre ligado	Economize 20-40% de tokens em CADA solicitação
💳 ASSINATURA	Claude Code (Pro/Max)	$20-200/mo	5h + semanalmente	Já inscrito
	Codex (Plus/Pro)	$20-200/mo	5h + semanalmente	Usuários OpenAI
	GitHub Copilot	$10-19/mo	Mensalmente	Usuários do GitHub
	Cursor IDE	$20/mo	Mensalmente	Usuários de cursor
💰 BARATO	GLM-5.1/GLM-4.7	$0.6/1M	Diariamente 10h	Backup de orçamento
	MiniMax M2.7	$0.2/1M	Rolamento de 5 horas	Opção mais barata
	Kimi K2.5	$9/mo plano	10 milhões de tokens/mês	Custo previsível
🆓 GRÁTIS	Kiro AI	$0	50 créditos/mês	Claude 4.5 + GLM-5 + MiniMax grátis (níveis pagos acima)
	OpenCode Free	$0	Varia*	Sem autenticação, modelos de busca automática (a lista muda ao longo do tempo)
	Vertex AI	Créditos $300	Novas contas do GCP	Gemini 3 Pro + DeepSeek + GLM-5 (use o endpoint Vertex AI Studio para obter créditos gratuitos)

💡 Dica profissional: combinação RTK + Kiro AI + OpenCode grátis = custo $0 + economia de token de 20-40%!

---

📊 Compreendendo os custos e faturamento do 9Router

Como funciona o faturamento do 9Router:

✅ Software 9Router = GRATUITO para sempre (código aberto, nunca cobra)
✅ Painel "custos" = Somente exibição/rastreamento (não são cobranças reais)
✅ Você paga diretamente aos provedores (assinaturas ou taxas de API)
✅ Provedores GRATUITOS permanecem GRATUITOS (Kiro ~50 créditos/mês, OpenCode Free, créditos do Vertex $300 = $0 dentro dos limites do nível gratuito) — observe que os níveis gratuitos do iFlow/Qwen/Gemini CLI foram descontinuados em 2026 ❌ 9Router nunca envia faturas ou cobra seu cartão

Como funciona a exibição de custos:

O painel mostra custos estimados como se você estivesse usando APIs pagas diretamente. Isto não é cobrança - é uma ferramenta de comparação para mostrar suas economias.

Cenário de exemplo:

Exibição no painel:
• Total de requisições: 1,662
• Total de tokens: 47M
• Custo exibido: $290

Custo real:
• Provedor: Kiro (nível gratuito: ~50 créditos/mês)
• Pagamento real: $0.00
• O que $290 significa: valor ECONOMIZADO ao usar modelos gratuitos!

Regras de pagamento:

• Provedores de assinatura (Claude Code, Codex): pague diretamente por meio de seus sites
• Provedores baratos (GLM, MiniMax): pague diretamente, 9Router apenas roteia
• Provedores GRATUITOS (iFlow, Kiro, Qwen): Genuinamente grátis para sempre, sem taxas ocultas
• 9Router: Nunca cobra nada

---

🎯 Casos de uso

Caso 1: "Tenho assinatura do Claude Pro"

Problema: A cota expira sem ser utilizada, limites de taxa durante codificação pesada

Solução:

Combo: "maximize-claude"
  1. cc/claude-opus-4-7        (use toda a assinatura)
  2. glm/glm-5.1               (backup econômico quando a cota acabar)
  3. kr/claude-sonnet-4.5      (fallback gratuito de emergência)

Custo mensal: $20 (assinatura) + ~$5 (backup) = $25 total
versus $20 + atingir limites = frustração

Caso 2: "Quero custo zero"

Problema: Não posso pagar assinaturas, preciso de codificação de IA confiável

Solução:

Combo: "free-forever"
  1. kr/claude-sonnet-4.5      (Claude 4.5 gratuito via Kiro, ~50 créditos/mês)
  2. kr/glm-5                  (GLM-5 gratuito via Kiro)
  3. oc/<auto>                 (OpenCode Free, sem autenticação)

Custo mensal: $0
Qualidade: modelos prontos para produção + economia de 20–40% com RTK

Caso 3: "Preciso de codificação 24 horas por dia, 7 dias por semana, sem interrupções"

Problema: Prazos, não podemos arcar com o tempo de inatividade

Solução:

Combo: "always-on"
  1. cc/claude-opus-4-7        (melhor qualidade)
  2. cx/gpt-5.5                (segunda assinatura)
  3. glm/glm-5.1               (econômico, renova diariamente)
  4. minimax/MiniMax-M2.7      (mais econômico, renovação em 5h)
  5. kr/claude-sonnet-4.5      (gratuito via Kiro, ~50 créditos/mês)

Resultado: 5 camadas de fallback = nenhuma interrupção
Custo mensal: $20-200 (subscriptions) + $10-20 (backup)

Caso 4: "Quero IA GRATUITA no OpenClaw"

Problema: Precisa de assistente de IA em aplicativos de mensagens (WhatsApp, Telegram, Slack...), totalmente gratuito

Solução:

Combo: "openclaw-free"
  1. kr/claude-sonnet-4.5      (Claude 4.5 gratuito)
  2. kr/glm-5                  (GLM-5 gratuito)
  3. kr/MiniMax-M2.5           (MiniMax gratuito)

Custo mensal: $0
Acesso por: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...

---

❓ Perguntas frequentes

📊 Por que meu painel mostra custos altos?

O painel rastreia o uso do token e exibe custos estimados como se você estivesse usando APIs pagas diretamente. Este não é faturamento real - é uma referência para mostrar quanto você está economizando usando modelos gratuitos ou assinaturas existentes através do 9Router.

Exemplo:

• O painel mostra: "Custo total $290"
• Realidade: Você está usando modelos gratuitos do Kiro (~50 créditos/mês)
• Seu custo real: $0.00
• O que significa $290: Valor que você economizou usando modelos gratuitos em vez de APIs pagas!

A exibição de custos é um "rastreador de economia" para ajudá-lo a entender seus padrões de uso e oportunidades de otimização.

💳 Serei cobrado pelo 9Router?

Não. 9Router é um software gratuito e de código aberto que roda em seu próprio computador. Nunca cobra nada.

Você só paga:

• ✅ Provedores de assinatura (Claude Code $20/mo, Codex $20-200/mo) → Pague-os diretamente em seus sites
• ✅ Provedores baratos (GLM, MiniMax) → Pague diretamente, 9Router apenas encaminha suas solicitações
• ❌ 9Router em si → Nunca carrega nada, nunca

9Router é um proxy/roteador local. Não possui cartão de crédito, não pode enviar faturas e não possui sistema de cobrança. É um software totalmente gratuito.

🆓 Os provedores GRATUITOS são realmente ilimitados?

Principalmente! Os provedores GRATUITOS atuais (Kiro, OpenCode Free, Vertex) são genuinamente gratuitos, mas os níveis gratuitos têm limites:

Estes são serviços gratuitos oferecidos pelas respectivas empresas:

• Kiro AI: ~50 créditos/mês grátis (mais 500 créditos de avaliação para novas contas nos primeiros 30 dias) via AWS Builder ID / Google / GitHub OAuth. Níveis pagos disponíveis acima disso.
• OpenCode Free: proxy de passagem sem autenticação, modelos buscados automaticamente em opencode.ai/zen/v1/models. A lista de modelos gratuitos varia com o tempo (alguns modelos são gratuitos apenas para promoções limitadas) — sujeita a alterações sem aviso prévio.
• Vertex AI: créditos gratuitos $300 para novas contas do Google Cloud (90 dias). Desde março de 2026, o endpoint da API Gemini não consome mais esses créditos. Em vez disso, use o endpoint Vertex AI Studio.

O 9Router apenas encaminha suas solicitações para eles - não há pegadinhas ou cobrança futura do próprio 9Router. Eles são serviços verdadeiramente gratuitos e o 9Router os torna fáceis de usar com suporte alternativo.

Níveis gratuitos descontinuados (não mais recomendados):

• ❌ iFlow: era gratuito e ilimitado, agora alterado para pago (2026)
• ❌ Qwen Code: nível OAuth gratuito totalmente descontinuado pelo Alibaba em 15/04/2026
• ❌ Gemini CLI: Serviço totalmente encerrado pelo Google em 18/06/2026 (substituído pelo Antigravity CLI de código fechado). Descontinuado – não use.

💰 Como posso minimizar meus custos reais de IA?

Estratégia Grátis primeiro:

1. Comece com um combo 100% grátis:

   1. kr/glm-5 (GLM-5 gratuito via Kiro, ~50 créditos/mês)
   2. Modelos do OpenCode Free (sem autenticação, obtidos automaticamente)
   3. Vertex AI Gemini 3 Pro (usando o endpoint do Vertex AI Studio com $300 em créditos)
   

   Custo: $0/mês (dentro do limite de crédito gratuito do Kiro; OpenCode/Vertex sujeito aos limites de nível gratuito)

2. Adicione backup barato apenas se precisar:

   4. glm/glm-4.7 ($0,60/1M tokens)
   

   Custo adicional: pague apenas pelo que você realmente usa

3. Use os provedores de assinatura por último:

   • Somente se você já os tiver

• 9Router ajuda a maximizar seu valor por meio do rastreamento de cotas

Resultado: A maioria dos usuários pode operar em $0/mês usando apenas níveis gratuitos!

📈 E se meu uso aumentar repentinamente?

O fallback inteligente do 9Router evita cobranças surpresa:

Cenário: você está em um sprint de codificação e ultrapassa suas cotas

Sem 9Router:

• ❌ Limite de requisições atingido → Paradas de trabalho → Frustração
• ❌ Ou: acidentalmente acumular enormes contas de API

Com 9Router:

• ✅ Assinatura atinge o limite → Retorno automático para nível barato
• ✅ O nível barato fica caro → Retorno automático para o nível gratuito
• ✅ Nunca pare de codificar → Custos previsíveis

Você está no controle: Defina limites de gastos por provedor no painel e o 9Router os respeita.

---

📖 Guia de configuração

🔐 Provedores de assinatura (maximizar valor)

Claude Code (Pro/Max)

Painel → Provedores → Conectar Claude Code
→ OAuth login → Renovação automática de token
→ Acompanhamento de cota de 5 horas + semanal

Modelos:
  cc/claude-opus-4-7
  cc/claude-opus-4-6
  cc/claude-sonnet-4-6
  cc/claude-haiku-4-5-20251001

Dica profissional: Use o Opus para tarefas complexas e o Sonnet para velocidade. 9Router rastreia cota por modelo!

OpenAI Codex (Plus/Pro)

Painel → Provedores → Conectar Codex
→ OAuth login (port 1455)
→ Renovação de 5 horas + semanal

Modelos:
  cx/gpt-5.5
  cx/gpt-5.4
  cx/gpt-5.3-codex
  cx/gpt-5.2-codex

GitHub Copilot

Painel → Provedores → Conectar GitHub
→ OAuth via GitHub
→ Renovação mensal (dia 1º)

Modelos:
  gh/gpt-5.4
  gh/claude-opus-4.7
  gh/claude-sonnet-4.6
  gh/gemini-3.1-pro-preview
  gh/grok-code-fast-1

Cursor IDE

Painel → Provedores → Conectar Cursor
→ OAuth login
→ Assinatura mensal

Modelos:
  cu/claude-4.6-opus-max
  cu/claude-4.5-sonnet-thinking
  cu/gpt-5.3-codex

💰 Provedores baratos (backup)

GLM-5.1 / GLM-4.7 (redefinição diária, $0.6/1M)

1. Inscreva-se: Zhipu AI
2. Obtenha a chave API do plano de codificação
3. Painel → Adicionar chave API:
   • Provedor: glm
   • Chave API: your-key

Usar: glm/glm-5.1, glm/glm-5, glm/glm-4.7

Dica profissional: O plano de codificação oferece cota 3× com custo de 1/7! Redefinir diariamente às 10h.

MiniMax M2.7 (redefinição de 5h, $0.20/1M)

1. Cadastre-se: MiniMax
2. Obtenha a chave API
3. Painel → Adicionar chave API

Usar: minimax/MiniMax-M2.7, minimax/MiniMax-M2.5

Dica profissional: Opção mais barata para contexto longo (1 milhão de tokens)!

Kimi K2.5 ($9/mês plano)

1. Inscreva-se: Moonshot AI
2. Obtenha a chave API
3. Painel → Adicionar chave API

Usar: kimi/kimi-k2.5, kimi/kimi-k2.5-thinking

Dica profissional: $9/mês corrigido para 10 milhões de tokens = custo efetivo de $0.90/1M!

🆓 Provedores GRATUITOS (recomendado)

Kiro AI (Claude 4.5 + GLM-5 + MiniMax GRATUITO)

Painel → Conectar Kiro
→ AWS Builder ID, AWS IAM Identity Center, Google ou GitHub
→ Uso conforme a cota do plano

Modelos:
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5
  kr/glm-5
  kr/MiniMax-M2.5
  kr/qwen3-coder-next
  kr/deepseek-3.2

Dica profissional: Melhor opção gratuita para Claude. Sem chave API, sem pagamento, totalmente ilimitado.

OpenCode Free (sem autenticação, modelos de busca automática)

Painel → Conectar OpenCode Free
→ Login não necessário (proxy de passagem)
→ Modelos obtidos automaticamente de opencode.ai/zen/v1/models

Dica profissional: Configuração mais rápida. Basta conectar e começar a codificar.

Vertex AI (créditos gratuitos $300 para novas contas do GCP)

Painel → Conectar Vertex AI
→ Envie o JSON da conta de serviço do Google Cloud
→ Ative a API Vertex AI no projeto GCP

Modelos:
  vertex/gemini-3.1-pro-preview
  vertex/gemini-3-flash-preview
  vertex/gemini-2.5-flash

Parceiros do Vertex (Anthropic / DeepSeek / GLM / Qwen via Vertex):
  vertex-partner/glm-5-maas
  vertex-partner/deepseek-v3.2-maas
  vertex-partner/qwen3-next-80b-a3b-thinking-maas

Dica profissional: novas contas do Google Cloud recebem créditos $300 gratuitamente por 90 dias. Bastante para codificação diária.

🎨 Criar Combos

Exemplo 1: Maximize a assinatura → Backup barato

Painel → Combos → Criar novo

Nome: premium-coding
Modelos:
  1. cc/claude-opus-4-7 (assinatura principal)
  2. glm/glm-5.1 (backup econômico, $0,60/1M)
  3. minimax/MiniMax-M2.7 (fallback mais econômico, $0,20/1M)

Use na CLI: premium-coding

Exemplo de custo mensal (100M de tokens):
  80M via Claude (assinatura): $0 extra
  15M via GLM: $9
  5M via MiniMax: $1
  Total: $10 + sua assinatura

Exemplo 2: somente gratuito (custo zero)

Nome: free-combo
Modelos:
  1. kr/claude-sonnet-4.5 (Claude 4.5 gratuito via Kiro, ~50 créditos/mês)
  2. kr/glm-5 (GLM-5 gratuito via Kiro)
  3. vertex/gemini-3.1-pro-preview ($300 free credits)

Custo: $0 (+ economia de 20–40% de tokens com RTK)!

🔧 Integração CLI

Cursor IDE

Configurações → Modelos → Avançado:
  OpenAI API Base URL: http://localhost:20128/v1
  OpenAI API Key: [copie do painel do 9Router]
  Model: cc/claude-opus-4-7

Ou use o combo: premium-coding

Claude Code

Editar ~/.claude/config.json:

{
  "anthropic_api_base": "http://localhost:20128/v1",
  "anthropic_api_key": "your-9router-api-key"
}

CLI do Codex

export OPENAI_BASE_URL="http://localhost:20128"
export OPENAI_API_KEY="your-9router-api-key"

codex "seu prompt"

OpenClaw

Opção 1 — Painel (recomendado):

Painel → Ferramentas CLI → OpenClaw → Selecionar modelo → Aplicar

Opção 2 — Manual: Editar ~/.openclaw/openclaw.json:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "9router/kr/claude-sonnet-4.5"
      }
    }
  },
  "models": {
    "providers": {
      "9router": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_9router",
        "api": "openai-completions",
        "models": [
          {
            "id": "kr/claude-sonnet-4.5",
            "name": "Claude Sonnet 4.5 (Kiro Free)"
          }
        ]
      }
    }
  }
}

Nota: OpenClaw só funciona com 9Router local. Use 127.0.0.1 em vez de localhost para evitar problemas de resolução IPv6.

Cline / Continue / RooCode

Provedor: compatível com OpenAI
Base URL: http://localhost:20128/v1
API Key: [copie do painel]
Model: cc/claude-opus-4-7

🚀 Implantação

Implantação VPS

# Clonar e instalar
git clone https://github.com/decolua/9router.git
cd 9router
npm install
npm run build

# Configurar
export JWT_SECRET="your-secure-secret-change-this"
export INITIAL_PASSWORD="your-password"
export DATA_DIR="/var/lib/9router"
export PORT="20128"
export HOSTNAME="0.0.0.0"
export NODE_ENV="production"
export NEXT_PUBLIC_BASE_URL="http://localhost:20128"
export NEXT_PUBLIC_CLOUD_URL="https://9router.com"
export API_KEY_SECRET="endpoint-proxy-api-key-secret"
export MACHINE_ID_SALT="endpoint-proxy-salt"

# Iniciar
npm run start

# Ou usar PM2
npm install -g pm2
pm2 start npm --name 9router -- start
pm2 save
pm2 startup

Docker

Imagens publicadas (multiplataforma linux/amd64 + linux/arm64):

• Hub Docker: decolua/9router
• GHCR: ghcr.io/decolua/9router

Início rápido (use imagem publicada):

docker run -d \
  --name 9router \
  -p 20128:20128 \
  -v "$HOME/.9router:/app/data" \
  -e DATA_DIR=/app/data \
  decolua/9router:latest

→ Abra http://localhost:20128

Compilar a partir do código-fonte (desenvolvedor):

git clone https://github.com/decolua/9router.git
cd 9router/app
docker build -t 9router .
docker run -d --name 9router -p 20128:20128 \
  -v "$HOME/.9router:/app/data" -e DATA_DIR=/app/data 9router

Padrões do contêiner:

• PORT=20128
• HOSTNAME=0.0.0.0

Comandos úteis:

docker logs -f 9router
docker restart 9router
docker stop 9router && docker rm 9router
docker pull decolua/9router:latest   # atualizar para a versão mais recente

Persistência de dados: $HOME/.9router/db/data.sqlite no host ↔ /app/data/db/data.sqlite no contêiner.

Variáveis de Ambiente

Variável	Padrão	Descrição
JWT_SECRET	Gerado automaticamente (~/.9router/jwt-secret)	Segredo de assinatura JWT para cookie de autenticação do painel (substituir para compartilhar entre instâncias)
INITIAL_PASSWORD	123456	Primeira senha de login quando não existe hash salvo
DATA_DIR	~/.9router	Localização principal dos dados do aplicativo (SQLite em $DATA_DIR/db/data.sqlite)
PORT	padrão da estrutura	Porta de serviço (20128 nos exemplos)
HOSTNAME	padrão da estrutura	Host de vinculação (o padrão do Docker é 0.0.0.0)
NODE_ENV	padrão de tempo de execução	Definir production para implantação
BASE_URL	http://localhost:20128	URL base interna do lado do servidor usada por trabalhos de sincronização na nuvem
CLOUD_URL	https://9router.com	URL base do endpoint de sincronização na nuvem do lado do servidor
NEXT_PUBLIC_BASE_URL	http://localhost:3000	URL de base pública/compatível com versões anteriores (prefira BASE_URL para tempo de execução do servidor)
NEXT_PUBLIC_CLOUD_URL	https://9router.com	URL de nuvem pública/compatível com versões anteriores (prefira CLOUD_URL para tempo de execução do servidor)
API_KEY_SECRET	endpoint-proxy-api-key-secret	Segredo HMAC para chaves de API geradas
MACHINE_ID_SALT	endpoint-proxy-salt	Salt para hashing estável de ID de máquina
ENABLE_REQUEST_LOGS	false	Habilita logs de solicitação/resposta em logs/
AUTH_COOKIE_SECURE	false	Forçar cookie de autenticação Secure (definir true atrás do proxy reverso HTTPS)
REQUIRE_API_KEY	false	Aplicar chave de API Bearer em rotas /v1/* (recomendado para implantações expostas à Internet)
HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, NO_PROXY	vazio	Proxy de saída opcional para chamadas de provedor upstream
SEARXNG_URL	http://localhost:8888/search	Endpoint para o provedor de pesquisa na web SearXNG não autenticado integrado

Notas:

• Variáveis de proxy em letras minúsculas também são suportadas: http_proxy, https_proxy, all_proxy, no_proxy.
• .env não está incluído na imagem Docker (.dockerignore); injete configuração de tempo de execução com --env-file ou -e.
• No Windows, APPDATA pode ser usado para resolução de caminho de armazenamento local.
• INSTANCE_NAME aparece em modelos de documentos/env mais antigos, mas atualmente não é usado em tempo de execução.

Arquivos e armazenamento em tempo de execução

• Estado principal do aplicativo: ${DATA_DIR}/db/data.sqlite (SQLite — provedores, combos, aliases, chaves, configurações, histórico de uso)
• Backups automáticos: ${DATA_DIR}/db/backups/
• Logs opcionais de solicitação/tradutor: <repo>/logs/... quando ENABLE_REQUEST_LOGS=true
• ${DATA_DIR} e ~/.9router resolvem para o mesmo local em um contêiner Docker — o link simbólico /root/.9router -> /app/data é criado no momento da construção.

---

📊 Modelos Disponíveis

Ver todos os modelos disponíveis

Claude Code (cc/) - Pro/Máx:

-cc/claude-opus-4-7 -cc/claude-opus-4-6 -cc/claude-sonnet-4-6 -cc/claude-sonnet-4-5-20250929 -cc/claude-haiku-4-5-20251001

Codex (cx/) - Plus/Pro:

-cx/gpt-5.5 -cx/gpt-5.4 -cx/gpt-5.3-codex -cx/gpt-5.2-codex -cx/gpt-5.1-codex-max

GitHub Copilot (gh/):

-gh/gpt-5.4 -gh/claude-opus-4.7 -gh/claude-sonnet-4.6 -gh/gemini-3.1-pro-preview -gh/grok-code-fast-1

Cursor (cu/) - Assinatura:

-cu/claude-4.6-opus-max -cu/claude-4.5-sonnet-thinking -cu/gpt-5.3-codex -cu/kimi-k2.5

GLM (glm/) - $0.6/1M:

-glm/glm-5.1 -glm/glm-5 -glm/glm-4.7

MiniMax (minimax/) - $0.2/1M:

-minimax/MiniMax-M2.7 -minimax/MiniMax-M2.5

Kimi (kimi/) - $9/mo plana:

-kimi/kimi-k2.5 -kimi/kimi-k2.5-thinking

Kiro (kr/) - Gratuito (~50 créditos/mês, níveis pagos acima):

-kr/claude-sonnet-4.5 -kr/claude-haiku-4.5 -kr/glm-5 -kr/MiniMax-M2.5 -kr/qwen3-coder-next -kr/deepseek-3.2

OpenCode grátis (oc/) - GRATUITO sem autenticação:

• Obtido automaticamente de opencode.ai/zen/v1/models

Vertex AI (vertex/) - Créditos gratuitos $300:

-vertex/gemini-3.1-pro-preview -vertex/gemini-3-flash-preview -vertex/gemini-2.5-flash -vertex-partner/glm-5-maas -vertex-partner/deepseek-v3.2-maas

---

🐛 Solução de problemas

"O modelo de linguagem não forneceu mensagens"

• Cota do provedor esgotada → Verifique o rastreador de cota do painel
• Solução: use o combo substituto ou mude para um nível mais barato

Limitação de requisições

• Cota de assinatura esgotada → Fallback para GLM/MiniMax
• Adicionar combo: cc/claude-opus-4-7 → glm/glm-5.1 → kr/claude-sonnet-4.5

O token OAuth expirou

• Atualizado automaticamente pelo 9Router
• Se os problemas persistirem: Painel → Provedor → Reconectar

Custos elevados

• Habilite RTK no Dashboard → Configurações de endpoint (padrão LIGADO, economiza 20-40% de tokens)
• Verifique as estatísticas de uso no Dashboard
• Mude o modelo primário para GLM/MiniMax
• Use o nível gratuito (Kiro, OpenCode Free, Vertex) para tarefas não críticas

Painel abre na porta errada

• Definir PORT=20128 e NEXT_PUBLIC_BASE_URL=http://localhost:20128

Primeiro login não funciona

• Verifique INITIAL_PASSWORD em .env
• Se não definida, a senha substituta é 123456

Nenhum registro de solicitação em logs/

• Definir ENABLE_REQUEST_LOGS=true

---

🛠️ Pilha de tecnologia

• Tempo de execução: Node.js 20+
• Estrutura: Next.js 16
• IU: React 19 + Tailwind CSS 4
• Banco de dados: SQLite (better-sqlite3 / node:sqlite / fallback para sql.js)
• Streaming: eventos enviados pelo servidor (SSE)
• Autenticação: OAuth 2.0 (PKCE) + JWT + chaves de API

---

📝 Referência da API

Chat Completions

POST http://localhost:20128/v1/chat/completions
Authorization: Bearer your-api-key
Content-Type: application/json

{
  "model": "cc/claude-opus-4-6",
  "messages": [
    {"role": "user", "content": "Escreva uma função para..."}
  ],
  "stream": true
}

Listar modelos

GET http://localhost:20128/v1/models
Authorization: Bearer your-api-key

→ Retorna todos os modelos e combos no formato OpenAI

📧 Suporte

• Site: 9router.com
• GitHub: github.com/decolua/9router
• Issues: github.com/decolua/9router/issues

---

👥 Colaboradores

Obrigado a todos os colaboradores que ajudaram a tornar o 9Router melhor!

---

📊 Gráfico de estrelas

🔀 Forks

OmniRoute — Um fork TypeScript completo do 9Router. Adiciona mais de 36 provedores, fallback automático de 4 camadas, APIs multimodais (imagens, incorporações, áudio, TTS), disjuntor, cache semântico, avaliações LLM e um painel sofisticado. Mais de 368 testes de unidade. Disponível via npm e Docker.

---

🙏 Agradecimentos

Construído sobre ombros de gigantes:

• CLIProxyAPI — implementação Go original que inspirou esta versão JavaScript.
• RTK — Economizador de tokens em Rust. O 9Router porta seu pipeline de compactação para JS → −20-40% de tokens de entrada em cada solicitação.
• Caveman por @JuliusBrussee — viral "por que usar muitos tokens quando poucos tokens resolvem". 9Router adapta seu prompt → −65% tokens de saída.
• Ponytail por @DietrichGebert — "desenvolvedor sênior preguiçoso" habilidade. 9Router injeta sua abordagem YAGNI-first → menos tokens, menos código, diferenças mais curtas.

Um grande agradecimento a esses autores – sem o trabalho deles, os recursos de economia de tokens do 9Router não existiriam. Dê uma ⭐ a eles no GitHub!

---

📄 Licença

Licença MIT - consulte LICENSE para obter detalhes.

---

_{Construído com ❤️ para desenvolvedores que codificam 24/7}