3. Review Pane로 변경 검토하기

Review Pane이 뭔가요?

Microsoft Word에서 "변경 내용 추적(Track Changes)" 기능을 사용해 본 적이 있나요? 누군가 문서를 수정하면, 어디가 지워지고 어디가 추가되었는지 색깔로 표시해 주는 기능입니다.

Review Pane은 코드 버전의 "변경 내용 추적"이라고 생각하면 됩니다. Codex가 여러분의 코드를 수정하면, Review Pane이 다음을 보여줍니다:

Review Pane에서 각 변경을 확인한 뒤, 승인(Accept)하거나, 마음에 들지 않으면 인라인 코멘트로 "이 부분은 다르게 수정해 줘"라고 피드백을 남길 수 있습니다. Codex는 그 피드백을 읽고 다시 수정합니다.

Git diff란?

Review Pane을 제대로 이해하려면, Git diff가 무엇인지 알아야 합니다. 어렵지 않습니다!

실제 Git diff 화면은 이렇게 생겼습니다:

  function greet(name) {
-   return "Hello, " + name;        // 삭제된 줄 (빨간색)
+   return `Hello, ${name}!`;       // 추가된 줄 (초록색)
  }

위 예시에서 - 표시는 "이전에 있던 코드가 삭제되었다"는 뜻이고, + 표시는 "새로운 코드가 추가되었다"는 뜻입니다. 이렇게 빨간색(삭제)과 초록색(추가)으로 변경 사항을 한눈에 파악할 수 있습니다.

왜 Review가 중요한가요?

AI는 놀랍도록 똑똑하지만, 완벽하지는 않습니다. Codex도 때때로 실수를 합니다. Review는 여러분의 안전망입니다.

리뷰 워크플로

Codex로 코드를 수정하고 리뷰하는 전체 과정을 단계별로 살펴봅니다. 각 단계에서 무엇을 하는지 자세히 설명합니다.

변경 보기 모드 비교

Review Pane에는 3가지 보기 모드가 있습니다. 상황에 따라 적절한 모드를 선택하면 원하는 변경만 집중해서 볼 수 있습니다.

Review Pane이 보여주는 것

Review Pane은 Codex 전용 화면이 아니라 Git diff 뷰어입니다. 따라서 Codex가 수정한 코드 외에도 다른 변경이 함께 보일 수 있습니다. 이것은 버그가 아니라 정상적인 동작입니다.

3가지 핵심 navigation 패턴 (공식 review 문서)

• ✓파일명 클릭 — 해당 파일의 diff로 점프
• ✓파일 배경(빈 영역) 클릭 — 파일 헤더를 토글해 diff를 접거나 펼치기 — 큰 PR을 빠르게 훑을 때 유용
• ✓코드 라인 Cmd+클릭 — 해당 줄을 외부 에디터(Settings의 file_opener로 지정)로 바로 열기

리뷰 워크플로 단계별 진행

아래는 Codex에게 작업을 요청하고, 결과를 리뷰하고, 피드백을 주는 전체 과정을 시간순으로 보여줍니다.

실전 시나리오: 코드 리뷰 따라하기

실제로 Codex를 사용하여 코드를 리뷰하는 과정을 따라해 봅시다. 아래 시나리오를 처음부터 끝까지 읽으면, Review Pane 사용법을 자연스럽게 익힐 수 있습니다.

  function calculateTotal(items) {
    const subtotal = items.reduce((sum, item) =>
      sum + item.price * item.qty, 0);
-   return subtotal;
+   const tax = subtotal * 0.1;
+   return subtotal + tax;
  }

+ const TAX_RATE = 0.1;
  function calculateTotal(items) {
    const subtotal = items.reduce((sum, item) =>
      sum + item.price * item.qty, 0);
-   const tax = subtotal * 0.1;
+   const tax = subtotal * TAX_RATE;
    return subtotal + tax;
  }

인라인 코멘트 작성법

인라인 코멘트는 Review Pane에서 가장 강력한 기능입니다. 일반 채팅으로 "3번째 줄 수정해 줘"라고 말하는 것보다, 해당 줄을 직접 클릭하고 코멘트를 남기는 것이 훨씬 정확합니다.

• 1 변경된 줄 클릭: Review Pane에서 피드백을 남기고 싶은 줄을 클릭합니다. 해당 줄 옆에 코멘트 입력창이 나타납니다.
• 2 구체적으로 작성: "이거 좀 이상해"보다는 "이 변수명을 data 대신 userList로 바꿔 줘. 의미가 더 명확해져"처럼 구체적으로 쓰세요.
• 3 이유도 함께 적기: "왜" 변경을 원하는지 이유를 함께 적으면, Codex가 의도를 더 정확히 이해합니다. 예: "이 함수가 너무 길어서 두 개로 분리해 줘. 유지보수가 어렵거든."
• 4 코멘트 전송: 작성을 마치면 전송 버튼을 누릅니다. 코멘트가 자동으로 대화 스레드에 연결되어, Codex가 정확히 어떤 줄에 대한 피드백인지 알 수 있습니다.
• 5 결과 확인: Codex가 피드백을 반영하여 코드를 재수정합니다. "Last turn 변경" 모드로 전환하면 방금 수정된 부분만 깔끔하게 확인할 수 있습니다.

핵심 포인트

• 1 Review Pane은 코드의 "변경 내용 추적" 기능입니다. 빨간색(삭제)과 초록색(추가)으로 무엇이 바뀌었는지 보여줍니다.
• 2 Git 저장소가 아니면 Review Pane이 동작하지 않습니다. git init으로 먼저 초기화하세요.
• 3 초보자에게는 "Last turn 변경" 모드를 추천합니다. Codex가 방금 수정한 부분만 깔끔하게 볼 수 있습니다.
• 4 인라인 코멘트로 구체적인 피드백을 남기면, Codex가 더 정확하게 재수정합니다.
• 5 AI도 실수할 수 있으므로, Review는 여러분의 안전망입니다. 항상 변경 사항을 확인하고 승인하세요.

실전 팁

자주 묻는 질문 (FAQ)

/review 슬래시 명령

Composer에서 /review를 입력하면 Codex가 현재 리뷰 패널의 변경 내용을 분석해 인라인 코멘트를 자동 생성합니다. 사람이 직접 줄별 코멘트를 다는 대신 1차 검토를 AI에게 맡기고, 사용자는 강조된 라인만 빠르게 확인할 수 있습니다.

Git 액션 3단계 (Diff / File / Hunk)

공식 Review 문서는 Git 액션을 세 가지 단위로 제공합니다.

• ✓Complete diff — 현재 변경 전체에 대해 Stage all / Unstage all / Revert all.
• ✓Individual file — 특정 파일 단위로 Stage / Unstage / Revert.
• ✓Single hunk — 변경 블록(hunk) 단위로 Stage / Unstage / Revert. 같은 파일에서 일부만 커밋하고 싶을 때 사용.

로컬 프로젝트에서는 Staged / Unstaged 보기가 분리되어 표시되며, 코드 라인을 Cmd+클릭하면 사용자가 지정한 외부 에디터(VS Code 등)에서 해당 줄이 바로 열립니다.

PR 리뷰 워크플로 (GitHub 통합)

GitHub PR을 Codex 안에서 체크아웃·리뷰하려면 GitHub CLI가 필요합니다. 최초 1회만 인증하면 이후 PR이 자동으로 로컬 worktree로 체크아웃됩니다.

gh auth login         # 1회 인증
gh pr checkout 1234   # PR을 로컬 브랜치로 체크아웃 (Codex가 자동 호출)

체크아웃 후 Review Pane에서 동일한 Diff/File/Hunk 액션을 그대로 사용할 수 있고, /review로 인라인 코멘트를 자동 생성해 PR 리뷰 시간을 단축합니다.

다음 단계

Review Pane의 기본 사용법을 배웠습니다! 다음으로 알아두면 좋은 내용들입니다:

장점 / 단점 / 한계점