liaohch3/claude-tap
Intercept and inspect Coding Agent API traffic from Claude Code, Codex CLI, Gemini CLI, Cursor CLI, OpenCode, Kimi/Kimi Code, Pi, and Hermes in a local trace viewer.
해결하는 문제
claude-tap은 AI 코딩 에이전트의 내부 작동 방식을 검사할 수 있는 방법을 제공합니다. Claude Code, Codex 또는 Gemini CLI와 같은 CLI 기반 에이전트가 LLM에 전송하는 정확한 시스템 프롬프트, 도구 호출 및 대화 기록을 볼 수 없는 "블랙박스" 문제를 해결합니다.
작동 방식
로컬 프록시 및 트레이스 뷰어 역할을 합니다. AI 에이전트 CLI를 claude-tap을 통해 실행하면 도구가 에이전트와 LLM 제공자 사이의 API 트래픽을 가로챕니다. 역방향 프록시 모드(에이전트의 base URL을 localhost로 리디렉션) 또는 순방향 프록시 모드(HTTPS_PROXY 및 로컬 CA 인증서 주입)로 작동할 수 있습니다. 캡처된 트래픽은 라이브 브라우저 기반 뷰어에 표시되거나 검토를 위해 휴대 가능한 HTML 파일로 내보낼 수 있습니다.
대상 사용자
- 개발자: 에이전트 동작을 디버깅하려는 AI 코딩 에이전트 사용자.
- 프롬프트 엔지니어: 시스템 프롬프트와 도구 스키마가 정확히 어떻게 구성되는지 확인해야 하는 전문가.
- 연구자: 다양한 에이전트 CLI에서 버전별 시스템 프롬프트 스냅샷을 아카이브하는 연구자.
주요 특징
- 폭넓은 클라이언트 지원: Claude Code, Codex, Gemini CLI, Grok Build, Kimi, Cursor CLI 등을 포함한 다양한 에이전트와 함께 작동합니다.
- 심층 검사: 시스템 프롬프트, 도구 정의, 도구 호출, 스트리밍 응답 및 토큰 사용량을 캡처합니다.
- 요청 디프(Diffing): 인접한 요청을 비교하여 턴 사이에 프롬프트나 컨텍스트에서 정확히 무엇이 변경되었는지 확인할 수 있습니다.
- 개인정보 보호 중심: 트레이스는 사용자의 로컬 머신에 저장되며, 기록 전에 일반적인 인증 헤더가 삭제됩니다。
- 휴대 가능한 아티팩트: 세션은 공유 또는 아카이브가 용이하도록 독립형 HTML 파일로 내보낼 수 있습니다.