웹스토어에 없는 크롬 확장, zip으로 설치하기 (압축 해제된 항목 로드)

웹스토어에 등록되지 않은 크롬 확장은 zip을 더블클릭해서 설치할 수 없습니다.
대신 압축을 푼 폴더를 통째로 크롬에 올리는 방식(unpacked) 으로 설치합니다.

zip 다운로드 → 압축 풀기 → 개발자 모드 켜기 → 폴더 올리기

준비물

• 크롬 (Edge, Whale 등 Chromium 기반 브라우저 동일)
• 설치할 확장 zip 파일

1. zip을 받아 압축을 풉니다

압축을 풀면 폴더 안에 manifest.json 이 있습니다. 이 파일이 있어야 정상입니다.

my-extension/
├─ manifest.json   ← 이 파일이 있어야 정상
├─ src/
└─ icons/

⚠️ 이 폴더는 설치 후 지우거나 옮기지 마세요. 크롬이 폴더 위치를 계속 참조해서, 폴더가 사라지면 확장도 비활성화됩니다. ~/chrome-extensions/처럼 고정해 둘 위치를 권장합니다.

2. 확장 프로그램 관리 페이지를 엽니다

주소창에 chrome://extensions 를 붙여넣고 Enter. (chrome:// 주소는 링크 클릭으로 이동이 안 되므로 복사해서 붙여넣어야 합니다.)

3. 개발자 모드를 켭니다

화면 오른쪽 위 의 개발자 모드(Developer mode) 토글을 켭니다. 켜면 왼쪽 위 에 압축 해제된 항목 로드 버튼이 나타납니다.

4. “압축 해제된 항목 로드”로 폴더를 올립니다

압축 해제된 항목 로드(Load unpacked) 를 클릭하고, 1단계에서 압축을 푼 폴더(manifest.json이 든 폴더)를 선택합니다.

⚠️ 폴더 안의 파일이 아니라 폴더 자체 를 선택해야 합니다.

목록에 확장 카드가 추가되면 설치 완료입니다.

5. 툴바에 고정 (선택)

확장은 처음에 주소창 오른쪽 퍼즐 아이콘(🧩) 안에 들어 있습니다. 확장 옆 핀(📌) 을 누르면 툴바에 고정됩니다.

업데이트

unpacked 확장은 웹스토어 확장과 달리 자동 업데이트되지 않습니다. 새 버전 zip을 받아 같은 폴더에 덮어쓴 뒤, 확장 카드의 새로고침(↻) 을 누릅니다.

문제 해결

폴더를 잘못 골랐거나 파일이 빠지면 확장 카드에 빨간 오류 버튼 이 뜹니다. 누르면 원인을 보여줍니다.

본문 스크린샷은 Chrome 공식 Hello World 튜토리얼에서 가져왔습니다.