‹ 스킬공유자료실#025 · 10월 7일 꿀팁

클로드 코드 화면을 말로 바꾸기

모드(Mods) 첫 모드 만드는 문장

단계 5개따라 하기 약 8분
AI 공부방 오픈카카오톡 · 막히면 같이 공부해요
입장하기

한눈에 보기

1버전 확인너무 옛날 버전이면 안 돼요›2첫 모드 문장 붙여 넣기공식 예시 문장 그대로›3허락 질문에 답하기"이번 세션에서 켜기" 고르기›4켜고 끄기모드 목록 열기›5꼭 알아 둘 점안전 · 계속 쓰기›6막히면자주 나오는 것›
모드(Mods)는 클로드 코드에 새로 생긴 추가 기능이에요. 게임에 모드를 깔면 화면과 규칙이 바뀌듯, 클로드 코드 화면에 내 패널·버튼·명령을 붙이고 움직임을 바꿀 수 있어요. 원하는 걸 말로 설명하면 클로드가 모드를 직접 만들어서 그 자리에서 적용해 줘요.

읽는 순서 — ① 버전 확인 → ② 첫 모드 문장 붙여 넣기 → ③ 허락 질문에 답하기 → ④ 켜고 끄기 → ⑤ 꼭 알아 둘 점 → ⑥ 막히면.
준비물
  1. 클로드 코드 2.1.287 이상 — 명령어 창(터미널)에서 쓰는 클로드 코드 기준이에요. 데스크톱 앱(Code 탭)은 2.1.286부터 돼요. 아직 클로드 코드가 없다면 자료실 #017 맨 위 설치 안내를 보세요.
    직접 명령어로 하고 싶다면

    PowerShell(윈도우 기본 명령어 창)에 붙여 넣으세요.

    irm https://claude.ai/install.ps1 | iex
  2. 따로 켤 필요 없음 — 최신 버전이면 모드는 처음부터 켜져 있어요.
  3. 깃(git)을 쓰는 폴더 하나 — 아래 예시 모드는 지금 작업 중인 갈래(브랜치) 이름을 보여 주는 거라, 깃을 쓰는 폴더에서 해 보면 결과가 잘 보여요.
1

버전 확인너무 옛날 버전이면 안 돼요

클로드 코드를 열고 아래 문장을 그대로 붙여 넣으세요.

제 클로드 코드 버전이 몇인지 알려 주세요. 2.1.287보다 낮으면 최신으로 업데이트해 주세요.
직접 명령어로 하고 싶다면 
claude --version
이렇게 되면 성공 — 클로드가 2.1.287 이상 숫자를 알려 줘요. 업데이트를 했다면 클로드 코드를 껐다 켠 뒤 다음 단계로 가세요.
2

첫 모드 문장 붙여 넣기공식 예시 문장 그대로

작업 폴더에서 클로드 코드를 켜고, 아래 문장을 그대로 붙여 넣으세요. 공식 문서에 나온 예시 문장이에요.

make a mod that shows the current git branch above the prompt

뜻은 "입력창 위에 지금 작업 갈래(git 브랜치) 이름을 띄우는 모드를 만들어 주세요"예요. 한국어로 말해도 되지만, 공식 예시는 영어라 처음엔 그대로 쓰는 걸 권해요.

3

허락 질문에 답하기"이번 세션에서 켜기" 고르기

클로드가 모드를 만들면서 파일을 만들어도 되는지 물어봐요. 허락하세요.

이어서 "hot reloading"(껐다 켜지 않고 바로 적용) 허용 여부를 묻는 창이 떠요. 선택지는 Enable for this session / Not now 두 개예요. Enable for this session(이번 세션에서 켜기)을 고르세요.

이렇게 되면 성공 — 클로드의 답이 끝나면 입력창 위에 브랜치 이름이 떠요.
4

켜고 끄기모드 목록 열기

클로드 코드 입력창에 아래를 치세요. Installed(설치됨) 탭에서 모드를 켜고 끌 수 있어요.

/plugin

탭 아래 흐린 줄에 1 mod active · first-mod 처럼 지금 켜진 모드 개수와 이름이 보여요.

다른 사람이 만든 모드를 깔 때는 클로드에게 이렇게 말하세요.

(모드 이름) 모드를 (모음집 이름)에서 설치하고 바로 적용해 주세요.
직접 명령어로 하고 싶다면

마켓플레이스 = 모드·플러그인을 모아 둔 목록이에요. 설치한 뒤 두 번째 줄을 치세요.

/plugin install 이름@마켓플레이스
/reload-plugins

공식 예시 모드 3가지 — token-weather(기억 공간을 얼마나 썼는지 입력창 위에 날씨처럼 표시), blast-radius(rm -rf 같은 위험한 삭제 명령을 붙잡고 지워질 파일 목록 + Proceed/Cancel 버튼), replay-theater(/replay 로 지난 파일 수정을 한 장씩 재생). 공식 샘플 저장소에 "지원 없이 있는 그대로" 공개돼 있어요.

5

꼭 알아 둘 점안전 · 계속 쓰기

모드는 따로 격리된 안전 공간(샌드박스)에서 돌지 않아요. 내 권한 그대로 돌아가서 내 파일, 비밀값(API 키 같은 것), 내가 입력한 모든 말을 볼 수 있어요. 믿을 수 있는 사람이 만든 모드만 까세요.

깔기 전에 클로드에게 검사를 맡길 수 있어요.

이 모드를 깔기 전에, 이게 제 컴퓨터에서 어떤 기능을 쓰는지 검사해서 쉽게 알려 주세요.
직접 명령어로 하고 싶다면 
claude plugin validate ./폴더
클로드가 만든 모드는 그 세션에서만 켜져요. 창을 닫으면 사라지고, 일정 기간 뒤 자동으로 지워져요. 계속 쓰고 싶으면 모드가 지워지기 전에 클로드에게 아래처럼 말해 두세요.
방금 만든 모드 폴더가 지워지지 않게 다른 곳에 복사해 두세요.
직접 명령어로 하고 싶다면

아래 폴더 안의 모드 폴더를 다른 곳에 복사해 두세요(~ = 내 사용자 폴더).

~/.claude/dev-mods/세션ID/
6

막히면자주 나오는 것

모드는 만들어졌는데 화면에 아무것도 안 보여요 — 화면이 보이는 곳은 명령어 창(터미널)과 데스크톱 앱 Code 탭이에요. VS Code(코드 편집기) 확장의 채팅창, claude -p, WSL(윈도우 안의 리눅스) 세션에서는 기능만 돌고 그림은 안 보여요.

옆 패널이 잘려 보여요 — blast-radius 같은 옆 패널은 가로로 넓은 창(약 144칸 이상)이 필요해요. 창을 넓혀 보세요.

회사 계정(Team/Enterprise)인데 안 돼요 — 관리자가 모드를 막아 둘 수 있어요. 관리자에게 확인하세요.

다음 날 모드가 사라졌어요 — 정상이에요. 5단계처럼 복사해 두지 않았다면, 2단계 문장을 다시 붙여 넣으면 돼요.

확인한 것
  • 모드 기본 켜짐·터미널 v2.1.287 / 데스크톱 v2.1.286·화면이 보이는 곳·/plugin 상태줄·샌드박스 아님 — 공식 문서 code.claude.com/docs/en/plugins/mods/overview (2026-10-06)
  • 예시 문장·hot reloading 질문·Enable for this session·세션 한정 유지·dev-mods 폴더 — 공식 문서 …/mods/create (2026-10-06)
  • claude plugin validate·회사 계정 관리자 제한 — 공식 문서 …/mods/admin (2026-10-06)
  • token-weather·blast-radius·replay-theater — GitHub anthropics/claude-code-playground 공식 샘플 (2026-10-06)
  • v2.1.287 릴리스 2026-10-01 — GitHub anthropics/claude-code releases
AI 공부방 오픈카카오톡 · 막히면 같이 공부해요
입장하기 ‹ 다른 자료 보러 가기

트렌드코어 스킬공유자료실 · 무료