Claude Code Teleport가 마지막 요약에서 압축된 Cloud 세션을 시작합니다 — 터미널에 도달하는 내용과 먼저 저장해야 할 사항 (2026)

이 변경 사항은 긴 릴리스 노트 중 한 줄에 불과합니다. 수십 개의 수정 사항 중 v2.1.311은 "압축된 cloud 세션이 마지막 압축에서 로드될 때 경고하도록 /teleport 및 claude --teleport를 개선하여 요약된 메시지가 로컬 복사본에 포함되지 않도록 함"을 나열하고 있습니다.

이 문장에서 두 가지 세부 사항이 중요합니다. 첫째, 경고는 압축된 세션에 관한 것이므로 압축된 적이 없는 짧은 cloud 세션은 영향을 받지 않습니다. 둘째, 주체는 로컬 복사본입니다. claude.ai/code의 cloud 세션은 여전히 존재하며, 노트에서 설명하는 것은 터미널 세션이 시작할 때 가지고 있는 내용입니다.

동일한 릴리스에서 압축 자체의 관련 문제도 수정되었습니다: "세션 앞부분에서 MEMORY.md 및 CLAUDE.md 파일을 편집한 직후 자동 압축이 발생했을 때 Claude가 오래된 콘텐츠를 보던 문제를 수정했습니다." 또한 요약이 누락되었을 때 처리하는 방식도 변경되었습니다: "모델의 답변에 요약이 없는 경우, Claude Code는 이제 대화를 대체하기 전에 대개 요약을 한 번 더 요청합니다." 두 가지 모두 동일한 점을 가리킵니다. 압축 후에는 요약이 세션이 실행되는 기반이 되므로, Anthropic은 요약에 들어가는 내용을 엄격히 제한하고 이를 상속받을 때 명확히 보이도록 만들고 있습니다.

Teleport는 cloud 세션을 자신의 머신으로 이동하는 방법입니다. Claude Code의 cloud 세션 문서에는 이를 수행하는 몇 가지 방법이 나열되어 있습니다: 세션 선택기를 위해 claude --teleport를 실행하거나 특정 세션을 위해 claude --teleport <session-id>를 실행하고, 기존 CLI 세션 내에서 /teleport 또는 /tp를 실행하거나, /tasks에서 백그라운게 세션의 t를 누르거나, claude.ai/code의 세션 메뉴에서 명령어를 복사합니다.

문서에서는 그 다음에 일어나는 일을 다음과 같이 설명합니다: "세션을 teleport할 때, Claude는 올바른 리포지토리에 있는지 확인하고, cloud 세션에서 브랜치를 가져와 체크아웃하며, 전체 대화 기록을 터미널로 로드합니다."

이 문장은 일반적인 경우를 위해 작성되었습니다. 10월 26일 릴리스 노트와 함께 읽어보면, "전체 대화 기록"은 세션이 현재 보유하고 있는 기록을 의미합니다. cloud 세션이 압축되었다면, 그 기록은 압축 요약으로 시작하며 그 이전의 메시지는 로컬 복사본의 일부가 아닙니다.

또한 문서에서는 결과물이 별도의 복사본임을 명확히 하고 있습니다: "터미널은 세션의 자체 복사본을 가집니다. 그곳에서의 새로운 작업은 로컬에만 유지되며 claude.ai의 cloud 세션이나 Claude 모바일 앱에는 나타나지 않습니다."

또한 teleport와 resume을 구분합니다. --resume은 "이 머신의 로컬 기록에서 대화를 다시 열며 cloud 세션을 나열하지 않는 반면", teleport는 cloud 세션과 해당 브랜치를 가져옵니다. 이 머신에서 시작한 세션을 찾고 있다면, Claude Code 세션 기록 찾기 및 재개 가이드에서 해당 측면을 다룹니다.

teleport가 먼저 확인하는 사항

Teleport는 네 가지 요구 사항이 충족될 때까지 시작되지 않습니다. 문서의 표에 나열된 사항은 다음과 같습니다:

• 깨끗한 git 상태. "작업 디렉토리에 커밋되지 않은 변경 사항이 없어야 합니다. 필요한 경우 teleport가 변경 사항을 스태시(stash)하도록 요청합니다."
• 올바른 리포지토리. 포크가 아닌 동일한 리포지토리의 체크아웃에서 실행해야 합니다.
• 브랜치 사용 가능. "cloud 세션의 브랜치가 원격(remote)에 푸시되어 있어야 합니다."
• 동일한 계정. cloud 세션에서 사용된 것과 동일한 claude.ai 계정으로 로그인해야 합니다.

이러한 확인 작업은 코드를 보호합니다. 대화에 관한 것은 없기 때문에 10월 26일 경고가 중요합니다. 코드는 cloud 세션이 남겨둔 그대로 도착하는 반면, 대화는 세션이 현재 보유하고 있는 형태로 도착합니다.

압축(Compaction)은 Claude Code가 긴 세션을 계속 유지하는 방법입니다. /compact 명령어는 "컨텍스트를 확보하기 위해 대화를 요약"하며, 창이 가득 차면 자동 패스가 동일한 작업을 수행합니다.

Cloud 세션은 예상보다 일찍 압축됩니다. 문서에서는 다음과 같이 설명합니다: "Cloud 세션은 자체적으로 CLAUDE_AUTOCOMPACT_PCT_OVERRIDE를 설정하므로, 자동 압축 창이 가득 찼을 때가 아니라 창의 중간쯤에서 압축이 트리거됩니다."

환경 설정에서 이를 나중에 트리거되도록 미룰 수 없습니다. 다음 문장은 다음과 같습니다: "이 값은 환경 변수에 추가한 값을 재정의하므로, 거기에 변수를 추가해도 압축이 트리거되는 시점은 변경되지 않습니다." 변경할 수 있는 것은 환경 변수에서 CLAUDE_CODE_AUTO_COMPACT_WINDOW를 설정하거나, 해당 변수가 설정되지 않은 세션에서 토큰 수와 함께 /autocompact를 실행하여 창 자체를 변경하는 것입니다.

따라서 긴 작업을 실행했거나, 많은 파일을 읽었거나, 여러 차례의 테스트를 거친 cloud 세션은 teleport하기 전에 최소 한 번은 압축되었을 가능성이 높습니다. 새로운 경고는 그러한 경우에 알려줍니다.

압축이 세션을 완전히 지우지는 않습니다. Claude Code의 컨텍스트 창 문서에는 각 콘텐츠 유형에 일어나는 일에 대한 표가 있으며, 그 중 많은 부분이 자체적으로 복구됩니다:

• 프로젝트 루트 CLAUDE.md 및 범위가 지정되지 않은 규칙은 "디스크에서 다시 주입"됩니다.
• 자동 메모리(Auto memory)도 "디스크에서 다시 주입"됩니다.
• Claude가 계획 모드에서 작성한 계획은 "디스크에서 다시 주입"됩니다.
• paths: 프런트매터가 있는 규칙 및 중첩된 CLAUDE.md 파일은 Claude가 일치하는 파일을 터치할 때 필요에 따라 다시 로드됩니다.
• Claude가 읽거나 편집한 파일: "Claude Code가 가장 최근에 수정된 순서대로 최대 5개까지 다시 읽습니다."
• 대화는 그대로 돌아오지 않습니다. 문서에서는 이 프로세스를 직접 설명합니다: "긴 세션이 압축될 때, Claude Code는 컨텍스트 창에 맞추기 위해 대화 기록을 요약합니다." 표에는 "이전에 추가된 훅(hook)의 컨텍스트"도 "나머지 대화와 함께 요약됨"으로 나열되어 있습니다.

실제로는 대화에만 존재하는 것들이 직접 말한 내용들입니다: 특정 접근 방식을 거부한 이유, Claude에게 처리를 요청한 예외 케이스, 테스트 실행의 정확한 에러 메시지, 첫 한 시간 동안 한 번 언급한 제약 조건 등입니다. 이러한 세부 사항은 요약에서 축소되거나 누락될 수 있습니다. Claude Code의 자동 압축을 필요한 내용에 맞추는 가이드에서 세션이 실행되는 동안 요약을 제어하는 방법을 다룹니다.

teleport 후 파일이 제공되는 위치

한 가지 놓치기 쉬운 점이 있습니다. 다시 주입되는 파일은 디스크에서 가져오며, teleport 후의 디스크는 사용자의 머신입니다. 프로젝트 CLAUDE.md는 방금 체크아웃한 브랜치에 있으므로 cloud 세션이 사용한 것과 동일한 파일입니다. 자동 메모리는 다른 이야기입니다. Claude Code의 메모리 문서에 따르면 "자동 메모리는 머신 로컬"이며 "파일은 머신이나 cloud 환경 간에 공유되지 않습니다." 따라서 터미널 세션이 로드하는 자동 메모리는 사용자의 컴퓨터에 있는 것입니다.

경고가 무언가 잘못되었음을 의미한다고 가정하는 것. 그렇지 않습니다. 이는 긴 cloud 작업에서 일반적인 세션 압축이 발생했음을 알려주는 것뿐입니다. 코드와 요약은 온전합니다.

이전 메시지를 보기 위해 터미널에서 위로 스크롤하는 것. 로컬 복사본은 마지막 압축부터 시작하므로 요약된 메시지는 스크롤해서 볼 수 없습니다.

cloud 환경에서 압축 임계값을 높이는 것. 문서에 따르면 cloud 세션 자체의 설정이 사용자가 추가한 설정을 재정의합니다.

teleport 후 휴대폰에서 제어하는 것. Remote Control 문서에 따르면 /teleport로 cloud 세션을 가져올 때 "연결된 디바이스는 가져온 대화의 이전 기록을 수신하지 않습니다." 새 메시지는 양방향으로 흐르지만, 이전 기록은 디바이스에 나타나지 않습니다.

두 복사본이 동기화 상태를 유지할 것으로 기대하는 것. 터미널에서의 새로운 작업은 "로컬에만 유지되며 cloud 세션에 나타나지 않습니다." 양쪽 모두에서 계속 진행하면 두 개의 대화가 생기게 됩니다.

1단계: 가져오기 전에 cloud 세션에 인수인계 요청하기

세션이 아직 cloud에 있는 동안 Claude에게 목표, 완료된 작업, 진행 중인 작업, 결정 사항 및 이유, 제외된 사항, 다음 단계 등 짧은 인수인계를 작성하도록 요청하세요. 초기에 말했던 내용 중 여전히 적용되는 사항을 포함하도록 요청하세요. 이 메시지는 이미 발생한 압축 이후에 도달하므로, 로컬 복사본이 작성된 그대로 수신하는 최근 메시지에 포함됩니다.

세션이 길다면 먼저 특정 초점에 맞춰 /compact를 실행하세요. 예를 들어 테스트 결과와 결정 사항을 유지하도록 요청하는 것입니다. 초점이 맞춰진 요약은 자동 패스가 중요하다고 추측하는 대신 사용자가 선택한 것을 유지합니다. 인수인계 프롬프트 작성 가이드에 붙여넣을 수 있는 템플릿이 있습니다.

2단계: 고정 규칙을 세션이 다시 로드하는 파일로 이동하기

작업의 나머지 부분에 적용되어야 하는 모든 것은 대화뿐만 아니라 파일에 속해야 합니다. 리포지토리에 대한 규칙은 프로젝트 CLAUDE.md에 들어가며, 이를 커밋하면 브랜치와 함께 도착합니다. 압축 표에 따르면 프로젝트 루트 CLAUDE.md는 압축 후 디스크에서 다시 주입되므로, 거기에 작성된 규칙은 압축과 teleport 모두에서 살아남습니다.

teleport하기 전에 이러한 변경 사항이 포함된 브랜치를 푸시하세요. teleport 확인은 브랜치가 원격에 있어야 하며, 거기에 있는 모든 것을 가져옵니다.

3단계: 계속하기 전에 도착한 내용 읽기

teleport 후 압축 경고가 표시되면 한 가지 질문으로 시작하세요: Claude에게 목표, 현재 상태, 따르고 있는 결정 사항, 다음 단계를 다시 설명하도록 요청하세요. 이를 1단계의 인수인계와 비교해 보세요. 누락된 것이 있다면 다음 메시지나 CLAUDE.md에 추가하세요.

그런 다음 작업이 계속될 위치를 결정하세요. 문서 자체의 표현이 그 이유입니다: 터미널에서의 작업은 로컬에 유지됩니다. 계속할 한 곳을 선택하고 다른 복사본은 기록으로 취급하세요. 휴대폰에서 계속 제어하려면 로컬 세션에서 /remote-control을 시작하세요.

Teleport는 세션과 해당 브랜치를 이동합니다. 작업 주변의 컨텍스트, 정해진 컨벤션, 여러 세션에 걸친 결정 사항, 그렇지 않으면 반복해야 할 선호도 등은 일부는 압축될 수 있는 대화에, 일부는 한 머신의 파일에, 일부는 해당 머신에 남아있는 메모리에 위치합니다.

MemoryLake는 해당 컨텍스트를 사용자가 유지 관리하는 하나의 목록에 보관하여 Claude Code 및 ChatGPT, Codex 등 연결하는 다른 어시스턴트가 사용할 수 있도록 하는 메모리 레이어입니다.

사용자는 자신의 언어로 직접 항목을 작성합니다. Claude Code 세션, cloud 세션, 자동 메모리, CLAUDE.md 파일 또는 공급업체의 저장소에서 아무것도 읽거나 쓰거나 삭제하지 않습니다. 작업 리포지토리의 경우, 외부에 보관하는 것에 대한 조직의 정책을 따르세요.

1단계: API 키 생성

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

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

해결책의 1단계 인수인계에서의 결정 사항, 즉 이번 작업뿐만 아니라 다음 작업에도 적용될 결정 사항부터 시작하세요. 항목당 하나의 포인트로 작성하고, 날짜를 기입하고, 속한 리포지토리로 라벨을 지정합니다.

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

Claude Code 및 사용하는 다른 어시스턴트를 연결합니다. 세션이 cloud에서 실행되든, 노트북에서 실행되든, teleport한 후에 실행되든 동일한 컨텍스트를 사용할 수 있습니다.

첫 번째 차이점은 경고가 더 이상 놀랍지 않다는 것입니다. 긴 cloud 세션이 압축되었을 가능성이 높고, 터미널이 해당 요약에서 시작한다는 것을 알고 있기 때문입니다.

두 번째는 중요하게 생각하는 어떤 것도 초기 메시지에만 존재하지 않는다는 것입니다. 인수인계와 파일이 이를 전달하며, 둘 다 압축과 teleport에서 살아남습니다.

세 번째는 작업이 계속될 위치를 선택한다는 것입니다. 한 복사본은 앞으로 나아가고, 다른 복사본은 기록이 됩니다. Claude 앱에서 원격 세션을 포크한 경우, Claude Code 원격 세션 포크 가이드에서 해당 종류의 복사본에 대한 동일한 질문을 다룹니다.

긴 cloud 세션은 압축되었다고 가정하세요. Cloud 세션은 자체 압축 임계값을 설정하며, 창이 가득 차기 전에 트리거됩니다.

세션이 아직 cloud에 있는 동안 인수인계를 요청하세요. 이는 터미널이 수신하는 기록의 일부가 됩니다.

긴 세션이 끝나기 전에 초점을 맞춰 압축하세요. 유지할 내용을 알려주세요.

고정 규칙을 프로젝트 CLAUDE.md에 커밋하세요. 압축 후 디스크에서 다시 주입되며 teleport할 때 브랜치와 함께 도착합니다.

teleport하기 전에 푸시하세요. 브랜치가 원격에 있어야 합니다.

계속하기 전에 다시 설명된 계획을 읽으세요. 요약이 무엇을 유지했는지 확인하는 가장 빠른 방법입니다.

한 곳에서 계속하세요. 터미널 복사본과 cloud 세션은 동기화되지 않습니다.

Teleport는 Claude Code cloud 세션의 브랜치와 대화를 터미널로 가져옵니다. v2.1.311부터는 해당 세션이 압축되었을 때 경고도 표시하는데, 로컬 복사본이 마지막 압축부터 시작하고 요약된 메시지는 포함되지 않기 때문입니다. Cloud 세션은 설계상 창의 중간쯤에서 압축되므로, 대부분의 긴 cloud 작업에 적용됩니다.

코드는 어느 쪽이든 안전합니다. 주의가 필요한 것은 대화입니다: 한 번 말했던 결정 사항, 제약 조건, 세부 사항들입니다. Teleport하기 전에 인수인계를 요청하고, 작업보다 오래 지속되어야 하는 규칙을 커밋하고, 도착했을 때 다시 설명된 계획을 확인하세요. 긴 세션에서 벗어났다가 teleport가 아닌 요약으로 돌아온 경우, Claude Code의 유휴 압축 가이드에서 해당 사례를 다룹니다.