liaohch3/claude-tap

어떤 프로젝트인가요?

핵심 기능

• 01지원되는 코딩 에이전트 CLI에서 스트리밍 API 요청과 응답을 캡처합니다.
• 02요청별 시스템 프롬프트, 도구 정의, 도구 호출, 토큰 사용량을 표시합니다.
• 03인접한 요청을 비교해 변경된 메시지, 프롬프트, 매개변수를 강조합니다.
• 04각 세션을 독립형 HTML 뷰어 또는 간결한 트레이스 번들로 내보냅니다.
• 05일반적인 인증 헤더를 마스킹하고 모든 트레이스 데이터를 로컬 기기에 보관합니다.

활용 사례

• 코딩 에이전트의 동작이 턴 사이에 바뀐 이유를 조사합니다.
• 에이전트가 모델에 보내는 도구와 시스템 프롬프트를 감사합니다.
• 에이전트 세션 간 토큰 사용량과 컨텍스트 증가를 비교합니다.
• 검토를 위해 에이전트 실행의 재현 가능한 트레이스를 보관하거나 공유합니다.

빠른 시작

1. 1

   uv로 claude-tap 설치(권장)

   uv tool install claude-tap
2. 2

   claude-tap을 통해 Claude Code 실행

   claude-tap
3. 3

   또는 Codex CLI를 트레이스

   claude-tap --tap-client codex

사용 전 알아둘 점

• !Python 3.11 이상과 트레이스하려는 에이전트 클라이언트를 별도로 설치해야 합니다.
• !AWS 네이티브 Bedrock과 같은 일부 클라이언트는 포워드 프록시 모드 등의 추가 설정이 필요합니다.

토픽

자주 묻는 질문

claude-tap은(는) 무엇인가요?

Claude Code와 Codex CLI 같은 AI 코딩 에이전트의 API 트래픽을 캡처해 프롬프트, 도구 호출, 토큰 사용량을 확인하는 로컬 프록시 및 트레이스 뷰어입니다. claude-tap은 AI 코딩 에이전트의 CLI를 로컬 프록시를 통해 실행하거나, 프록시를 사용할 수 없는 클라이언트의 로컬 트랜스크립트를 감시해 실제 API 트래픽을 기록합니다. 각 트레이스에는 시스템 프롬프트, 대화 기록, 도구 스키마, 도구 호출, 스트리밍 응답, 토큰 사용량, 인접한 요청 간 차이가 표시됩니다.

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

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

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

활발히 유지보수 중. claude-tap의 마지막 커밋은 2026년 10월 19일입니다.

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

코딩 에이전트의 동작이 턴 사이에 바뀐 이유를 조사합니다. 에이전트가 모델에 보내는 도구와 시스템 프롬프트를 감사합니다. 에이전트 세션 간 토큰 사용량과 컨텍스트 증가를 비교합니다. 검토를 위해 에이전트 실행의 재현 가능한 트레이스를 보관하거나 공유합니다.

claude-tap는 어떻게 설치하나요?

uv로 claude-tap 설치(권장): uv tool install claude-tap claude-tap을 통해 Claude Code 실행: claude-tap 또는 Codex CLI를 트레이스: claude-tap --tap-client codex

claude-tap은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/liaohch3/claude-tap