눈으로 하는 검증 | Diff와 Preview
Claude가 고친 줄에 라인 코멘트로 다시 요청하고, Preview로 실행 화면까지 세션 안에서 확인합니다
Overview
터미널에서 Claude가 파일을 고치면 검토는 내 몫의 왕복이었습니다. git diff 를 훑고, 브라우저로 넘어가 화면을 확인하고, 고칠 부분은 말로 다시 설명했습니다. Claude Code Desktop은 이 왕복을 한 화면에 모읍니다. 이 레슨을 읽으면 고친 줄에 직접 코멘트를 달아 다시 요청하고, 실행 화면까지 세션 안에서 확인하는 검토 흐름을 쓸 수 있게 됩니다.
학습 목표
- Diff 화면에서 변경된 파일과 줄을 검토합니다.
- 라인 코멘트로 수정 위치를 정확하게 다시 요청합니다.
- Review code가 잡는 문제와 잡지 않는 문제를 구별합니다.
- Preview와 내장 터미널로 실행 결과를 같은 세션 안에서 확인합니다.
시작하기 전 확인사항
- Code 탭에서 세션 열기 경험
- Part 1에서 만든 본인 Todo 앱 (미션에서 사용, 다른 로컬 프로젝트로 대체 가능)
고쳤다는 말만 믿게 되는 순간
터미널에서도 검토는 가능합니다. 다만 도구가 흩어져 있습니다. 변경을 보려면 git diff 를 실행하고, 화면을 보려면 브라우저로 전환하고, 수정을 요청하려면 "아까 그 부분을 다시" 같은 말로 위치를 설명해야 합니다.
왕복이 쌓이면 어느 순간 검토를 건너뛰게 됩니다. "고쳤습니다"라는 응답만 믿고 다음 요청으로 넘어가는 것입니다. 이 강의는 완료 신호가 Claude의 말이 아니라 직접 본 결과라는 원칙을 계속 강조해 왔습니다. 그 원칙이 무너지는 지점이 바로 여기입니다.
Desktop은 이 검토 비용을 낮춥니다. 변경된 줄, 실행 화면, 터미널이 한 세션 안에 있어서 확인이 왕복이 아니라 곁눈질이 됩니다.
Diff 화면: 줄 단위로 검토하기
Claude가 파일을 수정하면 세션에 +12 -1 같은 변경 표시가 나타납니다. 이 표시를 열면 왼쪽에 변경된 파일 목록, 오른쪽에 줄 단위 변경이 보입니다. 파일을 오가며 git diff 를 다시 실행할 필요 없이, 변경 전체를 한 화면에서 읽습니다.
라인 코멘트로 다시 요청하기
diff의 특정 줄을 클릭하면 코멘트를 남길 수 있습니다. 여러 줄에 의견을 달고 한 번에 제출하면 Claude가 코멘트를 읽고 다시 수정합니다.
이 방식은 "다시 해줘"보다 정확합니다. 어느 파일의 어느 줄을 고쳐야 하는지 Claude가 바로 알 수 있고, 나도 위치를 말로 설명하는 수고를 덜기 때문입니다.
Review code로 한 번 더 확인하기
diff 화면의 Review code는 현재 변경사항을 Claude에게 다시 검토하게 하는 기능입니다. 컴파일 오류, 명백한 로직 오류, 보안 취약점, 확실한 버그처럼 신호가 큰 문제에 집중해 인라인 제안을 남깁니다. 내 검토 전에 한 번 거르는 안전망으로 쓰면 좋습니다.
Preview와 내장 터미널: 실행 결과 확인하기
코드 변경은 diff만으로 끝나지 않습니다. 실행 결과가 요구사항과 맞는지 확인해야 합니다. Desktop에서는 이 확인도 세션 밖으로 나가지 않습니다.
Preview로 앱 보기
Preview 화면은 실행 중인 웹 앱을 세션 안에서 보여 줍니다. Claude가 dev server를 시작하고, 화면을 직접 보고, 화면 요소를 검사하고, 문제를 발견하면 다시 고칠 수 있습니다. 내가 말로 증상을 옮겨 주지 않아도 Claude가 같은 화면을 봅니다.
Preview가 브라우저를 완전히 대체하지는 않습니다. 다만 작은 UI 변경, 링크 확인, 에러 화면처럼 바로 봐야 하는 검증에는 브라우저 전환 없이 충분히 빠릅니다.
내장 터미널과 파일로 마무리 확인하기
내장 터미널은 현재 세션의 작업 폴더에서 열립니다. git status, bun test 같은 명령이 Claude가 편집 중인 파일 상태 그대로 실행됩니다. 파일을 직접 열어 한두 줄을 눈으로 확인하거나 손으로 고치고 싶다면 파일 편집 화면을 씁니다.
[미션] Todo 앱을 화면에서 검토하기
Part 1에서 만든 Todo 앱에 작은 기능을 추가하면서, 라인 코멘트와 Preview로 검토 흐름을 한 바퀴 돌아 봅니다. Todo 앱이 없다면 로컬에 있는 아무 웹 프로젝트로 진행해도 됩니다.
Step 1: Todo 앱을 Code 탭에서 열기
Code 탭에서 새 세션을 만듭니다. Environment는 Local, Project folder는 본인 Todo 앱 폴더를 고릅니다. 다음 프롬프트를 입력합니다.
할 일 목록 아래에 "완료 N개 / 전체 M개" 형태로 진행 현황을 표시해줘.Step 2: Diff에서 검토하고 라인 코멘트로 다시 요청하기
변경 표시를 열어 파일과 줄을 확인합니다. 마음에 들지 않는 부분이 있으면 그 줄을 클릭해 코멘트를 남기고 제출합니다.
이 문구는 목록 아래보다 입력창 옆에 두는 편이 눈에 잘 들어옵니다.Step 3: Preview로 실행 화면 확인하기
Preview를 열어 앱을 실행하고, 할 일을 추가하고 완료 처리하면서 표시가 요구사항대로 바뀌는지 확인합니다. 숫자가 어긋나면 화면을 열어 둔 채로 Claude에게 증상을 알려 다시 고치게 합니다.
화면이 대신하지 않는 것
Review code는 스타일 취향, 포맷팅, 이번 변경과 무관한 기존 코드의 문제까지 찾아 주는 기능이 아닙니다. diff와 Preview도 검토를 쉽게 만들 뿐, 무엇이 통과 기준인지는 정해 주지 않습니다.
기준은 배운 그대로입니다. 요구사항을 만족하는지, 테스트 같은 검증 기준을 통과하는지 직접 봅니다. 화면은 그 판단을 빠르게 만들어 줄 뿐, 마지막 판단은 사람이 합니다.
핵심 포인트 정리
- 라인 코멘트: diff의 줄을 클릭해 코멘트로 다시 요청하면 수정 위치를 말로 설명할 필요가 없습니다.
- Review code: 신호가 큰 문제를 거르는 안전망이고, 스타일과 기존 코드 문제는 범위 밖입니다.
- Preview·Terminal: dev server 화면과 명령 실행을 세션 안에서 확인해 검토 왕복을 없앱니다.
- 판단 기준: 화면은 검토 비용을 낮출 뿐, 통과 기준과 마지막 판단은 사람 몫입니다.
FAQ
이어서 배울 내용
지금까지의 세션은 전부 내 컴퓨터(Local)에서 실행됐습니다. 다음 Cloud 세션 레슨에서는 세션을 컴퓨터 밖으로 보냅니다. 노트북을 덮어도 작업이 계속되고, 폰과 웹에서 이어받는 흐름을 다룹니다.