Claude Code 모드(mods) 총정리: 코딩 몰라도 말로 만드는 나만의 AI 작업 도구와 안전 점검

Claude Code를 쓰다 보면 "이 부분만 내 방식대로 바뀌면 좋겠다"는 생각이 듭니다. 2026년 10월 1일 Anthropic이 발표한 모드(mods)는 바로 그 불편을 해결하는 기능입니다. 이 글에서는 모드가 무엇인지, 코딩을 잘 모르는 직장인이 어디까지 써볼 수 있는지, 시작 전에 꼭 확인할 안전 수칙은 무엇인지 정리했습니다.

결론부터 말하면, 모드는 개발자용 기능이지만 "Claude에게 말로 설명해서 만들게 하는 방식"이 공식 안내에 포함되어 있어 비개발자도 구경하고 따라 해 볼 만합니다. 다만 모드는 샌드박스 없이 내 컴퓨터에서 실행되므로, 신뢰할 수 있는 것만 설치해야 합니다.

핵심 요약
  • 모드는 Claude Code의 동작을 바꾸거나 화면을 새로 그리는 작은 TypeScript 함수입니다. (2026년 10월 1일 발표)
  • 프롬프트 고쳐 쓰기, 도구 호출 차단·재시도, 권한 요청 승인·거부, 도구 출력 속 비밀값 가리기 등이 가능합니다.
  • 직접 코드를 쓰지 않고 Claude Code에게 "이런 모드를 만들어 줘"라고 요청할 수 있습니다.
  • 모드는 샌드박스에서 실행되지 않으므로 믿을 수 있는 출처의 것만 설치해야 합니다.
  • Claude Code 2.1.287 이상에서 쓸 수 있고, CLI와 데스크톱 앱에서 지원됩니다.
Anthropic Claude 웹사이트 화면
Claude Code를 만든 Anthropic의 Claude 웹사이트 화면
이미지 출처: Wikimedia Commons · Software: Anthropic PBC · Public domain

1. 모드란 무엇인가: 훅보다 한 걸음 더 나간 기능

Anthropic 공식 안내에 따르면 Claude Code는 도구를 호출하거나, 권한을 묻거나, 화면 일부를 그릴 때마다 "이벤트"를 내보냅니다. 모드는 이 이벤트에 끼어드는 함수입니다. 이벤트가 일어나기 전에, 후에, 또는 그 대신 실행할 수 있고, 앞뒤를 모두 감쌀 수도 있습니다.

기존에도 훅(hooks)이 있었지만, 훅은 이벤트를 고쳐 쓰거나 새 화면을 그리거나 기능을 통째로 바꿀 수 없었습니다. 모드는 그것까지 가능하다는 점이 다릅니다. 공식 설명대로 모드는 플러그인 안에 담겨 배포되므로, 설치하고 공유하는 방법도 일반 플러그인과 같습니다.

구분훅(기존)모드(신규)
이벤트 관찰가능가능
이벤트 내용 고쳐 쓰기제한적가능
새 화면(UI) 그리기불가가능
내장 기능 대체불가가능(예: /diff)
세션 중 상태 유지쉘 명령 단위로드된 채 유지

위 표 중 "세션 중 상태 유지"는 Anthropic 개발 블로그의 설명을 바탕으로 정리했습니다. 설정 훅은 이벤트마다 쉘 명령을 실행하는 반면, 모드는 한 번 로드되면 세션 안에 머물며 상태를 가지고 화면을 갱신할 수 있다고 합니다.

2. 모드로 무엇을 할 수 있나

공식 안내는 한 개의 함수로 다음 일을 할 수 있다고 소개합니다. 프롬프트가 모델에 닿기 전에 고쳐 쓰기, 도구 호출을 막거나 바꾸거나 재시도하기, 권한 요청을 승인하거나 거부하기, Claude가 읽기 전에 도구 출력에서 비밀값 가리기입니다. 화면 쪽으로는 도구 결과나 Claude의 질문 같은 인터페이스를 고치거나 바꾸고, 버튼과 입력창을 추가할 수 있습니다.

개발 블로그 튜토리얼에는 세 가지 예시 모드가 나옵니다. 직장인 입장에서는 "이런 식으로 쓰는구나" 정도로 이해하면 충분합니다.

예시 모드하는 일직장인 관점의 의미
Token Weather대화창이 얼마나 찼는지 날씨 아이콘(맑음~곧 압축)과 퍼센트로 표시긴 작업 중 "이제 새 대화로 넘어갈 때"를 알려 주는 계기판
Blast Radiusrm -rf, git reset --hard 같은 위험 명령 실행 전에 영향 범위를 보여 주고 진행/취소 선택실수로 파일을 날리는 사고를 줄이는 확인 창
Replay Theater한 번의 작업에서 바뀐 파일을 diff로 한 단계씩 되돌려 보기AI가 무엇을 바꿨는지 검토하는 도구

특히 Blast Radius는 비개발자에게 와닿는 사례입니다. AI에게 작업을 맡길 때 가장 무서운 것은 모르는 사이에 파일이 지워지는 일인데, 실행 전에 한 번 멈춰 영향 범위를 보여 주는 장치이기 때문입니다. 다만 개발 블로그는 이것이 "안전망일 뿐 권한 시스템이 아니다"라고 분명히 적고 있습니다. 명령어 텍스트를 읽는 방식이라 별칭이나 스크립트 안의 삭제 명령은 놓칠 수 있고, 확실한 차단은 권한 규칙으로 해야 합니다.

3. 코딩 몰라도 시도하는 법: Claude에게 만들게 하기

개발 블로그의 튜토리얼에는 "지름길"이 있습니다. 모드 API를 몰라도 되고, claude를 실행한 뒤 원하는 모드를 설명하면 됩니다. 핫 리로드를 허용하겠느냐는 질문에 동의하면 작업 턴이 끝날 때 모드가 나타나고, 이후 수정 요청("Storm 기준을 70%로 바꿔 줘")도 바로 반영된다고 합니다.

코드 편집기 VS Code 화면 예시
코드 편집기 화면 예시(VS Code). Claude Code는 이런 편집기나 터미널과 함께 쓰입니다.
이미지 출처: Wikimedia Commons · Cycling2 · CC0

아래는 제가 정리한 시작 순서입니다. 공식 튜토리얼의 흐름을 따랐으며, 이 글을 쓰면서 제가 직접 실행해 본 것은 아닙니다.

단계할 일확인 포인트
1터미널에서 claude --version으로 버전 확인2.1.287 이상이어야 함
2claude 실행 후 원하는 모드를 문장으로 설명보여 줄 내용, 기준값, 갱신 시점을 구체적으로
3핫 리로드 허용 여부 질문에 동의세션 안에서만 임시로 로드됨
4턴이 끝난 뒤 화면 확인, 수정 요청한 번에 하나씩 바꿔 달라고 요청
5마음에 들면 폴더를 복사해 보관세션용 폴더는 나중에 정리됨

프롬프트를 쓸 때는 공식 예시처럼 "무엇을 보여 줄지"만 구체적으로 적으면 됩니다. 예를 들어 다음과 같이 쓸 수 있습니다.

Claude Code 모드를 하나 만들어 줘. 이름은 work-guard.
- 파일을 삭제하는 명령이 나오면 실행 전에 멈추고, 어떤 파일이 지워지는지 목록으로 보여 줘.
- 내가 1을 누르면 진행, 2를 누르면 취소야.
- 코드는 내가 이해할 수 있게 한국어 주석을 달아 줘.

이 프롬프트는 예시이며 실제로 같은 결과가 나오는지는 환경에 따라 다를 수 있습니다. 만들어진 뒤에는 반드시 "이 모드가 내 컴퓨터에서 접근하는 것이 무엇인지 설명해 줘"라고 되물어 확인하는 습관을 권합니다.

자물쇠가 걸린 노트북 사진
모드는 샌드박스 없이 내 컴퓨터에서 실행되므로 설치 전 보안 점검이 필요합니다(일반 이미지)
이미지 출처: Wikimedia Commons · Richard Nowell · CC BY-SA 4.0

4. 설치 전 안전 점검 5가지

모드는 Claude Code와 같은 수준으로 내 컴퓨터에 접근합니다. 공식 안내도 샌드박스가 없다는 점과, 믿을 수 있는 출처만 설치하라는 점을 강조합니다. 개발 블로그는 패키지를 설치하듯 저장소를 먼저 읽고, 신뢰하는 사람의 것만 설치하라고 말합니다. 아래 점검표를 만들어 봤습니다.

점검 항목왜 중요한가
출처가 공식 디렉터리 또는 아는 사람인가제작자는 Anthropic이 아니라 게시자입니다
저장소 코드를 읽어 보았는가읽기 어려우면 Claude에게 요약을 부탁해 보세요
파일·네트워크 접근 요구가 목적에 맞는가시계 표시 모드가 네트워크를 쓸 이유는 없습니다
회사 컴퓨터라면 보안 정책에 어긋나지 않는가Team·Enterprise는 관리자가 플러그인 마켓을 허용·차단합니다
중요한 작업 폴더는 백업했는가모드와 무관하게 AI 작업의 기본 안전장치입니다

회사 계정이라면 관리자 설정도 알아 두세요. 공식 안내에 따르면 Team과 Enterprise 플랜, 또는 관리 설정이 있는 기기에서는 sec-default라는 내장 모드가 가장 먼저 로드되어, 사용자가 설치한 모드가 권한 거부 규칙을 덮어쓰는 등의 위험한 일을 하지 못하게 막습니다. 관리자는 자체 모드를 먼저 로드하도록 바꿀 수도 있습니다.

처음 만드는 모드는 표시 기능부터

첫 모드부터 명령 차단이나 권한 자동 승인을 넣으면 잘못됐을 때 영향이 큽니다. 아래는 실제 로드·실행하지 않은 가상 표시 모드 설계입니다. 컨텍스트 사용률을 받아 70% 미만은 ‘보통’, 70% 이상은 ‘정리 검토’만 표시하고, 파일 쓰기·네트워크 요청·권한 변경은 하지 않도록 요구합니다.

시험 입력기대 표시
69.9%보통
70%정리 검토
값 없음확인 불가

이 기준은 공식 Token Weather의 구간을 그대로 옮긴 것이 아니라 연습용으로 정한 것입니다. 경계값에서 표시가 바뀌는지와 값이 없을 때 0%로 꾸미지 않는지를 봅니다. 이 숫자는 컨텍스트 창의 사용률이지, 구독 주간 한도나 남은 결제 금액이 아닙니다.

검토는 핫 리로드를 허용하기 전에 해야 합니다. 설치 명령을 아직 실행하지 않았더라도 핫 리로드로 세션 안에서 코드가 실행될 수 있습니다. 코드 검토 없이 표시가 정상이라는 이유만으로 안전하다고 판단하지 마세요.

기능 참고: 공식 Mods 소개 · 공식 시작 안내 (2026-10-28 확인). 연습 입력과 검수 기준은 가상 예시입니다.

5. 어떤 직장인에게 의미가 있을까

모든 사람에게 필요한 기능은 아닙니다. 아직 Claude Code를 기본 사용법도 모르는 단계라면 모드보다 권한 설정과 작업 폴더 정리가 먼저입니다. 반대로 AI에게 반복 작업을 자주 시키고, "이럴 때는 꼭 물어보고 진행했으면" 하는 규칙이 생겼다면 모드는 좋은 다음 단계입니다.

제가 이 기능에서 가장 눈여겨보는 점은 "내 방식에 맞춘 안전장치"를 말로 만들 수 있다는 점입니다. 이전에는 개발자가 아니면 설정 파일을 열어 규칙을 쓰기 어려웠지만, 이제는 하고 싶은 일을 문장으로 설명하고 결과를 확인하는 방식이 공식 경로로 제시됩니다. 다만 편리함만큼 책임도 사용자에게 있습니다. 코드를 이해하지 못한 채 믿고 쓰기보다, 작게 시작해서 하나씩 확인하는 방식이 안전합니다.

또 하나 알아 둘 점은 변화 속도입니다. 개발 블로그는 API가 릴리스 사이에 바뀔 수 있다고 적고 있으며, 모드를 불러올 때마다 현재 버전의 타입 선언 파일을 모드 폴더에 써 넣는데 그 파일이 해당 버전의 기준이라고 설명합니다. 즉 온라인 예제를 그대로 복사하기보다 내가 쓰는 버전을 기준으로 Claude에게 만들게 하는 편이 맞습니다.

6. 검증과 공유: 만든 모드를 믿어도 될까

개발 블로그는 만든 모드를 점검하는 명령도 소개합니다. claude plugin validate는 매니페스트와 모듈 소스를 읽어, 어떤 이벤트를 후킹하고 어떤 API를 호출하며 어떤 상태를 읽고 쓰는지 목록으로 보여 줍니다. 코드를 읽기 어려운 비개발자에게도 "이 모드가 무엇을 건드리는지"를 한눈에 파악하게 해 주는 요약이라 유용합니다. claude plugin test는 플러그인의 테스트 파일을 실제 실행 환경에서 돌려 줍니다.

공유할 때는 모드가 곧 플러그인이므로 마켓플레이스 파일이 든 저장소를 만들어 /plugin marketplace add, /plugin install, /reload-plugins 세 단계로 설치하게 합니다. 공식 안내에 따르면 Claude 디렉터리는 모드가 포함된 플러그인도 받으며, 제출 페이지에서 등록할 수 있습니다. 회사 동료에게 나눠 줄 때도 같은 원칙으로, 받는 사람이 먼저 코드를 읽을 수 있게 해 주세요.

자주 묻는 질문

Q1. 모드와 스킬, 훅은 무엇이 다른가요?
공식 안내에 따르면 훅은 이벤트를 관찰하는 정도에 그치지만, 모드는 이벤트를 고쳐 쓰고 화면을 그리고 내장 기능을 대체할 수 있습니다. 이 글에서는 스킬과의 차이는 다루지 않았습니다.

Q2. 무료 플랜에서도 쓸 수 있나요?
제가 확인한 공식 자료에는 플랜별 제공 여부가 명시되어 있지 않았습니다. 확인된 것은 CLI와 데스크톱 앱에서 쓸 수 있다는 점과 Claude Code 2.1.287 이상이 필요하다는 점입니다.

Q3. 모드를 잘못 설치하면 어떻게 되나요?
모드는 Claude Code와 같은 접근 권한으로 실행되므로, 악의적이거나 오류가 있는 모드는 파일에 영향을 줄 수 있습니다. 그래서 출처 확인과 코드 검토, 백업이 중요합니다. 정식 설치 명령 전이라도 핫 리로드를 허용하면 생성된 모드가 세션에서 실행될 수 있습니다.

마무리

모드는 "AI 도구를 내 방식대로 길들이는" 단계로 넘어가는 기능입니다. 개발자가 아니어도 문장으로 요청해 작은 계기판이나 확인 창부터 만들어 볼 수 있다는 점이 매력적입니다. 한편 샌드박스가 없다는 사실을 잊지 말고, 작게 시작해서 하나씩 확인하세요. 저도 제 작업 흐름에 맞는 안전장치 아이디어가 생기면 직접 만들어 본 뒤 후기를 앱 개발기로 남기겠습니다.

※ 이 글은 2026년 10월 17일 기준으로 Anthropic 공식 안내와 개발 블로그를 바탕으로 정리했습니다. 기능과 API는 이후 바뀔 수 있으며, 글에 담긴 사용 순서와 프롬프트는 제가 직접 실행해 본 결과가 아닙니다.

참고 자료

함께 읽으면 좋은 글

목록으로

이 블로그 검색

Copyright © The ISSUEFEED. All rights reserved.
새 글 소식을 RSS로 받아보세요 AI 활용법, 비개발자의 앱 개발기, 직장인 투자일기를 꾸준히 기록합니다.
RSS로 구독하기