liaohch3/claude-tap

해결하는 문제

claude-tap는 AI 코딩 에이전트의 내부 동작을 투명하게 만드는 로컬 프록시 및 트레이스 뷰어입니다. 일반적으로 에이전트의 CLI나 애플리케이션 인터페이스에 의해 숨겨지는 실제 API 트래픽과 LLM에 전송되는 컨텍스트를 개발자가 검사할 수 있도록 합니다.

작동 방식

이 도구는 AI 에이전트(클라이언트)와 LLM 공급자 API 사이의 프록시 역할을 합니다. 주로 두 가지 모드로 작동합니다:

• 리버스 프록시 모드: 에이전트의 API 기본 URL을 로컬 프록시로 리디렉션하여 트래픽을 캡처한 후 타겟 API로 전달합니다.
• 포워드 프록시 모드: 자식 프로세스에 HTTPS_PROXY와 로컬 CA 인증서를 삽입하여, 에이전트가 통신하는 모든 공급자의 트래픽을 캡처합니다.

캡처된 데이터는 로컬 트레이스 세션으로 저장되며, 실시간 브라우저 기반 뷰어에서 확인하거나 자체 포함형 HTML 파일로 내보내어 아카이브 및 공유할 수 있습니다.

대상 사용자

Claude Code, Codex, Gemini CLI, Cursor 등 AI 코딩 에이전트를 사용하고, 에이전트 동작을 디버깅하거나 시스템 프롬프트를 분석하거나 토큰 사용량과 도구 호출을 감사하고자 하는 개발자 및 AI 연구자.

주요 기능

• 심층적 컨텍스트 검사: 시스템 프롬프트, 대화 기록, 도구 스키마, 도구 호출, 재구성된 스트리밍 응답을 확인 가능.
• 세부적인 디버깅: 인접한 요청을 비교하여 각 턴 간 프롬프트나 파라미터에서 정확히 무엇이 변경되었는지 식별 가능.
• 광범위한 클라이언트 지원: Claude Code, Codex, Gemini, Grok, Kimi, Cursor 등 다양한 에이전트와 호환.
• 로컬 우선의 프라이버시: 트레이스는 로컬 머신에 보관되며, 민감한 인증 헤더는 기록 전에 마스킹 처리됨.
• 포터블 아티팩트: 트레이스 세션을 독립형 HTML 뷰어로 내보내어 검토 또는 공유 가능.