클로드 코드 모드(mods) 출시: 무엇을 바꿀 수 있나요?

클로드 코드(Claude Code)를 자기 작업 방식에 맞추려는 개발자는 모드(mods)로 화면과 도구 동작을 바꾸고, 설치 전에 그 코드가 행사할 권한을 살펴볼 수 있습니다. Anthropic은 2026년 10월 1일 작은 TypeScript 함수로 Claude Code를 확장하는 mods를 발표했습니다. 프롬프트를 고치거나 기본 기능을 대체하는 것까지 허용하며, 플러그인에 담아 설치·공유합니다. (공식 발표)

초기 Reddit 토론에는 확장 가능성에 대한 기대와 기능 설명을 이해하기 어렵다는 의견이 함께 나왔습니다. 실제 작업에서 효과를 측정한 후기와는 구분해 읽습니다. 아래 기능·이용 조건의 확인일은 2026년 10월 3일입니다. (출시 토론)

한눈에 보기

기능과 권한은 공식 발표·문서·입문 안내에 나온 설명입니다. 아래 활용 예시는 공식 자료가 제시한 가능성을 풀어 쓴 것이며, 직접 설치한 체험이나 성능 측정 결과는 포함하지 않았습니다. (공식 문서 · 입문 안내)

기존 hooks와 무엇이 달라지나요?

이벤트는 Claude Code가 도구를 호출하거나 사용자의 프롬프트를 받는 등 특정 동작을 할 때 내보내는 신호입니다. hook은 그 신호에 연결한 처리 코드입니다. 기존 설정 파일의 hooks는 외부 명령·HTTP 요청·프롬프트 등을 실행해 동작을 관찰하거나 차단하고 내용을 수정합니다. mod는 Claude Code 안에서 실행되는 함수로 이 처리에 참여합니다. 공식 문서에서는 두 방식 모두 hook이라고 부르므로, 설명을 읽을 때 설정 파일의 hook인지 mod의 함수인지 구별하면 이해하기 수월합니다. (hooks와 mods 비교)

mod 함수는 이벤트가 실행되기 전이나 후에 동작하고, 원래 동작을 대신 처리하거나 전후를 감쌀 수도 있습니다. 예를 들어 명령 실행 전에 입력을 점검하고 실행 뒤에는 결과를 기록하는 두 작업을 하나의 함수 안에서 연결합니다. 입문 안내의 next(e)는 이벤트를 다음 mod와 기본 동작으로 넘기는 호출입니다. 입력을 바꿔 넘기면 이후 코드가 수정된 내용을 받고, 넘기는 대신 답을 반환하면 해당 이벤트를 직접 처리합니다. (이벤트 처리 입문)

사용법을 글로 알려주는 skill은 반복 지침을 전달하는 데 맞고, 외부 서비스의 도구를 제공하는 MCP 서버는 연결을 확장하는 데 맞습니다. mods는 대화 옆에 새 패널을 넣거나 도구 호출 자체의 흐름을 바꾸려는 작업에 맞습니다. 이미 설정 hook으로 해결되는 기록·차단 기능이라면 그 방식과 mods의 변경 범위를 비교해 선택할 수 있습니다. (확장 방식 비교)

프롬프트와 도구 호출은 어디까지 바꾸나요?

공식 발표는 모델에 전달되기 전 프롬프트 수정, 도구 호출의 차단·수정·재시도, 권한 요청의 승인·거부, 모델이 읽기 전 도구 출력의 비밀정보 가리기를 제시합니다. 반복 작업의 입력 형식을 맞추거나 특정 출력에서 민감한 문자열을 가리는 동작을 붙일 수 있다는 설명입니다. 그 효과는 설치한 mod가 실제로 어떤 규칙을 구현했는지에 따라 달라집니다. (공식 발표의 동작 범위)

문서는 도구 호출을 잠시 멈추고 사용자에게 질문하거나, 실제 도구를 실행하는 대신 결과를 돌려주거나, 요청 하나를 다른 모델에 보내는 방식도 설명합니다. 따라서 도구 결과를 보는 화면뿐 아니라 그 결과가 만들어지는 경로도 검토 대상에 들어갑니다. 승인 처리 mod라면 어떤 호출을 허용하는지, 다른 모델로 보내는 mod라면 무엇을 어디로 보내는지를 코드와 호출 목록에서 살펴보는 것이 설치 판단에 도움이 됩니다. (도구·요청 처리 범위)

화면과 기본 기능도 바꿀 수 있나요?

mods는 대화 옆 패널이나 입력창 위 표시줄을 추가하고, 도구 결과 행 등 기존 화면의 일부를 바꾸며 버튼·입력란을 넣을 수 있습니다. 공식 입문 예시인 Token Weather는 모델이 한 번에 참고하는 대화·자료의 공간인 컨텍스트 창이 얼마나 찼는지 날씨 아이콘으로 보여 줍니다. Blast Radius는 위험한 셸 명령을 잠시 멈추고 변경 범위를 보여 주며, Replay Theater는 직전 작업의 파일 편집을 단계별로 살펴보는 예시입니다. 모두 공식 샘플의 동작 설명입니다. (공식 샘플 안내 · 만드는 과정)

내장 /diff도 mod로 제공됩니다. 사용자는 /plugin에서 이를 끄거나 다른 버전으로 교체할 수 있습니다. Anthropic은 더 많은 기본 기능을 mods로 옮길 계획도 밝혔습니다. 현재 제공되는 /diff와 앞으로 옮길 기능은 구분됩니다. (기본 기능 변경 발표)

여러 mods가 같은 이벤트를 처리하면 로딩 순서가 동작에 영향을 줍니다. 먼저 로드된 mod는 입력을 먼저 받고, 뒤쪽 처리와 기본 동작이 끝난 결과를 마지막으로 받습니다. 입력 검토·수정·결과 기록을 서로 다른 mods에 맡긴다면 어떤 순서로 묶이는지도 확인할 항목입니다. (실행 순서 설명)

어디서 이용하며 설치는 어떻게 하나요?

mods는 Claude Code v2.1.287 이상에서 기본 활성화됩니다. CLI와 데스크톱 앱의 Code 탭이 주요 제공 환경입니다. 화면을 그리는 기능의 범위는 이벤트 처리보다 좁습니다. VS Code 확장의 채팅 패널에서는 이벤트 처리는 실행되지만 mod가 만든 패널·표시줄은 보이지 않습니다. 화면 없이 실행하는 claude -p·Agent SDK와 클라우드 세션도 이벤트 처리만 돌아갑니다. 그래서 자동화 스크립트에서 돌리는 Claude Code에도 설치한 mod의 도구 차단·수정 규칙이 적용될 수 있습니다. 데스크톱의 WSL 세션은 플러그인을 지원하지 않아 mods도 실행되지 않습니다. (환경별 제공 표)

설치는 일반 플러그인과 같은 방식입니다. 공식 발표는 Claude 디렉터리나 CLI의 /plugin에서 설치하도록 안내합니다. 문서 예시는 /plugin install 플러그인이름@마켓플레이스이름 형식이며, 셸에서 설치했다면 열려 있는 세션에서 /reload-plugins를 실행해야 바로 불러옵니다. 직접 만드는 경우 Claude Code에 원하는 동작을 설명하면 코드를 작성하고 세션에 설치·즉시 다시 불러오는 방식으로 수정할 수 있습니다. 입문 안내는 API가 릴리스 사이에 바뀔 수 있으며, 해당 버전이 생성한 타입 선언을 기준으로 작성하도록 설명합니다. (설치 안내 · 제작·호환성 안내)

설치 전 로컬 검토는 다음 명령으로 시작합니다. ./some-mod는 내려받은 플러그인 폴더로 바꿉니다. 이 명령은 mod를 실행하지 않고 처리 이벤트와 Claude Code에 요청하는 호출을 나열합니다. 출력의 hooks:와 calls:를 읽은 뒤 실제 코드·작성자와 함께 판단합니다. (설치 전 검토 문서)

claude --version
claude plugin validate ./some-mod

설치 후에는 /plugin에서 활성 mods를 확인하고 개별 플러그인을 비활성화할 수 있습니다. 한 세션만 모든 설치 mods를 끄려면 claude --safe-mode로 시작하고, 모든 세션에서 끄려면 ~/.claude/settings.json에 "disableAllHooks": true를 넣습니다. 이 설정은 설정 파일 hooks와 사용자 지정 상태 표시줄도 함께 멈추며, /diff 같은 내장 mod는 멈추지 않습니다. 사전 체험 때 CLAUDE_CODE_ENABLE_FUNCTION_HOOKS를 설정했다면 지워야 합니다. v2.1.287부터는 이 값을 무시하므로 0으로 둬도 mods가 꺼지지 않습니다. (켜고 끄는 방법)

한국 계정의 지역별 제공 여부와 플랜별 접근 차이는 인용한 공식 자료에서 명시되지 않았습니다. 자신의 버전·관리자 정책과 함께 계정에서 설치가 표시되는지 확인하면 실제 이용 조건을 좁힐 수 있습니다. (활성화·관리 문서)

설치한 mod는 어떤 권한을 갖나요?

공식 발표와 문서는 mods가 샌드박스로 격리되지 않고 현재 사용자 권한으로 실행된다고 설명합니다. 파일 읽기·쓰기, 프로세스 실행, 네트워크 요청뿐 아니라 환경변수와 설정에 보관된 비밀정보, 대화와 도구 호출에도 접근할 수 있습니다. Claude가 실행하는 Bash 명령에 샌드박스를 켜더라도 mod가 시작한 프로세스는 그 밖에서 실행됩니다. 따라서 비밀정보를 가리는 mod를 도입할 때도 그 mod 자체가 자료에 접근한다는 조건을 함께 봅니다. (권한·샌드박스 문서)

승인 처리도 따로 볼 항목입니다. 문서에 따르면 도구 호출을 승인하는 mod는 ask 규칙이 원래 사용자에게 물어볼 호출이나, 사용자가 만든 PreToolUse 설정 hook이 막은 호출까지 승인할 수 있고 조건에 따라 deny 규칙이 거부한 호출을 승인하는 경우도 있습니다. 반면 권한 확인 창 자체는 mod가 바꿀 수 없어, 확인 창에 표시되는 내용은 그대로 보입니다. 기존 권한 규칙을 믿고 쓰던 사람이라면 승인 기능이 있는 mod를 설치할 때 이 차이를 확인합니다. (승인 범위 설명)

관리자는 플러그인 마켓플레이스 허용·차단으로 mods를 통제합니다. Team·Enterprise에서는 소유자가 관리 콘솔에서 정하고, Claude API·서드파티 API 플랜에서는 관리 설정을 사용자 기기에 배포합니다. 해당 플랜과 관리 설정이 적용된 기기에서는 내장 sec-default mod가 먼저 로드돼, 사용자가 설치한 mods가 권한 거부(deny) 규칙을 무시하는 등의 위험한 동작을 막습니다. 관리자가 다른 mod를 먼저 로드하도록 정하면 sec-default도 목록에 명시하는 방식으로 제한을 유지합니다. 조직에서는 승인된 마켓플레이스와 로딩 정책을 함께 확인할 수 있습니다. (조직 관리 설명)

비용과 요금은 어떻게 계산하나요?

2026년 10월 3일 확인한 발표와 개요 문서에는 별도의 mod 이용 요금이 명시돼 있지 않습니다. 반면 권한 문서는 mod가 사용자의 플랜이나 API 키로 모델을 호출해 사용량을 소비할 수 있다고 밝힙니다. 설치 비용과 설치 뒤 발생하는 모델 호출 비용은 나눠 보는 것이 좋습니다. (공식 발표 · 사용량 접근 문서)

화면에 숫자를 표시하는 mod와 매번 모델에게 검토를 요청하는 mod는 추가 호출 여부가 다릅니다. 공식 Token Weather 예시의 $.session.usage()는 상태 표시줄과 같은 사용량 숫자를 읽는 호출로, 입문 안내는 이 호출이 무료이며 세부 내역을 요청할 때만 토큰 수 계산 요청을 보낸다고 설명합니다. 다른 mods의 비용은 각각의 코드가 호출하는 모델·빈도와 계정의 과금 조건을 보고 판단합니다. (Token Weather 사용량 설명)

반응은 어떤가요? (2026년 10월 3일 기준)

r/ClaudeCode 출시 토론에서는 한 사용자가 DeepSeek의 확장 가능한 하네스와 비교했습니다. 하네스는 모델에 도구와 작업 흐름을 붙여 실제 일을 수행하게 하는 주변 실행 구조입니다. 또 다른 사용자는 mods의 가능성에 기대를 보였고, 일부는 이벤트와 함수가 어떻게 동작하는지 설명을 이해하기 어렵다고 했습니다. 이 반응은 확장 기능에 대한 초기 관심과 설명 방식에 대한 의견입니다.

만들고 싶은 mods를 묻는 토론에서도 기능 정의를 묻는 댓글과 공식 문서 링크를 안내하는 댓글이 나왔습니다. 아직 배우고 싶은 기능을 묻는 반응이며, 생산성 향상이나 보안 효과를 검증한 실사용 후기로 해석하지 않았습니다. 한국어 실사용 후기는 인용한 자료에서 찾지 못했습니다.

참고한 자료

확인일: 2026년 10월 3일. 기능·조건은 공식 자료를, 반응은 위 Reddit 토론을 참고했습니다.

• Anthropic: Customize Claude Code with mods
• Claude Code 문서: Mods overview
• 공식 입문 안내: Getting started with Claude Code mods