Mods 개요

​

mod가 할 수 있는 것

• 사용할 수 있는 인터페이스 그리기: 대화 옆의 창 또는 프롬프트 위의 밴드, 탭, 버튼, 텍스트 필드 포함. 인터페이스에 그리기를 참조합니다.
• Claude Code 자체 인터페이스 다시 그리기: Claude Code가 자체적으로 그리는 부분(예: 도구 호출의 행, 스피너 또는 Claude가 질문하는 대화)을 교체하거나 다시 스타일링합니다. Claude Code가 이미 그린 것 변경을 참조합니다.
• 도구 호출 또는 요청에 개입: 예를 들어, 도구 호출을 유지하면서 사용자에게 질문하고, 도구를 실행하지 않고 답변하거나, 한 요청을 다른 모델로 보냅니다. 도구 호출 보호 또는 변경 및 턴 따르기를 참조합니다.
• 명령에서 자신의 코드 실행: Claude 턴 없이 즉시 실행되는 /command, Claude가 작업 중일 때도 실행됩니다. 명령 또는 도구 추가를 참조합니다.
• hooks 간 데이터 공유: mod의 hooks는 파일의 변수를 공유하므로 한 hook이 기록하는 것을 다른 hook이 표시할 수 있습니다. 예를 들어, 한 hook은 도구 호출을 세면서 다른 hook은 스피너 옆에 개수를 표시하거나, 한 hook은 각 요청의 토큰 사용량을 읽으면서 다른 hook은 창에서 차트로 표시할 수 있습니다. 이벤트에 반응을 참조합니다.

​

mod 가져오기

• 이미 가지고 있는 것 사용: Claude Code의 일부 기능은 /diff와 같은 mods입니다. Claude Code에 내장된 Mods를 참조합니다.
• 하나 만들기: Claude Code 세션에서 원하는 것을 설명하면 Claude가 mod를 작성합니다. Claude에 mod 요청을 참조합니다. mod의 코드가 어떻게 작동하는지 배우려면 직접 작성합니다.
• 하나 설치: mod 설치 또는 업데이트를 참조합니다.

​

mod 설치 또는 업데이트

• Claude Code 세션에서 /plugin install token-chart@your-org를 실행합니다.
• 셸에서 claude plugin install token-chart@your-org를 실행합니다.

​

모드를 신뢰할지 결정하기

​

모드가 접근할 수 있는 것

• 사용자로서 머신에서 작동: 사용자 계정이 접근할 수 있는 모든 곳에서 파일을 읽고 쓰기, 프로그램 시작, 네트워크 요청 수행
• 비밀 정보 읽기: 환경 변수 및 설정 파일(API 키 포함)
• 세션 확인: 사용자가 보내는 모든 프롬프트 및 Claude가 수행하는 모든 도구 호출 확인
• 세션 변경: 프롬프트 또는 도구 호출 재작성, 사용자가 입력한 것처럼 프롬프트 제출, 다른 세션으로 메시지 전송
• 사용자에게 묻지 않고 작동: 사용자에게 묻기 전에 도구 호출 승인
• 사용량 소비: 플랜 또는 API 키의 모델 호출

​

설치하기 전에 모드가 수행하는 작업 나열하기

claude plugin validate ./some-mod

​

mods 켜기 또는 끄기

• 하나의 mod: /plugin의 설치됨 탭에서 플러그인을 비활성화하거나 제거합니다.
• 모든 설치된 mod, 한 세션 동안: --safe-mode로 Claude Code를 시작합니다. 이는 다른 사용자 정의도 제외합니다.
• 설치한 모든 mod, 모든 세션에서: ~/.claude/settings.json에서 "disableAllHooks": true를 설정합니다. 설정 hooks 및 사용자 정의 상태 줄도 중지됩니다. 조직이 관리하는 것은 계속 실행됩니다.

​

세션이 로드한 mods 보기

​

mod의 작동 방식

first-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.js

• plugin.json: 플러그인의 매니페스트
• hooks.json: 코드 파일을 가리킵니다
• register.js: 코드, hooks 모듈이라고 불립니다. Claude Code에 어떤 이벤트에서 함수를 실행할지 알려줍니다.

// 아래의 두 hooks로 공유되는 개수
let calls = 0

// Claude Code는 mod가 로드될 때 이것을 한 번 호출합니다
export function register(on) {
  // Claude가 도구를 사용하려고 할 때마다 실행됩니다
  on('tool.call', async ($, e, next) => {
    calls += 1
    // Claude Code에 인터페이스를 다시 그리도록 요청하여 새 개수가 표시되도록 합니다
    $.ui.invalidate('ui.render')
    // 도구가 평소대로 실행되도록 합니다
    return next(e)
  })

  // Claude Code가 스피너를 그릴 때마다 실행됩니다
  on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
    // Claude Code의 스피너를 유지하고 단어 뒤에 개수를 추가합니다
    return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })
  })
}

• tool.call hook은 Claude가 도구를 사용하려고 할 때마다 실행됩니다. calls에 1을 더하고, Claude Code에 인터페이스를 다시 그리도록 요청하고, 도구가 평소대로 실행되도록 합니다.
• ui.render hook은 Claude Code가 스피너를 그릴 때마다 실행됩니다. Claude Code의 스피너를 유지하고 단어 뒤에 개수를 추가합니다.

​

hook이 이벤트로 할 수 있는 것

• 관찰: 일어나는 일을 기록하고 예제의 tool.call hook처럼 변경되지 않은 상태로 계속합니다.
• 다시 작성: 이벤트를 변경한 후 계속합니다. ui.render hook이 스피너에 개수를 추가할 때처럼 합니다.
• 답변: 이벤트를 자체적으로 처리하여 일반적인 동작이 실행되지 않습니다(예: 명령 거부).

​

mods가 실행되는 위치

​

조직의 mods 제어

​

mods, 설정 hooks, skills, MCP 서버 비교

​

Claude Code에 내장된 Mods

​

내장 mods의 소스 읽기

• diff: /diff 창, 키보드 작업에 바인딩된 버튼 및 mod가 처리하는 스크롤링
• agents-md: AGENTS.md를 프로젝트 지침으로 로드, userConfig 옵션 포함
• sec-default: 기본적으로 일어나는 일 알기에 설명된 가드, mod가 정책을 적용하는 모델
• telemetry: 다른 mods가 호출할 수 있는 메서드를 추가하고 유형을 제공합니다

​

다음 단계

• mod 만들기: 도구 호출을 세고, 스피너 옆에 개수를 표시하고, 명령을 추가하는 것을 만들고, 편집 및 다시 로드 루프를 배웁니다.
• 인터페이스에 그리기: 창, 프롬프트 위의 밴드, 버튼, 텍스트 필드, 상태
• 이벤트에 반응: 도구 호출, 프롬프트, 턴, mods가 실행되는 순서
• mods API 사용: 명령, 도구, 모델 호출, 타이머, 파일
• mod 테스트: 세션 없이 실행되는 자동화된 테스트
• mod 문제 해결: mod가 아무것도 하지 않는 이유, 디버그 로그
• 조직의 mods 관리: 기본값, 관리 설정, mod 검토, 정책 mods
• Mods 참조: 모든 이벤트, 메서드, 요소, 제한