tigerless-labs/cost-xray

해결하는 문제

대부분의 AI 코딩 에이전트 사용 도구는 로컬 로그만 읽을 뿐, 모델 호출 전에 조립되는 '보이지 않는' 요청 시점 컨텍스트(예: 시스템 프롬프트, 툴 스키마, MCP 블록 등)를 놓친다. cost-xray는 실제 API 트래픽에 대한 가시성을 제공하여, 모델로 전송되는 정확한 내용과 요청의 각 특정 부분이 얼마나 비용이 드는지 확인할 수 있게 한다.

작동 방식

mitmproxy를 사용하여 로컬 캡처 홉으로 작동한다. 코딩 에이전트(Claude Code 또는 Codex 등)와 모델 API 사이의 HTTP/HTTPS 트래픽을 가로챈다. 프록시는 민감한 정보(예: API 키)를 마스킹하고 원시 요청/응답 바이트를 로컬 디스크에 저장한다. 별도의 '매터리얼라이저'가 오프라인에서 데이터를 토큰화하고 가격을 책정하여 요청의 핫패스에 영향을 주지 않으며, 에이전트 성능에 추가 지연을 주지 않는다.

대상 사용자

macOS 또는 Linux에서 AI 코딩 에이전트(특히 Claude Code와 Codex)를 사용하며, API 사용 비용을 세밀하게 추적하고 컨텍스트 창의 사용률을 최적화하고자 하는 개발자.

주요 기능

• 세밀한 비용 할당: 세션 총액이 아니라 개별 툴 호출과 그 출력까지 비용을 추적.
• 컨텍스트 창 분석: 컨텍스트 창을 차지하는 것이 무엇인지 정확히 보여주며(예: 시스템 프롬프트, MCP 서버), 프리픽스 내의 '무게 중심'을 식별.
• 사용되지 않는 MCP 낭비 탐지: 모든 요청에 삽입되지만 실제로 사용되지 않는 구성된 MCP 서버와 툴을 경고.
• 자기 복구 캡처: 프록시가 다운되었거나 캡처에 실패했을 경우 자동으로 재시작하거나 에이전트를 직접 라우팅하는 커맨드 래퍼를 사용하여 에이전트가 계속 기능하도록 보장.
• 로컬 및 개인 정보 보호: 모든 데이터는 ~/.cost-xray/에 로컬 저장되며, 텔레메트리 없이 민감한 필드는 저장 전에 마스킹된다.