Claude Code에게 코드베이스에서 완료할 작업을 맡기면, Claude는 종종 간결하게 결과를 보고합니다. Claude가 변경한 내용에 대한 설명 아래에는 작게는 사소한 변경부터 크게는 대규모 변경까지 다양한 파일이 변경되어 있을 수 있습니다. 코드 변경을 작성(하고 설명)한 바로 그 세션이 그 변경 사항을 판단하기에 가장 좋은 판단자는 아닌 경우가 많습니다. 변경 사항을 유지하기 전에 직접 한 번 살펴보고, 그런 다음 이 세션의 기록 없이 깨끗한 컨텍스트에서 Claude가 다시 검토하도록 하는 것이 좋은 습관입니다.
실제 변경 사항 검토하기
diff는 변경 전후를 보여줍니다: 파일별로 삭제된 줄과 추가된 줄입니다. /diff 명령은 커밋되지 않은 변경 사항을 이러한 형태로 보여주는 대화형 뷰어를 열며, Claude의 각 턴이 변경한 내용도 보여줄 수 있습니다. 위아래 화살표로 파일 간을 이동하고 Enter로 파일을 엽니다.
/diff매번 다시 한번 살펴볼 가치가 있는 가장 중요한 것들은 다음과 같습니다:
- 요청하지 않은 변경 사항. Claude가 파일을 작업하는 동안 수정된 설정 값이나, 언급하지 않았는데 다시 작성된 헬퍼 메서드 등입니다.
- 약해진 테스트. 작업 중인 프로젝트에 테스트가 포함되어 있다면, 통과시키기 위해 건너뛰거나 삭제하거나 완화된 테스트가 있는지 확인하세요.
- 새 패키지와 하드코딩된 값. 단 하나의 함수를 위해 추가된 의존성, 코드에 직접 작성된 URL이나 키 등입니다.
변경 사항 전체가 잘못되었다면 /rewind를 실행하거나(또는 빈 프롬프트에서 Esc를 두 번 누르고), 해당 변경을 만든 프롬프트를 선택한 다음 Restore code and conversation을 선택하세요. 한 가지 알아둘 제한 사항이 있습니다: 패키지 설치처럼 Claude가 실행한 셸 명령으로 변경된 파일은 롤백되지 않습니다.
아래 연습에서는 작은 가입 양식(signup-form) 작업을 사용합니다: 위에는 Claude의 요약, 아래에는 Claude가 수정한 8개 파일이 있습니다.
두 번째 의견 구하기
Explore → Plan → Code → Commit 레슨에서는 변경 사항을 커밋하기 전에 두 번째 검토자를 두라고 했습니다. 긴 세션은 읽고 결정한 모든 것을 그대로 가지고 있습니다. 이것이 바로 이전 레슨에서 관리하는 법을 배운 컨텍스트이며, 검토자에게는 바로 이 기록이 없어야 합니다. /code-review가 바로 그 두 번째 검토자입니다: 세션 기록이 전혀 없는 깨끗한 컨텍스트에서 변경 사항을 검토하고 발견한 내용을 보고합니다. 요청하지 않는 한 아무것도 수정하지 않습니다.
/code-review리뷰는 백그라운드에서 실행되며, 몇 초에서 몇 분 정도 걸리고, 다른 작업과 마찬가지로 사용량에 포함되므로 다시 한번 살펴볼 가치가 있는 변경 사항에만 사용하세요. 검토가 끝나면 결과가 대화에 도착합니다. 평범한 말로 요청할 수도 있으며, Claude는 그 요청에서 동일한 리뷰를 시작할 수 있습니다. Claude가 리뷰를 시작하는 대신 바로 답변한다면, 직접 명령을 실행하세요.
가입 양식 변경 사항에 대해 리뷰는 네 가지 발견 사항과 함께 돌아왔습니다:
각 발견 사항에 대해 어떻게 할지 결정하기
각 발견 사항을 다음 세 가지 더미 중 하나로 분류하세요:
- 지금 고치기. 실제 문제이고, 중요하며, 반드시 고쳐야 합니다.
- 이유 물어보기. 확실히 검증할 수 없거나 뭔가 이상해 보이는 발견 사항을 위한 더미입니다. 코드 변경 사항을 처음 접하며 읽는 검토자도 놓치는 부분이 있을 수 있습니다.
- 그대로 두기. 실제 문제이지만 작거나 중요하지 않습니다. 이런 것들은 나중에 한 세션에서 다룰 수정 사항 묶음으로 모아둘 수 있는 경우가 많습니다.
이유를 물어보려면, 발견 사항을 Claude에게 그대로 인용하며 다시 확인해 달라고 요청하세요. 위의 두 번째 발견 사항에 대해서는 다음과 같이 입력하면 됩니다:
수정을 요청할 때는 함께 증거도 요청하는 것이 좋습니다:
수정 사항이 결국 그 자체로 큰 변경으로 커진다면, 리뷰를 다시 실행하세요.
더 꼼꼼히 검토하는 것이 가치 있을 때
간단한 한 줄짜리 변경은 대개 diff를 빠르게 훑어보는 것만으로 충분합니다. 변경 사항이 머릿속에 담아둘 수 있는 것보다 크거나, 민감한 부분을 건드리거나, 파괴적인 작업을 수행할 때, 그리고 작업을 동료에게 넘기기 전에는 사람의 리뷰와 Claude의 리뷰를 모두 사용해야 합니다.
직접 해보기: 네 가지 발견 사항 분류하기
요약
- 요약만 믿지 말고 파일 변경 사항의 실제 diff를 읽으세요.
/diff를 실행하고 요청하지 않은 변경 사항, 약해진 테스트, 새 패키지나 하드코딩된 값을 찾아보세요. /code-review로 깨끗한 컨텍스트에서 두 번째 의견을 구하세요(또는 평범한 말로 요청해서 Claude가 시작하도록 하세요). 검토자는 보고만 하며, 요청하지 않는 한 Claude는 수정하지 않습니다.- 각 발견 사항을 지금 고치기, 이유 물어보기, 그대로 두기 중 하나로 다루고, 모든 수정에 대해 증거를 요청하세요.
검토자가 같은 문제를 여러 번 지적한다면, 모든 세션 시작 시 Claude가 읽을 규칙을 작성하는 것이 좋은 방법일 수 있습니다. 그 파일이 바로 CLAUDE.md이며, 다음 레슨에서 다룹니다.