Claude Code의 추론 능력을 향상시키는 어휘 제약 도구 Umwelt

실용적 조언

Claude Code를 사용 중이라면 npx @rodspeed/umwelt init 명령으로 설정을 자동 적용하라
다른 LLM을 사용하더라도 시스템 프롬프트에 제공된 20개의 금지 단어 목록을 추가하여 성능 향상을 시도하라

섹션별 상세

특정 어휘를 금지하는 것만으로도 모델의 추론 정확도가 유의미하게 향상됐다. 15,600회의 통제된 실험을 통해 6개 모델과 7개 작업 유형에서 평균 6.7%p의 정확도 상승이 확인됐다. 이는 FDR 보정을 거친 결과로 통계적 유의성을 확보했으며, 모델이 모호한 단어 대신 정밀한 언어를 선택하도록 강제한 결과이다.

bash

npx @rodspeed/umwelt init

Umwelt 라이브러리를 사용하여 CLAUDE.md에 어휘 제약 조건을 자동으로 주입하는 명령

text

You must not use these filler words: very, quite, rather, somewhat, really, pretty, just, fairly, slightly, extremely, incredibly, absolutely, totally, completely, simply, basically, actually, literally, definitely, certainly. Replace them with precise language.

CLAUDE.md에 수동으로 추가할 수 있는 불필요한 수식어 금지 규칙 텍스트

복잡한 언어적 제약보다 단순한 단어 금지가 더 효과적이라는 사실이 밝혀졌다. 'to be' 동사를 금지하는 E-Prime 같은 깊은 언어적 수정보다 'basically' 같은 단순 수식어를 금지하는 얕은 제약이 더 높은 성능 향상을 보였다. 이는 LLM의 토큰 생성 과정에서 불필요한 확률 분산을 줄이는 것이 추론 품질에 직접적인 영향을 미친다는 점을 시사한다.

Umwelt 도구는 CLAUDE.md 파일에 어휘 제약 블록을 자동으로 주입하여 실무 적용을 돕는다. npx 명령어를 통해 간단히 초기화할 수 있으며, Node.js 환경이 아닌 경우 수동으로 금지 단어 목록을 추가하는 방법도 제공한다. 이를 통해 개발자는 별도의 프롬프트 엔지니어링 없이도 코딩 에이전트의 응답 품질을 즉각적으로 개선할 수 있다.

용어 해설

CLAUDE.md 설정 파일(CLAUDE.md): — Claude Code와 같은 AI 에이전트의 행동 지침과 프로젝트 맥락을 정의하는 설정 파일이다. 이 파일에 특정 규칙을 명시하면 AI가 코드를 작성하거나 대화할 때 해당 지침을 준수하도록 강제할 수 있다.
불필요한 수식어(Filler Words): — basically, essentially와 같이 문장의 의미를 명확하게 하지 않으면서 분량만 늘리는 단어들이다. LLM의 프롬프트에서 이러한 단어를 금지하면 모델이 더 정밀하고 논리적인 언어를 사용하도록 유도할 수 있다.
허위 발견율 보정(FDR Correction): — 다중 비교 테스트에서 발생할 수 있는 통계적 오류를 줄이기 위한 보정 방법이다. 실험 결과가 단순한 우연이 아니라 통계적으로 유의미하다는 것을 입증하는 데 사용된다.

언급된 도구

Umwelt추천링크

CLAUDE.md에 어휘 제약 조건을 자동으로 주입하는 CLI 도구

Claude Code중립

Anthropic의 CLI 기반 코딩 에이전트

언급된 리소스

GitHubUmwelt GitHub Repository

문서Infrastructure Guide & Full Write-up