
Claude Code 사용량 한도에 걸렸을 때, 작업을 잃지 않고 다른 에이전트로 넘기는 법
실전 인계 가이드: 세션 상태를 포착하고, 다른 에이전트로 전환하고, 이어서 하기 — 파괴적인 git 조작도, 세션 공유 신화도, 커밋되지 않은 변경 유실도 없이.
작업 한가운데서 Claude Code가 사용량 한도 도달을 알리고, 리셋 시계는 몇 시간 남겨두고 있습니다. 작업을 막는 건 기술적으로 아무것도 아닙니다 — 나와 완성 사이에 서 있는 건 할당량 하나뿐이죠. 여기서는 작업을 다른 에이전트로 깨끗하게 넘기는 법을 정리합니다: 무엇을 넘기고, 무엇을 그대로 두고, 무엇을 기대하지 말아야 하는지.
무엇이 이동하고, 무엇이 안 되나
무엇보다 먼저 경계를 분명히 하세요:
이동합니다. git 히스토리. 작업 트리(커밋되지 않은 변경). 여러분이 쓴 노트. 저장소의 상태 — 무엇이 됐는지, 무엇이 남았는지, 어떤 테스트가 지나는지 포함.
이동하지 않습니다. 에이전트의 세션 내 기억, 대화 히스토리, 플랜 목록. 각 도구는 이걸 자기만의 독점 세션 포맷으로 보관합니다. 한 에이전트의 세션을 다른 에이전트에 붓는 지원되는 방법은 없습니다 — 그렇게 해준다는 약속은 미신을 파는 겁니다. 넘기는 것은 세션 자체가 아니라 여러분이 쓰는 요약입니다.
이것도 이동하지 않습니다: 할당량. 한 계정의 한도는 다른 에이전트의 계정에 아무 영향이 없습니다. 두 번째 도구를 자기 계정과 인증으로 로그인하면 그 도구 자체의 허용량을 쓰는 겁니다 — 전환이 성립하는 유일한 조건이고, 두 번째 도구가 빌린 자격 증명이 아니라 진짜 자기 자격으로 인증될 때만 작동합니다.
쓰던 Claude·Codex를 그대로 연결하고, 나머지는 몇십 분의 일 가격의 워커가 처리합니다.
meshcode 다운로드 →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 나란히 돌리기.
다른 글 더 보기
AI 코딩 ROI 측정법: 구독료를 본전 뽑았는지 확인하는 4단계 방법
AI 코딩에 쓰는 돈이 성과로 돌아오고 있는지 확인하려면 체감이 아니라 계산이 필요합니다. 비용 항목 4개(구독·토큰 초과·재작업·유지보수)를 정리하고, PR 리드타임과 재작업률로 회수율을 계산하는 4단계 프레임을 정리했습니다.
vibe coding 성과는 90일 뒤에 판가름난다: 유지보수 청구서가 도착하는 시점
vibe coding 프로젝트의 진짜 성과는 출시 시점이 아니라 90일 후 첫 유지보수 사이클에서 드러납니다. 18개월 내 유지보수 비용 300% 상승, 테스트 커버리지 12% vs 업계 표준 68%, 구독료 $20 대 실비 10~100배 — 2026년에 공개된 데이터로 성과를 제대로 읽는 법을 정리했습니다.
프롬프트 한 줄인데 요청이 여러 번? 코딩 에이전트의 과금 구조
프롬프트 한 줄이 모델 호출 하나가 아닙니다. 에이전트는 컨텍스트 전송, 도구 실행, 재시도로 하루 할당량을 여러 번 소모합니다. 어디서 계량되는지, 왜 짧은 작업이 요청 쿼터를 소진하는지, 내 세션을 측정하는 방법까지 정리했습니다.