주석 없는 코드를 처음 열었을 때의 그 막막함, 개발자라면 누구나 안다. 함수 이름만 봐서는 뭘 하는지 알 수 없고, 결국 호출 스택을 세 단계씩 따라가며 코드 전체를 읽게 된다. Claude Code를 쓰면 이 문서화 작업을 명령어 한 줄로 끝낼 수 있다. 이 글은 코드 주석 자동 추가하기 — 함수에 설명을 붙이는 방법을 처음부터 따라할 수 있게 정리한다.1. 왜 지금 이걸 봐야 하나팀 코드베이스에서 가장 많이 듣는 말이 있다. "이 함수 뭐 하는 거예요?" 그리고 그 질문에 대한 대답은 항상 같다. "코드 읽어봐요."주석이 없으면 코드를 읽는 데 시간이 걸리는 게 아니라, 맥락을 재구성하는 데 시간이 걸린다. 변수 이름이 v이고 함수 이름이 process라면 로직 전체를 처음부터 추적해야 한다. 하루..
