Claude가 ‘load-bearing’을 말하지 않게 만드는 방법 — MessageDisplay 훅으로 LLM 말버릇을 인프라 차원에서 걸러내기

GeekNews에 공유된 Claude Code 환경설정 팁을 보면, 모델이 특정 문구를 반복한다면 메시지 표시 훅(MessageDisplay hook)으로 다른 표현으로 자동 치환할 수 있습니다. 단순한 욕설 필터링이 아니라, "honest take", "load-bearing seam" 처럼 모델 학습 결과 굳어진 체화어를 가드레벨에서 걸러내는 패턴입니다.

한국 독자 입장에서 흥미로운 건 이 기법이 프롬프트 엔지니어링이 아니라 시스템 설계에 가깝다는 점입니다. 모델 출력을 바꾸려는 시도가 아니라, 표시 직전 단계에서 결정론적으로 가공하므로 일관성이 보장됩니다. SaaS 백엔드에 모델을 임베드하는 한국 팀이 "말버릇 때문에 신뢰가 깎이는" 문제를 다뤘다면, 이 레이어 분리 패턴은 실질적 해법이 됩니다.

• Claude Code가 “honest take”, “load-bearing seam” 같은 문구를 반복한다면 MessageDisplay 훅으로 화면에 표시되기 전 다른 표현으로 치환할 수 있음
• Python 스크립트가 표준 입력의 JSON에서 delta를 읽어 대소문자를 구분하지 않고 치환한 뒤, 변경된 displayContent를 JSON으로 반환함
• 예제에서는 seam을 whatchamacallit, you're absolutely right를 I'm a complete clown, honest take를 spicy doodad, load-bearing을 cooked로 바꿈
• 스크립트를 ~/.claude/hooks/wordswap.sh에 저장해 실행 권한을 부여하고, ~/.claude/settings.json의 hooks.MessageDisplay에 명령 훅으로 등록해야 함
• 훅은 Claude Code 시작 시 로드되므로 새 세션을 열어야 적용되며, 치환 목록은 원하는 어휘로 자유롭게 바꿀 수 있음

---

출력 문구를 바꾸는 스크립트

• MessageDisplay 훅을 이용해 Claude Code가 화면에 표시할 텍스트를 변경함
• wordswap.sh는 Python으로 작성하며, 표준 입력에서 JSON을 읽어 delta 필드의 문자열을 가져옴
• 각 원문 문구의 앞뒤에 \b 경계를 붙이고 re.escape()로 이스케이프한 다음, re.IGNORECASE를 적용해 대소문자와 관계없이 치환함
• 처리 결과는 다음 구조의 JSON으로 출력함
• hookSpecificOutput.hookEventName: MessageDisplay
• hookSpecificOutput.displayContent: 치환된 텍스트
• 예제 치환 규칙은 다음과 같음
• seam → whatchamacallit
• you're absolutely right → I'm a complete clown
• honest take → spicy doodad
• load-bearing → cooked

설치하고 활성화하기

• 스크립트를 ~/.claude/hooks/wordswap.sh에 저장함
• chmod +x ~/.claude/hooks/wordswap.sh를 실행해 실행 권한을 부여함
• ~/.claude/settings.json의 hooks 블록에 다음과 같이 등록함

`json

{

"hooks": {

"MessageDisplay": [

{

"hooks": [

{

"type": "command",

"command": "$HOME/.claude/hooks/wordswap.sh"

}

]

}

]

}

}

`

• 훅은 Claude Code 시작 시 로드되므로 설정 후 새 세션을 시작해야 적용됨
• replacements 항목을 수정하면 예제 대신 더 유용하거나 재미있는 문구로 바꿔 사용할 수 있음

한국 시장에서의 시사점

한국 LLM 도입 현장에서도 동일 패턴이 적용 가능합니다. 셀바스AI, 네이버 하이퍼클로바, LG 엑사원 계열의 한국형 모델이든 글로벌 API든, 모델이 특정 단어를 반복해 브랜드 일관성이 깨지는 경우가 종종 있습니다. MessageDisplay 훅과 같은 출력 후처리 레이어를 두면 다음 세 가지 이점이 생깁니다.

첫째, 프롬프트로 막지 못하는 결정성을 코드로 확보합니다. 둘째, 모델 업데이트 후에도 교체 룰만 갱신하면 됩니다. 셋째, B2B 고객사 요구에 맞춘 어휘 가이드를 인프라 차원에서 강제할 수 있습니다.

특히 금융·공공·법률 도메인에서는 단어 하나가 규제 리스크로 직결되는데, 이 패턴은 모델 거버넌스 차원의 안전장치로 정착할 여지가 큽니다.

원문: GeekNews #31448 — Claude가 'load-bearing'을 말하지 않게 만드는 방법

---

📰 원본 출처 · https://news.hada.io/topic?id=31448 (#N=31448)

이 글은 GeekNews(긱뉴스)에 게제된 글을 기반으로 작성되었습니다. 원본의 라이선스와 저작권은 원작자에게 있습니다.