본문 바로가기

Claude Code 모드(Mods) 입문 가이드: TypeScript 몇 줄로 Claude Code를 내 방식대로 바꾸기

모드는 플러그인에 담겨 오는 작은 TypeScript 함수로, Claude Code의 프롬프트·도구 호출·화면을 바꿉니다. 설치 방법과 반드시 알아야 할 보안 주의점을 초보자 눈높이로 정리했습니다.

글

Claude Code 모드(Mods)는 Claude Code의 동작과 화면을 바꾸는 작은 TypeScript 함수입니다. Anthropic은 2026년 10월 1일 이 기능을 공개하면서, 프롬프트를 고쳐 쓰거나 새 화면을 붙이거나 기본 기능을 다른 것으로 바꾸는 일이 모두 가능하다고 설명했습니다. 이 글은 코딩 경험이 적은 분도 개념을 이해하고, 설치하고, 안전하게 쓸 수 있도록 순서대로 안내합니다.

🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
🟢 현행 모델 라인업 일치 · Claude Opus 5.5 / Claude Sonnet 5.5 / Claude Haiku 5.5 (상위 티어: Claude Fable 5.2). 이 안내는 새 모델이 출시될 때만 바뀝니다.

Fable 구독 안내(2026년 11월 10일 갱신): 2026년 11월 9일 출시된 Claude Fable 5.2가 현행 Fable 모델이고, Fable 5.1과 Fable 5는 레거시로 전환됐습니다. 구독 조건은 세 모델이 같습니다 — Max·Ultra 플랜과 Team·좌석 기반 Enterprise의 프리미엄 시트는 주간 사용 한도의 50% 범위에서 포함되고, Pro 플랜과 표준 시트는 사용량 크레딧으로 이용합니다(Free 미제공). 출시 기념으로 2026년 11월 16일(PT)까지 Pro 플랜과 Team 표준 시트에도 Fable 모델이 주간 한도의 50% 범위에서 포함됩니다. API 요금은 Fable 5.2가 입력 100만 토큰당 $8·출력 $40, Fable 5.1·5는 $10·$50입니다. 일부 사이버보안·생물학 요청은 안전 분류기에 의해 Opus 모델로 대체 응답될 수 있습니다. 자세한 내용은 Fable 5.2 출시 소식과 Fable 5.2 가이드를 참조하세요.

이벤트 발생 도구 호출·권한 요청·화면 그리기 모드(TypeScript 함수) ① 이벤트 앞에서 실행 ② 이벤트 뒤에서 실행 ③ 이벤트 대신 실행 ④ 앞뒤를 모두 감싸 실행 달라진 결과 프롬프트·동작·화면

이 글로 할 수 있게 되는 것

모드가 무엇이고, 어떻게 설치하며, 무엇을 조심해야 하는지 약 10분 안에 파악할 수 있습니다. 직접 코드를 짜지 않아도 이미 만들어진 모드를 설치해 쓰거나, Claude에게 만들어 달라고 부탁하는 방법까지 다룹니다.

시작 전 준비물

준비물은 Claude Code 하나입니다. 공식 발표에 따르면 모드는 Claude Code CLI(명령어 입력 방식)와 데스크톱 앱에서 쓸 수 있습니다.

  • Claude Code 설치 — CLI 또는 데스크톱 앱 중 편한 쪽이면 됩니다.
  • 모드가 들어 있는 플러그인 — 아래 설치 단계에서 찾는 방법을 안내합니다.
  • 팀·회사 계정이라면 — 관리자가 플러그인 설치를 제한했을 수 있으니 먼저 확인하세요.

용어 빠른 풀이

  • 모드(Mod) — Claude Code가 하는 일에 끼어들어 결과를 바꾸는 작은 프로그램(함수)입니다.
  • TypeScript — 모드를 쓸 때 사용하는 프로그래밍 언어입니다. 직접 쓰지 않고 Claude에게 맡길 수도 있습니다.
  • 플러그인(Plugin) — 기능을 묶어 설치하는 꾸러미입니다. 모드는 플러그인 안에 담겨 배포됩니다.
  • 이벤트(Event) — 도구 호출, 권한 요청, 화면 일부 그리기처럼 Claude Code가 무언가 할 때마다 내보내는 신호입니다.
  • 훅(Hook) — 특정 순간에 자동으로 실행되게 거는 기능입니다. 모드는 훅이 못 하던 일까지 할 수 있습니다.
  • 샌드박스(Sandbox) — 프로그램을 가둬 놓고 실행하는 안전 구역입니다. 모드는 여기에 갇히지 않습니다.
  • 관리형 설정(Managed settings) — 관리자가 사용자 컴퓨터에 내려보내는 설정입니다.

모드는 무엇이고 훅과 무엇이 다른가요?

모드는 훅보다 더 깊이 Claude Code를 바꿀 수 있는 기능입니다. 문서에 따르면 훅은 일부 제어는 가능하지만 이벤트를 고쳐 쓰거나 새 화면을 그리거나 기능을 통째로 바꾸지는 못하는데, 모드는 이를 할 수 있습니다.

Claude Code가 무언가 할 때마다 이벤트가 발생하고, 모드는 그 이벤트에 걸리는 함수입니다. 위 도식의 번호와 같은 네 가지 방식으로 끼어듭니다.

  • 앞(①) — 이벤트가 일어나기 전에 실행됩니다.
  • 뒤(②) — 이벤트가 끝난 뒤에 실행됩니다.
  • 대신(③) — 이벤트를 대체해 실행됩니다.
  • 감싸기(④) — 앞과 뒤 모두에서 코드를 실행합니다.

모드로 구체적으로 무엇을 할 수 있나요?

공식 소개에 나온 대표 사례는 네 가지 동작과 화면 변경입니다. 함수 하나로 아래 일을 할 수 있다고 합니다.

  • 프롬프트 고쳐 쓰기 — 질문이 모델에 도착하기 전에 내용을 바꿉니다.
  • 도구 호출 제어 — 도구 호출을 막거나, 고치거나, 다시 시도하게 합니다.
  • 권한 요청 처리 — 권한 요청을 승인하거나 거부합니다.
  • 비밀 정보 가리기 — 도구 출력에서 비밀 값을 지워 Claude가 읽기 전에 걸러 냅니다.
  • 화면 바꾸기 — 도구 결과나 Claude의 질문 같은 화면 일부를 고치거나 교체하고, 버튼·입력칸을 추가합니다. 대상은 터미널, 데스크톱 앱, 또는 둘 다입니다.

기본 기능도 모드가 되고 있습니다. 예를 들어 내장 /diff 기능은 이제 모드이므로 /plugin에서 끄거나 내 버전으로 교체할 수 있다고 합니다.

모드는 어떻게 설치하나요?

모드는 플러그인에 담겨 오므로 플러그인을 설치하면 됩니다. 공식 안내는 Claude 디렉터리(플러그인 모음 사이트)에서 찾거나 CLI에서 /plugin을 실행하라는 것입니다.

  1. Claude Code를 실행합니다. CLI 또는 데스크톱 앱 모두 가능합니다.
  2. /plugin을 입력합니다.
    /plugin
    이렇게 보이면 성공: 플러그인을 관리하는 화면이 열립니다. 메뉴 이름은 버전에 따라 다를 수 있으니 화면에 표시된 항목을 확인하세요.
  3. 모드가 포함된 플러그인을 고릅니다. Claude 디렉터리에서 찾을 수 있습니다. 설치 전에 만든 사람과 설명을 꼭 읽으세요.
  4. 설치 후 동작을 확인합니다. 플러그인 목록에 나타나는지 보고, 해당 모드가 설명한 대로 동작하는지 간단한 요청으로 시험합니다.

주의 — 신뢰할 수 있는 출처만 설치하세요. 모드는 샌드박스에서 실행되지 않고 Claude Code와 같은 수준으로 내 컴퓨터에 접근합니다. 공식 안내도 컴퓨터에 아무 프로그램이나 설치하지 않듯 신뢰하는 출처의 모드만 설치하라고 합니다. 출처가 불분명한 모드는 설치하지 않는 것이 안전합니다.

안 될 때의 다음 행동은 이렇습니다.

  • /plugin이 인식되지 않을 때 — Claude Code가 최신 버전인지 확인하고 업데이트해 보세요.
  • 플러그인이 목록에 없을 때 — 팀·회사 계정이라면 관리자가 마켓플레이스를 막았을 수 있으니 관리자에게 문의하세요.
  • 모드가 기대와 다르게 동작할 때 — /plugin에서 해당 플러그인을 끄고 다시 시험해 원인을 가려내세요.

직접 만들기: Claude에게 부탁해도 되나요?

네, 가능합니다. 공식 설명에 따르면 Claude에게 모드를 만들어 달라고 하면 TypeScript를 작성하고, 설치하고, 현재 세션에서 바로 다시 불러오기(hot reload)까지 해 줍니다. 예를 들어 이렇게 요청할 수 있습니다.

도구 출력에 비밀번호처럼 보이는 값이 있으면 가려 주는 모드를 만들어 줘

이렇게 보이면 성공: Claude가 모드를 만들고 설치했다고 알려 주고, 이어서 요청해 보면 동작이 달라집니다. 직접 만드는 방법은 Anthropic의 첫 모드 만들기 가이드와 문서를 참고하세요. 만든 모드를 공유하려면 플러그인으로 묶어 디렉터리에 제출하면 됩니다.

주의: Claude가 만든 모드도 같은 권한으로 실행됩니다. 설치 전에 코드가 무슨 일을 하는지 설명해 달라고 요청해 확인하세요.

여러 모드를 함께 쓰면 어떤 순서로 실행되나요?

모드는 불러온 순서대로 실행됩니다. 먼저 불러온 모드가 이벤트를 가장 먼저 보고, 결과는 가장 마지막에 봅니다. 그래서 서로 다른 제작자의 모드를 쌓아 쓸 수 있습니다.

첫 번째로 불러온 모드 (이벤트 먼저, 결과 마지막) 두 번째로 불러온 모드 Claude Code 이벤트 이벤트 → ← 결과 팀·엔터프라이즈: sec-default가 맨 먼저

팀과 회사에서는 어떻게 관리하나요?

모드는 플러그인 안에 있으므로 기존 플러그인 통제 방식이 그대로 적용됩니다. 관리자는 플러그인 마켓플레이스를 허용하거나 막을 수 있습니다.

  • Team·Enterprise 플랜 — 소유자가 관리자 콘솔에서 설정합니다.
  • Claude API·서드파티 API 플랜 — 관리자가 관리형 설정을 사용자 컴퓨터에 내려보냅니다.
  • sec-default(보안 기본값) — Team·Enterprise 플랜이나 관리형 설정이 있는 컴퓨터에서는 이 내장 모드가 가장 먼저 로드되어, 사용자가 설치한 모드가 권한 거부 규칙을 무시하는 등 위험한 일을 하지 못하게 막습니다. 제한 내용은 소스 코드로 확인할 수 있습니다.
  • 관리자 자체 모드 — 관리자는 자기 모드를 먼저 로드할 수 있으며, 그럴 때는 제한을 유지하려면 목록에 sec-default를 함께 넣어야 합니다.

활용 예로는 CI/CD 상태(빌드 성공·실패)를 대화 옆 창에 표시하기, 운영 환경 설정을 건드리는 명령 전에 확인 요구하기, 다른 모드의 모든 호출을 기록하는 감사 로그가 소개되었습니다.

자주 묻는 질문

Q. 모드는 안전한가요?
샌드박스에서 실행되지 않으므로 출처를 믿을 수 있을 때만 설치해야 합니다. 모드는 Claude Code와 같은 수준으로 내 컴퓨터에 접근합니다.

Q. 코딩을 몰라도 쓸 수 있나요?
네, 이미 만들어진 모드를 플러그인으로 설치해 쓸 수 있고, Claude에게 만들어 달라고 부탁할 수도 있습니다.

Q. 어디에서 쓸 수 있나요?
Claude Code CLI와 데스크톱 앱에서 쓸 수 있습니다. 모드 하나가 터미널, 데스크톱 앱, 또는 둘 다를 대상으로 할 수 있습니다.

Q. 내장 기능을 끌 수도 있나요?
일부는 가능합니다. 내장 /diff가 모드로 바뀌어 /plugin에서 끄거나 교체할 수 있고, Anthropic은 앞으로 더 많은 기능을 모드로 옮길 계획이라고 밝혔습니다.

출처: Customize Claude Code with mods in TypeScript (Anthropic, 2026년 10월 1일)

관련 글

이 글이 도움이 됐나요?

이어서 읽어보세요