Claude Code가 상한에 도달해도 '마무리 지점'까지 계속 작동하게 되었습니다

본 기사에 대하여

Claude Code에게 큰 수정을 요청했는데, 잠시 후 확인해 보니 '상한에 도달했습니다'라는 메시지와 함께 멈춰 있었습니다. 게다가 파일이 절반만 수정되어 있어 동작하지 않았습니다. 유료 플랜으로 Claude Code를 사용하고 있다면, 비슷한 경험을 하신 분들이 있을 것입니다.

Anthropic이 이 문제에 대한 개선책을 마련했습니다. 바로 'Wrap-Up Allowance'라는 기능입니다. 직역하면 '마무리를 위한 할당량'이라는 뜻입니다. 상한에 도달하더라도 약간 더 작업을 계속하고, 깔끔하게 마무리되는 지점에서 멈춥니다.

이전과 이후의 차이점 (도움말 설명을 바탕으로 한 개략적인 그림이며 실제 화면은 아닙니다)

본 기사는 받은 공지 이메일과 도움말 페이지를 Claude에게 읽게 하고 정리한 것입니다. 유료 플랜에서 Claude Code를 사용하며 상한 때문에 작업이 멈춘 분들을 위한 내용입니다.

개요

구성

• Claude의 '상한' 복습
• 무엇이 바뀌었는지
• 플랜별 차이점
• 오늘부터 해야 할 일
• 주의할 점

1. Claude의 '상한' 복습

Claude 유료 플랜에는 사용할 수 있는 양에 두 가지 상한이 있습니다. 5시간 단위의 상한과, 1주일 단위의 상한입니다. 어느 한쪽에 도달하면, 해당 할당량이 돌아올 때까지 사용할 수 없습니다. 상한에 도달했을 때는 언제 돌아오는지 화면에 표시됩니다.

이 할당량은 claude.ai에서의 채팅과 Claude Code에서 공통으로 사용됩니다. 모델을 전환해도 같은 할당량에서 차감됩니다. 플랜별 할당량의 크기는 공식 설명 페이지에는 기재되어 있지 않습니다.

2. 무엇이 바뀌었는지

이전

작업 도중에 5시간 상한에 도달하면, Claude는 그 자리에서 멈추었습니다. 세 개의 파일을 수정하는 작업이라면, 두 번째 파일까지 끝난 지점에서 멈추고, 세 번째 파일만 오래된 상태로 남을 수 있었습니다. 개발사 역시 작업을 중간에 어중간하게 갑자기 멈추는 것이 좋은 경험은 아니었다고 인정했습니다.

이후

위가 이전, 아래가 이후 (개략도)

응답 도중에 5시간 상한에 도달해도, Claude Code는 약간 더 작업을 계속합니다. 마무리가 되는 시점은 응답이 완전히 끝났을 때, 할당량을 모두 사용했을 때, 스스로 중간에 멈췄을 때 중 하나입니다. 할당량을 모두 사용했다면, 그때 진행하던 한 단계를 끝까지 완료하고 다음 단계로 넘어가지 않습니다.

핵심 포인트

• 할당량은 소량이며 상한이 있습니다. 양은 플랜마다 다르며 숫자는 공개되지 않았습니다.
• 도움말에는 '작업을 완료하는 데 충분하지 않을 수 있다'고 쓰여 있습니다.
• 마무리에 사용된 부분은 1주일 상한에 포함됩니다. 1주일 상한 자체는 늘어나지 않습니다.

자세한 조건은 Claude Code Wrap-Up Allowance (Claude 도움말, 영어)에 나와 있습니다.

3. 플랜별 차이점

당신의 플랜은?

핵심 포인트

• 대상은 상한에 도달했을 때 동작하고 있던 응답만 해당됩니다. 상한에 도달한 후에 새로 보낸 메시지는 제외입니다.
• 계정과 조직이 생성된 후 일정 기간이 지난 것도 조건입니다. 이 기간은 공개되지 않았습니다.
• 단계적으로 제공되는 과정이라 아직 받지 못한 계정도 있습니다.

4. 오늘부터 해야 할 일

Claude Code 버전 확인하기

claude --version

2.1.277보다 오래되었다면, 업데이트합니다.

기억해야 할 점

Pro 사용자는 마무리가 주당 단 1회입니다. 같은 주에 두 번째 상한에 도달하면, 이전처럼 그 자리에서 멈춥니다. 멈춘 후에는 어디까지 진행되었는지 스스로 확인하는 것이 확실합니다.

상한에 도달했음에도 계속하고 싶다면, Claude Code에서 /rate-limit-options
라고 입력합니다. 상한이 돌아오기를 기다려 자동 재개하기, 추가 사용량 추가하기, 플랜 업그레이드하기 세 가지 중 하나를 선택할 수 있습니다.

5. 주의할 점

마무리(仕上げ) 기능은 자동으로 작동하며, 미리 신청하거나, 저장해 두거나, 다음으로 넘기는 것은 불가능합니다. 이 기능은 플랜에 포함된 기능이 아니며, Anthropic의 판단에 따라 제공되는 것이고, 예고 없이 변경/중지/종료될 수 있다고 명시되어 있습니다.

추가 사용량(usage credits)을 켜 놓은 사람은 먼저 마무리 기능을 사용하고, 그 후에는 추가 사용량으로 전환되어 일반 요금 그대로 계속되는 방식입니다.

활용 가이드라인

참고

홍보: 멈춘 대화의 연속은 session-relay로

마무리 사용량을 모두 소진한 후에는 상한이 돌아올 때까지 기다려야 합니다. 기다릴 수 없을 때의 방법은 다른 AI로 이어서 진행하는 것입니다.

session-relay는 새로운 채팅에 '계속'이라고 입력하기만 하면 이전 대화를 이어받을 수 있는 도구입니다. 새로운 AI가 이전 대화를 스스로 읽어와서, 계속부터 시작합니다. 인수인계서는 작성하지 않습니다. Claude Code와 Codex 사이에서도 옮길 수 있습니다.

설치 방법은 터미널에서 다음 두 줄입니다.

npm install -g @shoujiki-panman/session-relay
relay install

자세한 내용은 이전에 작성한 글에 모아두었습니다.

토론