Claude Code v2.1.287에 추가된 'Claude Mods'와 내장 Mod 'You should know' 조사

Claude Code v2.1.287에서 Claude Mods가 추가되었습니다.

이것은 Claude Code의 화면이나 동작 자체를 JavaScript로 수정할 수 있는 메커니즘입니다.

함께, Mod로 만들어진 내장 기능인 **'You should know'**도 들어왔습니다. Claude 작업 중에 다른 에이전트가 대화를 감시하며 놓치기 쉬운 것을 알려줍니다.

본문에서는 Claude에게 Mod를 만들게 하는 방법과 You should know가 어떤 것인지를 소개합니다 (v2.1.289에서 확인).

Mod는 Claude Code 내에서 작동하는 함수가 포함된 플러그인입니다.

'도구를 호출하기 직전', '스피너(spinner)를 그릴 때', '명령어가 입력되었을 때' 등의 타이밍에 함수가 호출되며, 보기만 할지・수정할지・대신 응답할지 중 하나를 선택할 수 있습니다.

다른 확장 수단과의 차이점은, 화면에 그려낼 수 있다는 점과, 그 자리에서 사람의 판단을 구할 수 있다는 점입니다.

역할 분담은 다음과 같이 정리할 수 있을 것 같습니다.

Mod는 JavaScript로 작성되지만, Claude Code에 '이런 Mod를 만들어 줘'라고 요청하는 것만으로 만들 수 있습니다.

내장 스킬인 plugin-authoring
을 Claude가 읽으면서 작성해 줍니다 (Ask Claude for a mod).

이번에는 **'도구 호출 횟수를 스피너 옆에 표시하고, /tally로 답하는 Mod'**를 요청했습니다.

완성된 것의 전체 모습입니다.

claude
을 실행하고 다음 내용을 그대로 붙여넣습니다.

Claude의 도구 호출 횟수를 스피너 옆에 표시하고, /tally로 횟수를 답하는 mod를 만들어줘

Claude가 plugin-authoring 스킬을 읽고 ~/.claude/dev-mods/에 Mod를 작성합니다.

이번에는

tool-tally
라는 이름으로, 테스트까지 작성하여 스스로 통과한 후 보고해 주었습니다. 작성을 시작하면 다음 확인 창이 나오므로, 2. Enable for this session을 선택합니다 (커서는 처음에 1에 있으니 주의하세요).

/plugin
을 열고, 탭 아래에 1 mod active · tool-tally가 보이면 OK입니다.

도구를 사용하라는 요청(예: '이 폴더의 파일을 일람하고 README를 읽어줘')을 하면, 작업 중인 스피너 끝에 [tools: N]이 붙습니다. 끝나면

/tally
를 입력합니다. Claude를 거치지 않고 즉시 응답합니다.

내용물이 Claude에게 지시가 되는 스킬과 달리, 직접 만든 명령어를 Claude의 턴을 사용하지 않고 구동할 수 있다는 것이 Mod만의 특징입니다.

(참고) Claude가 작성한 hooks/register.tsx (클릭하여 펼치기)

import { atom, read, update } from 'claude-code'
import type { Register } from 'claude-code'
const count = atom({ plugin: 'tool-tally', key: 'count' } as const, 0)
...

Claude가 작성한 Mod는 만든 세션에서만 로드됩니다 (dev-mods는 테스트용 장소이며, 약 30일 후 자동 삭제됩니다).

마음에 들면, 공식 문서에 있는 대로 ~/.claude/skills/로 옮기면 이후 모든 세션에서 로드됩니다.

mkdir -p ~/.claude/skills
v ~/.claude/dev-mods/*/* | head -1) ~/.claude/skills/ # 최근에 만든 Mod를 이동

이동한 후에는, 어떤 폴더에서 claude를 실행해도 /tally가 사용 가능합니다.

claude plugin list
로 다음과 같이 나오면 성공입니다. 한 번 옮기면 되므로, 평소 사용은 이것으로 충분해 보입니다.

횟수를 세는 것만으로는 장점을 전달하기 어려우므로, 공식 샘플이나 내장 Mod에서 활용 사례를 소개합니다.

참고로, 이러한 Mod는 안전망일 뿐 권한 시스템은 아닙니다.

반드시 막아야 할 것은 권한 규칙으로 거부하고, Mod는 사람의 눈을 거치는 계층으로 겹치는 것이 좋을 것 같습니다.

Claude Code 자체 기능에도 Mod가 있으며, /plugin

의 Installed 탭 Built-in 항목에서 확인할 수 있습니다(목록).

/diff

의 페인이나 AGENTS.md

의 로딩, 절차 1에서 사용한 plugin-authoring

스킬도 Mod입니다.

Claude가 긴 작업을 하는 동안, 또 다른 에이전트(side agent)가 대화를 읽고 놓칠 만한 것이 있으면 프롬프트 위에 메모를 표시하는 기능입니다.

기본적으로 비활성화되어 있으므로 다음 명령어로 활성화합니다.

claude plugin enable cc-plugin-you-should-know@builtin

예를 들어, README에 '실제 청구 배치(billing batch)는 세율 8% 전제'라고 적힌 리포지토리에서 테스트를 통과시키는 김에 README도 수정하게 한다면 다음과 같은 흐름이 됩니다.

Claude가 '완료했습니다'라고만 말했던 주의사항 삭제를, side agent가 포착해 주는 것입니다.

메모는 글쓴이가 실제로 표시되게 한 것이며, 내용은 '원래 README에 있던 청구 배치 주의사항이 업데이트로 사라졌다'는 내용입니다.

다만, 나오는 경우는 드뭅니다.

같은 상황을 여러 번 만들어 봐도, 메모가 나오지 않은 경우가 더 많았습니다.

매번의 안전망이라기보다는, 긴 작업을 맡기고 있을 때 가끔 팔을 걷어붙여 도와주는 존재라고 생각하는 것이 좋을 것 같습니다.