mod로 Claude Code 사용자 지정
TypeScript 몇 줄로 Claude Code의 동작과 외관을 변경하세요.
오늘 Claude Code의 작동 방식을 바꾸는 소규모 TypeScript 함수를 소개합니다. mod는 프롬프트를 다시 작성하거나, 새로운 UI를 추가하거나, 기본 제공된 기능을 대체하거나, 완전히 새로운 기능을 추가할 수 있습니다. 직접 mod를 작성하거나, Claude Code에 직접 작성해 달라고 요청할 수 있습니다. Mod는 플러그인 내에 포함되므로, 다른 플러그인과 마찬가지로 설치하고 공유할 수 있습니다. 이 기능은 Claude Code CLI와 데스크톱 앱에서 작동합니다.
Mod는 Claude Code 자체와 동일한 접근 권한을 가지고 사용자의 머신에 실행됩니다. 샌드박스로 제한되지 않으며, 컴퓨터에 코드를 설치하는 것과 같은 방식으로 신뢰할 수 있는 출처의 mod만 설치해야 합니다.
mod가 할 수 있는 일을 알아보려면 첫 번째 mod를 만드는 방법 가이드를 읽어보세요.
mod를 개발한 이유
개발자들은 Claude Code가 작동하는 방식을 더 잘 제어할 수 있기를 요청했으며, Claude Code가 출시될 때까지 기다리지 않아도 됩니다. 후크는 사용자가 이러한 제어 권한을 일부 제공했지만, 이벤트를 다시 작성하거나, 새로운 UI를 도출하거나, 기능을 대체할 수는 없습니다. Mod가 가능합니다.
Claude Code가 본인의 것처럼 느껴지기 때문에 자신의 업무 방식에 맞게 조정할 수 있습니다. 개발자들의 피드백을 받기 위해 출시 전에 GitHub에서 mod를 위한 디자인을 공유했습니다. 참여해 주신 모든 분들께 감사드립니다.
mod의 작동 방식
Claude Code는 어떤 작업을 할 때마다 이벤트를 발생시킵니다. 예로는 도구를 호출하고, 권한을 요청하고, 화면의 일부를 그려보는 등이 있습니다. mod는 이러한 이벤트 중 하나에 연결되는 기능입니다. 모드는 이벤트 전, 이벤트 후, 또는 이벤트 대신 실행할 수 있습니다. 또한 이벤트 마무리까지 진행해 전후 코드를 실행할 수 있습니다. 하나의 함수를 통해 mod는 다음과 같은 작업을 수행할 수 있습니다.
- 모델에 전달하기 전에 프롬프트를 다시 작성해야 합니다.
- 차단하거나, 재작성하거나, 도구 호출을 다시 시도하세요.
- 권한 요청을 승인 또는 거부하세요.
- Claude가 도구 출력의 비밀을 읽기 전에 수정합니다.
변경으로 표시되는 내용을 바꿀 수도 있습니다. 도구 결과나 Claude의 질문과 같이 Claude Code가 그린 인터페이스 일부를 편집하거나 대체할 수 있습니다. 버튼과 입력을 추가할 수 있으며, 사용자가 이를 누르면 다른 모드가 응답할 수 있습니다. 현재 mod는 터미널, 데스크톱 앱, 또는 둘 다를 대상으로 할 수 있습니다.
여러 개가 동일한 이벤트를 후크하는 경우, 로드된 순서대로 실행됩니다. 로드되는 첫 번째 mod는 이벤트를 먼저 확인하고, 결과는 마지막으로 확인합니다. 이를 통해 다양한 작성자의 mod를 쌓아 올릴 수 있습니다.
Claude Code를 사용하여 Claude Code를 수정할 수도 있습니다. Claude에게 mod를 만들어 달라고 요청하면, TypeScript를 작성해 설치하고, 사용자의 세션에서 다시 핫로드할 수 있습니다.
내장 기능을 자신만의 브라우저로 바꿔 보세요
Claude Code의 일부 기본 제공 기능은 이제 수정으로 제공됩니다. 예를 들어, 내장된 /diff 기능은 이제 수정 버전이므로, /plugin에서 비활성화하거나, 자체 버전으로 대체할 수 있습니다. 앞으로 더 많은 내장 기능을 mod로 도입할 예정이므로, Claude Code를 작은 코어로 줄여 원하는 부분만 추가할 수 있습니다.
팀 및 기업을 위한 모드
Mod는 플러그인 내에 포함되므로, 기존 플러그인 제어 기능이 적용됩니다. 관리자는 플러그인 마켓플레이스를 허용하거나 차단할 수 있습니다. Team 및 Enterprise 플랜의 경우 소유자가 관리자 콘솔에서 이 설정을 설정합니다. Claude API 및 타사 API 플랜의 경우 관리자가 관리형 설정을 사용자의 컴퓨터에 적용합니다.
Team 및 Enterprise 플랜과 관리 설정을 사용하는 모든 기기에서는 sec-default("보안 기본값")라는 기본 제공 모드가 먼저 로드됩니다. 사용자가 설치하는 mod가 권한 거부 규칙을 무시하는 등 위험한 작업을 하는 것을 막아줍니다. 소스 코드를 보고 어떤 제한을 하는지 확인할 수 있습니다. 관리자는 먼저 자신의 mod를 로드할 수 있습니다. 원하는 경우, 목록에 sec-default를 추가해 제한 사항을 유지하세요.
팀은 mod를 사용하여 자체 제어 기능과 기능을 구축할 수도 있습니다. 예:
- CI/CD 상태: mod는 대화 옆의 창에 파이프라인 상태를 표시하고, 빌드가 통과하거나 실패할 때 이를 업데이트할 수 있습니다.
- 프로덕션 보호 조치: 명령어를 프로덕션 설정에 적용하기 전에 mod의 확인을 요구할 수 있습니다.
- 감사 기록: 먼저 로딩되는 mod는 다른 모든 mod의 모든 통화를 녹음할 수 있습니다.
시작하기
모드는 오늘 Claude Code CLI와 데스크톱 앱에서 사용할 수 있습니다. Claude 디렉토리에서 mod가 포함된 플러그인을 설치하거나 CLI에서 /plugin을 실행하세요. 모드를 공유하려면 플러그인에 패키지화해 디렉토리에 제출하세요.