claude-tap
코딩 에이전트가 실제로 보낸 요청을 그대로 들여다보는 뷰어
pip install claude-tap코딩 에이전트가 실제로 주고받은 API 트래픽을 로컬에서 붙잡아 보여 주는 프록시이자 뷰어입니다. CLI 를 이 프록시를 거쳐 돌리거나 로컬 앱의 기록을 읽어서 시스템 프롬프트와 대화 이력, 도구 스키마, 도구 호출, 스트리밍 응답, 토큰 사용량을 그대로 확인합니다. 이웃한 두 요청을 구조적으로 비교해서 어떤 프롬프트나 메시지, 도구, 인자가 달라졌는지 짚어 냅니다. 에이전트가 왜 그렇게 행동했는지 추측 대신 근거로 따지려 할 때 쓰는 도구입니다. 열 개가 넘는 코딩 도구를 지원하고 실행 기록은 내보낼 수 있는 파일로 남습니다.
판단
이럴 때 씁니다
- 에이전트가 왜 그렇게 행동했는지 근거로 따져야 할 때
- 도구 정의나 시스템 프롬프트가 실제로 어떻게 전달됐는지 확인할 때
- 두 요청 사이에 무엇이 바뀌었는지 짚어야 할 때
이럴 땐 쓰지 마세요
- 평소 개발에는 프록시 한 겹이 늘 뿐입니다
- 기록에 대화 내용이 그대로 남으므로 취급에 주의해야 합니다
- 지원하지 않는 도구는 트래픽을 잡지 못합니다
차별점
- 실제 요청 본문을 그대로 보여 줘서 추측 대신 근거로 따집니다.
- 이웃한 요청을 구조적으로 비교합니다.
- 열 개가 넘는 코딩 도구를 지원합니다.
- 실행 기록을 내보낼 수 있는 파일로 남깁니다.
워크플로
- 01패키지를 설치합니다.
- 02프록시를 띄웁니다.
- 03코딩 도구를 이 프록시를 거치도록 돌리거나 로컬 기록을 읽게 합니다.
- 04뷰어에서 요청을 하나씩 펼쳐 봅니다.
- 05이웃한 요청을 비교해 달라진 부분을 찾습니다.
주요 명령
| 명령 | 설명 |
|---|---|
pip install claude-tap | 설치합니다. |
claude-tap | 프록시와 뷰어를 띄웁니다. |
함정
설치 전에 확인하세요
- 기록에 시스템 프롬프트와 대화 내용이 그대로 남습니다. 업무 코드가 오갔다면 그 파일도 같은 등급으로 다뤄야 합니다.
- 도구마다 잡는 방식이 다릅니다. 프록시를 거치는 것과 로컬 기록을 읽는 것 중 어느 쪽인지 확인해야 합니다.
- 판이 자주 올라갑니다. 특정 도구의 API 경로가 바뀌면 잡지 못하다가 다음 판에서 고쳐지는 식입니다.
- 프록시를 거치게 하면 그 도구의 인증 경로도 함께 지나갑니다. 설정을 되돌리는 방법을 알아 두어야 합니다.
비교
일반 관측 도구는 애플리케이션 코드에 계측을 넣어야 합니다. 이쪽은 이미 만들어진 코딩 도구를 대상으로 하기 때문에 소스를 고칠 수 없는 상황에서도 통합니다. 그 대신 프록시를 거치도록 설정을 바꿔야 하고 기록에 민감한 내용이 남습니다.
최근 변경
특정 도구의 표준 응답 API 경로를 잡지 못하던 문제를 고쳤습니다. 지원 대상이 늘면서 경로 대응이 계속 추가되고 있습니다.