Claude Code 검토 워크플로: 2.1.260의 새로운 전체 화면 변경 사항 패널

Claude Code 2.1.260의 변경 사항

AI 코드 변경 사항 검토를 위해 추가된 주요 기능은 전체 화면 변경 사항 비교 패널입니다. 해당 2.1.260 릴리스 노트 에서는 Claude가 편집하는 동안 커밋되지 않은 변경 사항을 보여 주는 대화 옆 패널을 설명합니다. 해당 /diff 명령으로 패널 표시를 전환할 수 있습니다.

이를 통해 대화를 계속 보면서 변화하는 변경 사항을 살펴볼 수 있습니다. 유용한 검토 습관은 변경 사항을 요청 내용과 비교하는 것입니다. 어떤 파일이 변경되어야 하고, 어떤 동작이 달라져야 하며, 어떤 제약 조건이 계속 유지되어야 할까요?

전체 화면 변경 사항 비교 패널 열기

현재 대화를 전체 화면 표시 방식으로 전환한 다음 패널 표시를 전환하세요.

/tui fullscreen
/diff

전체 화면 모드 자체는 이번 릴리스 이전부터 있었습니다. 버전 2.1.110에서 다음 기능이 도입되었습니다. /tui 및 다음 tui 설정; /tui fullscreen 은 같은 대화 내에서 표시 방식을 변경합니다. 이러한 이전 기능의 세부 정보는 다음 자료에 기록되어 있습니다. 버전이 명시된 변경 로그.

업데이트를 설명할 때 이 구분은 중요합니다. Claude Code 2.1.260은 실시간 변경 사항 비교 패널을 도입했지만, 전체 화면으로 전환하는 명령은 이미 존재했습니다.

검토 대상 릴리스 노트에는 최소 터미널 너비, 패널 자동 열기, 탐색 단축키, 파일 필터링 동작이 명시되어 있지 않습니다. 게시 기준 시점까지 확인되지 않은 제어 기능에 의존하기보다 문서화된 두 명령부터 사용하세요.

더 폭넓게 이해하려면 다음 자료를 참고하세요. Claude Code 가이드 허브 는 관련 워크플로를 살펴보는 출발점을 제공합니다.

실용적인 Claude Code 검토 워크플로

의도한 변경 사항 정의, 결과로 나온 변경 사항 비교 검토, 자동 검토 요청이라는 세 가지 점검 단계를 따로 사용하세요. 권한은 도구 작업에 대한 확인을 제어하므로 이러한 점검 단계와 함께 고려해야 합니다.

다음 순서는 권장 작업 방식입니다. 새 패널을 승인 인터페이스로 취급하지 않으면서 변경 로그에서 확인된 명령을 함께 사용합니다.

1. 편집 전에 범위 정의하기

Claude에 범위가 한정된 작업과 명확한 검토 기준을 제공하세요. 예상 동작, 관련 제약 조건, 특별히 주의해야 할 사항을 설명하세요.

예를 들어, 오류 처리를 변경해 달라는 요청에는 실패가 발생했을 때 기대하는 대응을 명시해야 합니다. 검토할 때는 이 요구사항을 기준으로 수정 사항이 실패를 일관되게 처리하는지 판단하세요.

변경된 각 파일이 왜 diff에 포함되어야 하는지 설명할 수 있을 만큼 요청 범위를 좁게 유지하세요. 관련 없어 보이는 수정이 있다면 진행하기 전에 Claude에게 해당 수정이 작업과 어떻게 연결되는지 설명해 달라고 요청하세요.

2. 변경 사항이 나타날 때마다 살펴보기

전체 화면 모드를 열고 다음 항목을 전환하세요: /diff. Claude가 수정하는 동안 커밋되지 않은 변경 사항을 설정한 범위와 비교하세요.

실용적인 점검 순서는 다음과 같습니다:

1. 변경된 파일이 작업과 관련 있는지 확인하세요.
2. 변경된 동작과 그 기반이 되는 가정을 살펴보세요.
3. 누락된 부분, 예상치 못한 범위 확장, 불분명한 근거가 있는지 확인하세요.
4. Claude에게 구체적인 우려 사항을 해결해 달라고 요청한 다음 업데이트된 diff를 살펴보세요.

이를 지속적인 대화로 진행하세요. 구체적인 후속 요청에는 우려되는 동작 변경과 기대했던 결과를 명시해야 합니다.

패널에는 이미 적용되었지만 아직 커밋되지 않은 수정 사항이 표시됩니다. 문서에 명시된 목적은 이러한 변경 사항을 확인할 수 있게 하는 것이며, 릴리스 노트에는 변경 구간별 승인 기능이 명시되어 있지 않습니다.

3. 검토 요청 및 결과 평가

변경 사항을 다시 점검할 준비가 되면 다음을 사용하세요: /review 또는 /code-review. 검토 결과를 실제 diff 및 원래 요구사항과 대조하여 평가하세요.

제안된 각 수정에 대해 구체적인 문제를 지적하는지, 제안된 변경이 작업에 적합한지, 범위를 추가로 확장하는지 확인하세요. 그런 다음 그에 따라 이루어진 수정 사항을 다시 살펴보세요.

이렇게 하면 점검, 검토 요청, 지적 사항 해결, 변경된 코드 재확인으로 이어지는 검토 순환이 만들어집니다. 눈에 보이는 diff나 자동 검토 응답만으로 충분한 근거가 확보되었다고 판단하지 마세요.

다음 항목의 /diff, /review및 /code-review 은

각 명령은 서로 다른 용도로 사용됩니다. /diff 명령은 실시간 패널을 제어합니다. /review 명령은 별칭을 통해 검토 명령을 호출합니다.

이 2.1.223 릴리스 노트(2026년 6월자)에는 다음 명령이 /review 다음 명령의 별칭이 되었다고 명시되어 있습니다: /code-review. 이 동작은 전체 화면 diff 패널이 도입되기 전부터 제공되었습니다.

현재 diff 검토

개요에는 다음 명령이 /review 및 /code-review 현재 diff를 검토할 수 있다고 명시되어 있습니다. 기본적인 검토 요청은 다음과 같습니다:

/review

2.1.223부터는 다음 명령을 호출할 때 /code-review 노력 수준을 지정하지 않으면 마지막으로 입력한 수준을 재사용합니다. 노력 수준을 명시적으로 선택하려면 다음을 사용하세요:

/code-review high

노력 수준을 생략하면 고정된 기본값으로 재설정된다고 가정하지 마세요. 문서에 명시된 동작은 이전 선택을 재사용하는 것입니다.

특정 풀 리퀘스트 검토

릴리스 노트에는 다음과 같은 풀 리퀘스트 구문이 제시되어 있습니다:

/code-review <level> <pr#>

여기서 <level> 및 <pr#> 항목은 노력 수준과 풀 리퀘스트 번호를 나타내는 자리표시자입니다. 따라서 같은 검토 명령으로 현재 diff와 지정된 풀 리퀘스트를 모두 검토할 수 있습니다.

관련 명령줄 자료는 다음을 참조하세요: Claude Code CLI 참조.

심층 클라우드 검토 이해하기

문서에 명시된 심층 클라우드 검토 요청 명령은 다음과 같습니다:

/code-review ultra

별도로, 버전 2.1.260에서는 다음 명령을 통한 장시간 클라우드 검토의 대기 시간을 늘렸습니다: /ultrareview 및 claude ultrareview 대기 시간은 30분에서 45분으로 늘어났습니다.

표현을 정확하게 유지하세요. 이는 해당 명령의 대기 시간 한도가 늘어났다는 의미이며, 검토가 45분 안에 완료된다는 보장은 아닙니다. 또한 릴리스 노트에는 검토 전용 가격이 제시되어 있지 않으므로, 이를 근거로 이 워크플로의 비용을 추정할 수 없습니다.

변경 사항 검토와 작업 승인을 별도로 진행하기

“승인 전 검토”는 서로 다른 두 시점을 의미할 수 있습니다. 제안된 도구 작업을 허용하기 전에 확인하는 시점과, 수정 사항을 유지할 준비가 되었는지 결정하기 전에 점검하는 시점입니다.

이전 변경 로그에는 다음 설정이 /permissions 특정 도구에 대한 확인을 요구하는 방법으로 명시되어 있습니다:

/permissions

워크플로에서 특정 도구에 대한 확인 단계가 필요하다면 해당 설정을 사용하세요. 확인 메시지가 표시되면 제안된 작업을 작업 목적 및 제약 조건과 대조하여 평가하세요.

전체 화면 diff 패널은 이 과정의 다른 시점에 사용됩니다. Claude가 수정하는 동안 이미 적용되었지만 아직 커밋되지 않은 변경 사항을 표시합니다. 이러한 변경 사항을 살펴보면 추가 설명, 수정 또는 검토가 필요한 부분을 판단할 수 있습니다.

확인 단계를 명확하게 구분하기

유용한 검토 체크리스트는 질문을 다음과 같이 구분합니다:

• 도구 승인 전: 제안된 작업이 이 작업에 적절한가?
• 수정 후: 적용된 변경 사항이 요청한 동작과 일치하는가?
• 자동 검토 후: 어떤 지적 사항에 수정이나 추가 조사가 필요한가?
• 결과를 유지하기 전: 최종 변경 사항을 요구사항과 대조하여 확인했는가?

이렇게 구분하면 승인 메시지가 코드 검토를 대신하는 일을 방지할 수 있습니다. 또한 diff 패널을 수정이 이루어지기 전에 이를 승인하는 기능으로 설명하는 일도 방지할 수 있습니다.

2.1.260 릴리스 노트에는 “모든 변경 사항 수락” 버튼이나 변경 구간별 수락/거부 기능이 명시되어 있지 않습니다. 다음을 /diff 점검용 패널로 설명하고, 결과 코드에 대한 결정은 검토 절차를 통해 내리세요.

되돌리기 수정 사항과 복원 확인

버전 2.1.260에는 수정 사항을 되돌리는 것과 관련된 두 가지 수정도 포함되어 있습니다. 해당 릴리스 노트 에는 체크포인트 백업이 없을 때 성공했다고 잘못 보고하는 문제와 다음 실행 후 파일 읽기 추적 정보가 오래된 상태로 남는 문제가 명시되어 있습니다: /rewind.

첫 번째 수정은 다음에 영향을 줍니다: /rewind 및 --rewind-files. 이전에는 체크포인트 백업이 없어 파일이 전혀 복원되지 않았는데도 성공했다고 잘못 보고할 수 있었습니다.

두 번째 수정은 다음 실행 후 파일 읽기 추적 정보가 오래된 상태로 남는 문제를 해결합니다: /rewind. 이는 특정 문제에 대한 수정이며, 모든 조건에서 모든 수정 사항을 항상 복원할 수 있다는 의미는 아닙니다.

되돌린 후 상태 확인하기

검토 결과 작업을 되돌리기로 했다면, 복구 과정에 결과 파일을 확인하는 단계를 포함하세요. Claude에게 계속 진행해 달라고 요청하기 전에 관련 변경 사항이 복원되었는지 확인하세요.

이 권장 사항은 이번 릴리스에서 해결한 실패 사례에 근거합니다. 성공 메시지가 항상 복원 완료를 의미하지는 않았습니다. 2.1.260에서 이러한 잘못된 보고를 수정했지만, 결과를 점검하는 것은 여전히 유용한 확인 단계입니다.

되돌리기는 자동 검토와도 용도가 다릅니다. 검토는 변경 사항을 평가하는 데 도움이 되고, 되돌리기는 수정 이전 상태로 돌아가기로 결정했을 때 사용합니다. 전체 화면 패널은 커밋되지 않은 변경 사항의 점검을 지원하며, 문서에 명시된 되돌리기 수정 사항은 복원 및 이후의 파일 읽기 추적과 관련되어 있습니다.

핵심 요점

• 2026년 3월에 출시된 Claude Code 2.1.260에는 전체 화면 모드에서 대화 옆에 표시되는 실시간 diff 패널이 도입되었습니다.
• 다음을 사용하세요: /tui fullscreen 명령으로 전체 화면 표시로 전환하고, 다음 명령으로 /diff 커밋되지 않은 변경 사항을 보여주는 패널의 표시를 전환하세요.
• /review 명령은 다음 명령의 별칭입니다: /code-review. 이 명령은 현재 diff 또는 지정된 풀 리퀘스트를 검토할 수 있습니다.
• /permissions 설정은 특정 도구에 대한 확인을 제어합니다. diff 패널은 적용된 수정 사항을 표시하며, 해당 릴리스 노트에는 변경 구간별 수락 기능이 명시되어 있지 않습니다.
• 버전 2.1.260에서는 되돌리기가 성공했다고 잘못 보고하는 문제를 수정하고, 다음 명령을 통한 장시간 /ultrareview 및 claude ultrareview 클라우드 검토의 대기 시간을 45분으로 늘렸습니다.

자주 묻는 질문

Claude Code의 전체 화면 diff 패널은 어떻게 여나요?

다음 명령을 실행하세요: /tui fullscreen 명령을 대화에서 사용한 다음, 다음 명령을 사용하세요: /diff 이 명령으로 실시간 패널의 표시를 전환할 수 있습니다. Claude Code 2.1.260에서 도입된 이 패널은 Claude가 수정하는 동안 커밋되지 않은 변경 사항을 대화 옆에 표시합니다.

다음 항목의 차이점은 무엇인가요: /diff 및 /review?

/diff 명령은 커밋되지 않은 변경 사항을 점검하는 전체 화면 패널의 표시를 전환합니다. /review 명령은 다음 명령의 별칭입니다: /code-review명령은 현재 diff 또는 풀 리퀘스트를 검토하며, 해당 별칭은 버전 2.1.223에서 도입되었습니다.

패널에서 개별 변경 사항을 승인할 수 있나요?

2.1.260 릴리스 노트에는 변경 구간별 수락/거부 기능이나 “모든 변경 사항 수락” 버튼이 명시되어 있지 않습니다. 패널이 커밋되지 않은 변경 사항을 표시한다는 점은 명시되어 있으며, 한편 /permissions 특정 도구 작업에 확인을 요구할 수 있습니다.

무엇을 /code-review ultra 하며, 클라우드 리뷰는 얼마나 오래 실행될 수 있나요?

/code-review ultra 심층 클라우드 리뷰를 요청합니다. 이와 별개로, 버전 2.1.260에서는 다음을 통한 장시간 실행 리뷰의 대기 시간을 늘렸습니다. /ultrareview 및 claude ultrareview 기존 30분에서 45분으로 늘렸으며, 이 대기 시간 제한이 완료 시간을 보장하지는 않습니다.