AI STUDY/ISSUE

Claude Code 주간 사용량 17% 축소 총정리 — "25% 인상"인데 왜 줄었나, 한도 아끼는 실전 세팅까지

또롬 2026. 9. 15. 16:10

    2026년 9월 14일부터 Claude Code의 주간 사용 한도가 바뀌었다. 앤트로픽 공식 계정은 "영구 25% 인상"이라고 알렸는데, 같은 계정이 곧이어 "오늘 기준으로는 17% 감소"라고 덧붙였다. 두 문장 다 사실이고, 이게 이번 논란의 전부이자 핵심이다. 나는 Claude Code를 주 작업 도구로 쓰는 입장에서 이 변경을 읽었고, 화날 일인지 아닌지보다 내 워크플로우에서 실제로 무엇을 바꿔야 하는지가 더 급했다. 숫자부터 정리하고, 그다음 대응을 순서대로 정리했다.

     

    1. 타임라인 — 어떻게 여기까지 왔나

    날짜 내용
    2026년 5월 6일 5시간 한도 영구 2배 인상(Pro·Max·Team·시트 기반 Enterprise), Pro·Max의 피크타임 감축 폐지
    2026년 5월 13일 주간 한도 50% 인상 프로모션 시작. 최초 종료 예정일은 7월 13일
    5~9월 종료일이 네 차례 연장됨(8월 19일 → 8월 31일 → 9월 13일 등)
    2026년 8월 29일 공식 개발자 계정이 "9월 14일부터 표준 주간 한도 영구 25% 인상" 공지, 직후 "오늘 대비 17% 감소" 인정
    2026년 9월 13일 23:59 PT 50% 프로모션 종료
    2026년 9월 14일 새 표준 한도 적용. 같은 날 공식 지원 문서도 개정됨

    프로모션은 Pro, Max, Team, 그리고 시트 기반 Enterprise 플랜에 자동 적용됐다. 무료 플랜과 사용량 기반 Enterprise 시트는 애초에 대상이 아니었다.

     

    2. 숫자 — 25%와 17%는 같은 변화의 두 얼굴이다

    계산은 한 줄로 끝난다. 프로모션 이전 표준 주간 한도를 100이라고 두자.

    구간 지수 기준
    프로모션 이전 표준 100 옛 기준선
    2026년 5월 13일 ~ 9월 13일 150 기준선 +50%
    2026년 9월 14일 이후 125 기준선 +25%(영구)

    125를 100과 비교하면 25% 인상이다. 125를 150과 비교하면 0.833, 즉 16.7% 감소이고 반올림하면 17%다. 앤트로픽이 직접 쓴 표현도 "오늘과 비교하면 Claude Code 주간 한도가 17% 줄어드는 셈"이다. 두 수치 모두 맞고, 어느 쪽도 다른 쪽의 정정이 아니다. 기준점이 다를 뿐이다.

    문제는 이 프로모션이 4개월을 굴러가면서 사실상 기본값으로 체감됐다는 점이다. 5월 13일 이후 Claude Code를 시작한 사용자에게 150은 프로모션이 아니라 그냥 '내 한도'였다. 그 상태에서 125로 내려오면, 공지 문구가 무엇이든 체감은 감축이다.

     

    3. 논란이 커진 진짜 이유 — 공지 방식

    나는 이번 건에서 숫자보다 공지 순서가 문제였다고 봤다. 최초 게시물은 "영구 25% 인상"만 앞세웠고, 오늘 대비 감소한다는 사실은 본문에 없었다. X에서 커뮤니티 노트가 붙었고, 개발자들이 "인상이라면서 왜 줄어드냐"고 반응하자 앤트로픽은 원 스레드를 내리고 17% 감소를 명시한 게시물을 다시 올렸다. 재게시된 문장에는 "사용자가 Claude에서 더 많은 걸 얻는다고 느끼게 하면서, 사용량에 대한 가시성과 통제권을 높이는 변화를 준비 중"이라는 예고가 붙었다.

     

    커뮤니티에서는 추가 의혹도 제기됐다. 지원 문서의 과거 스냅샷을 비교하면 7월 시점에 '50% 부스트'라는 표현이 소급해서 붙은 것처럼 보인다는 주장이다. 이건 사용자 측 주장이고 앤트로픽 공식 설명은 없으므로, 사실로 단정할 단계는 아니다. 다만 4개월간 네 번 연장된 프로모션을 문서 한 줄 수정으로만 관리해 온 방식이 신뢰 문제를 키웠다는 지적 자체는 타당하다.

     

    공급자 입장의 사정도 명확하다. 현재 사용량 한도 체계는 Claude가 '단순 챗봇'이던 시절에 설계됐다. Claude Code는 한 턴에 파일 내용, 도구 호출 결과, 다단계 추론이 통째로 들어가기 때문에 같은 한도가 훨씬 빨리 녹는다. 사용자도 답답하고, 비용을 떠안는 쪽도 부담이다. 플랫폼 안정성과 컴퓨트 관리 차원의 조정이라는 게 회사 측 설명으로 보도됐다.

     

    4. 헷갈리면 안 되는 것 — 5시간 한도는 안 바뀌었다

    실무에서 가장 많이 나오는 오해다. Claude Code는 한도를 두 개의 시계로 잰다.

    • 5시간 롤링 세션 한도: 세션을 시작한 시점부터 5시간 단위로 회복.
      이번 변경과 무관하다. 5월 6일의 2배 인상은 그대로 유지된다.
    • 주간 한도: 계정마다 고정된 요일에 리셋. 이번에 바뀐 건 이쪽뿐이다.

    낮에 반복적으로 막힌다면 대개 주간 한도가 아니라 5시간 창이다. 이걸 구분하지 않으면 "몇 시간 기다리면 되는 상황"에 플랜을 업그레이드하는 잘못된 처방을 내리게 된다.

    메시지 구분법도 알아 두면 좋다. "세션 한도에 도달" 또는 "주간 한도에 도달"은 구독 플랜의 사용 윈도우이고 모든 모델이 공유하므로 모델을 바꿔도 소용없다. 반면 "Opus 한도에 도달", "Sonnet 한도에 도달"처럼 모델명이 붙은 메시지는 다른 계열 모델로 전환하면 작업을 이어갈 수 있다.

     

    5. 내 사용량은 어디로 새고 있나 — 먼저 측정한다

    줄이기 전에 측정해야 한다. Claude Code 안에서 쓸 수 있는 도구가 이미 있다.

    /usage 를 실행하면 구독자 기준으로 플랜 사용량 막대와 함께 다음이 나온다.

    • 귀속(Attribution): 최근 사용량이 skills, subagents, plugins, 개별 MCP 서버 중 어디에 얼마나 잡아먹혔는지를 백분율로 보여준다.
    • 동작 플래그(Behavior flags): 긴 컨텍스트나 캐시 미스가 최근 사용량의 10% 이상을 차지하면 플래그가 뜬다. 이게 보이면 원인이 확정된 것이다.
    • 루프(Loops): 예약 작업이 토큰을 얼마나 먹는지 작업별로 정렬해 보여준다.
    • d 키와 w 키로 최근 24시간과 최근 7일을 전환할 수 있다.

     

    /insights 는 토큰 수가 아니라 작업 방식에 대한 리포트를 만든다. 최근 세션을 분석해 오해된 요청, 버그 있는 코드처럼 마찰이 생긴 지점을 HTML 보고서로 뽑는다. 보고서는 ~/.claude/usage-data/ 아래에 저장되고 기본 30일 후 정리된다.

    주의할 점 하나. /usage 수치는 이 기기의 로컬 세션 기록 기준이라 다른 기기나 웹 Claude 사용량은 포함되지 않는다.

     

    6. 한도를 아끼는 실전 세팅

    토큰 비용은 컨텍스트 크기에 비례한다. 결국 전략은 두 가지로 압축된다. 컨텍스트를 작게 유지할 것, 캐시 적중률을 높일 것.

    ① 작업이 바뀌면 /clear — 관련 없는 작업으로 넘어갈 때 대화를 비운다. 오래된 컨텍스트는 이후 모든 메시지에서 토큰을 낭비한다. 비우기 전에 /rename으로 이름을 붙여 두면 나중에 /resume으로 되돌아올 수 있다. 참고로 /compact는 요약할 대화를 전부 읽어야 하므로 그 자체가 큰 요청이다. 연속성이 필요 없으면 /clear가 공짜다.

     

    ② 모델을 작업에 맞게 고른다 — Sonnet이 대부분의 코딩 작업을 처리한다. Opus는 복잡한 아키텍처 결정이나 다단계 추론에 남겨 둔다. 단순한 subagent 작업은 아예 haiku로 지정한다.

     

    ③ MCP 오버헤드를 줄인다 — /context로 무엇이 자리를 차지하는지 확인하고, /mcp로 안 쓰는 서버를 끈다. gh, aws, gcloud처럼 CLI로 대체 가능한 건 CLI가 훨씬 컨텍스트 효율적이다. 도구 목록을 통째로 들고 오지 않기 때문이다.

     

    ④ CLAUDE.md를 다이어트한다 — 이 파일은 세션 시작 시 무조건 로드된다. PR 리뷰 절차나 DB 마이그레이션 가이드처럼 특정 상황에서만 필요한 지침이 들어 있으면 무관한 작업을 할 때도 그 토큰을 매번 낸다. 필요할 때만 로드되는 skills로 옮기고, CLAUDE.md는 200줄 이내로 유지한다.

     

    ⑤ 확장 사고 예산을 조정한다 — 사고 토큰은 출력 토큰으로 과금되고 기본 예산이 수만 토큰까지 갈 수 있다. 단순 작업에는 /effort로 노력 수준을 낮추거나 /config에서 사고를 끈다. 고정 예산 모델은 환경 변수 MAX_THINKING_TOKENS를 8000 수준으로 낮출 수 있다. 다만 Fable 계열 모델은 사고를 끌 수 없고 항상 확장 사고를 쓴다.

     

    ⑥ 장황한 작업은 subagent에 넘긴다 — 테스트 실행, 문서 가져오기, 로그 처리처럼 출력이 큰 작업은 subagent로 격리한다. 상세 출력은 subagent 컨텍스트에 남고 본 대화로는 요약만 돌아온다.

     

    ⑦ hooks로 전처리한다 — 1만 줄 로그를 Claude가 통째로 읽게 두지 말고, PreToolUse hook으로 에러 줄만 걸러 넘긴다. 수만 토큰이 수백 토큰이 된다.

     

    ⑧ 프롬프트를 구체적으로 쓴다 — "이 코드베이스 개선"은 광범위한 스캔을 유발한다. "auth.ts의 로그인 함수에 입력 검증 추가"는 최소한의 파일 읽기로 끝난다.

     

    ⑨ 복잡한 작업은 plan mode로 시작한다 — Shift+Tab으로 진입해 접근 방식을 먼저 승인받는다. 방향이 틀렸을 때 발생하는 비싼 재작업을 막는다. 잘못 가기 시작하면 Escape로 즉시 멈추고, /rewind나 Escape 두 번으로 이전 체크포인트로 되돌린다.

     

    ⑩ 에이전트 팀은 신중하게 — 팀원이 plan mode로 돌면 표준 세션의 약 7배 토큰을 쓴다. 팀원마다 독립 컨텍스트 윈도우를 유지하기 때문이다. 팀원 모델은 Sonnet으로, 팀은 작게, 작업이 끝나면 정리한다. 기본적으로 비활성화돼 있으므로 켰다면 의도한 것인지 다시 확인한다.

     

    ⑪ 유휴 상태의 누수를 잡는다 — 세션이 놀고 있어도 토큰이 나가는 경로가 있다. 예약 작업, 세션 간 메시지 전달, 목표 백그라운드 체크인이 대표적이다. 각각 실행 때마다 전체 컨텍스트를 보낸다. 체크인은 환경 변수 CLAUDE_CODE_GOAL_CHECKIN_MINUTES를 0으로 두면 끌 수 있고, 인바운드 메시지는 설정에서 보류로 돌릴 수 있다.

     

    ⑫ 캐시 수명을 의식한다 — 구독 사용 시 프롬프트 캐시 수명은 1시간이다. 그보다 긴 휴식 뒤 첫 메시지는 캐시를 놓치고 전체 컨텍스트를 재처리한다. 점심 먹고 와서 한 줄 물었는데 사용량이 훅 줄었다면 대개 이 경우다.

     

    7. 그래도 모자라면

    세 가지 선택지가 있다.

     

    기다린다. 세션 한도는 5시간 이내에 회복된다. Claude Code v2.1.234 이상은 한도로 중단된 작업을 리셋 후 자동으로 이어받도록 대기시킬 수 있다. /rate-limit-options에서 선택하거나, 조직 단위로는 관리 설정의 autoContinueAtUsageLimit으로 제어한다.

     

    사용량 크레딧을 켠다. /usage-credits를 실행하면 Pro·Max는 claude.ai 사용량 설정이 열린다. 플랜 한도를 넘겨 표준 API 요금으로 계속 쓰되 월 지출 한도를 직접 건다. 한 가지 함정이 있다. 사용량 크레딧을 쓰기 시작하면 프롬프트 캐시 수명이 1시간에서 5분으로 줄어든다. 긴 세션을 오래 붙잡고 있는 작업 패턴이면 TTL을 직접 지정하는 편이 낫다.

     

    과금 채널을 분리한다. 주간 할당량이 아예 없는 종량제 채널로 배치 작업이나 피크 부하를 빼는 방법이다. 구독은 대화형 작업에, 자동화는 종량제에 태우면 "할당량 소진, 그냥 대기" 상태 자체가 사라진다.

     

    정리

    • 2026년 9월 14일부터 Claude Code 주간 한도는 프로모션 이전 기준선 대비 영구 25% 인상 상태가 됐다.
    • 동시에 5월 13일부터 이어지던 50% 프로모션이 9월 13일 23:59 PT에 종료되면서, 직전 체감 대비로는 약 17% 감소다. 100 → 150 → 125 구조다.
    • 두 수치 모두 사실이며 기준점이 다를 뿐이지만, 최초 공지가 인상만 앞세워 커뮤니티 노트가 붙었고 앤트로픽이 감소를 명시해 재게시했다.
    • 5시간 롤링 한도는 이번 변경과 무관하다. 낮에 반복해서 막힌다면 대개 주간 한도가 아니라 5시간 창이다.
    • 대응 순서는 측정이 먼저다. /usage의 귀속·동작 플래그와 /insights로 어디서 새는지 확인한 뒤 줄인다.
    • 절약의 핵심은 컨텍스트 축소와 캐시 적중이다. 작업 전환 시 /clear, 모델 하향, MCP 정리, CLAUDE.md 다이어트, 사고 예산 조정이 효과가 크다.
    • 그래도 부족하면 자동 대기, 사용량 크레딧, 종량제 채널 분리 중에서 고른다. 단 사용량 크레딧을 켜면 캐시 수명이 5분으로 짧아진다.