워치타워: 클로드 코드 API 트래픽 모니터링을 위한 로컬 프록시

Watchtower의 기능

Watchtower는 로컬 HTTP 프록시와 실시간 웹 대시보드를 결합한 도구입니다. Claude Code(또는 Codex CLI)와 백엔드 API 간의 모든 API 트래픽을 가로챕니다. 이를 통해 개발자는 모든 요청, 서버 전송 이벤트(SSE) 스트림, 도구 정의, 시스템 프롬프트, 토큰 사용량, 속도 제한을 실시간으로 확인할 수 있습니다.

주요 기능과 동기

이 도구는 Claude Code 자체를 사용하여 제작되었습니다. 제작자에 따르면, Claude Code는 일반적으로 사용자 메시지당 2-3개의 API 호출을 전송합니다: 하나는 할당량 확인용, 다른 하나는 토큰 수 계산용, 그리고 실제 스트리밍 요청용입니다. 또한 완전히 다른 시스템 프롬프트와 더 작은 도구 세트를 가진 하위 에이전트를 생성합니다. 주요 시스템 프롬프트만 해도 20,000개 이상의 토큰으로 보고됩니다. 일반적으로 이 내부 통신은 사용자에게 보이지 않습니다.

설치 및 사용법

설치는 npm을 통해 진행합니다:

npm install -g watchtower-ai && watchtower-ai

사용하려면 환경 변수를 설정하여 프록시를 가리키도록 Claude Code를 실행하세요:

ANTHROPIC_BASE_URL=http://localhost:8024 claude

대시보드 인터페이스는 http://localhost:8025에서 브라우저로 열립니다.

프로젝트 상세

프록시 서버, 제공자 감지, SSE 파싱, 대시보드 UI를 포함한 전체 프로젝트는 Claude Code를 사용하여 구축되었습니다. MIT 라이선스로 배포되며, 무료 오픈소스로 유료 등급이나 계정 요구사항이 없습니다.

제작자는 이 도구가 추론 흔적을 확인하고 싶거나, 토큰 소비 패턴을 이해하거나, 더 나은 AI 에이전트를 직접 구축하기 위해 에이전트 하네스가 어떻게 작동하는지 배우고자 하는 개발자에게 유용하다고 말합니다.