클로드 코드 화면을 내 맘대로 바꿉니다 | AI 소식

클로드 코드로 작업하다 보면 이런 순간이 있습니다. 대화가 길어질수록 컨텍스트가 얼마나 찼는지 궁금한데, 확인하려면 명령어를 따로 쳐야 하죠. Claude가 rm -rf 같은 위험한 명령을 실행하려 할 때도 승인 창 한 줄만 보고 판단해야 했습니다. 이제는 입력창 바로 위에 "날씨 예보"처럼 컨텍스트 사용량이 뜨게 만들 수 있습니다. 위험한 명령은 무엇이 바뀌는지 먼저 보여주고 버튼으로 진행·취소를 고르게 할 수도 있고요. Anthropic이 10월 1일(미국 기준) 공개한 클로드 코드 모드(mods) 덕분입니다.

결론부터 말하면, 클로드 코드는 이제 "쓰는 도구"에서 "내 손에 맞게 고쳐 쓰는 도구"가 됐습니다.

한눈에 보기

항목	내용
발표	2026년 10월 1일, Anthropic 공식 블로그
무엇	클로드 코드의 동작과 화면을 바꾸는 TypeScript·JavaScript 함수
필요 버전	터미널 v2.1.287 이상, 데스크톱 앱 v2.1.286 이상
설치 방법	플러그인에 담아 /plugin으로 설치
만드는 방법	직접 코드 작성, 또는 Claude에게 말로 요청
주의	샌드박스 없이 내 권한으로 실행됨

모드, 기존 훅이랑 뭐가 다를까?

이미지: Anthropic

클로드 코드는 원래도 꾸밀 수 있었습니다. 셸 명령을 이벤트마다 실행하는 훅, 반복 지시를 담는 스킬, 외부 도구를 붙이는 MCP 서버가 있었죠. 다만 셋 다 클로드 코드 "바깥"에서 일했습니다. 스크립트를 돌리거나 Claude에게 글과 도구를 건네는 것까지만 가능했어요. 화면에 버튼을 하나 더 그리는 일은 불가능했습니다.

공식 발표에 따르면 모드는 클로드 코드 "안"에서 돌아가는 작은 함수입니다. 클로드 코드가 도구를 부르거나, 권한을 묻거나, 화면 일부를 그릴 때마다 이벤트가 생깁니다. 모드는 그 이벤트의 앞이나 뒤에서 실행되고, 아예 대신 처리할 수도 있어요. 공식 문서가 정리한 차이는 이렇습니다.

구분	모드	설정 훅	스킬	MCP 서버
정체	클로드 코드 안에서 도는 함수	이벤트마다 실행되는 셸 명령	Claude가 읽는 SKILL.md	도구를 주는 외부 프로세스
화면에 그리기	가능	불가	불가	불가
작성 언어	JavaScript·TypeScript	스크립트 + settings.json	마크다운	아무 언어

모드로 할 수 있는 일도 구체적입니다. 프롬프트가 모델에 닿기 전에 고쳐 쓰기, 도구 호출을 막거나 바꾸거나 재시도하기, 권한 요청을 승인·거절하기가 됩니다. 도구 결과에서 비밀 키를 가린 뒤 Claude에게 넘기는 것도 가능하고요. 대화 옆에 패널을 띄우거나 입력창 위에 띠를 두고 버튼과 입력칸을 넣을 수도 있습니다. 클로드 코드의 /diff 기능도 이제 모드로 만들어져 있어서, 끄거나 내 것으로 갈아 끼울 수 있다고 Anthropic은 밝혔습니다.

그럼 실제로는 어떻게 써볼 수 있을까요?

코드를 몰라도 모드를 만들 수 있나?

가장 쉬운 길은 Claude에게 부탁하는 겁니다. 공식 발표는 "직접 쓰거나 Claude에게 써 달라고 하면 된다"고 설명합니다. Claude가 TypeScript를 쓰고, 설치하고, 지금 세션에 바로 다시 불러온다는 거죠. Anthropic 개발자 블로그의 입문 가이드도 같은 방법을 지름길로 소개합니다.

직접 써보면 이렇게 하면 됩니다.

1. 터미널에서 버전부터 확인합니다. v2.1.287보다 낮으면 업데이트하세요

claude --version

2. 클로드 코드 세션을 열고 원하는 기능을 말로 설명합니다. 입문 가이드의 예시를 줄여 옮기면 이런 식입니다

token-weather라는 클로드 코드 모드를 만들어줘.
입력창 위 띠에 컨텍스트 사용량을 날씨처럼 보여줘.
25% 미만은 맑음, 50% 넘으면 비, 90% 넘으면 곧 압축 경고.
매 턴이 끝날 때마다 갱신해줘.

3. Claude가 핫 리로드를 켤지 한 번 묻습니다. 허용하면 턴이 끝날 때 띠가 나타납니다
4. 지금 켜진 모드를 보려면 /plugin을 입력합니다. 탭 아래에 "1 mod active" 같은 줄이 보입니다
5. 마음에 들지 않으면 /plugin의 Installed 탭에서 해당 플러그인을 끄면 됩니다

코드를 직접 읽어 보고 싶은 분을 위해 공식 문서에는 완성된 예제가 있습니다. Claude가 도구를 쓸 때마다 횟수를 세서 스피너 옆에 "tool calls: 3"처럼 붙여 주는 모드예요. tool.call 이벤트에서 숫자를 올리고, ui.render 이벤트에서 스피너 문구 뒤에 숫자를 덧붙이는 두 개의 훅이 전부입니다. 파일도 plugin.json, hooks.json, register.js 세 개면 됩니다.

만들기 전에 남이 만든 걸 먼저 구경해 볼 수도 있습니다.

샘플 모드 3종, 뭐부터 써볼까?

이미지: Anthropic

Anthropic은 샘플 모드 저장소에 완성된 모드 3개를 올려 두었습니다. 지원 없이 있는 그대로 공유한다는 조건이 붙어 있습니다.

샘플	하는 일
token-weather	입력창 위에 컨텍스트 창 사용량 예보를 그림
blast-radius	rm -rf, 강제 푸시 같은 위험한 셸 명령을 붙잡고 무엇이 바뀌는지 보여준 뒤 진행·취소 버튼 제공
replay-theater	/replay 명령을 추가해 지난 턴에 Claude가 고친 파일을 한 단계씩 다시 보여줌

써보는 순서는 이렇습니다.

1. 저장소를 내 컴퓨터에 복제합니다
2. 써볼 모드 폴더를 지정해 한 세션에서만 불러옵니다

claude --plugin-dir ./token-weather

3. 계속 쓰고 싶다면 복제한 폴더를 마켓플레이스로 추가하고 설치합니다
4. 셸에서 설치했다면 열려 있는 세션에서 /reload-plugins를 실행해야 바로 적용됩니다

입문 가이드는 이 밖에도 사용량·속도 제한 미터, 팀 규칙을 매 프롬프트에 붙이는 훅, 이번 세션에서 읽은 파일 목록 패널, 긴 작업이 끝나면 알림을 띄우는 집중 타이머를 아이디어로 꼽았습니다.

모드가 강력한 만큼, 설치 전에 꼭 확인할 것이 있습니다.

아무 모드나 깔아도 괜찮을까?

아닙니다. 공식 문서는 모드가 샌드박스 없이 "내 권한으로" 실행된다고 분명히 적어 두었습니다. 설치된 모드는 내 계정이 닿는 모든 파일을 읽고 쓸 수 있고, 프로그램을 실행하고, 네트워크 요청을 보낼 수 있습니다. 환경 변수와 설정 파일에 넣어 둔 API 키도 읽을 수 있고요. 모든 프롬프트와 도구 호출을 볼 수 있고, 내게 묻기 전에 도구 호출을 승인할 수도 있습니다.

그래서 Anthropic이 권하는 점검 순서가 있습니다.

1. 믿을 수 있는 작성자와 마켓플레이스에서만 설치합니다
2. 설치 전에 플러그인 파일을 받아 아래 명령으로 검사합니다. 출력의 hooks:와 calls: 줄에 모드가 다루는 이벤트와 요청하는 일이 나옵니다

claude plugin validate ./some-mod

3. 문제가 생기면 --safe-mode로 시작해 그 세션의 모드를 모두 끄거나, ~/.claude/settings.json에 "disableAllHooks": true를 넣어 전부 끕니다

회사에서 쓰는 분이라면 하나 더 알아 두세요. Team·Enterprise 요금제와 관리 설정이 걸린 기기에서는 sec-default라는 기본 모드가 가장 먼저 실행됩니다. 권한 거부 규칙을 덮어쓰는 것 같은 위험한 동작을 막아 주는 역할입니다. 관리자는 플러그인 마켓플레이스를 허용하거나 막을 수 있습니다. 또 모드는 화면 대부분을 바꿀 수 있어도 권한 확인 창만큼은 손대지 못하게 되어 있습니다.

비기 생각: 누구에게 쓸모 있을까

크리에이터 입장에서는 "자주 하는 확인"을 화면에 고정해 두는 용도가 가장 현실적입니다. 영상 스크립트 작업 중 컨텍스트가 얼마나 남았는지, 이번 세션에 어떤 파일을 읽었는지를 매번 묻지 않아도 되니까요. 직장인과 개발팀은 운영 서버 명령 앞에 확인 단계를 넣거나 모든 도구 호출을 기록하는 감사 로그로 쓰기 좋습니다. 공식 발표도 CI/CD 상태 패널, 운영 설정 확인, 감사 로그를 팀 활용 예로 들었습니다.

혼자 일하는 소상공인이나 1인 사업자라면 처음부터 만들 필요는 없어요. 샘플 3종 중 blast-radius 하나만 켜 둬도 실수로 파일을 날릴 위험을 줄일 수 있습니다. 이게 핵심입니다. 모드는 화려한 기능보다 "내 실수를 막아 주는 장치"로 먼저 써볼 때 가치가 큽니다.

오늘 바로 해볼 것 3가지

• [ ] claude --version으로 v2.1.287 이상인지 확인하고, 낮으면 업데이트하기
• [ ] 클로드 코드에 "입력창 위에 컨텍스트 사용량 보여주는 모드 만들어줘"라고 요청해 보기
• [ ] 남이 만든 모드를 깔기 전에 claude plugin validate로 하는 일 확인하는 습관 들이기

비기의 한 줄 정리

이제 클로드 코드의 불편한 점은 참지 말고 말 한마디로 고쳐 쓰세요!

더 자세한 사용법은 AI 가이드와 인스타그램 @biggie_ai에서 확인하세요.