Notice
Recent Posts
Recent Comments
Link
| 일 | 월 | 화 | 수 | 목 | 금 | 토 |
|---|---|---|---|---|---|---|
| 1 | 2 | 3 | 4 | 5 | 6 | 7 |
| 8 | 9 | 10 | 11 | 12 | 13 | 14 |
| 15 | 16 | 17 | 18 | 19 | 20 | 21 |
| 22 | 23 | 24 | 25 | 26 | 27 | 28 |
| 29 | 30 |
Tags
- 클로드코드
- 리팩토링
- Refactoring
- 스위프트
- uiscrollview
- combine
- Human interface guide
- RxCocoa
- 클린 코드
- swiftUI
- collectionview
- UICollectionView
- Xcode
- MVVM
- HIG
- clean architecture
- Observable
- Clean Code
- 리펙토링
- ios
- map
- tableView
- 애니메이션
- swift documentation
- uitableview
- claude code
- AI
- SWIFT
- rxswift
- UITextView
Archives
- Today
- Total
김종권의 iOS 앱 개발 알아가기
[AI] Claude Code 모드(mod) 본문
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
│
* 참고
'AI' 카테고리의 다른 글
| [AI] Claude Code의 /fast 기능 (opus, fast 모드) (1) | 2026.11.04 |
|---|---|
| [AI] Claude Code - 원격 사용 방법 (클로드코드 원격, remote-control) (0) | 2026.10.29 |
| [AI] Skill 잘 쓰는법 (2) | 2026.10.02 |
| [AI] MCP(Model Context Protocol) 개념, 만드는 방법 (1) | 2026.09.09 |
| [AI] 하네스 엔지니어링이 비효율이 되는 이유와 아키텍처 대안 (Harness의 비효율) (1) | 2026.09.02 |
Comments
