프로젝트 소개

cost-xray는 AI 코딩 에이전트를 위한 로컬 캡처 및 비용 귀속 도구입니다. 사후에 로컬 트랜스크립트를 읽는 대신, Claude Code와 Codex가 보내는 실제 API 요청을 가로채 각 요청을 구성 요소별로 분해하고 가격을 책정합니다. 존재 이유: 로그 기반 사용량 도구는 호출 또는 세션의 총 비용을 보여주지만, 요청 시점의 컨텍스트(시스템 프롬프트, 주입된 도구 스키마, MCP 블록, 도구 결과, 캐시 읽기/쓰기, 이전 사고 블록)는 요청 시점에 조립되며 트랜스크립트에 기록되지 않습니다. 이 보이지 않는 접두사는 컨텍스트의 큰 부분을 차지할 수 있습니다. cost-xray는 원시 와이어 요청을 읽어 스키마, MCP 서버, 도구, 메시지 버킷에 토큰과 비용을 개별 도구 호출 수준까지 귀속시킬 수 있습니다. 작동 방식: mitmproxy가 로컬 캡처 홉으로 실행됩니다. Claude Code는 인증서 없이 기본 URL 재정의를 통한 리버스 프록시 모드로 캡처되고, Codex는 포워드 프록시와 codex 명령에만 신뢰되는 범위 지정 로컬 CA를 사용합니다. 프록시는 127.0.0.1에 바인딩되고, 원격 측정을 보내지 않으며, Authorization 헤더, API 키, 쿠키, 비밀처럼 보이는 본문 필드를 ~/.cost-xray/ 아래에 디스크에 쓰기 전에 삭제합니다. 분석은 별도의 구체화기에서 요청 경로 밖에서 실행되므로 토큰화와 가격 책정이 라이브 릴레이에 지연을 추가하지 않습니다. 캡처된 트래픽은 고유 블록별로 중복 제거되고 턴별 델타가 적용되어 백만 토큰 세션에서도 디스크 사용량을 작게 유지합니다. README에 설명된 기능: 신규, 캐시 읽기, 캐시 쓰기, 출력 토큰으로 분할된 소스별 비용 귀속(개별 호출까지 가격 책정), 소스 수준 행으로 분할된 컨텍스트 창 점유율, 모든 요청에 주입되지만 호출되지 않는 구성된 MCP 서버 및 도구 감지, tiktoken 추정과 공급자 자체 사용량 합계에 대한 비례 보정을 사용하는 Claude 토큰화 접근 방식(합계는 정확, 소스별 분할은 근사), 프록시를 재시작하거나 직접 에이전트 실행으로 대체하는 자가 치유 래퍼, 라이브 TUI. 설치는 curl 파이프 설치 스크립트로 캡처할 에이전트를 묻거나 COST_XRAY_AGENTS=claude|codex|all을 허용합니다. 캡처는 전방 전용이며 새 터미널이 필요합니다. cx CLI는 TUI를 열고 서비스(상태, 중지, 시작, 재시작, 설치, 제거)를 관리합니다. 요구 사항은 macOS 또는 Linux, 지원되는 에이전트, API 키나 계정이 필요 없습니다. MIT 라이선스.