이런 분께
Claude Code에 긴 작업을 맡겨 놓고 다른 일을 하다가, 나중에야 중간에 틀어진 걸 발견한 적 있는 분께 맞아요. 프롬프트 위에 원하는 정보를 한 줄 띄워 두고 싶은 분에게도요.
끝나면 이렇게 됩니다
두 가지가 생겨요.
- Claude가 긴 작업을 하는 동안 옆에서 지켜보는 보조 에이전트가 켜져요. 내가 놓칠 만한 일이 생기면 프롬프트 위에 노트를 띄워 줘요. 기본 mod인 "You should know"예요.
- 말 한 줄로 만든 내 mod가 돌아가요. 예를 들어 프롬프트 위에 이런 줄이 늘 보여요.
branch: feature/login-fix
mod는 Claude Code의 화면과 동작을 바꾸는 plugin이에요. 2026년 10월 1일 v2.1.287에서 추가됐어요.
준비물
- Claude Code v2.1.287 이상(CLI 또는 데스크톱 앱의 Code 탭)
- 터미널(윈도우: 시작 메뉴에서 "터미널" 검색, 맥: Spotlight에서 "터미널" 검색)
- "You should know"는 Anthropic에 직접 연결된 세션(first-party)에서, 텔레메트리가 켜져 있을 때만 동작해요. 조직 설정에 따라 목록에 없을 수도 있어요.
- mod가 모델을 부르면 내 요금제 사용량을 써요.
- 기준: 2026년 10월 7일
따라 하기
- 터미널을 열고 버전을 확인해요. 2.1.287보다 낮으면 Claude Code를 먼저 업데이트해요.
claude --version
- 프로젝트 폴더에서
claude를 입력해 세션을 시작해요. /plugin을 입력하고 Tab 키를 눌러 「Installed」 탭으로 가요. 「Built-in」 아래에 기본 mod가 보여요. 「Show disabled」를 켜면 꺼져 있는 것까지 나와요. 여기에cc-plugin-you-should-know가 있는지 봐요.- 프롬프트로 돌아와 아래 명령어를 입력해요.
/plugin enable cc-plugin-you-should-know@builtin
- 이제 내 mod를 만들어요. 원하는 걸 말로 적어 보내요. 아래 "복사해서 쓰는 프롬프트"를 그대로 써도 돼요. Claude가
~/.claude/dev-mods/아래에 mod 파일을 만들어요. 파일을 만들 때마다 허용할지 물으면 내용을 보고 승인해요. - 첫 파일이 저장되면 hot reloading을 켤지 물어요. 「Enable for this session」을 골라요. 이 턴이 끝나면 mod가 바로 돌아가요.
/plugin의 「Installed」 탭에 방금 만든 mod가 보이는지 확인해요. 끄고 싶으면 같은 화면에서 꺼요.
복사해서 쓰는 프롬프트
make a mod that shows the current git branch above the prompt
공식 문서의 예시 문장이에요. 한국어로 적어도 돼요.
프롬프트 위에 [지금 git 브랜치 이름과 이번 세션에서 쓴 도구 호출 횟수]를 한 줄로 보여주는 mod를 만들어줘.
다 만들면 이 mod가 어떤 이벤트를 듣고 무엇을 읽는지 세 줄로 설명해줘.
대괄호 예시: "컨텍스트가 몇 퍼센트 찼는지", "rm -rf 명령이 나오면 실행 전에 멈추고 나에게 묻기"처럼 넣어요.
Claude가 만든 mod는 그 세션에서만 돌고 폴더도 시간이 지나면 지워져요. 계속 쓰려면 이렇게 시켜요.
