tigerless-labs/cost-xray

어떤 프로젝트인가요?

핵심 기능

• 01API 키나 에이전트 설정 변경 없이 로컬 프록시를 통해 Claude Code와 Codex의 원시 API 요청을 캡처합니다.
• 02각 출처의 비용을 신규 입력, 캐시 읽기, 캐시 쓰기, 출력으로 나눠 보여줍니다.
• 03개별 도구 호출과 MCP 서버 단위까지 비용을 배분합니다.
• 04시스템 프롬프트, 도구 스키마, MCP 블록, 메시지별 컨텍스트 윈도 점유율을 보여줍니다.
• 05모든 요청에 주입되지만 한 번도 호출되지 않은 MCP 서버와 도구를 표시합니다.
• 06데이터를 로컬에 저장하기 전에 자격 증명을 삭제합니다.

활용 사례

• 코딩 에이전트 세션의 비용이 예상보다 많이 나온 이유를 파악합니다.
• 사용하지 않는 MCP 서버나 큰 도구 스키마가 모든 요청을 불필요하게 키우는지 확인합니다.
• 프롬프트 캐싱이 안정적인 접두부에 적용되는지 확인하고 예상치 못한 캐시 재작성을 찾아냅니다.
• 코딩 에이전트가 모델 API에 보내는 컨텍스트를 로컬에서 감사합니다.

빠른 시작

1. 1

   Claude Code 또는 Codex가 설치된 macOS 또는 Linux 환경인지 확인합니다

2. 2

   README의 공식 설치 스크립트를 실행합니다

3. 3

   새 터미널을 열고 라이브 TUI를 실행합니다

   cx

사용 전 알아둘 점

• !macOS 또는 Linux에서만 실행됩니다.
• !Claude Code에서는 요청 내 소스별 토큰 분배가 대략적이지만, 총 비용은 정확합니다.
• !Codex 캡처에는 codex 명령만 신뢰하는 로컬 인증 기관이 사용됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

cost-xray은(는) 무엇인가요?

Claude Code와 Codex의 원시 API 트래픽을 캡처하고 요청 내 각 출처에 토큰 비용을 배분하는 로컬 프록시입니다. cost-xray는 AI 코딩 에이전트가 실제로 모델 API에 보내는 내용과 각 부분의 비용을 보여줍니다. 로그 기반 사용량 도구는 요청이 끝난 뒤 전체 합계만 확인할 수 있지만, cost-xray는 로컬 캡처 홉으로 실행되므로 시스템 프롬프트, 도구 스키마, MCP 서버 블록, 도구 결과, 캐시 읽기와 쓰기, 이전 사고 블록 등 요청 시점의 컨텍스트를 확인할 수 있습니다.

cost-xray은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

cost-xray은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

cost-xray은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. cost-xray의 마지막 커밋은 2026년 11월 5일입니다.

cost-xray은(는) 어디에 사용할 수 있나요?

코딩 에이전트 세션의 비용이 예상보다 많이 나온 이유를 파악합니다. 사용하지 않는 MCP 서버나 큰 도구 스키마가 모든 요청을 불필요하게 키우는지 확인합니다. 프롬프트 캐싱이 안정적인 접두부에 적용되는지 확인하고 예상치 못한 캐시 재작성을 찾아냅니다. 코딩 에이전트가 모델 API에 보내는 컨텍스트를 로컬에서 감사합니다.

cost-xray는 어떻게 설치하나요?

Claude Code 또는 Codex가 설치된 macOS 또는 Linux 환경인지 확인합니다 README의 공식 설치 스크립트를 실행합니다 새 터미널을 열고 라이브 TUI를 실행합니다: cx

cost-xray은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/tigerless-labs/cost-xray