Claude Code Mods 공개: TypeScript 함수로 에이전트 동작 수정

핵심 요약

Anthropic이 2026년 10월 1일 Claude Code의 새 확장 방식인 Mods를 발표했다 (Anthropic 공식 블로그). Mods는 TypeScript 함수로 Claude Code 에이전트의 동작을 수정하는 기능이다. 플러그인에 포함되어 배포되며, /plugin 명령으로 CLI와 데스크톱 앱에서 설치한다. 다만 Mods는 샌드박스 없이 실행된다. Anthropic은 신뢰할 수 있는 출처의 mod만 설치하라고 경고했다.

주요 기능

1. 프롬프트 재작성

Mod는 사용자의 프롬프트가 모델에 전송되기 전에 내용을 다시 쓸 수 있다. 팀의 규칙이나 맥락을 일관되게 덧붙이는 용도로 쓸 수 있다.

2. 도구 호출 제어

에이전트가 도구를 호출할 때 mod가 개입한다. 호출을 차단하거나, 인자를 재작성하거나, 다시 시도하게 할 수 있다.

3. 권한 요청 처리

Claude Code가 보내는 권한 요청을 mod가 승인하거나 거부한다. 반복되는 확인 절차를 코드로 정의할 수 있다.

4. 도구 출력의 비밀정보 마스킹

도구 출력에서 비밀정보를 가린 뒤 Claude가 읽게 할 수 있다. 환경 변수나 키가 포함된 출력이 모델에 그대로 전달되는 상황을 줄이는 데 쓸 수 있다.

기본 기능의 mod 전환

Anthropic은 기존 기능 일부를 mod로 옮겼다. 아래 세 가지가 해당한다 (공식 블로그).

핵심 기능이 같은 메커니즘 위에서 동작한다는 뜻이다. 외부 개발자가 쓰는 확장 지점이 Anthropic 자체 기능에도 쓰인다는 점은 의미가 있다.

보안과 관리

Mods는 샌드박스 없이 실행되므로 설치한 코드가 가진 권한이 곧 위험 범위다. 프롬프트, 도구 호출, 권한 요청 흐름에 모두 개입할 수 있어 신뢰할 수 없는 mod는 부담이 크다.

Team과 Enterprise 플랜은 위험한 덮어쓰기를 막는 sec-default mod를 먼저 로드한다. 조직 수준의 안전장치가 기본으로 깔리는 구조다. 이 mod가 구체적으로 어떤 덮어쓰기를 막는지는 확인한 자료에 상세히 나오지 않았다.

사용성 분석

설치 경로가 /plugin 하나로 통일되어 진입 장벽은 낮다. 확장 언어가 TypeScript여서 웹 개발자에게 익숙하다. 팀 단위로는 권한 승인 규칙, 비밀정보 마스킹, 프롬프트 규약을 플러그인으로 묶어 배포하는 방식이 적합하다. 반면 개인 사용자는 출처를 직접 검토해야 한다.

장단점

장점은 에이전트 흐름의 주요 지점에 코드로 개입할 수 있다는 점, 플러그인으로 배포가 쉽다는 점, 기본 기능이 같은 구조를 쓴다는 점이다. 한계는 샌드박스가 없어 보안 책임이 사용자에게 있다는 점과 Team/Enterprise 외 플랜의 기본 보호 장치가 확인되지 않았다는 점이다.

전망

Mods가 확산되면 에이전트 정책을 코드로 관리하는 방식이 자리 잡을 수 있다. 그 전에 mod 배포 출처의 신뢰 확보가 선결 과제다. 마켓플레이스 심사나 서명 같은 체계는 확인한 자료에 언급이 없다. 향후 샌드박스 도입 여부도 발표되지 않았다.

결론

Mods는 Claude Code를 팀 정책에 맞게 조정하려는 조직에 실용적인 확장 수단이다. 비밀정보 마스킹과 권한 자동 처리는 바로 쓸 만하다. 다만 샌드박스가 없으므로 직접 검토한 mod만 설치해야 한다. 팀 단위 Claude Code 운영자에게 추천한다.