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

Claude Code의 Transcript View란 무엇인가? Ctrl+O가 보여주는 것, 기본/상세/포커스 뷰의 차이, 그리고 압축 후 이전 메시지의 행방 (2026)

Claude Code의 메인 화면은 발생한 일을 깔끔하게 정리해서 보여줍니다. 셸 명령은 출력 결과의 줄 수와 함께 한 줄로 요약됩니다. 세 번의 MCP 호출은 서버가 세 번 호출되었다는 단일 행으로 표시됩니다. 사고 과정(Thinking)은 짧은 스텁(stub)으로 나타납니다. 이는 화면의 가독성을 유지해주지만, 문제가 발생하여 Claude가 정확히 무엇을 읽고, 실행하고, 결정했는지 확인해야 할 때는 상세 정보가 필요합니다.

그럴 때 사용하는 것이 바로 Transcript View(트랜스크립트 뷰)입니다. Anthropic의 대화형 모드 레퍼런스에 따르면 이 단축키는 다음과 같이 설명되어 있습니다: Ctrl+O는 "Transcript viewer 토글" 기능을 수행합니다. 이는 "각 어시스턴트 메시지에 사용된 모델과 타임스탬프를 포함하여, 상세한 도구 사용 및 실행 내역을 표시"합니다.

이 가이드에서는 Transcript View가 보여주는 내용, 내부 단축키, 기본(default), 상세(verbose), 포커스(focus) 뷰의 차이점, 사고 과정이 표시되는 방식, Claude Desktop에서의 작동 방식, 그리고 중요한 제한 사항인 세션이 압축(compacted)되고 재개된 후 이전 메시지가 화면에서 사라지고 디스크 파일에 저장되는 현상에 대해 다룹니다.

Ctrl+O가 보여주는 것

메인 화면에서 Claude Code는 세부 정보를 축소합니다. 설정 레퍼런스에서는 기본값을 다음과 같이 설명합니다: "기본적으로 트랜스크립트는 Claude가 실행한 명령과 출력 줄 수와 같이 각 도구 호출을 짧은 요약으로 축소하며, 세부 정보가 필요할 때 Ctrl+O를 눌러 전체 트랜스크립트를 확장 뷰로 전환합니다."

Transcript View는 이를 확장합니다. 대화형 모드 레퍼런스에 따르면 다음 내용이 표시됩니다:

  • 한 줄 요약 대신 상세한 도구 사용 및 실행 내역.
  • 각 어시스턴트 메시지에 사용된 타임스탬프와 모델.
  • 단일 행으로 표시되는 MCP 호출과 같이 기본적으로 축소되는 행들.
  • 메인 뷰에서는 한 줄 미리보기로 표시되는 다른 세션의 메시지들.

모델 라벨은 보기보다 중요합니다. 세션 중간에 모델을 전환한 경우, Transcript View는 어떤 모델이 어떤 메시지를 생성했는지 알려줍니다.

타임스탬프는 사용자의 시간 형식 설정을 따릅니다. 설정 레퍼런스에 따르면 이 형식은 "트랜스크립트 뷰어의 타임스탬프"에 적용되며, 뷰어에서 "패턴은 전체 타임스탬프이므로 날짜를 표시하려면 날짜 지시어를 추가해야 합니다."

Transcript View 내부 단축키

Anthropic의 레퍼런스에는 뷰어가 열려 있는 동안 사용할 수 있는 키 목록이 있습니다:

  • ?: 키보드 단축키 도움말 패널을 토글합니다. 전체 화면 렌더링이 필요합니다.
  • { 및 }: vim의 문단 이동처럼 이전 또는 다음 사용자 프롬프트로 점프합니다. 이 또한 전체 화면 렌더링이 필요합니다.
  • Ctrl+E: 모든 콘텐츠 표시를 토글합니다. "전체 화면 렌더링이 아닌 클래식 렌더러에서만 사용 가능"합니다.
  • [: 전체 대화 내용을 터미널의 기본 스크롤백(scrollback)에 씁니다.
  • v: 대화 내용을 임시 파일에 쓰고 에디터에서 엽니다.
  • q, Ctrl+C, 또는 Esc: Transcript View를 종료합니다.

사용 중인 렌더러를 확인하려면 인자 없이 /tui를 실행하라고 레퍼런스에 명시되어 있습니다.

전체 화면 렌더링 모드에서 Transcript 모드는 검색 기능도 제공합니다. 전체 화면 문서에 따르면 "less 스타일의 탐색 및 검색 기능"이 추가되어, /로 검색을 시작하고, n과 N으로 검색 결과 사이를 이동하며, g와 G로 맨 위나 맨 아래로 이동할 수 있습니다.

터미널 검색으로 대화 내용을 찾을 수 없는 이유

전체 화면 렌더링을 사용하면서 터미널에서 Cmd+F를 누르면 아무것도 찾지 못할 수 있습니다. 전체 화면 문서에서는 그 이유를 다음과 같이 설명합니다: "터미널의 Cmd+f 및 tmux 검색은 대화 내용이 기본 스크롤백이 아닌 대체 화면 버퍼(alternate screen buffer)에 있기 때문에 이를 인식하지 못합니다."

Transcript View가 이를 해결하는 방법입니다. Ctrl+O를 누른 후 다음을 수행하세요:

  • [: "모든 도구 출력이 확장된 상태로 전체 대화 내용을 터미널의 기본 스크롤백 버퍼에 씁니다." 그 후에는 터미널 자체의 검색, 복사 모드 및 기타 도구를 사용할 수 있습니다. Anthropic은 긴 세션의 경우 이 작업 중에 잠시 멈춤 현상이 발생할 수 있다고 언급합니다.
  • v: "대화 내용을 임시 파일에 쓰고 $VISUAL 또는 $EDITOR에서 엽니다."

스크롤백 복사본은 일시적입니다. 문서에 따르면 Transcript 모드를 종료할 때까지 유지되며, "다음 Ctrl+o 실행 시 새로 시작됩니다."

기본(Default), 상세(Verbose), 포커스(Focus) 뷰

Transcript View는 Claude Code가 세션을 표시하는 세 가지 방법 중 하나입니다. viewMode 설정으로 세션이 시작될 모드를 선택합니다. 설정 레퍼런스에 설명된 옵션은 다음과 같습니다:

  • default: "도구 출력이 생략된 일반 트랜스크립트"
  • verbose: "도구 출력이 전체 표시되는 트랜스크립트"
  • focus: "마지막 프롬프트, 편집 diffstats가 포함된 도구 호출의 한 줄 요약, 그리고 최종 응답만 표시." 포커스 뷰는 전체 화면 렌더러가 필요합니다.

각 모드를 켜는 별도의 방법이 있습니다:

  • Verbose. verbose 설정은 "모든 도구 호출의 전체 입력 및 출력을 실시간으로 표시하며, 이는 훅(hook), MCP 서버 또는 긴 셸 명령을 디버깅할 때 유용합니다." 이는 /config에서 Verbose output으로 나타납니다. --verbose 플래그는 단일 세션에 대해 동일한 역할을 합니다.
  • Focus. /focus를 실행합니다. 전체 화면 문서에 따르면 "이 설정은 세션 간에 유지됩니다. 끄려면 /focus를 다시 실행하세요."

두 개 이상의 설정이 지정된 경우의 우선순위도 문서화되어 있습니다. viewMode는 "고정된 /focus 선택과 verbose 설정을 모두 무시(override)"합니다. 그리고 --verbose는 "한 세션 동안 이 키보다 우선순위를 갖습니다."

실제 선택은 작업 내용에 따라 달라집니다. Default는 화면 가독성을 유지합니다. Verbose는 실시간 디버깅용입니다. Focus는 결과만 중요한 긴 작업용입니다. Transcript View는 과거를 되돌아봐야 할 때 필요에 따라 여는 화면입니다.

사고 과정(Thinking)이 표시되는 방식

사고 과정(Thinking)에는 자체 설정이 있습니다. 기본적으로 Claude Code는 축소된 스텁을 보여줍니다. 설정 레퍼런스에서는 다음과 같이 설명합니다: "설정되지 않았거나 false인 경우, Anthropic API는 사고 블록을 가리고 Claude Code는 축소된 스텁을 보여줍니다."

더 많은 정보를 원한다면 showThinkingSummaries 설정을 변경하세요: "Ctrl+O로 사고 과정을 확장할 때 전체 요약을 보려면 이 설정을 활성화하세요." 이 설정을 켜면 "Ctrl+O로 사고 과정을 확장할 때 전체 사고 요약을 볼 수 있습니다."

따라서 이 설정 없이 Ctrl+O를 누르면 도구 호출은 확장되지만 사고 과정은 여전히 스텁으로만 표시됩니다. Claude Desktop은 이를 별도의 뷰 모드로 처리하며, 다음에 다룹니다.

Claude Desktop에서의 Transcript View

Claude Desktop의 Code 탭에는 자체 버전이 있습니다. Anthropic의 Desktop 문서에 따르면: "뷰 모드는 채팅 트랜스크립트에 표시되는 세부 정보의 양을 제어합니다." 세션 제목 옆의 세션 메뉴에서 전환하거나, "macOS 또는 Windows에서 Ctrl+O를 눌러 모드를 순환할 수 있습니다."

Desktop 모드는 다음과 같습니다:

  • Normal: "도구 호출은 요약으로 축소되고, 텍스트 응답은 전체 표시"
  • Thinking: "도구 호출은 요약으로 축소되고, Claude의 사고 과정이 추가됨"
  • Verbose: "Claude가 수행하는 모든 도구 호출, 파일 읽기, 중간 단계 및 Claude의 사고 과정이 표시"

Anthropic의 제안: "도구 호출은 축소된 상태로 유지하면서 Claude의 추론 과정을 따라가려면 Thinking 모드를 사용하세요. Claude가 특정 행동을 취한 이유를 디버깅할 때는 Verbose 모드를 사용하세요." 또한 Thinking 모드는 보고 있는 세션에서 Claude가 사고 과정을 생성한 후에만 메뉴에 나타난다는 점에 유의하세요.

압축 후 Transcript View가 보여주지 않는 것

사람들이 자주 겪는 제한 사항이 여기 있습니다. Transcript View는 Claude Code가 로드한 대화 내용을 보여줍니다. 긴 세션이 압축(compact)된 후에는 해당 대화의 이전 부분은 원본 메시지가 아닌 요약본이 됩니다.

컨텍스트 창(context window) 문서에 따르면: "긴 세션이 압축될 때, Claude Code는 컨텍스트 창에 맞추기 위해 대화 기록을 요약합니다." 프로젝트 루트의 CLAUDE.md, 자동 메모(auto memory), Claude가 계획 모드에서 작성한 계획 등 일부 항목은 나중에 디스크에서 다시 가져오지만, 대화 내용 자체는 요약으로 대체됩니다.

전체 화면 문서에서는 세션에 복귀했을 때의 모습을 다음과 같이 설명합니다: "압축된 세션을 닫고 다시 시작하면, 위로 스크롤할 때 Conversation compacted 행에서 멈추며, 이전 메시지는 디스크의 트랜스크립트 파일에 남아 있게 됩니다."

이것이 핵심적인 차이점입니다. 이전 메시지는 사라진 것이 아닙니다. 파일에 존재하지만, 더 이상 화면에 나타나지 않으며 Claude의 컨텍스트에도 포함되지 않습니다. Anthropic의 조언은 다음과 같습니다: "해당 메시지에서 세부 정보를 가져오려면 Claude에게 해당 파일에서 찾아달라고 요청하세요."

세션 문서에서는 재개 시 복구되는 내용을 설명합니다. 대화 기록은 "메시지, 도구 호출 및 결과"를 포함하며, 압축된 세션의 경우 "마지막 압축 시 요약된 메시지는 다시 로드되지 않습니다"라고 덧붙입니다.

클라우드 세션을 터미널로 가져올 때도 동일하게 적용됩니다. 압축된 Claude Code 세션 텔레포트하기 가이드에서 Claude Code가 이 경우에 표시하는 경고를 다루고 있습니다.

전체 트랜스크립트가 저장되는 위치

이 모든 것의 배후에 있는 파일은 일반 JSONL 형식입니다. 세션 문서에 따르면: "기본적으로 Claude Code는 트랜스크립트를 ~/.claude/projects/<project>/<session-id>.jsonl에 JSONL로 저장합니다. 여기서 <project>는 영숫자가 아닌 문자가 -로 대체된 작업 디렉토리 경로입니다."

이 파일은 직접 파싱하도록 설계되지 않았습니다. Anthropic은 "항목 형식은 Claude Code 내부용이며 버전 간에 변경될 수 있으므로, 이 파일을 직접 파싱하는 스크립트는 릴리스마다 깨질 수 있습니다"라고 경고합니다. 읽기 쉬운 복사본을 원한다면 /export를 사용하라고 안내합니다.

파일은 영구적으로 보관되지 않습니다. 세션 문서에는 "30일 보관 기간을 변경"하는 설정으로 cleanupPeriodDays가 나열되어 있습니다. Claude Code 세션 기록 찾기 가이드에서 세션이 저장되는 위치와 재개 방법을 다룹니다.

사람들이 흔히 시도하는 것

터미널 자체 검색으로 찾기. 전체 화면 렌더링에서는 대화 내용이 대체 화면 버퍼에 있습니다. Ctrl+O를 누른 다음 [를 누르세요.

Ctrl+O가 전체 사고 과정을 보여줄 것이라 기대하기. showThinkingSummaries 설정이 없으면 사고 과정은 축소된 스텁으로 유지됩니다.

Verbose를 설정하고 왜 Focus 뷰가 무시되는지 궁금해하기. viewMode가 두 설정을 모두 무시하며, --verbose는 한 세션 동안 viewMode보다 우선합니다.

압축 지점 위로 스크롤하기. 뷰는 압축 행에서 멈춥니다. 이전 메시지는 트랜스크립트 파일에 있습니다.

JSONL 직접 파싱하기. 버전마다 형식이 바뀝니다. /export를 사용하세요.

해결책: Transcript View를 사용하여 실제 발생한 일 확인하기

1단계: 무언가 잘못되었을 때 열기

Ctrl+O를 눌러 전체 도구 사용 내역, 타임스탬프, 각 메시지에 응답한 모델을 확인하세요. 전체 화면 렌더링에서는 /를 사용하여 검색하세요.

2단계: 작업에 맞는 기본 뷰 선택

viewMode를 default, verbose 또는 focus로 설정하세요. 한 세션에 대해 전체 출력이 필요할 때는 --verbose를 사용하세요.

3단계: 필요한 경우 사고 과정 요약 켜기

사고 과정을 확장할 때 Claude의 사고 내용을 읽고 싶다면 showThinkingSummaries를 true로 설정하세요.

4단계: 압축되기 전에 결정 사항 기록하기

긴 세션이 압축될 예정이라면, 나중에 세션에서 읽을 수 있도록 중요한 결정 사항을 CLAUDE.md나 프로젝트 파일에 기록하도록 Claude에게 요청하세요. 트랜스크립트는 기록을 보관하지만, Claude가 다음으로 전달하는 것은 요약본입니다.

MemoryLake에서 설정하기

Transcript View는 단일 세션의 기록입니다. Claude가 무엇을 읽고 실행했는지 보여주지만, 압축 후 이전 부분은 디스크 파일에만 존재하며 재개 시 다시 로드되지 않습니다. 나중에 세션이 알아야 할 결정 사항은 트랜스크립트에만 두어서는 안 됩니다.

MemoryLake는 프로젝트 결정 사항, 컨벤션 및 그 배경 이유를 한곳에 유지하여 ChatGPT, Claude Code, Codex 등 연결된 어시스턴트가 사용할 수 있게 해주는 메모리 레이어입니다.

사용자는 자신의 언어로 직접 항목을 작성합니다. Claude Code 트랜스크립트, 세션 파일, CLAUDE.md, 자동 메모 또는 벤더의 저장소에서 아무것도 읽거나 쓰거나 삭제하지 않습니다. Transcript View, 압축 및 세션 저장소는 Anthropic이 설명한 방식 그대로 작동합니다.

1단계: API 키 생성

로그인 후 대시보드에서 키를 생성합니다. 이 키는 MemoryLake 워크스페이스에 속하며 Claude 계정과는 별개입니다.

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

2단계: 첫 번째 메모 업로드

트랜스크립트에서 찾아내야 했을 법한 내용부터 시작하세요: 왜 특정 라이브러리를 선택했는지, 어떤 접근 방식을 배제했는지, 다음 세션이 알아야 할 사항은 무엇인지 등입니다. 항목당 하나의 결정을 담으세요.

첫 번째 문서가 업로드되어 각 파일이 검색 가능한 메모리로 나열된 MemoryLake 워크스페이스
첫 번째 문서가 업로드되어 각 파일이 검색 가능한 메모리로 나열된 MemoryLake 워크스페이스

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

Claude Code 및 사용하는 다른 어시스턴트를 연결하세요. 새로운 세션은 오래된 트랜스크립트를 뒤지지 않고도 해당 항목들을 활용할 수 있습니다.

메모리 레이어에 연결할 수 있는 AI 클라이언트 및 에이전트 프레임워크가 나열된 MemoryLake 통합 화면
메모리 레이어에 연결할 수 있는 AI 클라이언트 및 에이전트 프레임워크가 나열된 MemoryLake 통합 화면

실제 작업에서의 변화

첫 번째 차이점은 탐색 시간이 줄어든다는 것입니다. 결정 사항이 긴 세션 속에 묻히지 않고 명시적으로 기록됩니다.

두 번째는 압축 후에도 더 나은 시작이 가능하다는 점입니다. 중요한 정보가 요약본에 포함되었는지 여부에 의존하지 않게 됩니다.

세 번째는 도구 간 컨텍스트 공유입니다. 동일한 항목을 사용하는 다른 어시스턴트에서도 사용할 수 있습니다.

Claude Code Transcript View 모범 사례

세부 정보가 필요할 때 Ctrl+O를 사용하세요. 도구 사용 내역, 타임스탬프, 각 메시지의 모델을 보여줍니다.

터미널 검색을 위해 [를 사용하세요. 전체 화면 렌더링에서 대화 내용을 기본 스크롤백에 씁니다.

긴 내용을 읽을 때는 v를 사용하세요. 에디터에서 대화 내용을 엽니다.

뷰 설정 방법을 하나로 정하세요. viewMode는 /focus 및 verbose보다 우선합니다.

필요한 경우 사고 과정 요약을 켜세요. 그렇지 않으면 사고 과정은 스텁으로 유지됩니다.

압축 후에는 트랜스크립트 파일을 확인하세요. 이전 메시지는 디스크에 남아 있습니다.

읽기 쉬운 복사본을 위해 /export를 사용하세요. JSONL 형식은 버전 간에 변경됩니다.

결론

Claude Code의 Transcript View는 Ctrl+O로 여는 화면입니다. 상세한 도구 사용 내역, 각 어시스턴트 메시지의 타임스탬프와 모델, 그리고 메인 뷰에서 축소된 행들을 포함하는 세션의 상세 버전입니다. 전체 화면 렌더링에서는 검색 기능이 추가되며, [ 또는 v를 통해 대화 내용을 터미널이나 에디터로 전달할 수 있습니다. viewMode 설정은 기본, 상세, 포커스 뷰 중에서 선택하며, showThinkingSummaries는 사고 과정을 확장할지 스텁으로 둘지 결정합니다.

세션이 압축된 후 재개하면 Transcript View는 압축 행에서 멈춥니다. 이전 메시지는 여전히 ~/.claude/projects 아래의 트랜스크립트 파일에 기본 30일 동안 보관되며, 요청 시 Claude가 그곳에서 찾아볼 수 있습니다. 중요한 결정 사항은 미리 기록하여 다음 세션이 해당 파일에 의존하지 않도록 하세요.

자주 묻는 질문

Claude Code에서 Ctrl+O는 무엇을 하나요?

Transcript viewer를 토글하며, 각 어시스턴트 메시지에 사용된 모델과 타임스탬프를 포함하여 상세한 도구 사용 및 실행 내역을 보여줍니다.

Verbose와 Transcript View의 차이점은 무엇인가요?

Verbose는 Claude가 작업하는 동안 실시간으로 전체 도구 출력을 보여줍니다. Transcript View는 필요할 때 Ctrl+O를 눌러 확장된 세션 기록을 확인하는 화면입니다.

Claude Code의 Focus 뷰란 무엇인가요?

마지막 프롬프트, 편집 diffstats가 포함된 도구 호출의 한 줄 요약, 그리고 최종 응답만 보여줍니다. /focus를 실행하여 켤 수 있으며 전체 화면 렌더링이 필요합니다.

왜 Transcript View에서 Claude의 사고 과정을 볼 수 없나요?

기본적으로 API는 사고 블록을 가리고 Claude Code는 축소된 스텁을 보여줍니다. Ctrl+O로 확장할 때 전체 요약을 보려면 showThinkingSummaries를 true로 설정하세요.

왜 Transcript View가 'Conversation compacted'에서 멈추나요?

압축된 세션이 재개된 후에는 이전 메시지가 다시 로드되지 않기 때문입니다. Anthropic은 해당 메시지들이 디스크의 트랜스크립트 파일에 남아 있다고 설명합니다.

Claude Code는 트랜스크립트를 어디에 저장하나요?

기본적으로 ~/.claude/projects/<project>/ 아래에 세션당 하나씩 JSONL 파일로 저장됩니다. cleanupPeriodDays를 변경하지 않는 한 30일 동안 보관됩니다.

Claude Code 대화 내용을 어떻게 검색하나요?

전체 화면 렌더링에서 Ctrl+O를 누른 후 /를 눌러 검색하거나, [를 눌러 대화 내용을 터미널 스크롤백에 쓴 다음 터미널의 검색 기능을 사용하세요.