가이드 · 2026년 11월

한도가 갑자기 빨리 줄 때: 어디서 썼는지 찾기

하는 일은 그대로인데 5시간·주간 한도가 훨씬 빨리 찬다면, 먼저 내 Mac의 어느 세션과 하위 에이전트가 토큰을 썼는지 확인해 보세요. 반복에 빠진 에이전트 하나가 한도를 다 쓰는 일이 실제로 있습니다.

왜 생기나요

최근 2주 사이 한도가 예상보다 빨리 찬다는 보고가 이어졌습니다: Team 플랜 주간 한도가 초기화 30시간 만에 100%(#107390), 같은 작업량인데 10월 중순부터 훨씬 빨리 줄어듦(#105621), 5시간 한 번에 주간 한도 절반(#106274). 플랜 쪽 계산이 바뀌었는지는 Anthropic만 확인할 수 있습니다.

하지만 내 Mac에서 확인할 수 있는 원인도 있습니다. 백그라운드 하위 에이전트 둘이 이미지 93장을 한 번씩 열라는 지시에 Read를 19,099번 반복해 한도를 두 번 다 씀(#106556), 자기 백그라운드 작업을 기다리는 하위 에이전트가 "Waiting." 알림으로 부모 세션을 계속 깨워 그때마다 한 턴씩 씀(#105928), 1분 간격 /loop가 밤새 1,200번 돌며 약 4억 토큰을 씀(#106522). 작업 중 Mac이 잠들었다 깨며 맥락을 다시 써 넣는 것도 원인이 됩니다.

직접 찾는 법

① 지금 도는 것 보기: 세션에서 /usage(별칭 /cost, /stats)로 플랜 사용량과 이번 세션 비용을, /tasks로 백그라운드에서 도는 하위 에이전트·셸을 보고 관리합니다(Claude Code 2.1.317 기준). 세션이 여러 개면 각 세션에서 따로 봐야 합니다. 이상한 반복이 보이면 그 세션에서 Esc로 멈추세요.

② 지난 24시간 세션별로 모아 보기: Claude Code는 대화를 ~/.claude/projects/<프로젝트>/<세션>.jsonl에, 하위 에이전트는 <세션>/subagents/ 아래에 따로 남기고, 응답마다 message.usage에 토큰 수를 적습니다. 아래 명령은 파일마다 응답 수·출력·입력(새로 쓴 캐시 포함)·캐시 읽기를 더해 큰 순서로 보여 줍니다(jq 필요, brew install jq). 같은 응답이 여러 줄로 남는 경우가 있어 message.id로 한 번만 셉니다.

since=$(date -u -v-24H +%Y-%m-%dT%H:%M)
find ~/.claude/projects -name '*.jsonl' -mtime -1 -print0 |
while IFS= read -r -d '' f; do
  jq -r --arg s "$since" 'select(.message.usage and .timestamp >= $s)
    | [.message.id, .message.usage.output_tokens,
       (.message.usage.input_tokens + (.message.usage.cache_creation_input_tokens // 0)),
       (.message.usage.cache_read_input_tokens // 0)] | @tsv' "$f" 2>/dev/null |
  sort -u -k1,1 | awk -v f="${f#$HOME/.claude/projects/}" \
    '{o+=$2; w+=$3; r+=$4} END {if (NR) printf "%6d %10d %12d %14d  %s\n", NR, o, w, r, f}'
done | sort -k3,3nr | head -15

읽는 법: 맨 앞 응답 수가 유난히 많은 줄은 반복을, 경로에 subagents가 들어간 줄은 하위 에이전트를, 응답 수에 비해 입력이 큰 줄은 맥락을 자주 새로 써 넣은 세션(잠자기·압축 뒤 등)을 뜻하는 경우가 많습니다.

한계: 한도는 토큰 수를 그대로 더한 값이 아니고 계산 방식이 공개되지 않아, 이 숫자는 어디가 많이 썼는지 비교하는 데만 쓰세요. 기록 형식은 공식 인터페이스가 아니라 업데이트로 바뀔 수 있습니다. 기록이 몇 GB면 30초쯤 걸립니다(Claude Code 2.1.317, M1 Pro에서 확인). 이 Mac의 기록만 보이고, 다른 기기나 웹에서 쓴 양은 빠집니다.

Lidnight로

Lidnight는 메뉴바에서 Claude와 Codex의 5시간·주간 한도와 지금 속도로 바닥날 예상 시각을 보여 주고, 토큰을 AI별·모델별·프로젝트별로 나눠 보여 줍니다(CSV 내보내기). 서비스 맵에서는 세션마다 띄운 하위 에이전트와 각각의 CPU·메모리를 펼쳐 볼 수 있습니다. 한도·오늘 사용량·서비스 맵은 무료, 7일·30일 통계와 한도가 빠르게 줄 때 미리 알림은 Pro입니다. 비용은 API 가격으로 계산한 추정치라 실제 구독 요금과 다르고, 반복을 대신 멈춰 주지는 않습니다. 밤새 돌리면 Claude Code 한도가 빨리 주는 이유

확인: 2026-11-11, Claude Code 2.1.317과 위 이슈 기준. 바뀌었을 수 있으니 확인하세요.

Lidnight 무료로 써 보기

Apple Silicon Mac · macOS 13 이상. 받으면 뚜껑 닫기 5회(최대 14일)까지 Pro 기능을 모두 써 볼 수 있고 결제 정보는 필요 없습니다. Pro는 한 번 결제(1대 $9.99 · 3대 $14.99), 14일 안 환불.

Homebrew: brew install whereisdw/tap/lidnight