Anthropic이 이달 초 Claude Code에 Mods라는 확장 방식을 추가했습니다. 기존 plugin이 skill, MCP 서버, slash command 같은 부가 기능을 바깥에서 더해 주는 방식이었다면, mod는 Claude Code 안쪽에서 실행되면서 화면에 보이는 요소와 동작 자체를 바꿉니다. 게임에 mod를 설치해 외형과 규칙을 바꾸듯, 터미널 입력줄 위에 상태 패널을 띄우거나 버튼을 붙이거나 긴 작업을 기다리는 동안 게임을 돌릴 수도 있습니다. 코드를 몰라도 자연어로 설명하면 Claude Code가 mod를 직접 만들어 주는 내장 skill이 있다는 점도 특징입니다. 이 글에서는 mod의 구조, 설치와 관리 방법, 지금 바로 쓸 만한 mod 몇 가지를 정리합니다.
plugin, hook, mod는 무엇이 다른가
mod는 plugin과 뿌리가 같지만 할 수 있는 일의 범위가 다릅니다. Claude Code는 세션 내내 메시지 전송, subagent(하위 작업을 맡는 보조 agent) 생성, tool 호출 같은 event를 계속 내보냅니다. 기존 hook은 이 event를 Claude Code 바깥에서 듣고 외부 스크립트를 실행해 작업을 허용하거나 막거나 주석을 달았습니다. 반면 mod는 Claude Code 내부에서 돌아가기 때문에 버튼을 그리거나 텍스트 widget을 띄우거나 전용 side panel을 여는 것처럼 UI에 직접 손을 댈 수 있습니다.
| 구분 | 실행 위치 | 주로 하는 일 |
|---|---|---|
| plugin | Claude Code에 덧붙임 | 추가 skill, MCP 서버, slash command 제공 |
| hook | Claude Code 바깥 | event를 듣고 외부 스크립트로 허용·차단·주석 |
| mod | Claude Code 내부 | 외관과 동작 변경, 버튼·widget·side panel 표시 |
mod를 쓰려면 Claude Code 버전이 2.1.287 이상이어야 합니다. 명령줄 인터페이스와 데스크톱 앱의 Code 탭 모두에서 같은 조건이 적용됩니다.
터미널 안에서 Doom을 돌리는 mod
mod가 어디까지 갈 수 있는지 보여 주는 사례로 한 개발자가 만든 멀티플레이 Doom 서버 mod가 있습니다. Claude Code가 여러 파일을 고치거나 명령을 실행하는 동안 터미널 안에서 실시간 멀티플레이 Doom 경기에 접속하게 해 주고, Claude가 작업을 마치는 순간 경기를 자동으로 끝내면서 그 세션의 K/D(킬 대 데스 비율)를 보고합니다.
장난처럼 보이지만 쓸모가 없지는 않습니다. agent 작업이 10분 가까이 걸리는 동안 휴대폰을 들여다보는 대신 터미널을 떠나지 않고 기다릴 수 있기 때문입니다. 무엇보다 3D 멀티플레이 게임을 터미널 안에서 돌릴 수 있다는 사실 자체가 mod 체계가 Claude Code에 얼마나 깊이 통합되어 있는지 보여 주는 것으로 보입니다.

▲ 긴 작업 중 터미널 안의 게임
mod를 구하는 세 가지 경로와 설치 전 점검
mod를 구하는 경로는 크게 셋입니다.
- 커뮤니티 marketplace: aitmpl.com처럼 skill, agent, MCP, mod를 한데 모은 디렉터리입니다. Mods 탭에 45개 이상의 항목이 올라와 있고, 각 항목이 원본 GitHub 저장소로 연결되어 설치 전에 코드를 살펴볼 수 있습니다.
- Anthropic 공식 커뮤니티 디렉터리: 자동 검증과 보안 심사 파이프라인을 거친 mod를 모아 둔 곳입니다.
- 직접 생성: Claude Code에 내장된 mod·plugin skill에 원하는 기능을 자연어로 설명해 만드는 방법입니다.
주의할 점은 mod가 Claude Code 내부에서 코드를 실행한다는 사실입니다. 검증되지 않은 커뮤니티 mod는 그 자체로 보안 위험이 될 수 있습니다. 설치 명령을 실행하기 전에 GitHub 저장소를 열어 hooks.js 같은 파일에 curl로 무언가를 내려받거나 숨은 shell 명령을 실행하는 부분이 없는지 확인하는 습관이 필요합니다.
Cache Tracker: cache가 만료되기 전에 알려 주는 HUD
실용성 면에서 가장 먼저 꼽을 만한 mod는 Prompt Cache Control, 흔히 Cache Tracker라고 부르는 mod입니다. 이 mod를 이해하려면 Claude Code가 대화를 다루는 방식을 알아야 합니다. Claude Code에는 여러 턴에 걸친 기억이 따로 없어서 prompt를 보낼 때마다 지금까지의 대화 기록 전체를 다시 읽습니다. 세션이 길어질수록 응답이 느려지고 token 비용도 크게 늘어나는 이유입니다.
prompt caching은 변하지 않는 과거 기록을 책갈피처럼 cache에 담아 두고 새로 추가된 부분만 읽게 해 이 문제를 줄입니다. 다만 cache에는 수명이 있습니다. Claude 구독으로 쓸 때는 약 1시간, API 크레딧으로 쓸 때는 5분 정도만 유지되어 둘 사이에 12배 차이가 납니다. cache가 만료되면 다시 전체 기록을 읽게 되므로, 언제 만료되는지 알면 비용을 아낄 수 있습니다. Cache Tracker는 현재 cache 비율과 만료까지 남은 시간을 보여 주는 HUD를 터미널에 띄워 이 시점을 놓치지 않게 합니다.
설치와 확인 과정
| 단계 | 할 일 |
|---|---|
| 1 | aitmpl.com에서 Prompt Cache Control을 찾아 설치 명령과 GitHub 문서 확인 |
| 2 | 새 터미널에서 npx claude-code-templates@latest --mod observability/prompt-cache-control claude 실행 |
| 3 | Claude Code가 자동으로 실행되면 작업 폴더를 신뢰할지 묻는 보안 확인에 응답 |
| 4 | 간단한 질문(예: 오류를 로그로 남기는 방법)을 입력해 mod의 hook을 작동시키고 cache bar가 뜨는지 확인 |
이 명령 한 줄로 mod 파일 설치와 Claude Code 실행이 함께 끝납니다. 실제로 질문을 하나 던지면 입력줄 근처에 cache 상태 표시가 나타납니다. 예를 들어 cache 적중률 50%, cache에서 읽은 token 23.3k, 1시간 TTL 가운데 09:47이 남았다는 카운트다운과 함께 "warm: keep going"이라는 안내가 뜨는 식입니다. 즉 cache가 아직 따뜻하니 지금 계속 작업하라는 뜻입니다.
설치한 mod는 Claude Code 안에서 /plugins를 입력해 관리합니다. plugin 관리자에는 Discover, Installed, Marketplaces, Errors, Stats 탭이 있고, Installed 탭에서 각 mod를 비활성화하거나 내용을 살펴보거나 삭제할 수 있습니다.

▲ Cache Tracker의 상태 표시
Next Steps와 Deck
Cache Tracker 외에 눈여겨볼 mod가 둘 더 있습니다.
Next Steps는 프로젝트 맥락을 분석해 다음에 할 개발 작업을 터미널 안에서 바로 제안합니다. 막연한 조언이 아니라 실행할 slash command, 터미널 명령, skill 스크립트를 정확히 짚어 준다는 점이 핵심입니다. 여러 단계로 나뉜 복잡한 코드베이스에서 명령 순서를 외우고 다닐 필요가 없어지고, 작은 스크립트 작업에서도 흐름을 놓치지 않고 집중하는 데 도움이 됩니다.
Deck은 Claude Code 입력줄 바로 위에 통합 대시보드를 띄우는 제어판입니다. 다음 항목을 한눈에 보여 줍니다.
- 5시간 세션 사용 한도
- 7일 단위 사용 한도
- context window(모델이 한 번에 다루는 입력 범위) 사용률
- 현재 모델 이름
- effort(추론 강도) 설정
여기에 픽셀 아트 pet이 하나 붙어 있습니다. Claude가 작업하는 동안 움직이다가 사용자 확인이 필요해지면 빨간 느낌표를 띄우고, 확인 요청을 계속 무시하면 표정이 붉게 화난 모습으로 바뀝니다. 작업을 걸어 두고 다른 창을 보다가 권한 요청을 놓치는 일을 막아 주는 장치로 보입니다. bar 스타일을 여러 가지로 바꿀 수 있고, 터미널 공간을 아끼고 싶을 때는 한 줄로 접을 수도 있습니다.
내 작업 기록으로 맞춤 mod 만들기
mod의 또 다른 쓰임은 자기 작업 방식에 맞춘 도구를 만드는 것입니다. Claude Code에 지난 세션의 transcript를 훑어보고 도움이 될 mod를 제안해 달라고 요청하면, 반복되는 명령과 시간을 잡아먹는 지점을 찾아냅니다. 한 주치 기록을 분석한 예시에서는 "테스트 다시 돌려"라는 요청이 14번 반복됐고, pnpm 경고가 자주 나왔으며, 테스트 묶음이 끝나기를 기다리느라 6분을 잃었다는 점이 드러났습니다. 이를 바탕으로 Claude는 한 번 눌러 테스트를 실행하는 버튼 같은 mod를 제안합니다.
제안을 수락하면 Claude가 mod 코드 전체를 그 자리에서 생성합니다. 첫 결과가 완벽하지 않을 수 있지만 대화를 이어 가며 다듬을 수 있어 코드를 직접 쓸 필요는 없습니다.
정리: 지금 해 볼 일
mod는 plugin과 hook이 하지 못하던 일, 즉 Claude Code의 화면과 동작을 안쪽에서 바꾸는 일을 가능하게 합니다. 현재 공개된 mod는 시작 단계이지만, 브라우저 확장이나 MCP 도구처럼 생태계가 빠르게 커질 것으로 보입니다. 지금 바로 해 볼 수 있는 일은 다음과 같습니다.
- Claude Code가 2.1.287 이상인지 확인합니다.
- 커뮤니티 mod는 설치 전에 GitHub 저장소를 열어 hooks.js에 외부 다운로드나 숨은 shell 실행이 없는지 살핍니다.
npx claude-code-templates@latest --mod <경로> claude형식의 명령으로 설치하고,/plugins에서 상태를 관리합니다.- 긴 세션을 자주 쓴다면 Cache Tracker를 먼저 설치해 구독 1시간, API 5분이라는 cache 수명을 눈으로 확인합니다.
- 사용량 한도가 신경 쓰이면 Deck을, 복잡한 프로젝트에서 다음 명령이 헷갈리면 Next Steps를 써 봅니다.
- Claude Code에 지난 세션을 분석해 mod를 제안해 달라고 요청해 자기 작업에 맞는 도구를 만들어 봅니다.


