Claude Code Mods: TypeScript 몇 줄로 AI 에이전트의 행동을 바꾼다

플러그인은 기능을 추가한다. Mods는 에이전트의 작동 방식 자체를 바꾼다.

2026년 10월 1일, Anthropic이 Claude Code 버전 2.1.287과 함께 Mods를 정식 출시했다. 기존 Claude Code의 훅(Hooks)이 특정 이벤트에 반응하는 쉘 스크립트였다면, Mods는 에이전트의 내부 동작을 감싸는 TypeScript 함수다. 도구 호출 결과를 가로채거나, 권한 요청을 자동 승인하거나, 민감한 정보를 자동으로 지우는 것까지 가능하다.

Mods가 할 수 있는 것 5가지

Anthropic이 공개한 Mods의 핵심 능력이다.

1. 프롬프트 재작성

모델에 도달하기 전에 프롬프트를 수정한다. 예를 들어 모든 요청에 "항상 TypeScript를 사용하라"는 지침을 자동으로 추가하거나, 특정 표현을 더 명확한 언어로 바꿀 수 있다.

2. 툴 호출 차단·재시도·리라이팅

Claude Code가 특정 명령(예: rm -rf)을 실행하려 할 때 Mod가 이를 감지해 차단하거나, 더 안전한 명령으로 재작성한 뒤 실행할 수 있다.

3. 권한 요청 자동 승인·거부

매번 직접 승인해야 했던 권한 창(permission dialog)을 Mod로 자동화할 수 있다. "이 디렉토리 안의 파일 읽기 요청은 항상 자동 승인"처럼 조건부 규칙을 만들 수 있다.

4. 툴 출력에서 민감 정보 제거

툴 실행 결과가 모델로 돌아가기 전에 API 키, 비밀번호, 개인정보 등을 자동으로 검열(redact)한다. 실수로 민감 정보가 컨텍스트에 쌓이는 것을 방지한다.

5. UI 커스터마이징

인터페이스 요소를 편집하거나 교체할 수 있다. 새로운 UI 패널을 추가하거나 기존 표시 방식을 변경하는 것도 가능하다.

기존 /diff 기능이 Mod가 됐다

주목할 변화 중 하나는 기존 내장 기능의 Mod화다. Claude Code의 /diff 명령(미커밋 변경사항을 대화 옆 패널에 보여주는 기능)이 이제 Mod로 제공된다. 즉, 사용자가 이 기능을 끄거나 자신만의 버전으로 교체할 수 있다. Anthropic은 앞으로도 일부 내장 기능을 Mod로 전환할 예정이라고 밝혔다.

어떻게 설치하는가

Mods는 플러그인(Plugin) 안에 탑재되어 /plugin 명령으로 설치한다. CLI와 데스크탑 앱 모두 지원된다.

가장 쉬운 시작점은 Claude Code 자체에게 Mod를 만들어 달라고 요청하는 것이다. 원하는 동작을 자연어로 설명하면, Claude Code가 TypeScript Mod 파일을 작성해 준다.

중요한 보안 주의사항

Anthropic은 공식 발표에서 이 점을 명시했다: Mods는 샌드박스 환경이 아니다. Mod는 Claude Code와 동일한 수준으로 사용자 컴퓨터에 접근할 수 있다. 따라서 신뢰할 수 없는 출처의 Mod를 설치하는 것은 위험하다.

개발자·팀 환경에서 Mod를 공유할 때는 코드를 직접 검토하는 것을 권장한다.

교육·에듀테크 관점에서의 활용

Mods는 교육용 Claude Code 환경을 구성하는 데 실질적인 도구가 될 수 있다.

안전한 학습 환경 구성: 학생들이 Claude Code를 쓸 때 특정 명령(파일 삭제, 시스템 폴더 접근 등)을 차단하는 Mod를 팀 전체에 배포할 수 있다.

코딩 스타일 통일: 수업에서 사용하는 언어·스타일 가이드를 프롬프트 재작성 Mod로 자동화하면, 모든 학생이 동일한 코딩 관례를 따르는 AI 어시스턴트를 갖게 된다.

민감 정보 보호: API 키나 개인정보가 Claude Code의 컨텍스트에 노출되는 것을 자동으로 차단하는 Mod를 기관 수준에서 적용할 수 있다.

정리: AI 에이전트의 '운영체제' 커스터마이징

Mods는 Claude Code를 단순히 사용하는 것에서, 자신의 팀과 워크플로우에 맞게 조각하는 것으로 차원을 바꾼다. TypeScript를 아는 개발자라면 지금 당장 시작할 수 있다. 아직 TypeScript가 낯설다면, Claude Code에게 "이런 동작을 하는 Mod를 만들어줘"라고 부탁하는 것이 가장 빠른 첫걸음이다.

Source:

• Customize Claude Code with mods in TypeScript — Anthropic Official Blog
• Anthropic Launches Claude Code Mods, TypeScript Agent Hooks — AI Weekly
• Claude Code Mods: What They Can Do and What They Can Reach — CellCog
• Claude Code 2.1.287 adds mods — Mixed News