Claudit

Claude 기반 자동 UI 검사·E2E 테스트 도구

Claudit은 Claude AI 에이전트가 어드민 패널이나 서비스 페이지 등 웹 화면을 직접 조작해 엔드 투 엔드(E2E) 테스트를 수행하는 Chrome 확장 프로그램입니다. 자연어 지시문으로 자동화 테스트를 실행하거나, 간단한 YAML 파일로 작성된 결정론적(deterministic) 회귀 테스트를 그대로 재실행할 수 있습니다. 모든 처리는 사용자의 브라우저 안에서 진행되며, Claudit이 운영하는 별도의 원격 오케스트레이션 서버는 존재하지 않습니다. 대상 사용자 QA 엔지니어, 테스트 자동화 엔지니어, 프런트엔드/백엔드 개발자, 그리고 반복적인 수동 회귀 테스트를 AI 기반 워크플로우로 대체하고 싶은 제품 팀에 적합합니다. 이미 테스트 스크립트를 작성하고 있지만 "테스트가 필요한 내용을 자연어로 표현하고 싶다"는 요구가 있다면, Claudit이 그 격차를 메워줍니다. 핵심 기능 • 자연어 자동화 — "로그인하고 상품 목록으로 이동해서 지난주 기준으로 필터링한 다음 합계를 검증해줘"라고 지시하면 클릭, 입력, 캡처, 검증을 처음부터 끝까지 수행합니다. • 107개의 내장 브라우저 도구 — 클릭, 입력, 대기, 캡처, DOM 검사, 네트워크 모니터링, 그리고 AgGrid, Material-UI, Ant Design, PrimeReact, TanStack Table, Handsontable 등 주요 UI 라이브러리에 최적화된 헬퍼를 제공합니다. • Mode 1 — 결정론적 회귀 테스트: 특정 URL 패턴에 대해 .test.yaml 파일을 실행하고, PASS/FAIL 결과를 8개 섹션 보고서로 통합합니다. • Mode 2 — 팀 검증: Planner 에이전트가 테스트 계획을 작성하고, Executor가 각 단계를 실행하며, Verifier가 결과를 독립적으로 확인하는 3단계 검증 — 중요한 시나리오에 적합합니다. • 명세(spec) 기반 테스트 — Markdown, YAML, 일반 텍스트 형식의 명세 문서를 지정하면 Claudit이 명세에 근거해 검증을 수행하며, QA 인력이 흔히 놓치는 명세-구현 불일치를 표면화합니다. • 로컬 파일 시스템 통합 — 명세, 테스트 결과, 학습 이력은 File System Access API를 통해 사용자의 로컬 디스크에만 저장됩니다. 클라우드 동기화나 외부 업로드가 일절 없습니다. • 탭별 독립 세션 — 각 탭이 독립된 에이전트 세션으로 동작합니다. 여러 탭에서 서로 다른 테스트를 병렬 실행해도 세션이 교차 오염되지 않습니다. • 커스텀 프로젝트 프롬프트 — 프로젝트 고유의 용어집, UI 규약, CRUD 패턴을 등록해두면 에이전트가 자동으로 로드해 사용합니다. • 한국어/영어 다국어 UI — Chrome 언어 설정에 맞춰 사이드바 인터페이스가 자동 전환됩니다. 작동 원리(개인정보 처리 모델) • 모든 처리는 사용자의 브라우저 안에서 이루어집니다. Claudit이 운영하는 원격 서버, 텔레메트리, 분석, 추적, 쿠키가 일절 없습니다. • API 호출은 사용자가 설정한 Claude API 엔드포인트(기본값: api.anthropic.com)로 브라우저에서 직접 전송됩니다. 내부 프록시나 게이트웨이를 지정하면 그 • Anthropic API 키는 chrome.storage.local에 로컬로 저장되며, Claudit은 사용자가 지정한 엔드포인트 외에는 어디로도 키를 전송하지 않습니다. • 민감한 폼 필드는 Claude API로 전송되기 전에 자동으로 마스킹됩니다: input type="password"/"file"/"hidden" 값, 그리고 data-sensitive, data-pii, data-private 속성이 부여된 모든 요소가 대상입니다. • 최초 사용 시 표시되는 동의 게이트는 어떤 데이터가 전송되는지(스크린샷, DOM 구조, 마스킹된 항목을 제외한 폼 필드 값, 페이지 URL, 선택적 네트워크 요청 URL)를 명시적으로 안내하며, 사용자가 확인하기 전까지 에이전트 동작을 차단합니다. API 사용 비용 Claudit은 사용자 본인의 Anthropic API 키를 사용합니다. 모든 테스트 실행은 브라우저에서 Claude API를 직접 호출하며, 사용 요금은 Anthropic이 사용자 계정에 직접 청구합니다. Claudit은 별도의 비용을 수집하거나 중계하거나 부과하지 않습니다. 장시간의 테스트 스위트를 실행하기 전에 Anthropic의 가격 정책을 검토하시기 바랍니다. 요구 사항 • 유효한 Anthropic Claude API 키 (console.anthropic.com에서 발급). • Chrome 120 이상. • 사용자가 소유 또는 운영하거나, 명시적인 서면 권한을 받은 테스트 대상 사이트. 사용 범위(중요) Claudit은 사용자가 소유한 웹 애플리케이션 또는 서면으로 명시적 테스트 권한을 부여받은 웹 애플리케이션을 테스트할 목적으로 제작되었습니다. 다음 용도로는 사용해서는 안 됩니다. • 사용자가 소유하지 않은 제3자 사이트의 스크래핑. • 인증, 속도 제한 또는 자동화 방지 장치의 우회. • 본인 소유가 아닌 계정의 자동화. • 대상 사이트의 이용 약관을 위반하는 모든 행위. 미허가 사용은 민·형사상 책임을 초래할 수 있습니다 (예: 미국 Computer Fraud and Abuse Act 또는 각국의 동등한 법률). Claudit 사용이 권한 범위 안에 있는지 확인할 책임은 전적으로 사용자에게 있습니다. 권한 사용 사유 • activeTab + scripting — 사용자가 명시적으로 활성화한 탭의 DOM 상태를 읽고 테스트 동작을 디스패치합니다. • tabs — 사이드바의 탭별 세션 UI에 표시할 탭 메타데이터(URL, 제목)를 조회합니다. • debugger — Chrome DevTools Protocol을 통해 합성 키보드/마우스 이벤트를 디스패치합니다. React DevTools, Lighthouse, Playwright 등 유사 도구가 사용하는 표준 기능입니다. • webRequest + webNavigation — 테스트 진행 중 요청 메타데이터(URL, method, status)를 관찰합니다. 요청 본문은 읽지 않습니다. • storage — API 키, 설정, 테스트 이력을 로컬에 저장합니다. • sidePanel + windows — 확장 프로그램의 사이드 패널로 채팅 UI를 제공합니다. • offscreen — 로컬 명세 및 메모리 읽기를 위한 File System Access API 핸들을 호스팅합니다. • notifications — 장시간 실행되는 테스트 완료 시 사용자에게 알립니다. • alarms — 장기 실행 테스트 중 Service Worker가 비활성화되지 않도록 유지합니다. • host_permissions는 https://api.anthropic.com/* 로 한정됩니다 (Claude API 호출용). • optional_host_permissions (https://*/*, http://*/*) — Options 페이지에서 사용자가 실제로 테스트하려는 사이트에 대해서만 사이트 단위로 권한을 부여합니다. 명시적으로 추가하지 않은 사이트에는 Claudit이 접근할 수 없습니다. • optional_permissions (declarativeNetRequestWithHostAccess) — 헤더 재작성이 필요한 커스텀 API 엔드포인트를 설정한 경우에만 요청됩니다. 전체 문서 • 홈페이지: https://github.com/youzooyou/claudit • 개인정보 처리방침: https://github.com/youzooyou/claudit/blob/main/PRIVACY_POLICY.md • 이용 약관: https://github.com/youzooyou/claudit/blob/main/TERMS_OF_SERVICE.md • 권한 상세 안내: https://github.com/youzooyou/claudit/blob/main/docs/permissions.md Claudit은 Anthropic과 무관합니다. "Claude"는 Anthropic의 상표이며, Claudit이 호출하는 API를 설명할 목적으로 본 문서에 표기되었습니다.