Claude Code 토큰 막힘, 세션 위생 4가지로 끊기

한도가 5월 6일 두 배로 풀렸어요. 그런데도 Claude Code 세션이 한 시간 만에 또 막혔다면, 원인은 한도가 아니라 세션을 쓰는 방식이에요. context 누적·반복 prompt·끊긴 세션 재시작 — 이 셋이 합쳐지면 늘어난 한도도 30분 만에 닿습니다. Plan mode, 세 슬래시(/clear·/compact·/context), ! prefix, /resume. 이 네 가지로 토큰 새는 길목을 막아요.

한도가 풀려도 토큰은 여전히 새어 나간다

5월 6일 Anthropic이 Claude Code 5시간 한도를 Pro·Max·Team·Enterprise 모든 플랜에서 두 배로 올렸고, Opus API rate limit도 Tier-I 기준 input 16배 폭으로 풀렸어요. ([Anthropic 공식 발표](https://www.anthropic.com/news/higher-limits-spacex))

그런데도 한도 막힘 호소는 줄지 않아요. 이유 세 가지가 동시에 작동해요.

첫째, context 누적. Claude Code 한 요청은 system prompt + 누적 대화 + 읽힌 파일 + tool-use 토큰을 함께 보내요. "edit this file" 한 줄 요청도 full context가 깔리면 한 번에 50,000~150,000 토큰을 씁니다.

둘째, weekly cap 미상향. 5월 6일 발표는 5시간 rolling limit과 Opus API만 손댔어요. 2025년 8월 이후 추가된 weekly cap은 그대로입니다.

셋째, prompt cache 5분 수명. 잠깐 자리를 비웠다 돌아오면 캐시가 만료되어 재계산 비용이 청구돼요.

Anthropic도 3월에 인정했어요.

"

"people are hitting usage limits in Claude Code way faster than expected. We're actively investigating... it's the top priority for the team."

([The Register 보도, 2026-03-31](https://www.theregister.com/2026/03/31/anthropic_claude_code_limits/))

한도를 늘려도 쓰는 방식이 바뀌지 않으면 같은 패턴이 반복돼요. 그래서 네 가지 도구입니다.

Plan mode — Shift+Tab으로 토큰 새는 첫 길목 막기

Plan mode는 Claude가 읽기만 하고 편집은 안 하는 상태예요. 변경 계획을 작성해서 보여준 뒤, 승인받기 전까지 디스크에 손을 안 댑니다.

"

"Plan mode tells Claude to research and propose changes without making them. Claude reads files, runs shell commands to explore, and writes a plan, but does not edit your source."

([Claude Code 공식 docs — Permission modes](https://code.claude.com/docs/en/permission-modes))

진입 방법:

• Shift+Tab × 2 — 사이클 default → acceptEdits → plan 진입. 상태 표시줄에 "plan mode on" 뜸
• `/plan` 슬래시 — 다음 단일 prompt만 plan mode로

토큰을 잡는 지점은 두 곳이에요. (1) Claude가 잘못된 방향으로 가서 30분어치 토큰을 갈아 넣는 일이 사라집니다. (2) 사용자가 계획을 먼저 검토하니 "아 이게 아니네, 다시 해" 재작업이 줄어요. 권장 사용 기준은 3개 파일 이상 / 스키마 변경 / 보안 민감 코드. 깐 지 1~2주 사용자라면 "첫 한 달은 plan mode default"가 안전합니다.

/clear vs /compact vs /context — 세 슬래시의 분기 룰

세션이 길어질수록 context가 토큰 대부분을 차지해요. 이 세 슬래시는 그 context를 다루는 도구예요.

/clear는 hard reset이에요. 코드베이스 이해·맥락이 같이 사라지니 다음 작업이 완전히 다를 때만 쓰세요.

/compact는 본문은 사라지지만 결정·방향·제약은 요약본에 보존돼요. mid-flow 이어갈 때 default 선택. ([Medium — Clear vs Compact 분석](https://medium.com/@nustianrwp/managing-your-context-window-clear-vs-compact-in-claude-code-8b00ae2ed91b))

/context는 진단 도구예요. system prompt·memory file·skill·대화 기록 어느 쪽으로 토큰이 새는지 한 번에 보여줍니다. 위 둘을 언제 써야 할지 판단할 근거를 만들어주는 슬래시예요.

실전 룰: 30~60분에 한 번 `/context` 점검 → 50% 넘으면 `/compact` → 작업 전환 시 `/clear`.

! prefix와 /resume — 셸 우회와 끊긴 세션 복원

마지막 두 도구는 묶어서 봐요. 토큰을 처음부터 안 쓰는 길과 끊긴 세션을 재사용하는 길 한 쌍입니다.

`!` prefix — 셸 명령은 LLM 우회

prompt 앞에 !를 붙이면 그 줄은 Claude를 거치지 않고 셸로 직접 들어가요. 출력은 conversation context에 자동으로 들어가지만, 명령 해석·계획 단계의 토큰이 0이에요.

! npm test
! git status
! ls -la

테스트 결과 확인 흐름에서 흔한 실수가 셸을 따로 열어 돌리고 stdout을 복붙해서 던지는 거예요. 토큰이 두세 번 청구됩니다. ! npm test 한 줄이면 LLM 우회 + 결과 자동 캡처 + Ctrl+B background까지 한 번에 처리돼요. ([Claude Code 공식 docs — Interactive mode](https://code.claude.com/docs/en/interactive-mode))

`/resume` — 끊긴 세션은 버리지 말고 이어 붙이기

토큰 막혀서 강제 종료된 세션, 어제 작업하다 멈춘 세션. 새로 열어 처음부터 설명하면 그 설명이 다시 5만 토큰을 먹어요. 복원 방법 세 가지.

• claude --continue — 현재 디렉터리의 가장 최근 세션 자동 복원. ID 기억 불필요
• claude --resume — 인터랙티브 picker. 요약·메시지 수·git 브랜치·timestamp 보고 고름
• 활성 세션 안 `/resume` — exit 없이 다른 세션으로 점프

복원되는 것은 메시지 history 전체 + tool 결과 + 마지막 흐름이에요. ([공식 docs — Common workflows](https://code.claude.com/docs/en/common-workflows)) 끊기는 게 일상이라면 alias cc='claude --continue' 한 줄을 걸어두세요. 다음 세션 시작 비용이 0에 수렴합니다.

다음 세션, 처음 할 일

복잡한 룰 다 외울 필요 없어요. 다음 Claude Code 세션 시작에 한 가지만 바꿔보세요. Shift+Tab × 2로 plan mode 진입. 작업 끝날 즈음 /context로 토큰 점검. 50% 넘으면 /compact. 작업이 바뀌면 /clear. 1주만 돌려보면 한도 닿는 빈도가 눈에 띄게 줄어요. weekly cap이 풀리기 전까지 같은 한도 안에서 더 오래 일하는 법은 이 네 가지가 전부입니다.

자주 묻는 질문

5월 6일에 한도가 두 배 됐는데도 세션 위생이 필요한가요?

네. 5시간 limit만 두 배가 됐고 weekly cap은 그대로예요. context 누적·prompt cache 5분 수명이 남아서 늘어난 한도도 30분 만에 닿을 수 있어요.

Plan mode와 acceptEdits mode는 어떻게 다른가요?

plan은 읽기만 — 디스크 손도 안 댑니다. acceptEdits는 파일 편집을 자동 승인해요. 계획부터 보고 싶으면 plan, 적용 흐름이면 acceptEdits.

/clear와 /compact 중 어느 쪽을 default로 써야 하나요?

같은 작업 흐름이 이어지면 /compact, 작업이 바뀌면 /clear. 30~50분마다 /context로 토큰 비중을 보고 결정하는 게 안전한 default 룰이에요.

! prefix로 실행한 명령 결과도 토큰을 차지하나요?

출력은 context에 들어가서 토큰을 씁니다. 다만 명령 해석·도구 호출 결정 단계 토큰이 빠져서 같은 작업 비교 시 1/3~1/5 비용이에요.

/resume과 claude --continue 중 어느 쪽이 안전한가요?

최근 세션 그대로면 --continue가 빠릅니다. 여러 세션 중 고르려면 --resume picker로 git branch·timestamp 보고 고르세요. 활성 세션 점프는 /resume이에요.

weekly limit은 5월 6일 발표에 포함됐나요?

아니요. 5시간 rolling limit과 Opus API rate limit만 손댔어요. 2025년 8월 이후 추가된 weekly cap은 그대로니 헤비 사용자는 별도 관리가 필요합니다.

작성: Bruce Choe · agenticworkflows.club