Opus 5의 장황함과 기타 문제를 해결하기 위한 Anthropic 공식 문서 기반 CLAUDE.md 설정
CLAUDE.md for Opus 5 based on Anthropic's official platform docs to fix verbosity and more.
핵심 요약
Anthropic 공식 문서를 바탕으로 Opus 5의 과도한 검증과 장황함을 제어하는 CLAUDE.md 설정법을 공유합니다.
- Opus 5 특성 — 이전 모델과 달리 스스로 검증을 수행하며 장황하게 반응함
- 설정 파일 활용 — CLAUDE.md를 통해 모델의 행동을 제어하고 토큰 낭비를 방지함
- 공식 문서 참조 — Anthropic이 권장하는 프롬프트 엔지니어링 방식을 적용함
- 모델 간 차이 — 기존 모델용 프롬프트가 Opus 5에서는 오히려 성능을 저하시킬 수 있음
최근에 Anthropic's official platform documentation for Claude Opus 5를 읽어봤는데, 이전 모델들이랑 비교해서 기본 동작 방식이 바뀐 게 꽤 흥미롭더라고. Anthropic 문서에 Opus 5가 기본적으로 어떤 습관을 가지고 있는지, 그리고 그걸 어떻게 다뤄야 하는지 예시까지 아주 상세하게 나와 있음.
문서 내용을 보면 Opus 5는 이전 모델들보다 훨씬 말이 많고 의욕이 넘침. 심지어 시키지도 않았는데 지가 알아서 자기 작업 검증까지 함. 만약 지금 쓰는 프롬프트에 "마지막으로 검토해라"라거나 "서브 에이전트 돌려서 코드 더블 체크해라" 같은 구식 지시사항이 들어가 있으면, Anthropic이 말하는 '심각한 과잉 검증 루프'에 빠져서 토큰만 쓸데없이 날리게 됨. 의욕이 너무 과해서 서브 에이전트 군단을 무한 증식시키는 꼴이 될 수도 있다더라.
문서에서 건진 핵심 내용은 이 정도인데, 이거 몇 개만 수정해도 모델이 훨씬 똑똑하게 굴고 내 목적에 딱 맞게 집중하는 게 체감될 정도임. 그래서 내가 알아낸 것들을 바탕으로 50줄 미만의 CLAUDE.md 설정 파일을 만들어서 적용해 봤음. 혹시 설정 파일 궁금하거나 직접 써보고 싶은 사람은 아래 링크에서 코드랑 설정 방법 확인해 봐.
문서 읽으면서 좀 웃겼던 게, 사람들이 Opus 5 쓰면서 불평하던 것들이 사실 Anthropic 입장에선 "이거 원래 이렇게 설계된 거임"이라고 박아둔 것들이더라고. 어떤 사람들은 이걸 퇴보라고 부르면서 Opus 4.8이나 Fable 같은 이전 모델로 갈아타던데, 왜 그런 반응이 나왔는지 이제야 좀 이해가 가네. 정작 본인들은 왜 그런지 이유도 모르고 그냥 답답해했을지도 모르겠지만.
참고한 자료들:
Claude Code Best Practices (CLAUDE.md)
Claude Prompting Best Practices
Prompting Claude Opus 5
Context 7 MCP Documentation
