무엇이 나왔나 — 플러그인 안에 들어가는 JavaScript 함수

모드는 플러그인의 한 종류입니다. JavaScript나 TypeScript로 쓴 함수 묶음이고, Claude가 도구를 쓰려 할 때·사용자가 프롬프트를 보낼 때·화면 일부를 그릴 때 같은 순간(이벤트)마다 Claude Code가 이 함수를 불러 줍니다. 함수는 그 순간을 지켜보기만 할 수도, 내용을 바꿀 수도, 아예 대신 처리할 수도 있습니다. 공식 문서가 꼽는 쓰임은 다섯 가지입니다. 대화 옆에 별도 창(패널)을 그리기, 스피너나 도구 실행 줄처럼 Claude Code가 원래 그리던 화면을 바꾸기, 도구 실행을 붙잡아 사용자에게 먼저 묻기, Claude를 거치지 않고 바로 실행되는 /명령어 만들기, 여러 함수가 데이터를 나눠 쓰기입니다. 2.1.287 이상이면 따로 켜지 않아도 동작하고, 화면에 그리는 기능은 터미널과 데스크톱 앱의 Code 탭에서만 보입니다. VS Code 확장의 채팅 창이나 claude -p 같은 무인 실행에서는 함수는 돌지만 화면에는 아무것도 그려지지 않습니다.

스킬·훅·MCP와 무엇이 다른가 — 고르는 기준

Claude Code에는 이미 확장 방법이 여럿 있습니다. 차이는 '어디서 돌아가느냐'입니다. 스킬은 Claude가 읽는 지시서(SKILL.md)라서 Claude가 아는 것과 하는 방식을 바꿉니다. 설정 훅(settings hook)은 settings.json에 적어 둔 셸 명령을 특정 시점에 바깥에서 실행해, 도구 실행을 막거나 허용하거나 기록합니다. MCP 서버는 바깥 프로그램으로 Claude에게 새 도구를 쥐여 줍니다. 모드만 Claude Code 안쪽에서 함수로 돌아가므로 화면을 그리고, 이벤트를 고쳐 쓸 수 있습니다. 공식 문서의 비교표를 실무 기준으로 줄이면 이렇습니다. 같은 지시를 매번 붙여 넣고 있다면 스킬, 이미 있는 스크립트로 막기·허용·기록만 하면 된다면 설정 훅, 쇼핑몰 관리자나 구글 드라이브 같은 외부 시스템에 닿아야 한다면 MCP, 작업 화면에 직접 보이는 창이나 버튼이 필요할 때만 모드입니다. 문서도 이미 다른 방식으로 되는 일이라면 모드를 쓰기 전에 비교해 보라고 권합니다.

모드는 내 권한으로 돌아갑니다 — 닿는 범위 6가지

공식 문서는 설치 전에 알아야 할 접근 범위를 따로 정리해 두었습니다. 한 번 로드된 모드는 ① 내 계정이 열 수 있는 모든 파일을 읽고 쓰며 프로그램 실행과 네트워크 요청을 할 수 있고, ② 환경변수와 설정 파일에 있는 API 키를 읽을 수 있고, ③ 내가 보내는 모든 프롬프트와 Claude의 모든 도구 실행을 볼 수 있고, ④ 프롬프트나 도구 실행을 고쳐 쓰거나 내가 입력한 것처럼 보낼 수 있고, ⑤ 나에게 묻기 전에 도구 실행을 승인할 수 있고, ⑥ 내 요금제나 API 키로 모델을 호출할 수 있습니다. 샌드박스를 켜도 격리되는 것은 Claude가 실행하는 Bash 명령뿐이고, 모드가 띄운 프로세스는 그 밖에서 돌아갑니다. 반대로 모드가 바꿀 수 없는 곳도 하나 명시되어 있습니다. 권한 확인 창(permission prompt)의 표시 내용입니다. 누끼토끼 작업 환경에도 식스샵 게시판 연동 키와 SFTP 접속 정보가 환경변수 파일로 들어가 있습니다. 출처가 불분명한 모드 하나가 여러 클라이언트의 키에 한꺼번에 닿을 수 있다는 뜻이라, 모드는 스킬보다 한 단계 더 엄격하게 골라야 합니다.

설치 전에 읽고, 문제가 생기면 끄는 3단계

첫째, 설치 전에 내용을 확인합니다. 모드 폴더를 내려받은 뒤 터미널에서 claude plugin validate ./모드폴더를 실행하면, 실행하지 않고도 출력의 hooks: 줄에서 어떤 이벤트를 다루는지, calls: 줄에서 파일 읽기·네트워크 요청 같은 무엇을 요청하는지 보여 줍니다. 쇼핑몰 작업과 상관없는 네트워크 요청이나 도구 자동 승인이 보이면 설치하지 않는 것이 기준입니다. 둘째, 지금 무엇이 켜져 있는지 봅니다. Claude Code에서 /plugin을 열면 탭 아래 흐린 글씨로 "1 mod active · 이름"처럼 로드된 모드 수와 이름이 나옵니다. 셋째, 끄는 범위를 고릅니다. 모드 하나만 끌 때는 /plugin의 Installed 탭에서 비활성화, 이번 세션만 전부 끌 때는 claude --safe-mode로 시작, 모든 세션에서 설치한 모드를 끌 때는 ~/.claude/settings.json에 "disableAllHooks": true를 넣습니다. 마지막 방법은 직접 등록한 설정 훅과 상태 표시줄까지 함께 멈추므로, 예약 작업이나 알림을 훅에 걸어 둔 경우 영향 범위를 먼저 확인해야 합니다. 미리보기 기간에 CLAUDE_CODE_ENABLE_FUNCTION_HOOKS를 설정해 두었다면 2.1.287부터는 무시되므로 지우라는 안내도 있습니다.

처음 써 볼 만한 것 — 이미 들어 있는 내장 모드부터

새 모드를 찾기 전에 이미 들어 있는 것부터 보는 편이 안전합니다. /diff 화면과 AGENTS.md를 프로젝트 지시서로 읽어 주는 기능도 사실 Claude Code에 내장된 모드입니다. 같은 날 추가된 'You should know'는 기본으로 꺼져 있는 내장 모드로, 긴 작업을 하는 동안 보조 에이전트가 사용자나 Claude가 놓칠 만한 점을 찾아 입력창 위에 메모로 띄웁니다. /plugin enable cc-plugin-you-should-know@builtin으로 켜며, 변경 기록에는 원격 분석(telemetry)이 켜진 Anthropic 직접 세션에서 쓸 수 있다고 적혀 있습니다. 참고로 disableAllHooks나 --safe-mode는 내장 모드를 멈추지 않으니, 끌 때는 /plugin에서 개별로 비활성화합니다. 직접 만들어 보고 싶다면 원하는 기능을 Claude Code에 설명하면 Claude가 모드를 작성해 주는 경로가 문서에 안내되어 있습니다. Anthropic이 공개한 예제 중 blast-radius는 rm -rf나 강제 push 같은 위험한 명령을 붙잡아 무엇이 바뀔지 보여 주고 진행·취소 버튼을 띄웁니다. 클라이언트 서버에 파일을 올리는 작업을 Claude에 맡기는 제작자라면 이런 '한 번 더 보기' 장치가 모드의 가장 현실적인 첫 쓰임입니다. 다만 예제는 지원 없이 있는 그대로 공유된 것이라, 써 보더라도 위의 validate 확인을 거친 뒤 한 세션에서만 불러 보는 것이 순서입니다.

모드는 Claude Code를 '설정하는 도구'에서 '내 방식대로 고쳐 쓰는 도구'로 바꿉니다. 대신 내 권한 전체를 넘겨받는 코드이므로, 스킬·훅·MCP로 되는 일은 그쪽으로 해결하고, 화면이 꼭 필요할 때만 모드를 고르는 것이 좋습니다. 설치 전에는 validate로 읽고, 켜진 모드는 /plugin에서 확인하고, 문제가 생기면 --safe-mode와 disableAllHooks로 끄는 세 단계를 기억해 두시면 됩니다.

누끼토끼가 운영하는 Claude Code 강의와 칼럼에서는 스킬·훅·MCP·모드를 쇼핑몰 제작 실무에 어떻게 나눠 쓰는지, 클라이언트 키를 어떻게 안전하게 다루는지를 계속 다룹니다.