pxpipe: 컨텍스트를 이미지로 렌더링하여 Claude Code 토큰 사용량 60% 절감

pxpipe는 가격 차이를 활용하는 로컬 프록시입니다. AI 모델은 이미지에 대해 픽셀 크기로 비용을 청구하며, 포함된 텍스트 밀도는 고려하지 않습니다. 시스템 프롬프트, 도구 문서, 히스토리와 같은 방대한 컨텍스트의 경우, 실제 클로드 코드 트래픽 기준으로 이미지 토큰당 약 3.1자, 텍스트 토큰당 약 1자로 변환됩니다. 그 결과, 정가 기준 약 59~70%의 비용 절감, 압축 요청 기준 약 72~74%의 비용 절감이 이루어집니다. 주요 지표는 입력 토큰 감소로, 예를 들어 약 25k 텍스트 토큰이 약 2.7k 이미지 토큰으로 렌더링됩니다.

작동 방식

pxpipe는 Claude Code/Gateway의 요청을 가로채는 로컬 프록시로 실행됩니다. 요청이 머신을 떠나기 전에 방대한 부분(시스템 프롬프트, 도구 문서, 오래된 히스토리)을 PNG 이미지로 다시 작성합니다. 또한, 모델이 텍스트를 안정적으로 읽을 수 있도록 OCR 명령 배너를 이미지 위에 함께 렌더링합니다. Fable 5는 깔끔한 평가에서 100/100 읽기 정확도를 달성합니다. Opus 4.8은 밀도 높은 이미지 콘텐츠에서 어려움을 겪습니다(정확한 값은 텍스트로 유지해야 함).

시작하기

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

http://127.0.0.1:47821/을 열면 저장된 토큰, 세션별 통계, 모든 텍스트→이미지 변환을 나란히 보여주는 라이브 대시보드가 표시됩니다.

주요 결과

• 토큰 감소: 밀도 높은 콘텐츠가 약 10배 압축됩니다(25k 텍스트 → 2.7k 이미지 토큰).
• 비용 절감: 일반 Claude Code 트래픽에서 59~70% 청구액 절감, 압축 요청에서 72~74% 절감.
• 정확도: Fable 5 모델이 깔끔한 평가에서 이미지 읽기 100/100 달성; Opus 4.8은 정확한 값에 대해 손실이 있음.
• 데모 비교: 세션 합계: 일반 $42.21(컨텍스트 96% 사용) vs pxpipe $6.06(컨텍스트 7.4% 사용).

제한 사항

소량의 작은 요청에는 이점이 없습니다. Opus 4.8은 이미지에서 정확한 값(예: 구문 개수)을 안정적으로 읽을 수 없습니다. 단일 응답 형식 준수에 약간의 문제가 있을 수 있습니다(한 번의 후속 조치가 필요할 수 있음).

대상 사용자

특히 Fable 5 환경에서 대규모 시스템 프롬프트, 광범위한 도구 문서, 긴 대화 히스토리를 사용하는 Claude Code 개발자에게 적합합니다.