관리 메뉴

김종권의 iOS 앱 개발 알아가기

[AI] Claude Code 모드(mod) 본문

AI

[AI] Claude Code 모드(mod)

jake-kim 2026. 10. 21. 01:46

Claude code mod란?

  • Claude Code의 화면과 동작을 바꾸는 플러그인. 도구 호출, 프롬프트 제출, UI 렌더링 같은 이벤트에 맞춰 JS/TS 핸들러가 실행
  • 패널, 상단 밴드, 버튼, 텍스트 입력 같은 UI 추가 가능

mod와 유사한 개념 비교

형태 플러그인 내 JS/TS 함수 셸/HTTP/프롬프트 Markdown 지침 외부 프로세스 도구
UI 그리기 가능 불가 불가 불가
언제 쓰나 패널, 명령어, 이벤트 재작성 기존 스크립트로 차단/로깅 반복 지침 외부 시스템 연결

mod 활용해보기

  • 디폴트 클로드코드 화면

  • mod 활용
    • claude code에 아래와 같이 명령
mod 관련 예제를 만들고 있는데, 간단히 내가 지금 클로드코드 쓸때 토큰 얼마나
  쓰는지 실시간으로 보여주는 가시성 좋은 UI 하나 근처에 띄워줘
    • 청록색으로 "tokens in 565.1k ..." 이것 처럼 실시간으로 내가 얼마나 토큰을 쓰고 있는지 확인이 가능

mod와 hook

- mod: 설치하고 공유하고 버전을 매기는 폴더 단위. plugin.json이 이 신분증 역할
- hook: mod가 Claude Code의 사건(모델 응답, 도구 호출, 화면 그리기 등)에 걸어 두는 연결점. on('turn.step', ...)이 하나의 hook
- 폴더: mod의 모든 파일이 들어 있는 곳. 복사하거나 깃에 올리면 그대로 옮겨짐
- hooks.json: mod가 어떤 hook을 쓰는지 적은 목록. 이 목록을 보고 엔진이 register.tsx를 읽음

mod 원리

  • 관련 저장 위치: /Users/{사용자이름}/.claude/dev-mods/<세션 번호>/token-meter/

mod는 목차를 보고, 본문을 읽고, 본문에 적힌 대로 일을함

- hooks.json(목차): 에 저장
- register.tsx(본문): 실제로 무엇을 할지 적은 글. "모델이 답하면 숫자를 더해라, 화면 아래에 보여줘라". 
ex) 위에서 정한 mod 이름은 "token-master"라고 한다면 아래처럼 구조가 잡힘

token-meter/                  ← mod 상자 (폴더 전체)
│
├── 이름표/                   ← 이 상자가 무엇인지 적은 종이
│   └── plugin.json
│
├── 목차/                     ← 본문이 어디 있는지 알려 주는 쪽지
│   └── hooks.json
│

 

* 참고

- https://code.claude.com/docs/en/plugins/mods/overview

Comments