# 2026년 Claude Code 한도: 토큰 소진을 피하는 8가지 규칙

> 2026년 Claude Code Pro 및 Max 한도와 토큰 절약을 위한 8가지 규칙: /compact, Plan Mode, 간결한 CLAUDE.md, skills, 모델 선택, 캐시로 90% 절약.

Source: https://ailoot.ai/blog/ko/claude-code-token-limits-saving/
Canonical: https://ailoot.ai/blog/ko/claude-code-token-limits-saving/
Language: ko
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-129
Revision: sha256-392e4e949219c69743f2ecc0c0e4a2953c8a8c1d1435b76c738fb1f35355bbc7


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="이 섹션의 핵심">

핵심 내용

Claude Code 한도가 소진되는 이유는 구독제가 아니라 사용 방법에 있습니다. 저자가 설명한 경험에 따르면, 하루의 모든 작업을 하나의 채팅에 넣으면 점심때쯤 컨텍스트가 넘치고 토큰이 두 배 빠르게 소모됩니다. 작업마다 새 대화를 시작하고, 간결한 CLAUDE.md를 사용하고, 계획을 별도 파일에 보관하며, 필요할 때 Skills를 불러오면 100달러 Max 구독으로 하루 종일 바이브 코딩을 할 수 있습니다. 이 글에서는 실제 요금제, 토큰 절약을 위한 8가지 규칙, 그리고 일시 중지된 2026년 6월 15일 자동화 발표를 살펴봅니다.

</div>

Ailoot 참고 문서: [ailoot.ai/docs/](https://ailoot.ai/docs/).



## 2026년 Claude Code 한도는 어떻게 작동하며, 왜 한도에 도달할까요?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="이 섹션의 핵심">

핵심 내용

월 20달러인 Pro는 5시간 동안 약 45개의 메시지를 제공하고, 100달러인 Max 5x는 그 다섯 배, 200달러인 Max 20x는 스무 배를 제공합니다. 한도는 5시간 단위와 주 단위로 별도 집계됩니다. Anthropic은 2026년 5월 6일 5시간 할당량을 두 배로 늘렸습니다. 한도가 같아도 어떤 사람은 8시간 일하는 반면 다른 사람은 점심때 한도에 도달합니다. 차이는 전적으로 사용 방법에 있습니다.

</div>

2026년 5월 20일 기준, 유료 Claude Code 요금제는 다음과 같습니다.

| 요금제 | 가격 | 5시간 단위(약) | 특징 |
|----|----|----|----|
| Pro | 월 $20 | ~45개 메시지 또는 44K 토큰 | 기본 요금제, 체험용 |
| Max 5x | 월 $100 | ~225개 메시지 | 우선 이용 |
| Max 20x | 월 $200 | ~900개 메시지 | 새 모델 얼리 액세스 |
| Team Premium | 사용자당 연 $100 | 사용자당 Max 5x | SSO, 공유 프로젝트 |
| Enterprise | 계약 | 맞춤형 + 규정 준수 | RBAC, 데이터 레지던시 |

수치는 Anthropic 공식 페이지를 참고했습니다. 5시간 단위 한도 외에도 주간 한도가 있으며, 헤비 유저는 금요일쯤부터 이 한도의 영향을 받기 시작합니다.

### 5월 6일 한도 두 배 확대는 무엇이었나요?

2026년 5월 6일 **Code with Claude SF** 콘퍼런스에서 Anthropic은 [SpaceX Colossus 1과의 계약](https://www.anthropic.com/news/higher-limits-spacex)을 발표했습니다. NVIDIA 그래픽 카드 220,000개, 300 MW의 용량을 한 달 안에 가동한다는 내용입니다. 즉시 다음 조치가 적용됐습니다.

- 모든 유료 요금제의 **5시간 한도가 두 배로 늘었습니다**.
- 이전에는 피크 시간에 할당량을 줄였던 **일일 피크 시간대 제한이 없어졌습니다**.
- **API의 경우** Opus의 분당 최대 입력 토큰이 30K에서 500K로(+1500%), 최대 출력 토큰은 8K에서 80K로 늘었습니다.

또 다른 기간 한정 프로모션은 5월 13일부터 7월 13일까지 진행됩니다. Pro / Max / Team의 **주간 한도가 +50%** 늘어납니다. 7월 13일 이후에는 주간 할당량이 이전 수준으로 돌아갑니다.

### 바이브 코더는 실제로 얼마나 사용할까요?

Anthropic은 [공식 문서](https://code.claude.com/docs/en/costs)에서 참고 수치를 제공합니다.

- 개발자는 평균적으로 **하루 $13**, **월 $150-250**를 지출합니다.
- 사용자의 90%는 하루 $30 이내로 이용합니다.
- Plan Mode에서 에이전트 팀을 사용하면 일반 세션보다 토큰을 약 **7배 더 많이** 소모합니다.

컨텍스트 창의 크기는 모델에 따라 다릅니다. [Anthropic 문서](https://code.claude.com/docs/en/model-config#extended-context)에 따르면 2026년 9월 기준 Opus 4.7 이상, Sonnet 5, Fable 모델은 Pro를 포함한 모든 요금제에서 **1M 토큰** 창을 지원하며, 기본 자동 압축(auto-compact)은 약 967K에서 시작됩니다. 확장 컨텍스트를 사용하지 않는 Opus 4.6과 Sonnet 4.6은 **200K** 창을 지원하고, 200K 경계에서 압축이 시작됩니다. `/autocompact` 명령으로 직접 임계값을 설정할 수도 있습니다. 예를 들면 `/autocompact 500k`입니다. 하루 반나절의 작업을 하나의 채팅에 쌓아 두면 컨텍스트가 비대해지고 Claude가 맥락을 놓쳐 같은 파일을 다시 읽기 시작하며, 토큰이 1.5~2배 빠르게 소모됩니다.

저자가 설명한 경험상, 아래의 8가지 규칙을 따르면 200달러 구독으로 충분합니다. 이 규칙을 따르지 않으면 Max 20x도 점심때쯤 소진됩니다.

## 규칙 1. 왜 “작업 하나에 대화 하나”가 토큰을 가장 많이 절약할까요?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="이 섹션의 핵심">

핵심 내용

토큰을 절약하는 첫 번째 규칙은 하루의 작업 세 가지를 한 채팅에 쏟아붓지 않는 것입니다. 새로운 주제마다 새 창을 여세요. 컨텍스트가 반나절 분량의 대화로 가득 차면 Claude는 이미 알고 있는 내용을 다시 읽고, 관련 없는 정보를 유지하는 데 토큰을 씁니다. 채팅 하나에 작업 하나를 두면 Claude와 사용자 모두 머릿속이 명료해집니다.

</div>

이 규칙은 “채팅 5개를 병렬로 열라”는 뜻이 아닙니다. 핵심은 “이전 채팅 내용을 긁어모아 다음 작업에 사용하는 일을 하지 말라”는 것입니다.

설명된 방식은 이렇습니다. 메시지를 보낼 때마다 Claude는 새 요청뿐 아니라 이전 대화 전체도 봅니다. 아침에 랜딩 페이지를 논의하고, 이어서 이메일 캠페인으로 넘어간 뒤, 워크숍 지침을 고쳐 달라고 했다면 세 번째 요청의 컨텍스트에는 대화 기록 전체가 포함됩니다. 이미 잊어버린 랜딩 페이지를 “기억하는” 데도 토큰이 쓰입니다.

### “머리를 비우는 것”은 왜 효과가 있나요?

작업이 끝나면 바로 채팅을 닫으세요. 토큰 때문만은 아닙니다. 집중력을 되찾는 방법이기도 합니다.

작업이 정말 끝났다면 “나중에 다시 할지도 모르니”라며 채팅을 계속 열어 두지 마세요. 새 채팅을 여세요. 브랜치 이름, PR ID, 태그 등 원하는 표시자를 사용해 `claude --resume` 또는 `/resume`으로 이전 대화를 찾을 수 있습니다.

### 작업이 이틀에 걸쳐 이어지면 어떻게 해야 하나요?

작업을 정말 이어가야 한다면 채팅을 “미완성 상태로” 남겨 두지 마세요. 닫기 전에 Claude에게 인접한 채팅을 위한 프롬프트를 작성해 달라고 요청하세요(규칙 7 참조). 그러면 50K 토큰의 기록을 500토큰 프롬프트로 압축하고, 다음 날 새 채팅에서 모든 내용을 다시 쓰지 않고도 맥락을 이어갈 수 있습니다.

## 규칙 2. CLAUDE.md는 500줄이 아니라 200줄로 유지하세요

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="이 섹션의 핵심">

핵심 내용

CLAUDE.md는 모든 세션의 시작에 로드되어 끝날 때까지 컨텍스트에 남습니다. 500줄이라면 세션마다 그 500줄만큼의 토큰을 지불합니다. Anthropic은 공식적으로 200줄 이내를 권장합니다.

</div>

[CLAUDE.md는 새 세션에서 Claude가 처음 읽는 파일](https://ailoot.ai/blog/ko/claude-md-template/)입니다. 이 절에서는 특히 토큰 절약을 다룹니다.

### 적당한 줄 수는 몇 줄인가요?

| 방식 | 줄 수 | 적합한 경우 |
|----|----|----|
| Anthropic의 공식 권장 사항 | 최대 200 | 일반적인 저장소 |
| `/init`으로 자동 생성 | 다양함 | 개선보다 악화하는 경우가 더 많음 |

### 긴 CLAUDE.md는 왜 에이전트를 둔하게 만들까요?

설명은 간단합니다. `/init`은 저장소를 “모델에게 다시 설명하면서”, 모델이 이미 알고 있거나 구조만 훑어봐도 알아낼 수 있는 정보를 컨텍스트에 추가합니다. 이런 중복은 토큰을 소비하고 초점을 흐립니다.

### 밀도 규칙: 모든 단어가 행동을 바꿔야 합니다

CLAUDE.md에서 한 줄을 삭제해도 Claude의 행동이 달라지지 않는다면, 그 줄은 불필요합니다. 다음 기준을 사용하세요.

1.  CLAUDE.md를 열고 모든 문단을 살펴봅니다.
2.  스스로 묻습니다. “이걸 지우면 Claude가 실수를 하기 시작할까?”
3.  그렇지 않다면 삭제하거나 [Skill](https://ailoot.ai/blog/ko/claude-code-skills-library/)로 옮깁니다.

특정 상황에만 적용되는 규칙은 모두 skills(`.claude/skills/<name>/SKILL.md`)에 넣습니다. CLAUDE.md에는 항상 필요한 내용만 둡니다.

## 규칙 3. Claude Code 계획을 별도 파일에 보관해야 하는 이유는 무엇인가요?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="이 섹션의 핵심">

핵심 내용

계획은 읽기 전용 단계입니다. Claude는 코드를 작성하지 않고 조사하고 접근 방식을 제안합니다. 승인 후 구현 권한 모드를 명시적으로 선택합니다. 저는 프로젝트의 `plans/` 폴더에 계획을 별도 파일로 보관하고 구현을 위한 컨텍스트로 채팅에 제공합니다. 처음 방향이 잘못되어 다시 작업하는, 가장 큰 비용을 아낄 수 있습니다.

</div>

Plan Mode는 `Shift+Tab`으로 활성화하는 Claude Code 모드입니다. 이 모드에서는 구현 전에 코드를 살펴보고 파일을 읽으며 질문합니다. 아래 방식에서는 저장소 편집을 분리하세요. 제안 계획을 검토해 직접 프로젝트 `plans/`에 저장하거나 Plan Mode를 명시적으로 벗어나 계획 파일 쓰기를 승인한 뒤 새 채팅을 시작하세요.

### 파일에 있는 계획이 Claude의 머릿속 계획보다 나은 이유는 무엇인가요?

모든 프로젝트에 `plans/` 폴더가 있습니다. 작업을 시작할 때는 다음과 같이 합니다.

1.  Plan Mode에서 Claude에게 조사하고 접근 방식을 제안해 달라고 합니다.
2.  계획을 검토하고 직접 `plans/YYYY-MM-DD-task-name.md`에 저장하거나 Plan Mode를 벗어나 파일 쓰기를 승인하세요. 채팅 종료 전에 저장 내용을 검증하세요.
3.  채팅을 닫습니다.
4.  새 채팅에서 “`plans/YYYY-MM-DD-...md`를 읽고 1단계를 구현해”라고 말합니다.

얻는 효과는 다음과 같습니다.

- **계획이 고정됩니다**. Claude가 한 시간 전에 결정한 내용을 “잊지” 않습니다.
- **계획을 직접 편집할 수 있습니다**. 5단계를 보고 3단계가 불필요하다고 판단하면 삭제하고 진행할 수 있습니다.
- **계획은 재시작 후에도 남습니다**. 다음 날 돌아와 파일을 열고 이어서 진행할 수 있습니다.
- **에이전트에게 순차적으로 넘길 수 있습니다**. 한 채팅에서 계획을 작성하고, 다른 채팅에서 구현하고, 세 번째 채팅에서 검토합니다.

### Plan Mode는 캐시를 깨뜨리지 않습니다

중요한 점은 Plan Mode가 대화 캐시(메시지)만 무효화하는 반면 시스템 프롬프트와 프로젝트 컨텍스트(CLAUDE.md)는 그대로 유지된다는 것입니다. 즉 Plan Mode로 전환했다 돌아와도 토큰 비용은 거의 없습니다. 반면 `/model`로 모델을 바꾸면 입력 가격의 90%에 적용되는 캐시가 깨지고 전체 접두부를 다시 계산해야 합니다.

컨텍스트 엔지니어링에는 5시간 뒤 사라질 채팅이 아니라 오래 보존될 곳에 계획을 두는 것도 포함됩니다.

## 규칙 4. Skills는 세션 시작이 아니라 트리거가 발생할 때 로드됩니다

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="이 섹션의 핵심">

핵심 내용

[Claude Code Skills](https://ailoot.ai/blog/ko/claude-code-skills-library/)는 SKILL.md 파일이 들어 있는 폴더로, Claude가 작업과 관련 있을 때만 확인합니다. CLAUDE.md는 항상 로드되지만 skill은 설명이 요청과 일치할 때만 로드됩니다. 따라서 프로젝트에 skills가 수십 개 있어도 컨텍스트에 부담을 주지 않습니다. 시작 프롬프트에는 각 skill의 이름과 설명을 담은 짧은 헤더만 포함됩니다.

</div>

Skills는 세 단계로 로드됩니다.

1.  **메타데이터는 항상 로드**: 세션이 시작되면 Claude는 각 skill의 `name`과 `description`만 봅니다. 예산: skill당 ~100토큰.
2.  **트리거 발생 시 지침 로드**: 사용자가 관련된 내용을 말하면 Claude가 SKILL.md 본문을 로드합니다. 예산: 최대 5000토큰.
3.  **요청 시 리소스 로드**: 함께 제공된 파일(예제, 템플릿)은 모델이 직접 필요로 할 때만 가져옵니다.

<figure>
<blockquote>
<p>Claude가 skill이 관련 있다고 판단할 때만 전체 지침이 로드됩니다(5k 토큰 미만). 보조 스크립트와 파일은 명시적으로 필요할 때만 로드됩니다. 따라서 관련 없는 작업의 성능에 영향을 주지 않고도 수십 개의 skills를 설치해 둘 수 있습니다.</p>
</blockquote>
<figcaption>— Anthropic Skills 문서, https://code.claude.com/docs/en/skills</figcaption>
</figure>

### 토큰 사용 방식은 어떻게 달라질까요?

설명된 예시에서는 교육용 지침 작성 규칙, 메일 발송 규칙, 코드 검토 규칙을 모두 CLAUDE.md에 넣었습니다. 파일은 500줄까지 늘었고, 대화가 랜딩 페이지에 관한 것이어도 매 세션 시작 때 500줄 전체의 비용을 냈습니다.

이 예시에서는 CLAUDE.md에 탐색 정보와 기본 원칙 200줄을 넣습니다. 4개 규칙 모음은 skills에 둡니다.

```
.claude/skills/
├── write-tutorial/SKILL.md         # trigger: “write a guide”
├── deploy-checklist/SKILL.md       # trigger: “check before publishing”
├── send-broadcast/SKILL.md         # trigger: “send a mailing”
└── debug-payment-webhook/SKILL.md  # trigger: “check the payment”
```

Claude는 시작할 때 헤더만 봅니다. 400토큰입니다. “가이드 작성해”라고 하면 해당 SKILL.md를 불러와 지침을 따릅니다. “메일 발송해”라고 하면 다른 skill을 불러옵니다.

[Anthropic 공식 문서](https://code.claude.com/docs/en/skills)의 skill 작성 규칙에서 인용합니다.

<figure>
<blockquote>
<p>skill이 로드되면 이후 턴에서도 그 내용이 컨텍스트에 남으므로 모든 줄이 반복적으로 토큰 비용을 발생시킵니다. 해야 할 일을 쓰고, 방법과 이유를 되풀이하지 마세요.</p>
</blockquote>
<figcaption>— Anthropic Skills 문서, https://code.claude.com/docs/en/skills</figcaption>
</figure>

### 의심스러운 skill은 설치하지 마세요

Skills는 파일과 API 키에 직접 접근할 수 있는 실행 가능한 지침입니다. 다른 사람의 모음을 설치하기 전에 모든 `SKILL.md`를 직접 열어 읽습니다. 안에 외부 URL로 연결되는 `bash:` 블록이 있으면 경고 신호이므로 설치하지 않습니다.

## 규칙 5. 언제 주 세션 대신 하위 에이전트에게 작업을 맡겨야 할까요?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="이 섹션의 핵심">

핵심 내용

하위 에이전트는 자체 컨텍스트 창, 시스템 프롬프트, 도구 모음을 갖춘 별도의 Claude 세션입니다. 최종 결과만 상위 세션으로 돌아옵니다. 파일 50개를 읽고 로그 10K줄을 분석하면서 생기는 모든 “잡음”은 하위 에이전트의 컨텍스트에 남습니다. 주 세션이 탐색 검색으로 비대해지는 유형의 작업에서는 토큰을 최대 90% 절약할 수 있습니다.

</div>

[공식 문서](https://code.claude.com/docs/en/costs)에서 발췌했습니다.

<figure>
<blockquote>
<p>출력이 많은 작업은 하위 에이전트에게 맡기세요. 상세한 출력은 그들의 컨텍스트에 남고 결과만 주 대화로 돌아옵니다.</p>
</blockquote>
<figcaption>— Claude Code 문서, https://code.claude.com/docs/en/costs</figcaption>
</figure>

### 어떤 작업을 하위 에이전트에게 맡길 수 있나요?

- **대규모 코드베이스 검색.** 하위 에이전트가 파일 30개를 읽고 “관련 함수는 `src/lib/payment/cloudpayments.ts:142`에 있습니다”라고 알려줍니다. 주 컨텍스트에서 파일 30개의 내용을 볼 필요가 없습니다.
- **테스트 실행과 로그 분석.** 하위 에이전트가 `npm test`를 실행해 출력 200줄을 확인한 뒤 “X, Y, Z에서 테스트 3개가 이런 이유로 실패했습니다”라고 알려줍니다.
- **여러 파일에 걸친 리팩터링.** 파일마다 하위 에이전트 하나씩 병렬로 맡깁니다.
- **가이드의 링크 확인.** 하위 에이전트가 WebFetch로 URL 30개를 방문해 “링크 5개가 404를 반환합니다”라고 알려줍니다.

2026년 5월, Anthropic은 [Multi-Agent Orchestration](https://claude.com/blog/code-w-claude-sf-2026-sf)을 정식 기능으로 발표했습니다. 이전에는 SDK를 사용해 코드에서만 하위 에이전트를 실행할 수 있었지만, 이제 Claude Code에서 슬래시 명령으로 직접 실행할 수 있습니다.

### 하위 에이전트가 제대로 작동하지 않는 경우

따라서 하위 에이전트를 반나절 동안 점검 없이 두지 않습니다. 병렬로 더 많이 맡길수록 중간 결과를 더 자주 확인해야 합니다. 큰 작업에서는 각 하위 에이전트에 별도로 Plan Mode를 활성화합니다.



## 규칙 6. 작업에 맞는 Claude 모델(Opus / Sonnet / Haiku)은 어떻게 고를까요?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="이 섹션의 핵심">

핵심 내용

Opus 4.7, Sonnet 4.6, Haiku 4.5의 가격은 대략 5-15배 차이가 납니다. Opus는 Haiku보다 10배 비싸지만, 작업의 90%에서 10배 더 똑똑한 것은 아닙니다. 규칙은 간단합니다. 심층적인 아키텍처 결정이나 복잡한 리팩터링이 필요할 때만 Opus를 사용하세요. 일반 작업의 기본값은 Sonnet입니다. 간단한 검색, 분류, 조회에는 Haiku를 사용합니다.

</div>

API 가격(토큰 100만 개당):

| 모델 | 입력 | 출력 | 캐시된 입력 |
|------------|-------|--------|--------------|
| Opus 4.7 | $5 | $25 | $0.50 |
| Sonnet 4.6 | $3 | $15 | $0.30 |
| Haiku 4.5 | $1 | $5 | $0.10 |

출처: [Anthropic 공식 페이지](https://platform.claude.com/docs/en/about-claude/pricing). 구독제에서는 가격이 표시되지 않지만 비율은 같습니다. Opus 4.7에는 한 가지 유의점이 있습니다. Opus 4.6과 비교하면 새로운 토크나이저가 같은 텍스트에 최대 **+35% 더 많은 토큰**을 사용할 수 있습니다. 토큰당 가격이 오른 것은 아니지만 요청당 실질 비용은 늘었습니다. 생각 없이 모든 작업을 Opus로 처리하면 Sonnet이나 Haiku로 작업의 절반을 처리할 때보다 한도가 5배 더 빨리 소진됩니다.

### 모델 선택 예시

| 작업 | 모델 | 이유 |
|----|----|----|
| 아키텍처 결정, 새 제품 섹션 | Opus 4.7 | 깊이 있는 사고가 필요함 |
| 명확한 명세에 맞춰 컴포넌트 작성 | Sonnet 4.6 | 기본값 |
| 오타 수정, 변수 이름 변경 | Sonnet 4.6 또는 Haiku 4.5 | 간단한 수정 |
| 설명을 바탕으로 파일 찾기, 파일 라우팅 | Haiku 4.5 | 저렴함 |
| 텍스트 번역, 분류, 요약 | Haiku 4.5 | 간단한 모델로 처리 가능 |
| 직접 작성한 코드 검토 | Sonnet 4.6 | 기본값 |
| 여러 단계의 추론이 필요한 복잡한 버그 조사 | Opus 4.7 | 추론의 연쇄가 필요함 |

`/model` 명령으로 모델을 바꿉니다. **하지만** 모델을 바꾸면 캐시가 무효화됩니다. 세션 중간에 Sonnet에서 Opus로 전환하면 다음 요청에서 전체 접두부를 캐시 가격이 아닌 일반 입력 가격으로 처음부터 다시 계산합니다. 따라서 모델을 계속 바꾸기보다 작업 시작 시 선택하는 편이 좋습니다.

### /effort: 덜 공격적인 설정

2026년 4월, [Anthropic은 `/effort`를 출시했습니다](https://code.claude.com/docs/en/changelog). 추론 깊이를 minimal / low / medium / high / xhigh의 5단계로 설정할 수 있습니다. Opus 4.7을 사용하는 Claude Code의 기본값은 xhigh입니다.

제가 사용하는 방식은 다음과 같습니다.

- 분류, 데이터 추출, 짧은 요약에는 `/effort low`를 사용합니다. 깊은 추론이 필요하지 않은 작업 유형에서 30-70%를 절약합니다.
- 간단한 코딩 작업에는 `/effort medium`을 사용합니다.
- 복잡한 아키텍처 작업에서는 xhigh를 그대로 둡니다.

`/effort`는 모델이 아니라 추론의 깊이를 바꿉니다. 캐시는 유지됩니다.

## 규칙 7. `/compact` 대신 새 채팅에 프롬프트를 전달하세요

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="이 섹션의 핵심">

핵심 내용

`/compact`는 채팅 기록을 요약으로 압축하지만 대화 캐시를 깨뜨리고 요약 자체에도 토큰을 씁니다. 저는 더 효과적인 방법을 씁니다. Claude에게 작업과 컨텍스트를 담은 새 채팅용 프롬프트를 작성하게 하고, 그 프롬프트를 새 채팅에 복사한 다음 따뜻한 접두부로 시작합니다. 이렇게 하면 50K 토큰의 기록을 500토큰 프롬프트로 압축할 수 있습니다.

</div>

`/compact`는 기록을 요약으로 대체하는 Claude Code 공식 명령입니다. 캐시가 살아 있을 때(구독제 TTL은 1시간) 마지막 메시지 직후에 실행하면 요약이 캐시되고 표준 가격의 10%로 읽힙니다. 한 시간이 지난 뒤 실행하면 캐시가 식어 전체 가격을 지불합니다.

`/compact`를 사용자 지정할 수 있습니다.

```bash
/compact Focus on code samples and API usage
```

또는 CLAUDE.md에서 기본 요약 초점을 지정할 수 있습니다.

```markdown
# Compact instructions
When you are using compact, please focus on test output and code changes
```

하지만 저는 대개 다르게 합니다.

### 인접한 채팅에 프롬프트 전달하기: 예시

단계는 다음과 같습니다.

1.  현재 채팅에서 컨텍스트가 50%를 넘은 것을 보면 이렇게 말합니다. **“의미를 잃지 않고 작업을 이어갈 인접한 채팅용 프롬프트를 작성해 줘. 지금까지 작업한 내용, 완료된 내용, 남은 일, 핵심 파일과 상수를 포함해.”**
2.  Claude가 300-800토큰 프롬프트를 제공합니다.
3.  `/clear`로 현재 채팅을 닫거나 새 채팅을 엽니다.
4.  프롬프트를 붙여넣고 CLAUDE.md와 프로젝트 컨텍스트는 따뜻하게 로드된 상태로, 대화 기억은 깨끗한 새 채팅에서 시작합니다.

`/compact`와 비교해 얻는 점은 다음과 같습니다.

- **새 채팅에 무엇을 넣을지 제어할 수 있습니다.** `/compact`는 자체 이해에 따라 요약하지만, 새 채팅을 시작하기 전에 프롬프트를 직접 편집할 수 있습니다.
- **프롬프트를 `plans/` 파일에 저장**하고 다음 날 이어갈 수 있습니다.
- **새 채팅은 깨끗한 대화 캐시로 시작**하며, 그 뒤에는 캐시된 입력 가격으로 작업합니다.

### `/compact`가 더 나은 경우는 언제인가요?

- Plan Mode에 있으며 현재 계획을 잃고 싶지 않을 때.
- 작업이 일관되고 컨텍스트가 통일되어 있을 때(예: 긴 문서 번역).
- Claude의 답변 **직후** `/compact`를 실행할 때. 요약이 따뜻한 캐시에 들어가 10% 비용만 들기 때문입니다.

### `/clear`: 최후의 수단

`/clear`는 프로젝트 컨텍스트를 포함해 모든 것을 지웁니다. 완전히 다른 주제로 전환하면서 이전 내용을 전혀 남기고 싶지 않을 때만 사용합니다. `/clear` 뒤에는 다음 요청에서 CLAUDE.md를 다시 로드하는 전체 비용을 지불합니다.

## 규칙 8. Claude Code 캐시를 무효화하는 것은 무엇이고, 왜 비용이 드나요?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="이 섹션의 핵심">

핵심 내용

Claude Code는 캐싱을 통해 입력 가격을 90% 할인합니다. 캐시된 토큰은 일반 입력 가격의 10%입니다. 구독제에서 캐시는 1시간 동안 유지되며(API의 기본값은 5분), 시스템 프롬프트나 프로젝트 컨텍스트를 조금이라도 수정하면 캐시가 깨져 전체 접두부를 다시 계산해야 합니다. 이 지식은 매일 도움이 됩니다. 짧은 요청에서 갑자기 엄청난 양의 토큰을 사용했다면, 그 사이에 캐시가 깨진 것입니다.

</div>

구독제의 캐시 TTL은 **1시간**이며, 접근할 때마다 연장됩니다. API의 기본값은 5분입니다. 따라서 40분 뒤에 다시 작업하면 캐시가 살아 있어 다음 요청의 입력 비용은 매우 낮습니다. 1시간 뒤에는 캐시가 만료되어 전체 가격을 지불합니다.

<figure>
<blockquote>
<p>압축에 걸리는 시간의 대부분은 캐시 미스가 아니라 요약 생성에 쓰입니다.</p>
</blockquote>
<figcaption>— Claude Code 문서, https://code.claude.com/docs/en/prompt-caching</figcaption>
</figure>

### 캐시를 깨뜨리는 항목(작업 중간에는 피하세요)

1.  **`/model`: 세션 중간에 모델 변경.** 모델마다 캐시가 따로 있습니다. `/model opus` 뒤의 요청은 Opus용 전체 접두부를 처음부터 다시 계산합니다.
2.  **`opusplan` 설정으로 Plan Mode 활성화.** 이 모드에서는 Plan Mode가 Opus, 일반 모드가 Sonnet입니다. Shift+Tab을 누를 때마다 모델이 바뀌어 캐시가 무효화됩니다.
3.  **MCP 서버 연결 / 해제.** 일시적인 오류 뒤의 자동 재연결도 포함됩니다. MCP 서버가 불안정하면 비용을 두 번 냅니다.
4.  **기본 이름으로 지정한 거부 규칙**(`Bash`, `WebFetch`): 시스템 프롬프트의 도구 정의를 바꿉니다.
5.  **`/compact`**: 대화 계층을 무효화합니다(설계상 의도된 동작).
6.  **Claude Code를 새 버전으로 업그레이드**: 새 버전은 새로운 시스템 프롬프트와 캐시를 의미합니다.

### 캐시를 깨뜨리지 않는 항목은 무엇인가요?

- 저장소의 파일 수정(필요할 때 읽습니다).
- 세션 중간에 CLAUDE.md 수정(단, 재시작 전까지 변경 사항은 적용되지 않습니다. 규칙 2 참조).
- 출력 스타일 변경.
- 권한 모드 변경(`opusplan`이 관련되지 않은 경우).
- Skills / 명령 호출(대화 계층에 추가됨).
- `/recap`(캐시 무효화 없이 요약하는 새 명령).
- `/rewind`(이미 따뜻해진 접두부로 돌아가기).
- 하위 에이전트 실행(상위 세션의 캐시에는 영향이 없음).

### 캐시를 유리하게 활용하는 방법

- 이유 없이 `/model`을 바꾸지 마세요. 작업 시작 시 모델을 선택하세요.
- “혹시 모르니” MCP 서버 10개를 켜지 마세요. 각 서버는 시스템 프롬프트에 내용을 추가하고 재연결 시 캐시를 깨뜨립니다.
- 작업 사이에 CLAUDE.md를 수정하지 마세요. 변경 사항을 한 번에 모은 뒤 다시 시작하세요.
- 컨텍스트를 비우려는 게 아니라 요약만 확인하려는 경우 `/compact` 대신 `/recap`을 사용하세요.

## 6월 15일 자동화 크레딧 제안은 어떻게 됐나요?

대화형과 프로그램형 구독 풀 분리 제안은 일시 중지됐습니다. [Anthropic 지원 업데이트](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan)는 Agent SDK, `claude -p`, 타사 앱이 여전히 구독 한도를 쓸 수 있다고 설명합니다. 폐기된 제안의 크레딧 금액을 필수 두 번째 청구로 더하지 마세요.

10월에 적격 Max·Team에 도입된 별도 월 API 크레딧은 연결된 Console 조직의 포함 허용량입니다. 대화형 한도를 대체하지 않습니다. [현재 API 크레딧 안내](https://support.claude.com/en/articles/17154008-monthly-api-credits-for-max-and-team-plans)는 구독 로그인과 API 키 작업을 구분하며 제외 실행 화면도 설명합니다.

예약 작업 예산 전 인증 방식, 실행 화면, 모델, 실제 사용량을 기록하세요. `claude -p` 명령만으로 어느 잔액을 쓰는지 알 수 없습니다. 추가 유료 API 사용은 조직 결제 설정에 달려 있습니다. 현재 설명과 계산기는 [Claude Code 자동화 결제](https://ailoot.ai/blog/ko/claude-code-pricing-automation-billing/)를 보세요.

## Claude Code를 사용하는 바이브 코더의 하루

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="이 섹션의 핵심">

핵심 내용

8가지 규칙을 모두 함께 적용하면 하루 8-10시간 바이브 코딩에 100달러 Max 5x 구독으로 충분합니다. 채팅마다 작업 하나를 맡기고, CLAUDE.md를 간결하게 유지하고, 계획을 파일에 저장하고, 필요할 때 skills를 불러오고, 무거운 작업은 하위 에이전트에게 맡기고, 작업에 맞춰 모델을 고르며, 작업 전환 때 프롬프트로 인계하고, 세션 중간에 /model이나 MCP를 바꾸지 않으므로 한도가 소진되지 않습니다.

</div>

하루의 예시는 다음과 같습니다.

1.  **9:00.** 작업 #1을 엽니다. 이메일 템플릿 수정입니다. 새 채팅을 열고 Plan Mode에서 Claude에게 조사해 달라고 합니다. 계획은 3분 만에 준비되고, 자동 수락으로 전환해 수정하는 데 10분이 걸립니다. 채팅을 닫습니다.
2.  **9:30.** 작업 #2는 교육용 가이드 작성입니다. 새 채팅을 열면 가이드 작성 skill이 트리거됩니다. 방법론 4000토큰을 불러옵니다. 작업을 진행하고 40분 만에 가이드가 완성됩니다. 끝입니다.
3.  **11:00.** 작업 #3은 복잡한 아키텍처 문제입니다. `/model opus`, Plan Mode, 논의를 진행합니다. 계획을 검토해 직접 `plans/2026-05-20-...md`에 저장하거나 Plan Mode를 벗어나 쓰기를 승인하세요. 파일을 검증한 뒤 채팅을 닫습니다.
4.  **12:00.** 새 채팅에서 “`plans/2026-05-20-...md`를 읽고 1단계를 구현해”라고 말합니다. 하위 에이전트 6개가 파일마다 하나씩 병렬로 작업합니다. 45분 만에 1단계가 완성됩니다. 채팅을 닫습니다.
5.  **14:00.** 작업 #4는 랜딩 페이지 수정입니다. `/model sonnet`으로 설정합니다. 새 채팅에서 계획과 구현에 30분을 씁니다. 채팅을 닫습니다.
6.  **15:00.** 작업 #5는 프로덕션 디버깅입니다. `/model opus`, Plan Mode로 시작합니다. 깊이 있는 분석이 필요합니다. 한 시간 논의한 뒤, 확인한 원인과 제안된 수정 사항을 담아 인접한 채팅에서 이어갈 프롬프트를 작성해 달라고 합니다. 새 채팅에 복사해 20분 만에 구현합니다.

하루가 끝나면 작업 6개, 닫은 채팅 8개, `/compact`는 한 번도 사용하지 않았습니다. 한도는 40-60% 사용됩니다. 충분합니다.

다음과 같은 사람은 한도를 소진합니다.

- 컨텍스트를 이미 50% 사용한 채팅에 작업 전체를 쌓아 둡니다.
- “언젠가 쓸지도 모르니”라며 CLAUDE.md를 600줄로 유지합니다.
- 간단한 수정에도 `/model opus`로 바꿉니다.
- “혹시 모르니” MCP 서버 8개를 켭니다.
- 하위 에이전트를 전혀 사용하지 않고 모든 것을 주 대화에 끌어옵니다.

프로젝트 파일에 두 번째 두뇌를 구축하고 Claude를 팀의 엔지니어처럼 대하는 사람은 한도를 소진하지 않습니다. 명확한 작업을 주고 모든 것을 하나의 대화에 쏟아붓지 않으며, 작업마다 다른 도구를 사용합니다.

<div class="section" role="doc-bibliography" aria-label="출처">

### 출처

- [Anthropic - 한도 상향 및 SpaceX 계약(2026년 5월 6일)](https://www.anthropic.com/news/higher-limits-spacex)
- [Claude Code 문서 - 비용 최적화](https://code.claude.com/docs/en/costs)
- [Claude Code 문서 - 모델별 컨텍스트 창 및 자동 압축](https://code.claude.com/docs/en/model-config#extended-context)
- [Claude Code 문서 - 프롬프트 캐싱](https://code.claude.com/docs/en/prompt-caching)
- [Claude Code 문서 - Skills](https://code.claude.com/docs/en/skills)
- [Claude Code 문서 - 변경 로그](https://code.claude.com/docs/en/changelog)
- [Anthropic API 가격](https://platform.claude.com/docs/en/about-claude/pricing)
- [Anthropic Code with Claude SF 2026 - 기조연설 요약](https://claude.com/blog/code-w-claude-sf-2026-sf)

</div>

[ailoot.ai](https://ailoot.ai/)에서 Ailoot을 더 살펴볼 수 있습니다.

## 2026년 Claude Code 한도: 토큰 소진을 피하는 8가지 규칙: 자주 묻는 질문

### Plan Mode에서 계획을 어떻게 저장하나요?

제안 계획을 검토해 직접 프로젝트 `plans/` 파일로 복사하거나 Plan Mode를 벗어나 쓰기를 명시적으로 승인하세요. 다음 채팅이 실제 파일을 읽을 수 있게 종료 전에 내용을 확인하세요.

### 새 채팅으로 옮기기 전 인계에는 무엇을 넣나요?

작업, 완료 내용, 남은 일, 주요 파일, 결정을 포함하세요. 승인 계획이나 인계를 먼저 저장하고 새 채팅에 경로를 주세요. 필요한 정보를 보존할 때만 짧은 인계가 유용합니다.


## Ailoot · 회사와 그 프로젝트 포트폴리오

Ailoot는 축적된 운영 경험, 폭넓은 고객 기반, 안정적인 서비스, 지속적인 KPI 관리를 바탕으로 합니다.

회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.

Ailoot는 이러한 운영 경험을 고객의 제품, 에이전트, 애플리케이션, 자동화에서 AI 기능을 이용할 수 있는 API 접근에 활용합니다.
