Claude Code에서 diff 줄마다 댓글을 달아 코드 변경을 검토한다

comment-diff는 Claude Code에서 코드 변경 내역(diff)의 각 줄에 댓글을 달고, 여러 댓글을 리뷰로 묶어 Claude에 보낼 수 있는 모드다. Claude가 댓글을 처리하면 해결 여부와 조치 내용을 표시한다.

Claude Code 2.1.302 이상을 터미널에서 실행해야 하며, 터미널에서 마우스 클릭을 활성화해야 한다. diff에 표시되는 +를 클릭해 댓글을 작성하고, Enter를 누르면 검토 목록에 추가된다. Send now를 누르면 해당 댓글을 바로 보내며, Cancel을 누르거나 같은 +를 다시 클릭하면 취소된다. 댓글을 쓰는 동안 프롬프트에 입력해 둔 내용은 잠시 보관됐다가 복원된다.

검토 목록에서 Submit review를 누르면 대기 중인 댓글이 한 메시지로 전송된다. Claude가 작업 중일 때 보낸 댓글은 현재 턴이 끝날 때까지 기다리지 않고 다음 도구 결과와 함께 전달된다. 댓글에 답글을 달거나 수정하고, 해결 또는 삭제할 수 있으며 해결된 댓글에 답글을 달면 다시 대기 상태가 된다. 댓글은 해당 세션에만 남고 세션 간에는 저장되지 않는다.

설치는 Claude Code 터미널의 프롬프트에서 다음 명령을 실행한다.

/plugin install comment-diff --marketplace formstep/claude-mod-comment-diff

y를 눌러 formstep 마켓플레이스를 추가한 뒤 적용 범위를 선택한다. 기본값인 사용자 범위는 모든 세션에서 모드를 활성화한다. 설치 후 재시작 없이 바로 사용할 수 있다. 셸에서는 다음 명령으로 설치하며, 데스크톱 앱에서는 프롬프트 옆 +를 눌러 Plugins에서 마켓플레이스와 플러그인을 추가한다.

claude plugin install comment-diff --marketplace formstep/claude-mod-comment-diff

업데이트와 제거에는 각각 다음 명령을 사용한다.

claude plugin update comment-diff
claude plugin uninstall comment-diff

매우 큰 diff는 약 90,000자(대략 800줄 이상)를 넘으면 댓글 버튼 없이 Claude Code의 기본 diff로 표시된다. 오류가 난 도구 호출도 기본 diff를 유지한다. 이보다 작은 긴 diff는 여러 부분으로 나뉘어 표시된다. 서브에이전트가 수정한 내용은 대화 기록에 diff로 표시되지 않아 댓글을 달 수 없다. 자세한 사용법과 소스 코드는 프로젝트 저장소에서 확인할 수 있다.