Anthropic이 자사의 터미널 및 데스크톱 AI 코딩 도구인 Claude Code 내부에서 직접 동작하며 UI와 작동 방식을 수정할 수 있는 미들웨어 시스템인 Claude Code Mods를 출시했습니다.13 개발자는 기존의 정형화된 어시스턴트 환경을 벗어나 자바스크립트(JavaScript) 또는 타입스크립트(TypeScript) 함수로 프롬프트 흐름을 가로채거나 UI를 새로 그릴 수 있습니다.12
이번 변화가 중요한 이유는 단순한 지침 추가나 외부 스크립트 연동 수준을 넘어, 도구 내부의 이벤트 처리 로직 자체를 직접 조작할 수 있는 깊은 수준의 제어권을 제공하기 때문입니다.34 이를 통해 개발자 개인의 작업 방식에 맞춰 AI 코딩 도구의 작동 메커니즘을 맞춤 설정할 수 있게 되었습니다.34
외부 연동 방식과의 차이 및 내부 작동 원리
기존에도 Claude Code는 설정 파일이나 단방향 셸 명령을 실행하는 설정 훅(settings hooks), 그리고 외부 데이터나 도구를 연결하는 MCP(Model Context Protocol) 서버를 통한 커스터마이징을 지원했습니다.24 하지만 이 방식들은 모두 Claude Code 외부에서 작동하므로 인터페이스를 직접 수정하거나 내부 실행 로직에 깊이 개입하는 데 한계가 있었습니다.24
반면 Claude Code Mods는 Claude Code 내부에서 직접 실행되는 플러그인 기반 시스템입니다.12 도구가 사용자 프롬프트를 수신하거나 도구 호출(Tool call)을 실행하고 UI를 렌더링할 때 발생하는 다양한 이벤트에 자바스크립트 또는 타입스크립트 함수를 연결합니다.12 이 핸들러 함수는 이벤트가 일어나기 전, 후, 또는 이벤트를 대체하여 실행될 수 있으며, 프롬프트를 재작성하거나 도구 호출을 차단, 승인, 변형하는 작업을 수행합니다.23
여러 개의 Mods가 동일한 이벤트에 연결된 경우, 로드된 순서대로 실행되는 스택 구조를 가집니다.23 가장 먼저 로드된 Mod가 이벤트를 가장 먼저 감지하고, 그 최종 실행 결과는 가장 나중에 처리하게 됩니다.23 또한 Mod 내부 파일의 변수를 공유하여 도구 호출 횟수를 카운트해 UI 상단에 표시하거나 토큰 사용량을 차트로 그려주는 등 이벤트 간 상태를 지속해서 기록하고 시각화할 수 있습니다.24
주요 활용 사례와 기본 탑재 모드
Claude Code Mods를 활용하면 대화창 옆에 전용 패널을 추가하거나 내부 작동 방식을 실시간으로 확장할 수 있습니다.12 예를 들어 Anthropic이 GitHub의 claude-code-playground 저장소를 통해 공개한 샘플 Mod인 blast-radius는 rm -rf나 강제 푸시(force push) 같은 위험한 셸 명령어를 가로채 영향을 시뮬레이션하고 승인/취소 버튼을 제공합니다.2 token-weather는 컨텍스트 창 사용량 비율에 따라 날씨 상태(Clear, Showers, Storm)로 시각화해 표시하며, replay-theater는 지난 턴에서 Claude가 변경한 파일 이력을 /replay 명령으로 되짚어볼 수 있게 합니다.24
기존의 기본 기능 일부도 Claude Code Mods 구조로 전환되고 있습니다. 대표적으로 코드 변경 사항을 확인하는 /diff 명령어는 이미 Mod 형태로 구현되어 있어 사용자가 원할 경우 비활성화하거나 자체 버전으로 대체할 수 있습니다.13 또한 첫 번째 공식 플러그인으로 제공되는 You Should Know는 클로드의 출력을 모니터링하는 별도의 에이전트를 가동하여, 대화 과정에서 사용자가 놓칠 수 있는 중요한 정보를 감지하면 알림을 보내줍니다.1 개발자는 세션 안에서 인공지능에게 원하는 기능을 설명하여 타입스크립트 코드를 생성하고 즉시 동적으로 로드해 사용할 수도 있습니다.23
보안 구조와 권한 제약
Mods는 도구 내부에서 강력한 제어력을 제공하지만, 그만큼 명확한 보안적 주의가 필요합니다. Mods는 사용자의 권한으로 직접 실행되며 시스템 레벨에서 격리되는 샌드박스 처리가 되지 않습니다.12 따라서 사용자와 동일한 파일 읽기/쓰기, 프로세스 시작, 네트워크 요청 권한을 가지며, 환경 변수나 설정 파일에 보관된 API 키 등 민감한 정보에도 접근할 수 있습니다.2
비록 Claude Code 자체에서 샌드박스 기능을 활성화하더라도, 이는 Claude가 실행하는 Bash 명령을 격리할 뿐 Mod가 시작하는 프로세스는 샌드박스 외부에서 작동합니다.2 이 때문에 Anthropic은 검증되지 않은 마켓플레이스나 출처의 Mods를 설치하지 말 것을 경고합니다.12
조직 관리를 위해 기업 및 엔터프라이즈 환경에서는 중앙 집중식 제어 수단을 제공합니다.23 관리자는 허용되는 플러그인 마켓플레이스를 지정할 수 있으며, 중앙 관리가 적용된 환경에서는 sec-default라는 보안 기본 Mod가 사용자 설치 Mod보다 항상 먼저 로드됩니다.23 sec-default는 사용자가 설치한 Mod가 권한 거부 규칙(deny rules)을 임의로 우회하는 위험한 동작을 사전에 차단합니다.3
실무 적용 범위 및 도입 전 점검 기준
Claude Code Mods는 현재 Claude Code CLI와 데스크톱 앱에서 온전히 지원되며, VS Code 확장 프로그램에서는 부분적으로 작동합니다.12 CLI 환경에 친숙하고 대화형 개발 프로세스를 세밀하게 제어하려는 개발자 및 개발 팀에게 유용한 도구입니다.13
도입을 검토하는 팀은 다음 기준을 사전에 점검해야 합니다.
소스 코드 검증: 외부에서 도입하는 Mod의 소스 코드가 신뢰할 수 있는 출처에서 제공되었는지 사전 검토합니다.12
보안 정책 확인: 팀원들의 실행 환경에
sec-default를 비롯한 보안 거버넌스 정책이 올바르게 적용되어 있는지 확인합니다.3적절한 수단 선택: 기존 설정 훅이나 MCP 서버로 충분히 해결 가능한 작업인지 판단하고, UI 직접 제어나 이벤트 차단이 필수적인 경우에 한해 Claude Code Mods로 확장하는 접근이 바람직합니다.2
참고
1Claude Code's new Mods system lets developers rewrite the AI coding tool from the inside
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.