Claude Code 사용량 한도에 걸렸을 때, 작업을 잃지 않고 다른 에이전트로 넘기는 법

작업 한가운데서 Claude Code가 사용량 한도 도달을 알리고, 리셋 시계는 몇 시간 남겨두고 있습니다. 작업을 막는 건 기술적으로 아무것도 아닙니다 — 나와 완성 사이에 서 있는 건 할당량 하나뿐이죠. 여기서는 작업을 다른 에이전트로 깨끗하게 넘기는 법을 정리합니다: 무엇을 넘기고, 무엇을 그대로 두고, 무엇을 기대하지 말아야 하는지.

무엇이 이동하고, 무엇이 안 되나

무엇보다 먼저 경계를 분명히 하세요:

이동합니다. git 히스토리. 작업 트리(커밋되지 않은 변경). 여러분이 쓴 노트. 저장소의 상태 — 무엇이 됐는지, 무엇이 남았는지, 어떤 테스트가 지나는지 포함.

이동하지 않습니다. 에이전트의 세션 내 기억, 대화 히스토리, 플랜 목록. 각 도구는 이걸 자기만의 독점 세션 포맷으로 보관합니다. 한 에이전트의 세션을 다른 에이전트에 붓는 지원되는 방법은 없습니다 — 그렇게 해준다는 약속은 미신을 파는 겁니다. 넘기는 것은 세션 자체가 아니라 여러분이 쓰는 요약입니다.

이것도 이동하지 않습니다: 할당량. 한 계정의 한도는 다른 에이전트의 계정에 아무 영향이 없습니다. 두 번째 도구를 자기 계정과 인증으로 로그인하면 그 도구 자체의 허용량을 쓰는 겁니다 — 전환이 성립하는 유일한 조건이고, 두 번째 도구가 빌린 자격 증명이 아니라 진짜 자기 자격으로 인증될 때만 작동합니다.

1단계: 전환 전에 상태를 담아라

첫 에이전트가 아직 협조적일 때 하세요(저율 한도 상태여도 "요약 써줘"는 작은 부탁입니다). 완전히 멈췄다면 저장소에서 직접 하세요.

실행하고, 읽고, 저장하세요:

git status            # 무엇이 수정·스테이징·추적 안 됨 상태인지
git diff              # 실제 대기 중인 변경
git log --oneline -10 # 이미 커밋된 것

출력을 저장한 뒤 — 직접 또는 에이전트와 함께 — 짧은 인계 노트를 쓰세요:

## 작업
<한 줄: 무엇을 만들고/고치는 중인가>

## 완료
- <완료된 것과 위치 — 파일/경로>
- <현재 통과하는 테스트>

## 대기 중
- <다음 구체적 단계>
- <이미 내려진 결정(채택한 접근, 기각한 대안)>

## 주의점
- <알려진 함정: 실패하는 테스트 이름, 불안정한 셋업, 버전 고정, 환경 변수>

## 완료의 정의
- <끝났음을 아는 방법 — 실행할 명령, 기대 출력>

가장 값진 두 섹션은 대기 중과 주의점입니다. "대기 중"은 다음 에이전트가 계획을 다시 도출하는 일을 막고, "주의점"은 여러분이 이미 값을 치른 함정 — 실패하는 테스트, 파괴적 변경, 절대 돌리면 안 되는 스크립트 — 을 재발견하는 비용을 막습니다. 이 둘 없는 인계는 그냥 단계가 하나 더 붙은 재시작입니다.

2단계: 안전하게 에이전트를 전환하라

작업이 작고 작업 트리가 깨끗하면 그냥 git stash, 두 번째 도구 로그인, git stash pop, 인계 노트 붙여넣기면 충분합니다. 조금이라도 의심되면 스태시하지 마세요 — 작업 디렉터리를 통째로 복사하는 게 더 관대하고 실수가 불가능합니다:

# 프로젝트의 부모 디렉토리에서
rsync -a --exclude 'node_modules' --exclude '.git' myproject/ myproject-handoff/
cd myproject-handoff && git checkout -b handoff-from-claude

(git worktree add ../myproject-handoff <branch>로 깃 추적 콘텐츠는 같은 효과를 냅니다. 요점은 새 에이전트가 뭘 하든 무시되는 깨끗한 사본입니다.)

그다음 새 에이전트에서는 막연한 "이어서 해"가 아니라 인계 노트로 시작하세요. 노트가 곧 계약입니다. 한 번에 한 에이전트, 한 작성자. 두 에이전트를 같은 작업 트리에 동시에 붙이지 마세요 — 같은 파일을 두고 싸우고, 풀어헤치는 시간이 절약한 시간보다 커집니다.

3단계: 새 에이전트가 뭘 물었는지 검증하라

신뢰하기 전에:

• 새 세션의 git status / git diff가 여러분이 남겨둔 상태와 일치하는가?
• 이전에 통과하던 테스트가 여전히 통과하는가?
• 에이전트가 재진술한 "대기 중"이 여러분이 쓴 것과 일치하는가, 아니면 흘렀는가?

하나라도 아니오면, 에이전트가 잘못된 읽기 위에서 진행하게 두지 말고 인계 노트를 고치고 멈추세요. 조용히 흘러간 인계는 인계가 아예 없는 것보다 나쁩니다 — 끝에서야 드러나니까요.

하지 말아야 할 것

• 계정을 돌려 쓰거나 공유하지 마세요. 남의 로그인으로 할당량을 피하려 하지 마세요. 시간만 낭비하고 약관 위반입니다. 정당한 방법은: 자기 소유의 두 번째 도구, 자기 계정으로 인증.
• 완전히 이해하지 못한 파괴적 git 조작을 하지 마세요. git reset --hard, 강제 푸시, 추적 안 되는 파일을 스태시에 넣기는 실제 작업을 삼킬 수 있습니다. 사본이 사과보다 셉니다.
• 세션이 "따라온다"고 기대하지 마세요. 새 에이전트는 이전 대화, 선호도, 첫 에이전트와 나눴던 아키텍처 논쟁을 모릅니다. 글로 적어서 옮기는 것만이 이동입니다.
• 할당량 시스템과 청구 시스템을 섞지 마세요. 구독의 사용량 한도와 API 계정의 토큰 지출은 다른 겁니다. 실제로 싸우고 있는 게 어느 쪽인지 확인하세요.

인계가 맞는 순간 vs 기다릴 순간

한도가 한 시간 안에 리셋되고 작업이 흐름 한가운데라면 기다림이 진짜로 셀 수 있습니다 — 인계에도 고유한 비용이 있는 컨텍스트 스위치니까요. 리셋이 여러 시간 남았거나 남은 작업이 기계적이어서 프론티어급 용량이 필요 없다면, 싼 계량기의 두 번째 에이전트가 보통 더 나은 거래입니다. 패턴은 일반화됩니다: 희소한 쿼터는 결정에 아끼고, 기계적인 나머지는 싼 계량기에 쓰세요.

meshcode는 이 패턴을 중심으로 설계됐습니다: 여러 에이전트를 병렬 창으로, 각자 자기 도구와 계정으로 로그인한 채. 한 창이 한도에 걸리면 같은 노트로 다음 창에 넘기면 됩니다 — 프로젝트를 떠나거나 뭘 설정할 필요 없이.

관련 글: Gemini CLI와 Code Assist의 공유 쿼터 · 프롬프트 하나에 요청이 여러 번 드는 이유 · Claude와 Codex 나란히 돌리기.

👉 meshcode 다운로드