MemoryLake
모든 글로 돌아가기
Tutorial2026년 11월 18일·11 분 소요

Claude Code의 Ultrareview란 무엇인가요? 브랜치 업로드 항목, 결과 반환 위치, PR 게시를 위해 세션을 유지해야 하는 이유 (2026)

대규모 변경 사항을 머지하기 전에 /code-review ultra 1234를 실행하고 결과를 풀 리퀘스트(PR)에 게시하기로 선택했습니다. 리뷰에 시간이 걸릴 것이라는 안내를 보고 노트북을 덮고 회의에 들어갔습니다. 나중에 돌아와 대화를 재개했을 때, PR에는 아무것도 게시되지 않았습니다.

Anthropic의 문서는 그 이유를 다음과 같이 설명합니다: "Claude Code는 게시 선택 사항을 해당 세션에만 유지합니다. 리뷰가 끝나기 전에 세션이 종료되면, 나중에 대화를 재개하더라도 Claude Code는 아무것도 게시하지 않습니다."

이 가이드에서는 ultrareview가 무엇인지, 로컬 머신에서 무엇을 업로드하는지, 로컬 리뷰와 어떻게 다른지, 결과가 어디로 반환되는지, PR 게시가 어떻게 작동하는지, 리뷰를 중단하거나 계정을 전환하면 어떻게 되는지, 스크립트에서 실행하는 방법, 그리고 각 리뷰에서 배운 내용을 유지하는 방법을 다룹니다.

ultrareview란 무엇인가

Anthropic의 문서는 이를 두 문장으로 설명합니다: "Ultrareview는 Anthropic의 인프라에서 클라우드 세션으로 실행되는 심층 코드 리뷰입니다. /code-review ultra를 실행하면, Claude Code는 클라우드 샌드박스에서 리뷰어 에이전트 군단을 가동하여 브랜치나 풀 리퀘스트의 버그를 찾습니다."

로컬 /code-review와 비교하여 문서는 세 가지 차이점을 나열합니다:

  • 더 높은 신뢰도(Higher signal). "보고된 모든 발견 사항은 독립적으로 재현 및 검증되므로, 스타일 제안보다는 실제 버그에 집중된 결과를 제공합니다."
  • 더 넓은 범위. 더 많은 리뷰어 에이전트 군단이 변경 사항을 병렬로 탐색합니다.
  • 로컬 리소스 미사용. 리뷰가 클라우드 샌드박스에서 실행되므로 터미널을 자유롭게 사용할 수 있습니다.

이 기능은 스스로 시작되지 않습니다. 문서에 따르면: "이 명령은 사용자가 /code-review ultra로 호출할 때만 실행됩니다. Claude는 스스로 ultrareview를 시작하지 않습니다."

Ultrareview는 클라우드 세션으로 실행되기 때문에 claude.ai 계정이 필요합니다. Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry에서는 사용할 수 없으며, Zero Data Retention(데이터 제로 보유) 또는 HIPAA 구성이 적용된 조직에서도 사용할 수 없습니다. 문서는 이러한 경우 "/code-review ultra는 대신 세션 내에서 로컬 리뷰를 실행합니다"라고 명시하고 있습니다.

리뷰 대상

인자 없이 실행할 경우, 문서는 "ultrareview는 현재 브랜치와 기본 브랜치 사이의 차이점(커밋되지 않은 변경 사항 및 스테이징된 변경 사항 포함)을 리뷰합니다"라고 설명합니다.

다른 대상을 지정할 수도 있습니다:

  • 다른 베이스. /code-review ultra develop은 develop 브랜치와 비교하여 현재 브랜치를 리뷰합니다. 커밋 ID나 태그도 사용할 수 있습니다.
  • 풀 리퀘스트. /code-review ultra 1234 또는 현재 디렉토리의 저장소에 대한 PR URL을 붙여넣습니다.
  • 일반 텍스트 메모. 인증 변경 사항 확인과 같이 작업 중인 내용을 설명할 수 있습니다.

마지막 옵션은 리뷰에 유용한 컨텍스트를 제공합니다. 문서는 다음과 같이 설명합니다: "Claude는 텍스트를 메모로 보관하여 실행 대화 상자에 표시하고, 결과가 도착하면 이를 메모와 연결합니다." 메모는 해당 실행에만 적용되며, 현재 브랜치라는 리뷰 범위 자체를 바꾸지는 않습니다.

로컬 머신에서 업로드되는 항목

이는 대상에 따라 다릅니다.

풀 리퀘스트의 경우, 문서는 명확합니다: "풀 리퀘스트를 리뷰할 때 Claude Code는 로컬 머신에서 아무것도 업로드하지 않습니다." PR은 클라우드에서 클론됩니다.

브랜치의 경우, Claude Code는 "저장소 상태를 번들로 묶어 클라우드 세션에 로컬 저장소를 업로드하는 규칙에 따라 클라우드 샌드박스로 업로드합니다." 이러한 규칙은 클라우드용 Claude Code 문서에 있으며, 로컬 머신을 떠나는 항목을 결정합니다:

  • macOS, Linux, WSL에서 커밋되지 않은 자격 증명 파일. "Claude Code는 credentials 또는 keys와 같이 이름이 지정된 파일의 커밋되지 않은 변경 사항을 업로드에서 제외합니다." 문서에는 .env 파일, Terraform *.tfvars 파일, id_rsa 및 *.pem과 같은 키 파일이 언급되어 있습니다. 알림을 통해 로컬 머신에 남겨진 파일 목록을 보여줍니다.
  • 네이티브 Windows. "추적된 파일의 커밋되지 않은 변경 사항은 파일 이름에 관계없이 그대로 업로드됩니다." 문서는 클라우드에 올리고 싶지 않은 편집 사항이 있다면 시작하기 전에 스태시(stash)하거나 되돌릴 것을 권장합니다.
  • 추적되지 않은 파일(Untracked files). "추적되지 않은 파일은 포함되지 않습니다. 클라우드 세션에서 확인하길 원하는 파일은 git add를 실행하세요."

크기 제한도 있습니다. 클라우드 문서에 따르면 번들 저장소는 100MB 미만이어야 하며, 더 큰 경우를 위한 폴백(fallback)이 있습니다. 특히 ultrareview의 경우, 브랜치 리뷰는 기본적으로 최대 500개의 변경된 파일과 8,000개의 변경된 라인을 포함할 수 있으며, 문서는 이 수치가 변경될 수 있음을 명시합니다. 저장소가 너무 커서 번들로 묶을 수 없는 경우, Claude Code는 드래프트 PR을 열고 대신 그것을 리뷰할 것을 제안합니다.

실행 전, Claude Code는 리뷰 범위, 남은 무료 실행 횟수, 예상 비용이 포함된 확인 대화 상자를 표시합니다. 브랜치 리뷰의 경우 범위에 파일 및 라인 수가 포함됩니다. 이 대화 상자를 확인하는 것이 클라우드로 무엇이 전송되는지 확인하는 시점입니다.

결과가 반환되는 위치

리뷰는 백그라운드에서 실행됩니다. 문서에 따르면: "리뷰는 일반적으로 5분에서 15분 정도 소요됩니다." 세션에서 계속 작업할 수 있으며, /tasks 명령어로 실행 중이거나 완료된 리뷰 목록을 볼 수 있습니다.

완료되면 "Claude Code는 세션에 알림으로 검증된 결과를 표시합니다. 각 결과에는 파일 위치와 문제 설명이 포함되어 있어 Claude에게 직접 수정을 요청할 수 있습니다."

즉, 결과는 리뷰를 시작한 세션으로 도착합니다. 브랜치 리뷰의 경우, 문서는 Claude Code가 세션에만 결과를 표시한다고 설명합니다. 풀 리퀘스트의 경우 결과를 게시하도록 선택할 수도 있습니다.

Claude Code 팀이 검증을 어떻게 생각하는지, 다음 실행을 위해 무엇이 기록되는지 등에 대해서는 Claude Code 팀이 Claude의 작업을 검증하는 방법 가이드에서 다루었습니다.

풀 리퀘스트 게시 작동 방식

github.com의 풀 리퀘스트에 대해, Claude는 완료된 결과를 사용자의 GitHub 계정으로 단일 댓글로 게시할 수 있습니다. 문서는 이 댓글이 "리뷰나 승인이 아니며", Claude Code에 의해 생성되었다는 메모로 끝난다고 설명합니다.

게시는 각 실행마다 선택 사항(opt-in)입니다. 게시하지 않는 것이 기본값입니다. 대화형 세션에서는 실행 대화 상자에서 실행 및 게시 여부를 선택합니다.

게시 자체는 Anthropic 측에서 이루어집니다. "Claude Code는 로컬 머신에서 게시하지 않습니다. 리뷰의 세션 ID를 Anthropic API로 보내면, API가 Claude에 연결된 GitHub 계정을 통해 저장된 리뷰 결과를 댓글로 게시합니다."

그리고 도입부 예시의 세부 사항이 여기 있습니다. 대화형 세션에서 Claude Code는 결과가 도착할 때 게시를 시작하므로, 그때 세션이 열려 있어야 합니다. 문서에 따르면: "Claude Code는 게시 선택 사항을 해당 세션에만 유지합니다. 리뷰가 끝나기 전에 세션이 종료되면, 나중에 대화를 재개하더라도 Claude Code는 아무것도 게시하지 않습니다."

게시 선택권은 세션 내에 존재하므로, 결과가 도착하기 전에 세션을 닫으면 아무것도 게시되지 않습니다. 게시가 실행되면 Claude는 게시 성공 여부, 이미 게시되었는지 여부 또는 실패 여부를 알려줍니다. 실패 시 결과는 터미널에 남아 있으므로 수동으로 게시할 수 있습니다.

리뷰 중단 또는 계정 전환 시 발생하는 일

문서는 여러 상황을 다룹니다:

  • 리뷰 중단. "리뷰를 중단하면 Claude Code는 클라우드 세션을 아카이브하며 부분적인 결과를 반환하지 않습니다."
  • claude.ai에서 클라우드 세션이 중단되거나 아카이브됨. Claude가 리뷰가 중단되었음을 알립니다.
  • 세션이 삭제되었거나 다른 곳에서 로그인함. "리뷰의 클라우드 세션이 삭제되었거나, 실행 후 다른 Claude 계정 또는 조직으로 로그인한 경우 Claude는 세션을 찾을 수 없다고 알립니다."
  • 리뷰 중간에 계정 전환. "계정을 전환한 경우, 리뷰는 시작한 계정에서 계속 완료될 수 있습니다. 리뷰가 여전히 실행 중이라면 해당 계정으로 다시 로그인하고 claude --resume으로 대화를 재개하여 다시 연결하세요."

중단된 리뷰도 횟수에 포함됩니다. 문서에 따르면 조기에 중단하거나 완료되지 못한 리뷰도 무료 실행 횟수를 사용합니다. Pro, Max, Ultra 플랜에는 계정당 1회성 할당량으로 3회의 무료 실행이 포함되며, 그 이후에는 사용 크레딧으로 비용이 청구됩니다.

스크립트에서 ultrareview 실행하기

CI 또는 스크립트의 경우, 문서는 claude ultrareview 하위 명령어를 가리킵니다. 이는 동일한 리뷰를 시작하고 완료될 때까지 기다린 후 결과를 출력합니다.

문서의 두 가지 주의 사항이 적용됩니다:

  • -p는 기다리지 않습니다. claude -p를 통해 슬래시 명령어를 실행하면 클라우드 리뷰를 시작하고 결과 없이 종료되므로, 대신 하위 명령어를 사용하세요.
  • 조기 종료 시 로컬에서 결과를 잃게 됩니다. "결과가 도착하기 전에 하위 명령어가 종료되면 결과가 터미널에 도달하지 않습니다. 리뷰는 클라우드에서 계속 실행 중일 수 있습니다." 하위 명령어를 다시 실행하면 해당 리뷰를 재개하는 대신 새 리뷰를 시작합니다.

하위 명령어는 폴더를 신뢰할지 묻습니다. 문서의 조언: "코드의 내용을 신뢰할 수 있는 경우에만 신뢰하세요. git과 Claude Code가 git 구성 및 프로젝트 설정에 명시된 프로그램을 실행할 수 있기 때문입니다." CI 작업에서는 --trust-workspace 플래그를 사용하여 해당 실행에 대해 폴더를 신뢰할 수 있습니다.

Ultrareview 대 /code-review

문서는 두 가지를 다음과 같이 비교합니다:

  • /code-review는 세션 내에서 로컬로 실행되며, 몇 초에서 몇 분 정도 걸리고 일반 사용량에 포함됩니다. 반복 작업 중 빠른 피드백을 위한 것이며, 작업 중인 diff, PR, 브랜치 또는 경로를 리뷰할 수 있습니다.
  • /code-review ultra는 멀티 에이전트 군단과 독립적인 검증을 갖춘 클라우드 샌드박스에서 실행되며, 약 5분에서 15분 정도 소요되고 무료 실행 횟수 또는 사용 크레딧을 사용합니다. 상당한 변경 사항을 머지하기 전의 확신을 얻기 위한 것입니다.

사람들이 처음에 겪는 실수

게시를 선택한 후 세션 닫기. 게시 선택 사항은 해당 세션에만 유지됩니다.

중단된 리뷰에서 부분적인 결과 기대하기. Claude Code는 부분적인 결과를 반환하지 않습니다.

CI에서 claude -p를 통해 실행하기. claude ultrareview 하위 명령어를 사용하세요.

새 파일을 추적되지 않은 상태로 두기. 추적되지 않은 파일은 브랜치 리뷰에 포함되지 않습니다.

커밋되지 않은 비밀 정보가 절대 업로드되지 않는다고 가정하기. 네이티브 Windows에서는 추적된 파일의 커밋되지 않은 변경 사항이 이름에 관계없이 업로드됩니다.

해결책: 리뷰, 세션, 기록을 함께 유지하기

1단계: 실행 대화 상자 확인

업로드가 시작되기 전에 범위와 파일 수를 확인하세요.

2단계: 작업 트리 준비

리뷰를 원하는 파일은 스테이징하고, 클라우드에 올리고 싶지 않은 편집 사항(특히 Windows에서)은 스태시하세요.

3단계: 게시하는 경우 세션 열어두기

결과가 도착하고 게시가 완료될 때까지 실행 상태를 유지하세요.

4단계: 각 결과에 대해 결정한 내용 기록

어떤 결과를 수정했는지, 어떤 결과를 위험으로 수용했는지, 그리고 그 이유를 기록해 두세요.

MemoryLake에서 설정하기

Ultrareview의 결과는 한 세션에 도착하며, 게시를 선택하면 하나의 PR 댓글로 남습니다. 특정 결과를 수용한 이유, 어떤 패턴이 버그를 유발했는지, 또는 다음에 더 자세히 살펴봐야 할 영역 등 사용자가 결정한 사항은 다음 리뷰나 다른 도구가 해당 댓글에서 얻을 수 없는 프로젝트 컨텍스트입니다.

MemoryLake는 이러한 프로젝트 컨텍스트(결정 사항, 알려진 위험, 그 배경 이유 등)를 사용자가 관리하는 한 곳에 보관하고 ChatGPT, Claude Code, Codex 등 연결된 어시스턴트가 사용할 수 있게 해주는 기억(memory) 레이어입니다.

사용자는 자신의 언어로 직접 항목을 작성합니다. Claude Code 세션, 클라우드 세션, 리뷰 결과, PR 댓글, 저장소 또는 공급업체의 저장소에서 아무것도 읽거나 쓰거나 삭제하지 않습니다. Ultrareview는 Anthropic이 설명한 방식 그대로 작동합니다.

1단계: API 키 생성

로그인 후 대시보드에서 키를 생성합니다. 다른 자격 증명과 마찬가지로 저장소 외부에 보관하세요.

새 키가 생성되고 에이전트에서 사용하기 위해 복사되는 API 키 화면을 보여주는 MemoryLake 콘솔
새 키가 생성되고 에이전트에서 사용하기 위해 복사되는 API 키 화면을 보여주는 MemoryLake 콘솔

2단계: 첫 번째 기억 업로드

해결책의 4단계에서 작성한 내용, 즉 각 결과에 대한 결정 사항부터 시작하세요. PR 또는 브랜치와 함께 항목당 하나의 결정을 입력합니다.

첫 번째 문서가 업로드되어 각 파일이 검색 가능한 기억이 되는 과정을 보여주는 MemoryLake 워크스페이스
첫 번째 문서가 업로드되어 각 파일이 검색 가능한 기억이 되는 과정을 보여주는 MemoryLake 워크스페이스

3단계: AI 및 에이전트 연결

Claude Code, Codex 및 사용하는 다른 어시스턴트를 연결하세요. 다음 리뷰나 수정 작업은 동일한 결정 사항에서 시작할 수 있습니다.

기억 레이어에 연결할 수 있는 AI 클라이언트 및 에이전트 프레임워크 목록을 보여주는 MemoryLake 통합 화면
기억 레이어에 연결할 수 있는 AI 클라이언트 및 에이전트 프레임워크 목록을 보여주는 MemoryLake 통합 화면

실제적인 변화

첫 번째 차이점은 리뷰 간의 연속성입니다. 수용된 위험이 나중에 예기치 않은 문제로 다시 발견되지 않습니다.

두 번째는 세션보다 오래 지속되는 기록입니다. 결정 사항이 PR 댓글이나 터미널에만 의존하지 않습니다.

세 번째는 도구 간의 일관성입니다. 동일한 결정 사항을 Claude Code와 다른 어시스턴트에서 모두 사용할 수 있습니다.

ultrareview를 위한 모범 사례

상당한 변경 사항을 머지하기 전에 사용하세요. 빠른 피드백을 위해서는 /code-review를 사용하세요.

로컬 파일을 업로드하고 싶지 않을 때는 PR을 리뷰하세요. Claude Code는 PR 리뷰 시 로컬 머신에서 아무것도 업로드하지 않습니다.

리뷰를 원하는 항목은 스테이징하세요. 추적되지 않은 파일은 포함되지 않습니다.

Windows에서 자격 증명 파일을 주의하세요. 커밋되지 않은 변경 사항은 그대로 업로드됩니다.

게시 중에는 세션을 열어두세요. 세션을 닫으면 선택 사항이 유지되지 않습니다.

CI에서는 하위 명령어를 사용하세요. -p는 결과 없이 종료됩니다.

집중을 위해 메모를 추가하세요. Claude는 결과를 해당 메모와 연결합니다.

결론

Ultrareview는 Anthropic 인프라의 클라우드 샌드박스에서 리뷰어 에이전트 군단을 실행하며, 보고된 모든 결과는 독립적으로 재현 및 검증됩니다. 브랜치의 경우, Claude Code는 클라우드 업로드 규칙에 따라 저장소 상태 번들을 업로드하며, 이 규칙은 macOS, Linux, WSL에서 커밋되지 않은 자격 증명 파일을 제외하고 추적되지 않은 파일은 포함하지 않습니다. 풀 리퀘스트의 경우 로컬 머신에서 아무것도 업로드하지 않습니다.

결과는 리뷰를 시작한 세션에 알림으로 반환됩니다. 결과를 풀 리퀘스트에 게시하기로 선택했다면, 게시 선택 사항이 해당 세션에만 유지되므로 세션을 열어두어야 합니다. 중단된 리뷰는 부분적인 결과를 반환하지 않으며 여전히 무료 실행 횟수를 사용합니다. 리뷰가 실행되는 동안 세션을 염두에 두고, 결과에 대해 결정한 내용을 세션보다 오래 지속되는 곳에 기록해 두세요.

자주 묻는 질문

Claude Code의 ultrareview란 무엇인가요?

Anthropic의 인프라에서 클라우드 세션으로 실행되는 심층 코드 리뷰로, 리뷰어 에이전트 군단을 사용합니다.

ultrareview는 어떻게 실행하나요?

Claude Code에서 /code-review ultra를 실행하며, 선택적으로 베이스 브랜치나 PR 번호를 지정할 수 있습니다.

ultrareview가 내 코드를 업로드하나요?

브랜치 리뷰의 경우 Claude Code는 저장소 상태 번들을 업로드합니다. 풀 리퀘스트의 경우 로컬 머신에서 아무것도 업로드하지 않습니다.

.env 파일도 업로드되나요?

macOS, Linux, WSL에서는 자격 증명과 유사한 이름의 파일에 대한 커밋되지 않은 변경 사항은 제외됩니다. 네이티브 Windows에서는 추적된 파일의 커밋되지 않은 변경 사항이 그대로 업로드됩니다.

왜 내 결과가 PR에 게시되지 않았나요?

리뷰가 끝나기 전에 세션이 종료되었기 때문입니다. Claude Code는 게시 선택 사항을 해당 세션에만 유지합니다.

리뷰를 중단하면 어떻게 되나요?

Claude Code는 클라우드 세션을 아카이브하며 부분적인 결과를 반환하지 않습니다. 실행 횟수는 차감됩니다.

ultrareview는 얼마나 걸리나요?

일반적으로 5분에서 15분 정도 소요됩니다.