Claude Code 주간 한도, 수요일에 바닥나지 않게: 5시간 세션·주간 한도 구조와 아끼는 습관 5가지
AI 코딩 도구를 쓰다 보면 어느 순간 "사용 한도에 도달했습니다"라는 메시지를 만납니다. 이 글은 그 메시지를 덜 보기 위해 Claude 공식 문서가 안내하는 한도 구조와 아끼는 습관을 직장인 눈높이로 정리한 것입니다. 읽고 나면 지금 내 한도가 어디까지 찼는지 확인하는 법, 한도를 빨리 태우는 습관 5가지, 오늘 바로 적용할 점검표를 가져가실 수 있습니다.
먼저 밝혀 둘 점이 있습니다. 저는 개발자가 아니라 AI 도구로 업무와 앱을 만들어 보는 직장인이고, 이 글은 2026년 10월 27일 아침에 확인한 Claude 공식 도움말과 Claude Code 공식 문서를 바탕으로 정리한 가이드입니다. 한도 수치는 요금제와 시기에 따라 달라지므로 구체적인 숫자는 쓰지 않고, 구조와 습관 위주로 다룹니다.
- Claude Pro와 Max 요금제에는 5시간마다 초기화되는 세션 한도와 주간 한도가 있고, Max에는 Fable 모델용 주간 한도가 따로 있습니다.
- 이 한도는 Claude(채팅)와 Claude Code가 함께 씁니다. 코딩만 한 것 같아도 채팅에서 쓴 양이 같이 줄어듭니다.
- Claude Code에서는
/usage로 한도 막대를, 웹에서는 설정의 사용량(Usage) 화면으로 진행 상황을 볼 수 있습니다. - 한도를 가장 크게 좌우하는 것은 대화(컨텍스트)의 길이, 모델 선택, 추론 강도, 막연한 요청입니다.
- 사용량을 예측해 주는 서드파티 도구도 나왔지만, 공식 기능이 아니므로 한계를 알고 써야 합니다.
왜 지금 '한도 관리'가 화제인가
이번 달 들어 AI 코딩 도구는 거의 매주 업데이트됐습니다. Claude Code 공식 변경 내역을 보면 10월 한 달 사이에 2.1.290번대에서 2.1.311까지 버전이 빠르게 올라갔고, 10월 26일 변경 내역에는 ultrathink가 지원 모델에서 xhigh(높음) 추론 강도로 한 턴을 실행하도록 바뀐 항목이 들어 있습니다. 도구가 더 깊이 생각하고 더 오래 일할수록 한 번에 쓰는 토큰도 늘기 쉽습니다. 이 마지막 연결은 제 추정이며, 공식 문서가 "ultrathink가 한도를 얼마나 쓴다"고 밝힌 것은 아닙니다.
또 한 가지 흐름은 에이전트 방식입니다. 질문 하나에 답하는 채팅과 달리, 에이전트는 파일을 읽고 명령을 실행하며 스스로 여러 단계를 이어 갑니다. 공식 도움말도 사용량에 영향을 주는 요소로 메시지 길이, 첨부 파일 크기, 현재 대화 길이, 도구 사용, 모델 선택, 추론 강도(effort), 아티팩트 생성, 코드 실행·파일 생성·웹 탐색 같은 여러 단계 작업을 꼽습니다. 일을 시킬수록 한도가 빨리 줄어드는 구조입니다.
그래서 요즘에는 "수요일인데 이번 주 한도가 끝났다"는 고민이 자연스럽게 나옵니다. 사용량 예측과 경고를 해 주는 Peras 같은 작은 오픈소스 도구가 10월 중순부터 등장한 것도 같은 맥락입니다. 이 글 뒤쪽에서 따로 다룹니다.
한도 구조 먼저 이해하기: 세션, 주간, 사용 크레딧
Claude 공식 도움말(Pro 또는 Max 요금제에서 Claude Code 사용하기)은 구조를 이렇게 설명합니다. 두 요금제 모두 5시간 세션 한도와 주간 한도가 있고, Max에는 Fable 모델용 별도 주간 한도가 있습니다. 그리고 이 한도는 Claude와 Claude Code가 공유합니다. 아래 표는 핵심만 추려 직접 정리한 것입니다.
| 구분 | 내용 | 직장인 관점 해석 |
|---|---|---|
| 5시간 세션 한도 | 5시간 단위로 초기화되는 단기 한도 | 오전에 몰아 쓰면 점심 이후까지 기다릴 수 있음 |
| 주간 한도 | 일주일 단위로 초기화되는 장기 한도 | 주 초반에 과하게 쓰면 주 후반 작업이 막힘 |
| Fable 주간 한도(Max) | Max 요금제에서 Fable 모델에 따로 적용 | 모델을 바꿔도 한도가 같이 줄어드는지는 요금제 화면에서 확인 |
| 공유 범위 | Claude 채팅과 Claude Code가 같은 한도 사용 | 회의 자료 만들기에 쓴 양도 코딩 한도에서 빠짐 |
| 사용 크레딧(선택) | 한도에 도달했을 때 표준 API 요금으로 이어서 쓰는 옵션 | 켜는 순간부터 추가 과금이므로 월 지출 한도 설정이 필수 |
사용 크레딧은 공식 도움말에 따르면 한도에 막히는 대신 소비량 기반 가격으로 계속 쓰게 해 주는 기능이며, 월 지출 한도에 닿거나 잔액이 떨어지면 멈춥니다. 또 Max 요금제에 포함된 월간 API 크레딧은 Claude 앱이나 Claude Code의 사용 크레딧으로는 쓸 수 없다고 안내돼 있습니다. 헷갈리기 쉬운 부분이라 결제 전에 꼭 도움말을 다시 확인하시기 바랍니다.
한도에 도달하면 "Usage limit reached · wrapping up" 같은 문구와 함께 이미 진행 중이던 응답을 마무리할 수 있는 소량의 여유(wrap-up allowance)가 제공될 수 있다고 합니다. 다만 이 기능은 점진적으로 제공 중이어서 내 계정에는 아직 없을 수 있고, 그 사용량도 주간 한도에 포함됩니다. 이 여유를 믿고 작업을 시작하지 말고, 중간 저장용 안전장치 정도로만 생각하는 편이 안전합니다.
내 사용량 확인하는 방법 3가지
아끼려면 먼저 봐야 합니다. 공식 문서가 안내하는 확인 경로는 다음과 같습니다.
- Claude Code의
/usage: 구독자는 요금제 사용량 막대와 활동 통계, 사용 내역을 볼 수 있습니다. 화면 위쪽 Session 블록의 달러 금액은 API 사용자용 추정치여서, 구독자에게는 청구 금액과 상관이 없다고 문서에 적혀 있습니다. 금액에 놀라지 마시고 막대를 보세요. - 웹의 Settings > Usage: Pro, Max, Team, 좌석형 Enterprise 요금제는 이 화면에서 5시간 세션과 주간 한도를 얼마나 썼는지 진행 막대로 확인할 수 있고, 초기화까지 남은 시간도 나옵니다.
- 한도 접근 경고 메시지: 한도에 가까워지면 경고가 표시됩니다. 이 경고를 보면 새 큰 작업을 시작하지 말고 정리 모드로 전환하세요.
사용량 확인 요청이 실패하는 경우도 있습니다. 문서에 따르면 사용량 조회 주소가 요청 제한에 걸리면 마지막으로 불러온 막대를 보여 주고, r 키로 다시 시도할 수 있습니다. "rate limited until 3:14am" 같은 문구는 한도를 다시 조회할 수 없다는 뜻이지 내 작업이 막혔다는 뜻이 아니라고 합니다. 이름이 비슷해 오해하기 쉬운 부분입니다.
한도를 빨리 태우는 습관 5가지와 고치는 법
Claude Code 공식 문서의 토큰 절감 항목과 사용량 모범 사례 도움말을 비교해, 직장인이 바로 바꿀 수 있는 순서로 정리했습니다. 아래 팁은 문서의 권고를 옮긴 것이며, 제가 모든 설정을 직접 실험해 수치로 비교한 것은 아닙니다.
1) 한 대화창을 끝없이 이어 쓴다
문서는 컨텍스트가 커질수록 메시지마다 처리하는 토큰이 늘어난다고 설명합니다. 관련 없는 작업으로 넘어갈 때는 /clear로 새로 시작하라는 권고가 있습니다. 나중에 돌아올 세션은 /rename으로 이름을 붙인 뒤 지우고, /resume으로 다시 열면 됩니다. 요약해서 이어 갈 때는 /compact 뒤에 "코드 예시와 API 사용법 위주로 남겨 줘"처럼 보존할 내용을 적을 수 있습니다.
2) 모든 작업을 가장 큰 모델로 시킨다
문서는 Sonnet이 대부분의 코딩 작업을 잘 처리하고 Opus보다 비용이 덜 든다고 안내하며, Opus는 복잡한 구조 설계나 다단계 추론에 아껴 쓰라고 권합니다. /model로 세션 중에도 바꿀 수 있습니다. 단순한 보조 작업(서브에이전트)에는 더 작은 모델을 지정할 수도 있습니다.
3) 추론 강도를 항상 최대로 둔다
확장 사고(extended thinking)는 기본으로 켜져 있고, 사고 토큰은 출력 토큰으로 계산됩니다. 단순한 작업에는 /effort로 강도를 낮추면 비용을 줄일 수 있다고 문서에 나옵니다. 다만 일부 최신 모델은 사고를 끌 수 없으므로, 그 경우 강도 조절이 유일한 방법입니다. 앞서 말한 ultrathink 키워드는 필요한 턴에만 쓰는 것이 합리적입니다.
4) "이 코드 좀 개선해 줘" 같은 막연한 요청
문서는 "코드베이스를 개선해 줘" 같은 요청이 넓은 탐색을 부른다고 경고합니다. 대신 "로그인 함수에 입력값 검증을 추가해 줘"처럼 대상을 좁히면 읽는 파일이 줄어듭니다. 비개발자라면 "구글 시트 B열의 날짜가 문자열이면 날짜로 바꾸는 함수를 하나만 만들어 줘"처럼 파일, 위치, 원하는 결과를 한 문장에 넣는 식으로 바꿔 보세요.
5) 쓰지 않는 연동(MCP)과 긴 설명서를 계속 켜 둔다
/context로 컨텍스트가 무엇에 쓰이는지 볼 수 있고, /mcp로 설정된 서버를 확인해 안 쓰는 것은 꺼 두라는 안내가 있습니다. 프로젝트 지침 파일인 CLAUDE.md는 세션 시작 때마다 읽히므로 200줄 이하의 핵심만 남기고, 특정 작업용 긴 지침은 필요할 때만 불러오는 스킬로 옮기라고 권합니다.
오늘 바로 쓰는 절약 프롬프트와 작업 순서
아래는 위 원칙을 반영해 제가 만든 예시입니다. 그대로 복사해 상황에 맞게 바꿔 쓰시면 됩니다.
| 상황 | 아끼지 못하는 요청 | 아끼는 요청 예시 |
|---|---|---|
| 버그 수정 | 앱이 안 돼, 고쳐 줘 | 시트 "접수" 탭에서 실행하면 3행에서 TypeError가 납니다. 오류 문구는 아래와 같습니다. 해당 함수만 고쳐 줘. |
| 기능 추가 | 알림 기능 넣어 줘 | submitForm 함수 끝에 카카오 알림 호출을 한 줄 추가해 줘. 다른 파일은 건드리지 마. |
| 문서 정리 | 이 자료 정리해 줘 | 첨부한 회의 메모를 결정 사항 3개, 담당자별 할 일 표로만 정리해 줘. |
| 큰 작업 | 전체를 새로 만들어 줘 | 먼저 계획만 세워 줘. 내가 승인하면 1단계부터 하나씩 진행해. |
큰 작업은 계획 모드(Shift+Tab으로 전환)를 쓰라는 것이 문서의 권고입니다. 코드를 건드리기 전에 방향을 승인하면 잘못된 방향으로 달려가 토큰을 낭비하는 일을 줄일 수 있기 때문입니다. 방향이 틀어졌다 싶으면 Esc로 바로 멈추고, 두 번 누르거나 /rewind로 이전 시점으로 돌아갈 수 있습니다. 결과 확인 기준(테스트나 기대 출력)을 프롬프트에 적어 주면 스스로 검증해 재요청이 줄어든다는 점도 문서에 있습니다.
사용량 예측 도구 Peras, 써도 될까
공식 /usage 막대만으로는 "이 속도면 언제 바닥나는지"를 알기 어렵습니다. 이 빈칸을 겨냥해 10월에 소개된 도구가 Peras입니다. 신제품 목록 사이트 GetToolRank의 소개 정리에 따르면, Peras는 Claude Code와 Codex의 5시간·7일 사용량을 보여 주고 현재 속도로 언제 소진되는지 예측하며, 사용자가 정한 기준에서 알림을 띄우거나 다음 도구 호출 전에 확인을 묻거나 도구 호출을 멈추게 하는 무료 오픈소스 CLI입니다. macOS 메뉴 막대 앱은 4.99유로의 별도 유료 버전이라고 합니다.
다만 신중하게 볼 지점이 분명합니다. 같은 소개 글은 이 도구가 Claude Code와 Codex에 훅(hook)을 설치하며(peras remove로 제거), 제작사 사이트에서도 사용량 추적에 누락이 있을 수 있다고 밝힌다고 적습니다. 또한 해당 정리는 10월 23일 기준이고 GitHub 별이 3개 수준인 아주 초기 프로젝트이며, Windows와 Linux 지원은 언급되지 않았다고 합니다. 저는 이 도구를 설치해 써 보지 않았고, 소개 내용만 확인했습니다. 업무용 컴퓨터에는 회사 보안 정책을 확인하고, 훅이 내 설정 파일을 바꾼다는 점을 이해한 뒤에 쓰시길 권합니다. 대안으로는 공식 /usage 막대를 하루 두 번(출근 직후, 퇴근 전) 확인하는 습관만으로도 충분히 도움이 됩니다.
남은 한도를 작업량으로 바꾸기 전에
주간 막대가 30% 남았다고 해서 “코딩을 3시간 더 할 수 있다”로 바꾸어 읽을 수는 없습니다. 대화 길이와 작업 종류가 다르기 때문입니다. 아래는 실제 측정치가 아닌 기록표 작성 예시입니다.
| 기록할 항목 | 가상 기록 |
|---|---|
| 작업 | 한 파일의 날짜 표시 오류 수정 |
| 시작·종료 사용량 | 42% → 45% |
| 차이 | 3%포인트 |
| 조건 | 같은 모델, 새 대화, 동시에 실행한 작업 없음 |
| 다음 초기화 | 내 사용량 화면에 표시된 날짜·시각을 그대로 기록 |
숫자가 즉시 갱신되지 않거나 그 사이 채팅도 썼다면, 차이를 이 작업 하나의 소비량으로 단정하지 않습니다. 비슷한 작업을 여러 번 기록해 대략적인 경향만 보세요. 남은 한도를 쓰기 위해 불필요한 리팩터링을 시작하기보다, 다음 초기화 전에 꼭 끝내야 할 일을 먼저 남겨 두는 편이 낫습니다.
참고: Claude 요금제 안내 · Claude Code 비용 안내 (2026-10-28 확인). 기록표는 가상 예시입니다.
직장인용 주간 한도 운영 체크리스트
| 시점 | 할 일 |
|---|---|
| 월요일 아침 | 주간 한도 초기화 시각 확인, 이번 주 큰 작업 2~3개를 요일별로 배분 |
| 작업 시작 전 | 이전 작업과 무관하면 /clear, 이번 작업에 필요한 모델과 추론 강도 선택 |
| 요청할 때 | 파일, 위치, 원하는 결과, 확인 기준을 한 번에 적기(여러 질문은 한 메시지에 묶기) |
| 큰 작업 | 계획 모드로 계획 승인 후 한 단계씩 진행, 단계마다 테스트 |
| 한도 경고가 뜰 때 | 새 대형 작업 중단, 결과물 저장, 다음 초기화 시각까지 문서 정리나 기획 같은 가벼운 일로 전환 |
| 주간 초기화 전 확인 | 사용량 화면의 다음 초기화 날짜·시각을 확인하고, 그 전에 필요한 작업에 쓸 여유를 남겨 둡니다. 잔여량을 소진하려고 불필요한 작업을 시작하지 않습니다. |
사용 크레딧은 급할 때의 비상구입니다. 켜기 전에 월 지출 한도를 반드시 정하고, 한도 없이 두면 지출이 제한되지 않는다는 점을 기억하세요. 문서도 지출 한도를 설정하지 않으면 지출 행에 "Unlimited"로 표시된다고 안내합니다.
자주 묻는 질문
Q. 채팅만 했는데 코딩 한도가 줄었어요. 오류인가요?
아닙니다. 공식 도움말에 따르면 Pro와 Max의 한도는 Claude와 Claude Code가 공유합니다. 어느 쪽에서 썼든 같은 한도에서 빠집니다.
Q. 모델을 바꾸면 한도가 다시 생기나요?
상황에 따라 다릅니다. Claude Code 문서에는 모델 전용 한도(예: Opus 한도)에 걸렸을 때는 다른 모델 계열로 바꾸면 계속 작업할 수 있다고 나옵니다. 반면 세션 한도나 주간 한도는 모든 모델에 공통이라 모델을 바꿔도 복구되지 않는다고 설명합니다. 어떤 메시지가 떴는지 문구를 먼저 확인하세요.
Q. 일을 안 시키고 두면 토큰이 안 나가나요?
문서에는 유휴 상태에서도 이전 대화 요약(재개 기능용) 같은 백그라운드 기능이 토큰을 일부 쓴다고 나와 있습니다. 양은 문서에 수치로 적혀 있지 않으니, 걱정되면 /usage 막대 변화를 직접 지켜보세요.
마무리
한도 관리는 결국 습관의 문제입니다. 대화를 짧게 끊고, 모델과 강도를 작업에 맞추고, 요청을 구체적으로 쓰고, 큰 일은 계획부터 승인하는 네 가지만 지켜도 같은 한도로 훨씬 오래 일할 수 있다는 것이 공식 문서의 일관된 메시지입니다. 도구가 강해질수록 쓰는 사람의 요청 설계가 비용을 좌우합니다. 오늘 하루만 /usage를 아침과 저녁에 열어 보고, 어떤 작업이 막대를 크게 움직이는지 기록해 보세요. 그 기록이 내 업무에 맞는 가장 좋은 절약 규칙이 됩니다.
※ 이 글은 2026년 10월 27일 확인한 공식 문서 기준의 정리이며, 요금제·한도·기능은 바뀔 수 있습니다. 결제나 요금제 변경은 반드시 공식 안내를 확인한 뒤 본인이 판단하세요.
참고 자료
- Claude Code 공식 문서: Manage costs effectively
- Claude 도움말: Use Claude Code with your Pro or Max plan
- Claude 도움말: Manage usage credits for paid Claude plans
- Claude 도움말: Usage limit best practices
- Claude Code 변경 내역(Changelog)
- GetToolRank: Peras 소개(2026-10-23 확인 기준)