Claude Code의 Reddit 차단 우회를 위한 브라우저 확장 프로그램 패치 가이드

커뮤니티 반응

작성자가 제시한 상세한 패치 방법 외에도 CLI 도구를 활용한 더 쉬운 대안에 대한 언급이 포함되어 있다.

주요 논점

01찬성다수

확장 프로그램의 내부 로직을 수정하여 Anthropic의 인위적인 도메인 제한을 완전히 제거할 수 있다.

합의점 vs 논쟁점

합의점

Anthropic의 공식 확장 프로그램이 특정 사이트에서 Claude Code의 기능을 제한하고 있다.
로컬에서 소스 코드를 수정하고 개발자 모드로 로드하는 방식이 유효한 해결책이다.

논쟁점

확장 프로그램 패치 방식의 번거로움 때문에 wonda sh와 같은 외부 CLI 도구를 사용하는 대안이 선호되기도 한다.

실용적 조언

확장 프로그램 수정이 복잡하다면 wonda sh와 같은 우회 기능을 갖춘 CLI 도구를 사용하는 것이 더 간편하다.
패치 후에는 반드시 기존 Claude Code 확장 프로그램을 비활성화해야 충돌을 방지할 수 있다.

섹션별 상세

Claude Code의 브라우저 확장 프로그램은 Anthropic API를 호출하여 방문 중인 URL의 카테고리를 확인한다. API 응답이 category1 또는 category2로 분류되면 안전 제한을 이유로 사이트 상호작용을 차단한다. 이를 해결하기 위해 확장 프로그램의 소스 코드를 로컬로 복사한 뒤 API 체크를 수행하는 함수를 무력화하는 과정이 필요하다.

javascript

static async getCategory(e){
  if(await $.isUrlBlockedByManagedPolicy(e)) return "category_org_blocked";
  // ... fetches category from api.anthropic.com ...
}

Anthropic API를 통해 도메인의 차단 카테고리를 확인하는 기존 로직

bash

code = code.replace(
  /static async getCategory\(e\)\{/,
  'static async getCategory(e){return undefined;'
);

도메인 분류 함수가 항상 undefined를 반환하도록 수정하여 차단을 우회하는 패치 코드

Chrome의 보안 메커니즘인 해시 검증을 우회하기 위해 확장 프로그램 내 _metadata 폴더를 삭제해야 한다. 수정된 코드가 포함된 폴더를 '압축 해제된 확장 프로그램' 모드로 로드하면 브라우저는 변조된 코드를 정상적으로 실행한다. 이 과정에서 기존의 공식 확장 프로그램은 비활성화하고 개발자 모드를 활성화하는 설정 변경이 수반된다.

패치 작업은 mcpPermissions 관련 JavaScript 파일 내의 getCategory 정적 메서드를 대상으로 수행된다. 해당 함수가 호출될 때 즉시 undefined를 반환하도록 코드를 치환하면 어떤 도메인도 차단 대상으로 분류되지 않는다. Node.js를 활용한 간단한 문자열 치환 스크립트를 통해 자동화된 패치가 가능하다는 점이 확인됐다.

용어 해설

모델 컨텍스트 프로토콜(MCP): — AI 모델이 외부 도구나 데이터 소스와 상호작용하기 위한 표준 규약이다. 이 글에서는 브라우저 확장 프로그램이 특정 웹사이트의 데이터를 읽어올 때 권한을 제어하는 메커니즘으로 활용됐다.
압축 해제된 확장 프로그램(Unpacked Extension): — Chrome 웹 스토어를 거치지 않고 로컬 디렉토리에서 직접 로드하는 확장 프로그램 형태이다. 개발자가 소스 코드를 직접 수정하고 즉시 반영하여 테스트할 수 있는 환경을 제공한다.
해시 검증(Hash Verification): — 파일의 무결성을 확인하기 위해 고유한 해시값을 비교하는 보안 절차이다. Chrome은 확장 프로그램의 코드가 변조되었는지 확인하기 위해 이를 사용하며, 수정을 위해서는 관련 메타데이터를 제거해야 한다.

언급된 도구

Claude Code중립

Anthropic에서 제공하는 AI 코딩 에이전트 및 CLI 도구

wonda sh추천

도메인 제한을 우회하여 스크래핑 등을 수행할 수 있는 CLI 도구