Claude Mods 해설, Claude Code를 자신의 주의 방식에 맞게 확장하는 구조

Mod는 프롬프트, 도구 호출, 화면 렌더링 같은 이벤트에 반응하는 함수로, CLI와 Desktop의 동작과 외관을 바꾼다. 저자는 이를 에이전트 하네스의 미들웨어로 자리매김한다. Claude Code에는 Mod 작성법을 알려주는 스킬이 내장되어 있어, 평이한 말로 요청하면 Claude가 만들어 준다. agents-md, diff, plugin-authoring, sec-default, telemetry, you-should-know 여섯 개가 Anthropic이 만든 내장 Mod이며, 이 중 you-should-know만 기본 상태에서 꺼져 있다.

저자가 유용하다고 꼽는 것은 두 가지다. You Should Know는 부 에이전트가 작업을 관찰하다가 놓치기 쉬운 정보를 알려준다. 실제 사례에서는 편집 중이던 CompareView.swift에 커밋되지 않은 작업이 있다는 경고가 떴고, 다른 약 45개 파일도 같은 상태라고 알려 주었다. 데모 편집을 버리면 이전 작업까지 잃을 수 있다는 사실을 미리 알아챌 수 있었다. 또 하나는 저자가 직접 만든 Next Steps Supervisor로, 파일 편집이나 명령 실행이 있었고 도구 호출이 8회 이상인 턴이 끝난 뒤 작동하며, 다음 단계를 클릭 가능한 버튼으로 제안한다. 이 기능은 오픈소스 플러그인 ModSmith에 포함되어 있다.

비교 대상으로는 OpenAI가 10월 7일 GPT-6과 함께 ChatGPT에 도입한 Intelligent UI를 든다. 모델이 답변마다 OpenAI의 부품 모음으로 UI를 생성하기 때문에 설정은 필요 없지만 제어할 수 있는 범위는 좁다. Cursor의 PR Routing & Approval은 코드 소유권과 커밋 이력을 바탕으로 리뷰어를 배정하고, 위험이 낮은 PR은 자동 승인할 수 있다. 정책은 팀이 작성하지만 흐름 자체는 Cursor의 것이다. Claude Mods는 사용자와 에이전트가 코드로 인터페이스 자체를 만든다는 점에서 다르다.

과제도 솔직하게 적혀 있다. 10월 15일 도입 이후 111개 턴 중 99개 턴에서 Supervisor가 작동해 노이즈가 되었고, 결국 읽지 않고 넘기게 되었다. 점검할 때마다 대화를 분기하고 다시 읽어 들이기 때문에, README의 추정으로는 50k 토큰 세션에서 한 번 점검에 약 5~6k의 입력 상당 토큰이 든다. Mod는 샌드박스로 격리되어 있지 않아 파일을 읽고 쓰거나 전송되는 프롬프트를 볼 수 있으며, 내장 Mod는 --safe-mode에서도 동작한다. 저자는 직접 만든 것과 내장된 것 이외에는 코드를 읽은 뒤에 설치하라고 말한다.

앞으로는 세션 기록에서 반복적으로 수정하는 부분을 찾아내 Mod를 제안하는 하네스가 이상적이라고 본다. 저자는 하네스가 사람과 에이전트를 잇는 인터페이스의 토대가 되고, 다른 회사들이 그 위에 사업을 세우게 될 것이라는 전망을 제시한다.