pxpipe: Reduza em 60% o uso de tokens do Claude Code ao renderizar contexto como imagens

pxpipe é um proxy local que explora uma diferença de preços: modelos de IA cobram por imagens com base nas dimensões dos pixels, não na densidade do texto embutido. Para contextos volumosos como prompts de sistema, documentações de ferramentas e histórico, isso significa ~3,1 caracteres por token de imagem vs ~1 caractere por token de texto no tráfego real do Claude Code. O resultado é uma redução de custos de ~59–70% (preços de lista) e ~72–74% em requisições compactadas, com a métrica principal sendo a redução de tokens de entrada — por exemplo, ~25k tokens de texto renderizados como ~2,7k tokens de imagem.

Como Funciona

pxpipe roda como um proxy local interceptando requisições do Claude Code/Gateway. Ele reescreve as partes volumosas (prompt de sistema, documentação de ferramentas, histórico mais antigo) em imagens PNG compactas antes que a requisição saia da sua máquina. O proxy também inclui um banner de instrução OCR co-renderizado no topo para que o modelo leia o texto de forma confiável. O Fable 5 atinge 100/100 de precisão de leitura em uma avaliação limpa. O Opus 4.8 tem dificuldades com conteúdo denso em imagens (valores exatos devem permanecer como texto).

Primeiros Passos

npx pxpipe-proxy
# proxy em 127.0.0.1:47821
ANTHROPIC_BASE_URL=http://localhost:47821 claude

Abra http://127.0.0.1:47821/ para um painel ao vivo mostrando tokens economizados, estatísticas por sessão e cada conversão texto→imagem lado a lado.

Resultados Principais

• Redução de tokens: Conteúdo denso comprime ~10x (25k texto → 2,7k tokens de imagem)
• Economia de custos: 59–70% menos na conta do tráfego típico do Claude Code, 72–74% em requisições compactadas
• Precisão: Modelo Fable 5 lê imagens com 100/100 em avaliação limpa; Opus 4.8 é impreciso para valores exatos
• Comparação de demonstração: Totais de sessão: simples $42,21 (contexto 96% cheio) vs pxpipe $6,06 (contexto 7,4% cheio)

Limitações

Requisições curtas ou pequenas não se beneficiam. Opus 4.8 não consegue ler valores exatos de imagens de forma confiável (por exemplo, contagens de frases). A conformidade com formato de resposta única tem pequenas arestas (um ou dois ajustes de acompanhamento podem ser necessários).

Para Quem é

Desenvolvedores que usam Claude Code com prompts de sistema grandes, documentações extensas de ferramentas ou longos históricos de conversa — especialmente em ambientes Fable 5.