코드 주석을 감사하고, 사실 삭제하는 것을 고려해 보세요.
Audit the comments, in fact consider deleting them.
핵심 요약
Claude가 생성하는 부정확하고 불필요한 코드 주석이 오히려 모델의 판단을 흐리게 하므로 삭제하는 것이 좋다는 의견입니다.
- 주석의 위험성 — 모델이 잘못된 주석을 사실로 받아들여 코드 수정 시 오류를 유발함
- 주석 삭제 권장 — 모델이 생성한 주석은 부정확하거나 구식인 경우가 많아 제거가 효율적임
- 모델의 한계 — 코딩 능력은 뛰어나지만 비즈니스 로직 이해나 주석 작성 능력은 부족함
- 대안적 접근 — 주석 대신 모델에게 코드 설명을 요청하고 직접 작성하는 방식이 권장됨
Opus 4.7/4.8 때부터 그랬는데, 이번 Opus 5는 진짜 코드에 주석을 미친 듯이 달아대네.
처음엔 좋았지. 예전엔 주석을 아예 안 달아서 파이썬 코드에 기본적인 구글 독스트링 하나 넣게 하려고 아주 생쇼를 해야 했거든.
근데 개발자라면 다들 알겠지만, 주석의 문제는 주석은 거짓말을 한다는 거야.
- 코드가 뭘 하는지 설명하는데 틀린 소리를 함
- '왜' 그런지 설명하는데, 이유가 살짝 틀렸거나 중요한 디테일/뉘앙스를 빼먹음
- 업데이트도 안 돼서 나중엔 잘못된 정보만 주는 지뢰밭이 됨
근데 이게 클로드한테 어떤 영향을 주는지 아냐? 새로운 세션에서 클로드가 자기가 예전에 달아놓은 주석을 읽잖아? 그럼 그게 거의 프롬프트 인젝션처럼 작동해서 모델을 이상한 방향으로 굴려. 지가 쓴 주석을 철석같이 믿고, 그게 진짜 맞는지 의심조차 안 한다고.
요즘은 클로드한테 주석 무시하라고, 주석은 다 거짓말이니까 실제 코드만 보고 판단하라고 계속 말하는 중이야.
클로드가 주석 내용을 근거로 우기면, 내가 그건 틀렸거나 구닥다리라고 일일이 반박하면서 싸워야 함.
직접 코드 까보니까 몇 분 안 돼서 주석 거의 전부가 최소한 미묘하게 틀렸다는 걸 발견했다. 그냥 코드베이스에 있는 주석 싹 다 밀어버릴 생각이야. 다 지우고 나면 스트레스 훨씬 덜 받겠지.
같은 개발자로서 조언 하나 남긴다.
다들 어떻게 생각함? 너네도 이런 거 느낌?
세 줄 요약:
클로드가 코드에 주석을 다는데, 그 주석은 거짓말을 하고 클로드는 나중에 그걸 진짜로 믿음. 그냥 주석 다 지워라. 정 주석이 필요하면 클로드한테 코드 설명해달라고 한 다음에, 네가 직접 달아. 그게 코드 이해하는 데도 훨씬 도움 됨.
