Opus 5 불평하기 전에 설정부터 점검해라
Audit your setup before whining about Opus 5
핵심 요약
Opus 5의 성능 저하가 기존의 복잡한 claude.md 설정 때문일 수 있으니, 설정을 간소화하고 최적화해 보라는 조언.
- 설정 최적화 — 기존의 복잡한 claude.md를 간소화하여 모델 성능을 개선함.
- 불필요한 지시사항 — 과도한 가이드라인이 오히려 모델의 추론 과정을 방해할 수 있음.
- 성능 개선 — 설정을 정리한 후 동일한 프롬프트에서 작업 속도가 현저히 빨라짐.
- 모델 특성 — Opus 5는 이전 모델보다 더 적은 지시사항으로도 충분히 작동함.
그냥 겪은 일인데, 순전히 개인적인 경험이지만 여러분께 도움이 될지도 모르겠네요.
저는 직업상 여러 프로젝트, 코드 베이스, 고객들과 일합니다. 그래서 전역 claude.md 파일은 꽤 간결하게 유지하지만, 각 프로젝트마다 꽤 잘 정의된 프로젝트 수준의 claude.md 파일(그리고 코딩 표준 같은 지원 참조 자료들)을 가지고 있죠.
한 달 정도 손대지 않았던 프로젝트의 간단한 기능을 작업 중이었는데, Opus 5가 정말 헤매는 느낌이었습니다. 딱히 잘못된 일을 하는 건 아니었는데, 불필요하게 계속 grep을 돌리는 것 같았고, 내부 독백으로 "아 알겠다" 했다가 "아니네 틀렸네"를 반복하더군요.
오늘 아침에 Y Combinator에서 Boris Cherny의 강연을 보지 않았더라면 이런 생각을 못 했을 겁니다. 저는 모델이 하던 작업을 멈추고 새 세션을 시작한 뒤, 프로젝트의 기존 claude.md와 프로젝트 내에 있던 몇 가지 스킬들을 감사(audit)해달라고 요청했습니다. 불필요한 지시사항이 있는지, 혹은 지시사항과 참조 자료를 다르게 작성할 수 있는지 확인해달라고 했죠.
몇 분 후, 모델이 제안한 변경 사항으로 90줄짜리 claude.md에서 약 40줄이 삭제되었고, 시스템 구축 방식에 대한 여러 지원 문서들도 상당히 다듬어졌습니다. 또한 제 스킬 중 두 가지는 "솔직히 불필요하다"고 하더군요. 그 스킬들은 워크플로우 및 보고와 관련된 것들이었습니다.
몇 가지를 백업해두고 변경 사항을 적용한 뒤, 새 세션을 시작해서 정확히 똑같은 프롬프트를 복사해서 붙여넣었습니다(나름 과학적인 방법이죠). 이전 시도에서는 몇 분 동안 허우적거렸는데, 이번에는 1분 만에 끝났습니다.
Opus 5는 이전보다 지시사항이 덜 필요할지도 모르며, 예전에는 효과적이었던 가이드라인들이 오히려 문제를 일으키고 있을 수도 있다고 생각합니다.
요약: "항상 잘 작동하던 설정"을 검토해볼 때가 된 것 같습니다. Opus 5에서는 문제를 유발하고 있을지도 모르니까요.
