r/ClaudeCode•2개월 전•103•41
AI 코드 리뷰 아직 하시나요? Opus 5가 주석을 엄청나게 달아대네요
Dunno if you guys still review AI code, but Opus 5 writes a TON of comments
핵심 요약
Claude Opus 5가 과도하게 많은 주석을 생성하는 문제에 대해 사용자들이 원인과 해결책을 공유합니다.
- 주석 과다 생성 — 최신 모델 업데이트 이후 코드 내 주석 비중이 급격히 증가함
- 시스템 프롬프트 영향 — 모델의 주석 제한 지침이 삭제되거나 변경된 것이 원인으로 지목됨
- 사용자 대응 전략 — Claude.md 파일에 주석 작성 금지 규칙을 추가하거나 직접 수정하여 해결함
- 주석의 효용성 논쟁 — 코드 품질 향상을 위한 사고 과정이라는 의견과 토큰 낭비라는 의견이 대립함
비교적 간단한 기능을 구현하는데도 내 PR이 왜 수천 줄이나 되는지 이유를 찾아보고 있었음.
알고 보니 모델이 작성하는 주석의 양이 엄청나게 늘어났음. 분석을 요청해 보니, 현재 작업 중인 브랜치는 주석이 40%, 코드가 60%라고 함. 반면 메인 브랜치에 있는 파일들은 주석 8%에 코드 92%였음.
문서나 테스트 같은 것들도 양이 늘어난 것 같긴 한데 확실히 말하긴 어려움. 의심할 여지 없이 가장 눈에 띄는 건 주석임.
이게 도움이 되는 건지, 아니면 토큰 낭비인지는 판단하기 어려움. 내가 직접 코드를 리뷰할 때는 막연하게 도움이 되긴 하는데, 이제 Opus 5가 인라인 주석을 통해 레포지토리를 매핑하는 능력이 더 좋아진 건지, 아니면 그냥 그런 것들을 생성하고 읽느라 토큰만 낭비하는 건지 궁금함.
