r/ClaudeCode•3개월 전•24•15
Claude가 대화 내용을 코드 주석이나 docstring에 그대로 적지 않게 하려면 어떻게 해야 할까요?
How can I get claude to stop writing docstrings like an extension of our conversation
핵심 요약
Claude가 대화 맥락을 불필요한 주석으로 남기는 문제를 해결하기 위한 프롬프트 전략과 사후 처리 방안을 논의합니다.
- 주석 문제 — Claude가 대화 내용을 코드 주석에 포함하는 현상
- 프롬프트 전략 — claude.md에 메타 코멘트 금지 지침 추가
- 사후 처리 — 별도의 리뷰 에이전트를 활용한 코드 정제
- 문서화 원칙 — 변경 과정이 아닌 현재 상태와 비즈니스 로직에 집중
Claude가 대화에 응답하는 것과 그것을 코드 주석이나 docstring으로 공식화하는 것 사이를 구분하는 데 어려움을 겪는다는 걸 알게 됐습니다. 예를 들어, 제가 "이 파일에서 20개 메트릭이 모두 선택되었는지 확인하고, 중복이 없는지 다시 체크해 줘"라고 말하면 Claude는 당연히 그렇게 하겠지만, # /some/file.py에서 20개 메트릭만 선택 - 중복 없음 같은 멍청한 주석을 추가하곤 합니다. 그냥 코드가 스스로 말하게 하거나, # 메트릭 추가처럼 더 간결하고 나중에 수정될 가능성이 적은 내용을 적을 수도 있는데 말이죠.
이건 제가 지어낸 예시이니 너무 따지지는 마세요. 기본적으로 Claude는 에이전트 코딩 과정과 관련된 정보와 최종 버전 관리 아티팩트에 포함하는 것이 적절한 정보를 혼동하는 것 같습니다.
도움이 될까 해서 claude.md에 지침을 추가해 봤지만(어느 정도 효과는 있음), 일관성이 없고 긴 세션이 이어지면 종종 예전으로 돌아가 버립니다. 다른 분들도 이런 LLM 특유의 현상을 겪어보셨나요? 아니면 더 낫거나 일관된 결과를 얻는 데 성공하신 분 계신가요?
