마켓 없이 쓰는 플러그인

AI 도구에 확장을 붙이려면 장터에 등록된 것부터 찾는 게 보통입니다. 그런데 만들다 만 걸 잠깐 돌려보고 싶거나, 회사 안에서만 쓰는 걸 나눠주고 싶을 때는 그 과정이 통째로 부담이 됩니다. 이제 압축 파일 하나 또는 주소 하나만으로 바로 띄울 수 있습니다. 같은 이름이 이미 깔려 있어도 이번 실행에서는 내 것이 우선하고요. 다만 플러그인이 담을 수 있는 것의 범위를 알고 나면 아무 주소나 가리키면 안 되는 이유도 분명해집니다. 그 둘을 같이 정리했습니다.

📌 30초 요약

• 폴더뿐 아니라 압축 파일도 됩니다 — 풀지 않고 그대로 가리키면 로드됩니다.
• 주소로도 됩니다 — 시작할 때 받아서 그 실행 동안만 씁니다.
• 같은 이름이 깔려 있어도 내 것이 이깁니다 — 지우고 시험할 필요가 없습니다.
• 못 받아와도 안 죽습니다 — 그냥 그것 없이 시작하고 오류 목록에 남습니다.
• 상시로 두는 길도 따로 있습니다 — 장터도 설치도 없이 폴더에 넣는 방식.
• ⚠️ 아무 주소나 가리키면 안 됩니다 — 실행 파일과 배경 감시까지 담을 수 있습니다.

압축 파일과 주소로 부르기

원래 있던 방식은 폴더를 가리켜 그 안의 플러그인을 띄우는 것이었습니다. 만드는 중에 시험할 때 쓰는 용도였죠. 여기에 두 가지가 붙었습니다. 하나는 같은 자리에 압축 파일을 넣어도 된다는 것. 풀어놓을 필요 없이 파일 하나를 그대로 가리키면 됩니다. 다른 하나는 그 압축 파일이 인터넷 어딘가에 있어도 된다는 것입니다. 주소를 주면 시작할 때 받아서 씁니다.

주소 방식의 성격이 중요합니다. 문서는 "그 실행 동안만 로드한다"고 못 박아 뒀습니다. 설치가 아니라 빌려 쓰는 것에 가깝습니다. 그래서 자동 빌드가 만들어 놓은 결과물을 그대로 가리켜 "이번 것만 한번 돌려보자"가 됩니다. 여러 개를 한꺼번에 부르고 싶으면 같은 옵션을 여러 번 쓰거나, 주소들을 공백으로 이어 따옴표로 묶어 한 번에 줄 수도 있습니다.

방식	유효 범위	이럴 때
폴더 가리키기	그 실행 동안	내가 지금 고치고 있는 것
압축 파일 가리키기	그 실행 동안	받아둔 것을 풀지 않고 시험
주소 가리키기	그 실행 동안	자동 빌드 결과물·사내 배포
스킬 폴더에 두기	계속	내가 늘 쓰는 것, 장터 없이
장터에서 설치	계속	남이 만든 것을 정식으로

못 받아왔을 때의 동작도 적혀 있습니다. 주소가 죽었거나 파일이 망가졌으면 그것 없이 그냥 시작하고, 플러그인 관리 화면의 오류 목록에 기록을 남깁니다. 실행 자체가 막히지 않는다는 뜻이라 자동화에 걸어두기에도 부담이 적습니다. 반대로 "분명 붙였는데 명령이 안 보인다" 싶을 때 제일 먼저 볼 곳도 거기입니다.

같은 이름이 이미 깔려 있어도

실무에서 제일 성가신 상황이 하나 풀렸습니다. 장터에서 설치해 쓰던 확장을 고쳐보려면 예전에는 먼저 지워야 했습니다. 지금은 같은 이름의 로컬 사본을 가리키면 그 실행 동안 로컬 쪽이 이깁니다. 쓰던 걸 건드리지 않고 수정본만 얹어 확인한 뒤, 창을 닫으면 원래대로 돌아옵니다.

예외가 하나 있습니다. 관리 설정이 켜라 꺼라 강제해둔 플러그인은 이 방식으로 못 덮습니다. 회사에서 지급한 장비라면 여기서 막힐 수 있으니, 안 먹힌다고 설정을 의심하기 전에 그쪽부터 확인하시는 게 빠릅니다. 그리고 고치는 도중에는 다시 읽어들이는 명령으로 재시작 없이 반영할 수 있는데, 스킬·에이전트·훅·연결 서버·코드 인텔리전스 서버까지 한 번에 다시 읽습니다. 훅을 어떻게 짜서 끼우는지는 셸을 거치지 않는 훅 실행 방식에서 따로 다뤘습니다.

장터 없이 상시로 두는 길

매번 옵션을 붙이는 게 번거롭다면 방법이 하나 더 있습니다. 뼈대를 만들어주는 명령을 쓰면 내 스킬 폴더 안에 플러그인 한 벌이 생기고, 다음 실행부터 장터도 설치 단계도 없이 자동으로 잡힙니다. 이름 뒤에 어디서 왔는지 표시가 붙어 구분됩니다. 개인용으로 쓸지 프로젝트에 둘지, 그리고 작업 폴더를 신뢰해야 하는 조건 같은 건 별도 문서에 정리돼 있습니다.

만들 때 가장 흔한 실수도 문서가 경고 상자로 못 박아 뒀습니다 — 스킬·에이전트·훅 폴더를 설정 폴더 안에 넣으면 안 됩니다. 설정 폴더에는 정체를 적는 파일 하나만 들어가고, 나머지는 전부 바깥, 즉 플러그인 뿌리에 있어야 합니다. 확장을 여러 개 얹어 쓰는 방식 자체가 어떤 이득과 부담을 갖는지는 확장 묶음을 통째로 뜯어봤던 글에서 정리한 적이 있습니다.

무엇이 딸려 오는가

🔒 "신뢰하는 것만"이라는 경고의 실제 내용

문서는 주소 방식에 대해 내가 통제하거나 신뢰하는 것만 가리키라고 적어뒀습니다. 왜 그런지는 플러그인이 담을 수 있는 목록을 보면 분명합니다 — 지시문·보조 에이전트·훅·외부 연결 서버·코드 인텔리전스 서버에 더해, 실행 파일을 담는 자리가 따로 있고 그것들이 켜져 있는 동안 명령 검색 경로에 들어갑니다. 배경에서 계속 도는 감시 항목도 담을 수 있는데, 여기 적힌 명령의 출력이 그대로 대화에 전달됩니다. 게다가 기본 설정 파일로 본체가 쓰는 에이전트 자체를 바꿔 지시문·도구 제한·모델까지 갈아끼울 수 있습니다. 압축 파일 하나가 이만큼을 들고 옵니다.

반대로 보면 플러그인 하나로 작업 환경을 통째로 넘겨줄 수 있다는 뜻이기도 합니다. 팀에서 쓰는 검사 규칙, 배경 감시, 전용 에이전트를 한 벌로 묶어 압축한 뒤 주소만 알려주면 됩니다. 특정 도구를 위한 전용 확장을 통으로 받아 쓰는 감각은 전용 플러그인으로 앱을 만들어봤을 때와 비슷한데, 이제 그 배포 경로가 장터를 거치지 않아도 되는 형태로 하나 더 생긴 셈입니다.

🔁 반대로, 마켓에 닿아야만 되는 자리

여기서는 장터 없이 플러그인을 쓰는 법을 적었는데, 반대인 자리가 하나 있습니다. 클라우드 세션으로 넘어가는 설정을 보면 저장소 설정에 적어 둔 플러그인은 세션이 시작될 때 장터에서 내려받아 설치합니다. 그래서 장터에 닿을 바깥 연결이 열려 있어야 하고, 망을 잠가 두면 플러그인이 조용히 빠집니다. 한편 내 설정에만 켜 둔 플러그인은 아예 안 따라가고, 계정 쪽에서 켜 두면 동기화되는 형태로 실립니다. 클라우드에서 쓰실 거면 어느 경로로 들어오는지부터 정하세요.

자주 묻는 질문 (FAQ)

Q. 장터에 안 올리고 팀에 나눠줄 수 있나요?

됩니다. 압축해서 사내 저장소나 산출물 보관소에 올려두고 주소만 공유하면 각자 그 주소로 띄웁니다. 다만 이 방식은 실행할 때마다 붙여야 하니, 늘 쓰는 것이라면 각자 스킬 폴더에 두는 쪽이 편합니다. 정식으로 버전을 관리하며 배포하고 싶다면 비공개 저장소를 장터로 쓰는 길이 따로 있습니다.

Q. 붙였는데 명령이 안 보입니다

순서대로 셋을 확인하세요. ①오류 목록 — 못 받아왔거나 파일이 망가졌으면 조용히 넘어가고 거기 기록이 남습니다. ②폴더 구조 — 스킬·에이전트·훅 폴더가 설정 폴더 안에 들어가 있으면 안 잡힙니다. ③다시 읽기 — 고친 직후라면 재시작 대신 다시 읽어들이는 명령을 한 번 치면 됩니다. 참고로 플러그인의 명령은 이름 앞에 플러그인 이름이 붙어 나오니, 그냥 이름만으로 찾으면 안 보일 수 있습니다.

Q. 남이 준 주소를 그냥 붙여도 되나요?

권하지 않습니다. 플러그인은 설정 뭉치가 아니라 실행 파일과 배경에서 도는 명령까지 담을 수 있는 꾸러미입니다. 켜져 있는 동안 그 안의 실행 파일이 명령 검색 경로에 올라가고, 감시 항목에 적힌 명령은 계속 돕니다. 출처가 확실하지 않다면 압축을 먼저 풀어 내용물을 눈으로 보고 붙이시는 편이 안전합니다.

🧾 정직하게 밝혀둘 것

• 직접 압축 파일을 만들어 주소로 올려 띄워보지는 않았습니다. 문서에 적힌 동작과 제약을 정리한 것입니다.
• 받아온 파일을 어딘가에 보관해두는지, 다음 실행 때 다시 받는지는 문서에서 확인하지 못했습니다. "그 실행 동안만 로드한다"는 서술만 있습니다.
• 옵션과 명령 표기는 읽기 쉽게 풀어 적었습니다. 정확한 철자는 원문 문서를 보셔야 합니다.
• 관리 설정이 강제한 플러그인은 로컬 사본으로 덮을 수 없습니다. 회사 장비에서는 결과가 다를 수 있습니다.
• 한 주치(5월 4~8일) 변경점이 출발점이고, 플러그인이 담을 수 있는 항목은 계속 늘어나는 중입니다.

✨ 정리하면

확장을 붙이는 문턱이 "장터에 올린다"에서 "파일 하나를 건넨다"로 내려왔습니다. 시험할 때는 지우지 않고 얹어서, 나눠줄 때는 주소 하나로, 늘 쓸 것은 폴더에 두고. 대신 그 파일 하나가 실행 파일과 배경 명령까지 들고 온다는 건 알고 쓰셔야 합니다. 확장 묶음의 득실은 확장 묶음 총정리, 전용 플러그인으로 앱을 만드는 쪽은 전용 플러그인 가이드, 그 안에 담기는 훅은 셸 없이 도는 훅, 도구에 드는 값을 통으로 잡는 흐름은 AI 지출 관리 허브에 모아뒀습니다.

※ 출처: Claude Code 주간 변경 노트 2026년 19주차(5월 4~8일, v2.1.128~v2.1.136)와 플러그인 제작 공식 문서. 본문의 동작은 2026년 8월 기준으로 문서에 적힌 내용이며, 옵션 이름과 담을 수 있는 항목은 버전에 따라 달라집니다. 외부 주소에서 받아오는 방식은 출처를 확인한 뒤 사용하세요.