noemica-io/open-claude-in-chrome

공식 Claude in Chrome은 58개의 차단된 도메인과 두 개의 브라우저만 제공합니다.
Open Claude in Chrome은 웹 전체를 제공합니다.

Anthropic 브라우저 확장 프로그램의 클린룸 재구현 (Clean-room reimplementation). 차단 목록 없음. 모든 Chromium 브라우저 지원. 100% 기능 및 성능 동일.

작성자: noemica

차이점 · 설치 · 아키텍처 · 데모 · 제작 방식

Claude가 공식 확장 프로그램이 접근할 수 없는 사이트인 Tinder, Reddit, Robinhood를 탐색하는 모습을 확인하세요.

공식 Claude in Chrome 확장 프로그램은 Anthropic의 "안전한" 사이트 허용 목록(allowlist) 내에 머무는 한 Claude Code에 완전한 브라우저 자동화 기능을 제공합니다. Open Claude in Chrome은 18개의 모든 MCP 도구를 유지하면서 제한 사항을 제거하고 공식 확장 프로그램과 동일한 성능을 구현한 클린룸 재구현(clean-room reimplementation) 프로젝트입니다.

비교 항목	Claude in Chrome	Open Claude in Chrome
도메인 차단 목록 (Domain blocklist)	11개 카테고리에 걸친 58개 차단 도메인	차단 목록 없음. 어디든 탐색 가능.
브라우저 지원	Chrome 및 Edge만 지원	모든 Chromium 브라우저 (Chrome, Edge, Brave, Arc, Opera, Vivaldi 등)
소스 코드	폐쇄형 소스 (Closed source)	오픈 소스 (Open source, MIT)
도구 (Tools)	18개의 MCP 도구	동일한 18개의 MCP 도구
성능	기준점 (Baseline)	동일 (Identical)

카테고리	차단된 사이트
금융 (Banking)	Chase, BofA, Wells Fargo, Citibank
...

Open Claude in Chrome에는 이러한 제한 사항이 전혀 없습니다.

Claude Code <--stdio MCP--> mcp-server.js <--TCP--> native-host.js <--native messaging--> Extension <--> Browser

세 가지 구성 요소:

Extension (확장 프로그램)— CDP 기반 브라우저 자동화(18개 도구 전체)를 포함하는 Manifest V3
MCP Server (MCP 서버)— Claude Code에 의해 시작되는 Node.js 프로세스로, MCP를 통해 도구를 노출함
Native Messaging Host (네이티브 메시징 호스트)— MCP 서버와 확장 프로그램 사이의 브릿지

Node.js v18+
모든 Chromium 브라우저 (Chrome, Edge, Brave, Arc, Opera, Vivaldi 등)
Claude Code v2.0.73+

cd host
npm install
cd ..

• 다음 주소로 이동:
  chrome://extensions

(또는 brave://extensions / edge://extensions)

• Developer mode (개발자 모드) 활성화
• **Load unpacked (압축해제된 확장 프로그램을 로드합니다)**를 클릭하고 extension/ 폴더를 선택하세요.

디렉토리 - 확장 프로그램 이름 아래에 표시된 **extension ID (확장 프로그램 ID)**를 복사하세요.

./install.sh <your-extension-id>

여러 브라우저를 사용하는 경우, 모든 ID를 전달하세요:

./install.sh <chrome-id> <brave-id> <arc-id>

모든 창을 닫고 다시 여세요. 브라우저는 시작 시 네이티브 메시징 호스트 (native messaging host) 설정을 읽어옵니다.

claude mcp add open-claude-in-chrome -- node /absolute/path/to/host/mcp-server.js

다음 명령어로 절대 경로를 확인하세요:

echo "node $(pwd)/host/mcp-server.js"

새로운 Claude Code 세션을 시작하고 테스트하세요:

reddit.com으로 이동하여 스크린샷을 찍어줘

Reddit이 로드됩니다. 도메인 제한이 없습니다.

Chrome에서의 Claude와 동일한 18개의 도구:

도구	설명
tabs_context_mcp	탭 그룹 컨텍스트 (tab group context) 가져오기
tabs_create_mcp	새 탭 생성
navigate	URL 이동, 뒤로 가기, 앞으로 가기
computer	마우스, 키보드, 스크린샷 (13가지 동작)
read_page	요소 참조 (element refs)가 포함된 접근성 트리 (accessibility tree)
get_page_text	기사/본문 텍스트 추출
find	텍스트/속성으로 요소 찾기
form_input	참조를 통해 폼 값 설정
javascript_tool	페이지 컨텍스트에서 JS 실행
read_console_messages	콘솔 출력 (필터링됨)
read_network_requests	네트워크 활동
resize_window	브라우저 창 크기 조정
upload_image	파일 입력창에 스크린샷 업로드
gif_creator	GIF 녹화 (stub)
shortcuts_list	단축키 목록 (stub)
shortcuts_execute	단축키 실행 (stub)
switch_browser	브라우저 전환 (stub)
update_plan	계획 제시 (자동 승인)

빌드 단계는 없습니다. 모든 파일은 일반 JavaScript입니다. 코드를 가져오거나(pulling) 편집한 후에는:

변경 사항	조치 사항
extension/background.js 또는 extension/content.js 또는 extension/manifest.json
확장 프로그램 재로드: brave://extensions > 새로고침 아이콘 클릭
host/mcp-server.js
오래된 서버를 종료하고 재연결: pkill -f "node.*mcp-server" 실행 후 Claude Code에서 /mcp 입력
host/native-host.js
브라우저 재시작 (모든 창을 닫고 다시 열기)
install.sh 또는 네이티브 호스트 (native host) 이름이 변경됨
./install.sh <extension-id> 재실행, 브라우저 재시작, MCP 재추가

문제가 발생했는데 원인을 알 수 없는 경우:

# 1. 모든 MCP 서버 종료
pkill -f "node.*mcp-server"
# 2. 설치 재실행
...

여러 개의 Claude Code 세션이 동일한 브라우저 확장 프로그램을 공유할 수 있습니다. 첫 번째 세션이 "기본 (primary)" 세션(TCP 포트를 소유)이 되며, 이후의 세션들은 기본 세션을 통해 클라이언트로서 연결됩니다. 모든 세션은 브라우저를 동시에 사용할 수 있습니다.

세션이 연결 해제되면, 오래된 서버를 종료하고 재연결하세요:

pkill -f "node.*mcp-server"
# 그 다음 각 Claude Code 세션에서 /mcp 입력

• 확장 프로그램이 로드되고 활성화되었는지 확인
• ./install.sh가 올바른 확장 프로그램 ID와 함께 실행되었는지 확인
• 브라우저를 완전히 재시작 (모든 창)
• 네이티브 메시징 호스트 (native messaging host) 매니페스트가 존재하는지 확인:
  Chrome (macOS):~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.anthropic.open_claude_in_chrome.json

Brave (macOS):~/Library/Application Support/BraveSoftware/Brave-Browser/NativeMessagingHosts/com.anthropic.open_claude_in_chrome.json

Edge (macOS):~/Library/Application Support/Microsoft Edge/NativeMessagingHosts/com.anthropic.open_claude_in_chrome.json

절대 경로를 사용하세요:

claude mcp add open-claude-in-chrome -- node /절대/경로/to/host/mcp-server.js

MCP 서버는 시작되었으나 네이티브 호스트 (native host)가 연결되지 않은 경우. 다음을 시도하세요:

• 아무 웹페이지나 열기 (서비스 워커 (service worker)를 깨움)
• 서비스 워커 로그 확인:
  chrome://extensions

"검사 보기: 서비스 워커 (Inspect views: service worker)" - host/native-host-wrapper.sh가 존재하는지 확인

이전 세션의 오래된 (Stale) MCP 서버 프로세스가 포트를 점유하고 있을 수 있습니다. 해결 방법:

pkill -f "node.*mcp-server"

그 다음, 다시 연결하기 위해 Claude Code에서 /mcp를 입력하세요. 새로 실행된 서버가 포트를 바인딩 (bind)하고 네이티브 호스트 (native host) 연결을 수락할 것입니다.

기본 포트는 18765입니다. 변경하려면:

• ~/.config/open-claude-in-chrome/config.json 파일을 생성하세요.

:{ "port": 19000 }

• 브라우저와 Claude Code를 재시작하세요.

MIT

Sebastian Sosa (Noemica) 제작