Claude Code 브라우저 확장 프로그램 역공학 및 무제한 버전 재구축

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

Claude Code의 브라우저 확장 프로그램을 역공학하여 MCP 기반의 무제한 실행 환경을 구축하고 주요 기술적 난제 해결법을 공유한 프로젝트이다.

배경

Claude Code 유출 이후, 크롬 브라우저 내의 MCP 도구 스키마를 분석하여 제약 없는 실행 환경을 직접 구현하고 기술적 난제 해결 과정을 공유했다.

의미 / 영향

이 프로젝트는 Claude Code와 같은 상용 에이전트의 내부 작동 원리를 MCP 표준을 통해 재현할 수 있음을 입증했다. 브라우저 자동화 과정에서 발생하는 DPR 조정이나 MV3 제약 해결과 같은 실무적 난제들에 대한 구체적인 해결책이 커뮤니티에 공유됐다. 이는 향후 오픈소스 기반의 자율형 웹 에이전트 개발에 중요한 기술적 토대가 될 것으로 보인다.

실용적 조언

브라우저 에이전트 개발 시 CDP를 통해 DPR을 1로 고정하여 좌표 정확도를 확보할 것
MV3 환경에서 서비스 워커의 30초 제한에 대비한 연결 유지 전략이 필요함

섹션별 상세

Claude의 MCP 도구 스키마를 분석하여 18개의 도구와 5개의 프로세스를 재구축했다. 각 도구 호출 시 4단계의 프로토콜 변환을 수행하여 브라우저 환경에서 LLM이 명령을 실행하도록 설계했다. 원문에서 18개 도구와 4단계 변환 과정을 명시했다. 모델이 브라우저와 상호작용하는 표준화된 인터페이스를 오픈소스로 구현했다는 의미가 있다.

화면 캡처 시 발생하는 좌표 오류를 해결하기 위해 CDP를 사용했다. DPR을 1로 강제 설정하여 Retina 디스플레이의 고해상도 이미지가 3배 크게 캡처되는 현상을 방지했다. 원문에서 DPR=1 설정을 하지 않을 경우 클릭 위치가 빗나간다는 실무적 장애물을 제시했다. 시각적 에이전트의 정확도를 높이기 위한 필수적인 전처리 공정이다.

크롬 확장 프로그램의 MV3 규격으로 인한 실행 중단 문제를 해결했다. 30초 후 자동으로 종료되는 서비스 워커가 네이티브 메시징 연결을 끊지 않도록 관리 프로세스를 최적화했다. 서비스 워커의 30초 제한이 작업 도중 연결을 끊는다는 구체적 한계를 명시했다. 최신 브라우저 환경에서 안정적인 LLM 에이전트를 구동하기 위한 기술적 우회책을 제시했다.

Reddit 등 복잡한 웹사이트의 Shadow DOM 구조와 브라우저 프로필 간의 포트 충돌을 처리했다. 표준 DOM 탐색이 불가능한 영역에 접근하기 위한 로직을 구현하고 TCP 포트 점유 문제를 조정했다. Reddit의 Shadow DOM이 탐색을 방해한다는 구체적 사례를 언급했다. 실제 상용 웹사이트 환경에서 에이전트의 범용성을 확보하는 방법을 보여준다.

실무 Takeaway

Claude Code의 핵심 로직을 MCP 스키마 기반으로 재구현하여 브라우저 내 자율 에이전트 환경을 구축할 수 있다.
브라우저 자동화 에이전트 구축 시 CDP를 이용한 DPR 조정은 정확한 좌표 계산과 토큰 절약을 위해 필수적이다.
MV3의 서비스 워커 제약과 Shadow DOM 같은 웹 표준의 특수성이 LLM 에이전트의 안정성에 큰 영향을 미친다.

언급된 도구

Claude Code중립

LLM 기반 코딩 에이전트

MCP추천

Model Context Protocol 도구 스키마 활용

Chrome중립

브라우저 확장 프로그램 실행 환경

언급된 리소스

GitHubopen-claude-in-chrome GitHub Repository