1. 컨텍스트 창 한도: 한 세션에서 모델이 동시에 처리할 수 있는 총 토큰 수를 제한합니다. 가득 차면 모델이 압축을 요청하거나 기록을 자동으로 압축합니다. 2. 계정 사용 한도: 이동 시간 창(예: 5시간 재설정 또는 주간 할당량)의 총 요청량 또는 토큰 소비를 제한합니다. 도달하면 Claude는 재설정 시각과 함께 "You have exceeded your current usage limit"를 표시합니다.
개발자는 가득 찬 컨텍스트 창을 계정 속도 제한과 혼동하거나, 세션 핸드오프 도구가 Claude의 컨텍스트 창을 인위적으로 넓힌다고 여기기도 합니다. Watch는 사용 할당량을 우회하거나 Claude의 네이티브 압축을 대체하지 않습니다. 차이를 알아야 올바른 복구 경로를 고릅니다.
1단계: 터미널 오류 신호로 한도 유형 식별
Claude가 재설정 시각과 함께 "exceeded your limit"를 보고하면 계정 사용 한도입니다. 모델 할당량이 소진되어 /compact는 실패합니다. 재설정을 기다리거나 Codex / OpenCode로 넘기세요. Claude가 대화 길이 한도나 높은 지연을 보고하면 컨텍스트 창 한도입니다. /compact를 실행하세요.
2단계: 컨텍스트 길이는 네이티브 방법으로 해결 (/compact & /clear)
Claude Code 안에서 /compact를 실행해 대화 기록을 압축된 요약으로 만듭니다. 과거의 조사 턴이 더 이상 필요 없으면 /clear를 실행해 현재 작업 공간에서 깨끗이 시작하세요.
3단계: 계정 사용 할당량에 걸리면 세션 상태 저장
Claude Code가 세션 기록을 ~/.claude/projects/<enc-cwd>/<session-id>.jsonl에 기록했는지 확인합니다. Watch로 작업 디렉터리와 Codex 또는 OpenCode 대상 준비 상태를 살펴보세요.
4단계: 컨텍스트를 반복하지 않고 다른 에이전트로 핸드오프
Watch로 기록된 추론과 테스트 결과를 대상 에이전트 형식으로 변환한 뒤, 앞선 컨텍스트 전체와 함께 새 CLI에서 이어가세요.
# 시나리오 A: 컨텍스트 창 한도의 네이티브 해결 (Claude Code 내부)
/compact # 기록을 자동 압축해 컨텍스트 용량 확보
/clear # 작업 디렉터리 컨텍스트는 유지하고 대화 비우기
# 시나리오 B: 계정 사용 한도에 걸렸을 때의 다중 에이전트 핸드오프 (Shell)
npm run watch -- open <claude-session-id> --to codex --json
npm run watch -- open <claude-session-id> --to opencode --json1. Watch는 단일 에이전트 컨텍스트를 확장하지 않음: 새 에이전트에서 이어가기는 그 에이전트 자신의 컨텍스트 창 한도를 받습니다. 2. 도구 표현 변화: Claude tool_use 이벤트는 스키마 파싱 오류를 막기 위해 Codex에서 구조화된 텍스트 표현으로 저하됩니다. 3. 프로세스를 갑자기 종료하지 말 것: 터미널 창을 닫기 전에 세션 파일이 기록되었는지 확인하세요.