클로드에 숨어 있는 리셋권,
/limit-reset의 정체

30초 요약

정리하면 이렇습니다. 한도에 걸렸을 때의 선택지는 지금까지 ‘기다린다 / 크레딧을 산다 / 플랜을 올린다’ 세 가지로 알려져 있었는데, 여기에 ‘주 1회짜리 초기화권을 쓴다’가 조용히 하나 더 붙어 있었습니다.

실행 파일에 들어 있는 한 줄짜리 정의문

확인 방법은 단순합니다. 설치된 Claude Code 실행 파일에서 문자열을 뽑아 ‘limit reset’으로 걸러 보면 됩니다. 제 환경은 ~/.local/share/claude/versions/2.1.271이었습니다.

가장 중요한 문장은 이것입니다. 명령 설명문으로 쓰이는 문자열입니다.

한 문장에 세 가지가 다 들어 있습니다. 무엇을(세션 한도), 얼마나 자주(주 1회), 대가는(주간 한도는 여전히 차감). 메뉴에 표시되는 문구도 같은 내용입니다. to reset your session limit now · uses weekly limit · 1/week.

공짜가 아닙니다: 주간 한도에서 당겨 씁니다

여기가 오해하기 쉬운 지점입니다. 구독 플랜의 한도는 두 겹입니다. 공식 오류 문서가 이렇게 정리합니다.

이 구조 위에서 /limit-reset이 하는 일은 바깥쪽(주간)은 그대로 두고 안쪽(세션) 벽만 치워 주는 것입니다. 그래서 실행 후 표시되는 문구가 이렇습니다.

성공 문구 끝의 “your weekly limit still applies”가 이 기능의 성격을 요약합니다. 총량은 그대로이고, 쓰는 속도의 제한만 한 번 풀어 주는 장치입니다.

그래서 오히려 조심할 부분이 생깁니다. 세션 벽이 사라진 상태로 몰아 쓰면 주간 한도가 훨씬 빨리 바닥납니다. 주간 한도는 며칠 뒤에나 풀리고, 그때는 /limit-reset도 소용이 없습니다. 이 명령은 세션 한도 전용이기 때문입니다.

실수 방지 장치도 들어 있습니다. 한도에 걸리지도 않았는데 실행하면 이렇게 되묻습니다.

거절 사유가 15가지나 있습니다

흥미로운 건 여기입니다. A session-limit reset isn't available right now. 주변에 거절 사유 코드가 줄줄이 박혀 있습니다.

코드 이름만 봐도 대략 짐작이 갑니다. 성격별로 묶으면 이렇습니다.

tenure와 other_experiment가 특히 눈에 띕니다. 같은 플랜을 써도 계정마다 이 명령이 될 수도, 안 될 수도 있다는 뜻입니다. 커뮤니티에서 “나는 되던데”와 “나는 그런 거 없던데”가 동시에 나오는 이유가 여기 있습니다. 버그가 아니라 설계입니다.

사용자에게 보이는 문구도 조건별로 따로 있습니다. No reset to use, you're not at a usage limit right now, Your reset can't be used for this limit right now, Your reset doesn't cover this limit. 세 번째와 네 번째가 중요합니다. 리셋권이 있어도 ‘그 한도’에는 안 통할 수 있습니다.

실패 후 안내도 세심합니다. Couldn't confirm the reset went through — check /usage in a moment, 그다음 단계로 Still couldn't confirm your reset — nothing more was used. “더 소모되지는 않았다”는 말을 굳이 넣어 둔 걸 보면, 리셋권이 날아갈까 봐 걱정할 사람을 염두에 둔 문구입니다.

덤으로 알게 된 것: 한도가 7종류였습니다

같은 구간에서 한도 종류 목록도 함께 나옵니다. 공식 문서가 설명하는 것보다 세분화돼 있습니다.

공식 문서가 안내하는 한도 메시지는 세션·주간·Opus·Sonnet 네 가지인데, 내부적으로는 Cowork와 OAuth 앱이 별도 주간 한도로 분리돼 있습니다. 즉 터미널에서 코딩만 하는 사람과 외부 앱 연동을 많이 쓰는 사람의 한도가 같은 통에서 나오지 않는다는 뜻입니다.

공식 문서에서 확인되는 원칙도 함께 기억해 둘 만합니다. 세션·주간 한도는 모델 공통이라 /model로 바꿔도 안 풀리고, Opus·Sonnet 한도는 계열별이라 다른 계열로 바꾸면 계속 쓸 수 있습니다.

리셋 시각은 30분 단위로 떨어집니다

여기서부터는 문자열이 아니라 제 계정의 실제 기록입니다. Claude Code는 한도에 걸린 429 응답을 세션 로그(~/.claude/projects)에 그대로 남깁니다. 거기서 resetsAt만 뽑아 한국 시간으로 바꿔 봤습니다.

세 건 모두 1800초(30분)의 배수에 정확히 맞습니다. 그리고 두 번째 줄을 보세요. 같은 날 13분 뒤에 다시 걸렸는데 리셋 시각은 13:30:00으로 동일합니다. 창이 요청할 때마다 밀리는 구조였다면 두 번째 값은 뒤로 갔어야 합니다.

여기서 실용적인 결론이 나옵니다. 오류 메시지가 resets 3:45pm처럼 분 단위로 보이더라도, 실제 값은 대체로 :00 또는 :30에 떨어지는 정돈된 시각이고 한번 정해지면 그 창 안에서는 움직이지 않습니다. 12시 20분에 걸렸다면 12시 21분에 다시 시도한다고 리셋이 미뤄지지 않습니다. 걸린 뒤 재시도를 반복하는 게 손해도 이득도 아니라는 뜻입니다.

한 가지 단서는 달아 둡니다. 제 계정에서 나온 세 건이 전부라, 모든 계정에서 항상 30분 경계라고 단정할 수는 없습니다. 다만 초 단위 난수가 아니라 규칙적인 값이 나온다는 점은 분명합니다. 같은 방법으로 자기 계정을 확인해 볼 수 있습니다.

그래서 어떻게 쓰나

정리하면 판단 기준은 주간 한도가 얼마나 남았는가 하나입니다.

두 번째 줄을 강조하고 싶습니다. 공식 문서가 설명하는 자동 대기 기능이 생각보다 잘 돼 있습니다. 세션을 열어 두면 화면 아래에 Usage limit reached · continuing automatically at 3:45pm · esc to cancel이 뜨고, 리셋 시각에 마지막 메시지를 다시 보내는 게 아니라 하던 작업을 이어받는 고정 프롬프트를 넣어 줍니다. 반복해서 한도에 걸리면 최대 두 번까지만 자동 재무장하고 멈춥니다.

주의할 예외도 문서에 있습니다. 컴퓨터가 30분 넘게 잠들었다가 그사이 리셋되면 자동으로 이어지지 않고 press enter to continue가 뜹니다. 그보다 짧은 절전이면 알아서 이어집니다. 그리고 리셋이 24시간 넘게 남은 경우(주간 한도가 대표적)에는 자동 대기를 시작하지 않습니다.

자주 묻는 질문

제 계정에서는 /limit-reset이 안 나옵니다.
정상일 수 있습니다. 거절 사유에 tenure(가입 기간), other_experiment(다른 실험군), cli_version(버전), no_grant(권한 미배정)가 있습니다. 조건부로 배포되는 기능이라 계정마다 다릅니다. 명령 메뉴에 안 떠도 /rate-limit-options는 전체 이름을 직접 입력하면 열립니다.

쓰면 한도가 늘어나나요?
아닙니다. 세션 한도만 초기화되고 주간 한도는 그대로 소모됩니다. 총량이 아니라 ‘속도 제한’을 푸는 기능입니다.

몇 번 쓸 수 있나요?
문자열에 1/week으로 명시돼 있습니다. 쓰고 나면 Weekly reset used · available again {date}로 다음 사용 가능 시점을 알려 줍니다.

한도에 안 걸렸을 때 미리 써 둘 수 있나요?
물어보긴 합니다. You haven't reached a limit yet — use your reset anyway? 다만 주 1회뿐이라 아껴 두는 편이 낫습니다.

이 글의 내용이 공식 문서와 다르면 무엇을 믿나요?
공식 문서입니다. 이 글의 /limit-reset 부분은 문서화되지 않은 기능을 실행 파일 문자열에서 읽어 정리한 것이라, 예고 없이 바뀌거나 사라질 수 있습니다. 반면 세션·주간 한도 구조와 자동 대기 동작은 공식 문서에서 확인한 내용입니다.