Wirepane은 macOS용 Claude Code 플러그인으로, 브라우저·iOS 시뮬레이터·iPhone·Android 에뮬레이터와 기기의 HTTP·HTTPS 요청을 가로채 확인하는 디버깅 프록시다. 요청 목록과 상세 내용을 Claude Code가 읽을 수 있어, 실제 요청과 응답을 바탕으로 오류를 살펴볼 수 있다. 제작자는 Proxyman·Charles·mitmproxy를 대체할 수 있는 일상적인 디버깅 도구라고 설명하지만, HTTP/2와 gRPC, 대화형 중단점은 지원하지 않는다.

Wirepane 웹사이트 · 설치 안내 · 실행 및 변경 사항 · 설계 문서

macOS와 Claude Code 2.1.292 이상, openssl이 필요하다. 프록시는 Node.js 18 이상에서 동작하며, 설치 프로그램이 사용 가능한 Node.js를 찾는다. Claude Code 프롬프트에서 /plugin install wirepane --marketplace legostin/wirepane를 실행해 설치한 뒤 /proxy를 입력하면 프록시가 127.0.0.1:8899에서 시작되고 요청 창이 열린다. /proxy setup으로 클라이언트를 설정하고, /proxy stop으로 프록시를 중지할 수 있다.

Wirepane은 TLS를 복호화해 호스트별 요청을 표시하고, 필터링과 트리 보기를 제공한다. 요청·응답 헤더와 압축 해제된 본문을 살펴볼 수 있으며, 지연·속도 제한·모의 응답·헤더 및 본문 변경 등의 규칙을 적용한다. 규칙은 프로젝트의 .claude/proxy-rules.json에 저장되며, 파일이 바뀌면 프록시가 다시 읽는다. 스크립트 규칙은 SHA-256 승인을 거친 뒤 실행된다.

기기 설정 방식은 다르다. 별도 브라우저 창은 자체 프로필을 사용해 인증서 설치 없이 프록시를 신뢰한다. iOS 시뮬레이터와 iPhone, Android 기기는 설정 창의 안내에 따라 인증서와 프록시를 설정해야 한다. Android 휴대전화는 USB 연결을 이용해 Wi-Fi 없이 프록시에 연결할 수도 있다. Safari와 macOS 앱은 CA 인증서를 신뢰해야 하며, 시스템 프록시 설정은 중지 시 복원된다.

기본적으로 프록시는 로컬에서 수신 대기한다. lan 모드를 켜면 네트워크상의 휴대전화가 연결할 수 있다. 추적 도메인을 지정하면 해당 호스트만 복호화·기록하고 나머지 연결은 그대로 통과시킨다. Wirepane은 자체 원격 측정이나 업데이트 확인을 하지 않는다고 밝힌다. 다만 기록된 요청에는 앱의 비밀번호·토큰·개인정보가 들어갈 수 있으며, 요청은 Claude가 도구를 호출해 읽을 때 대화에 포함된다. 기록은 ~/.claude/proxy-mod/flows/에 저장되고 세션 폴더는 마지막 사용 후 이틀이 지나면 삭제된다.

제작자가 밝힌 한계로는 HTTP/1.1만 제공해 HTTP/2 기반 gRPC가 동작하지 않는 점, WebSocket 프레임을 해독하지 않는 점이 있다. kill -9로 프록시를 강제 종료하면 시스템 프록시 설정이 복원되지 않을 수 있다. 플러그인은 초기 접근 단계의 Claude Code API를 사용한다.

관련 자료: Claude Code · CI 상태 · 라이선스 · Wirepane 저장소 · 설치 · 사용 이유 · 기능 · 클라이언트 설정 · Claude Code 보호 · 추적 도메인 · 규칙 · 필터 · Claude용 도구 · 옵션 · 작동 방식 · 실행 및 변경 사항 · 제거 · 자주 묻는 질문 · 제한 사항 · 개발 · MIT 라이선스

Wirepane은 MIT 라이선스로 배포되며 Anthropic, Proxyman, Charles 또는 mitmproxy와 제휴하지 않는다.