모드(Mods) 입문: 클로드 코드를 안에서부터 바꾸는 확장 기능

이 강좌를 끝내면 모드의 정의를 한 문장으로 말하고, 모드가 작동하는 순서를 단계로 설명하고, 모드의 적용 조건과 보안 한계를 구분해 판단할 수 있습니다. 사전지식은 두 가지면 됩니다. ‘플러그인’은 기존 프로그램에 끼워 넣어 기능을 더하는 부품이고, ‘CLI(명령줄 인터페이스)‘는 글자 명령을 입력해 프로그램을 쓰는 방식입니다. 핵심 메시지는 하나입니다. 모드는 클로드 코드의 화면과 동작을 플러그인 형태의 코드로 바꾸는 확장 기능이며, 사용자 권한으로 실행되므로 신뢰할 수 있는 것만 설치해야 합니다.

한 문장으로 이해하기

모드(Mods)는 앤트로픽이 공개한 기능으로, 클로드 코드의 화면과 동작을 바꾸는 플러그인 구조의 확장 기능입니다(c1). 도구를 바깥에서 쓰는 방법이 아니라, 도구 안쪽의 동작을 고쳐 쓰는 방법입니다. 이 강좌는 하나의 가상 예시를 끝까지 따라갑니다. 어떤 개발자가 명령 확인용 모드 ‘확인창’을 직접 만든다고 가정하겠습니다. 이는 설명을 위해 지어낸 가상 예시입니다.

왜 필요한가

개발 취지는 사용자마다 업무 방식이 다르다는 점입니다(c3). 가상 예시의 개발자도 같은 처지입니다. 이 개발자는 인공지능(AI)이 요청한 명령을 그냥 넘기지 않고 매번 눈으로 한 번 확인하고 싶습니다. 기본 화면만으로는 그 습관을 담을 수 없으니, 도구 안쪽을 자기 작업 흐름에 맞추려 합니다.

어떻게 이루어지는가

제작과 배포, 그다음 설치와 실행 순서로 보면 이해하기 쉽습니다.

1. 개발자가 자바스크립트나 타입스크립트로 함수를 작성합니다. 둘 다 프로그래밍 언어이고, 함수는 특정 작업을 하도록 묶어 둔 코드 덩어리입니다(c2).
2. 이 함수를 사용자 입력, 도구 호출, 화면 표시 같은 ‘이벤트’에 연결합니다(c2). 이벤트는 프로그램에서 발생하는 사건이고, 도구 호출은 AI가 도구 실행을 요청하는 일이며, 화면 표시는 화면을 그리는 과정입니다.
3. 완성된 모드를 플러그인에 담아 배포하고, 사용자는 CLI나 클로드 데스크톱 앱에서 ‘/plugin’ 명령으로 설치합니다(c4).
4. 설치된 뒤 연결해 둔 사건이 실제로 발생합니다.
5. 그 순간 해당 함수가 실행되어 화면이나 동작이 바뀝니다(c2).

하나의 예시로 따라가기

가상 예시인 ‘확인창’에 위 순서를 그대로 적용해 봅시다. 먼저 자바스크립트로 함수를 하나 씁니다. 그 함수를 도구 호출 사건에 연결합니다. 이 모드를 플러그인에 담아 배포하고, 본인 컴퓨터에서 ‘/plugin’ 명령으로 설치합니다. 이후 AI가 도구 실행을 요청하는 사건이 생기면, 연결된 함수가 실행되어 확인용 화면이 나타납니다.

적용 조건도 같은 예시로 확인합니다. 이 개발자가 쓰는 클로드 코드가 2.1.287 이상이어야 하고, 사용자 지정 화면이 보여야 하므로 CLI 터미널이나 클로드 데스크톱 앱의 ‘코드’ 탭에서 써야 합니다(c9). 같은 기능을 남이 만든 모드로 받을 수도 있지만, 그때는 출처를 신뢰할 수 있는지가 설치 여부를 가릅니다.

언제 쓰고 언제 쓰지 않는가

모드는 CLI와 데스크톱 앱에서 작동하며, 코드 편집기인 VS Code의 확장 기능에서는 일부만 작동합니다(c10). 화면이 바뀌지 않는다면 먼저 버전과 실행 환경을 확인해야 합니다.

한계는 더 중요합니다. 모드는 별도 샌드박스 없이 사용자 권한으로 실행됩니다. 샌드박스는 프로그램을 격리된 공간에서만 돌리는 안전장치입니다. 그래서 모드는 파일과 폴더를 관리하는 체계, 프로그램 실행, 네트워크에 접근할 수 있고, 프로그램 실행에 쓰이는 설정값과 지시문, 도구 호출 정보도 볼 수 있으며, 권한 남용 위험이 있습니다(c7). 앤트로픽은 신뢰할 수 있는 출처의 모드만 설치하라고 권고합니다(c12).

안전장치도 있습니다. 모드는 권한 승인 창을 임의로 바꿀 수 없고, 플러그인 검증 명령과 모드 실행 차단 옵션, 조직 관리자 제어 기능이 제공됩니다(c8). 다만 이런 장치가 있다는 사실이 모든 모드의 안전을 보장한다는 뜻은 아닙니다.

핵심 정리와 확인문제

모드는 클로드 코드의 화면과 동작을 플러그인 형태의 코드로 바꾸는 확장 기능이며, 사용자 권한으로 실행되므로 신뢰할 수 있는 것만 설치해야 합니다. 가상 예시의 ‘확인창’을 돌아보면, 직접 만든 모드도 사용자 권한으로 실행되므로 코드의 동작과 접근 범위를 확인해야 합니다. 남이 만든 같은 기능을 받을 때는 출처 신뢰가 먼저입니다.

1. 모드가 바꾸는 두 가지는 무엇입니까?

정답: 화면과 동작입니다. 해설: 모드는 클로드 코드의 화면과 동작을 바꾸는 플러그인 구조의 확장 기능으로 공개됐습니다.

2. 설치된 모드에서 연결된 사건이 발생하면 무엇이 실행됩니까?

정답: 그 사건에 연결해 둔 함수가 실행됩니다. 해설: 모드는 자바스크립트나 타입스크립트 함수를 사용자 입력, 도구 호출, 화면 표시 같은 이벤트에 연결해 두고, 해당 사건이 생길 때 그 함수가 실행되어 화면이나 동작이 바뀝니다.

3. 지원 버전을 쓰고 있다면 출처를 신뢰할 수 없는 모드를 설치해도 됩니까?

정답: 아닙니다. 해설: 버전 조건은 작동 여부의 문제일 뿐입니다. 모드는 샌드박스 없이 사용자 권한으로 실행되어 파일과 네트워크 등에 접근할 수 있으므로, 앤트로픽은 신뢰할 수 있는 출처의 모드만 설치하라고 권고합니다.

참고자료

• 모드 입문 참고자료
• 모드 입문 참고자료