오늘의 AI 꿀팁 · 미니교안 · 2026-08-01

클로드 토큰,
어디서 새는가

한도가 빨리 닳는 건 질문을 길게 써서가 아니에요. 새는 곳은 거의 항상 정해져 있습니다 — 스킬 · 캐시 · 대화 누적 세 군데.

⏱ 읽기 8분 📄 Anthropic 공식문서 3개 대조 🔢 인용 수치 전부 출처 표기 🧪 오늘 바로 확인할 7가지

오늘의 한 문장

입력은 내가 쓴 질문이 아니다
매 턴 통째로 다시 계산된다

여기서 오해가 시작돼요. "짧게 물어봤는데 왜 이렇게 많이 쓰지?" — 한 번의 요청에 실제로 들어가는 입력은 이렇습니다.

입력에 포함되는 것언제 들어가나
시스템 프롬프트 · 설정 파일매 턴
설치된 스킬 전부의 이름 + 설명매 턴
연결된 도구·MCP 목록과 스펙매 턴
지금까지의 대화 전체 (도구 호출 결과 포함)매 턴
내가 방금 친 질문매 턴 (보통 제일 작음)

즉 대화가 길어질수록 같은 내용을 계속 다시 읽히고 있는 것. 그래서 아껴야 할 대상은 "내 질문"이 아니라 매 턴 따라다니는 짐이에요.

새는 곳 1 · 스킬

스킬은 공짜가 아니다
(그런데 거의 공짜다)

"스킬 많이 깔면 무거워지지 않나요?" — 이 질문의 답이 Progressive disclosure(단계적 공개)예요. 클로드는 스킬을 세 단계로 나눠서 필요할 때만 읽습니다.

단계언제 로드토큰 비용내용
Level 1
메타데이터
항상 (시작할 때)스킬당 약 100토큰YAML의 namedescription
Level 2
본문
스킬이 발동될 때5,000토큰 미만SKILL.md 본문 (실제 지시사항)
Level 3+
자료·코드
필요할 때만읽기 전엔 0참고 파일·스크립트

📄 출처: Anthropic 공식문서 Agent Skills — “How Skills work” 표 원문 그대로.

💡 핵심 문장 그대로: “until a Skill is triggered, only its name and description occupy context” — 발동 전까지는 이름과 설명만 자리를 차지합니다.

그래서 실전 결론은

⭕ 괜찮은 것

스킬을 여러 개 설치하는 것 자체. 안 쓰이면 이름+설명값만 냅니다.

❌ 비싼 것

설명을 길게 쓴 스킬을 잔뜩 까는 것. Level 1은 항상 로드되니까 여기가 곧 고정비예요.

description은 최대 1,024자까지 쓸 수 있어요. 쓸 수 있다고 다 채우면, 그게 매 대화마다 따라붙습니다. “무엇을 하는지 + 언제 쓰는지” 두 가지만 짧게 쓰는 게 정답이에요.

스크립트는 왜 특히 싼가

스킬 안에 파이썬 스크립트를 넣어두면, 클로드는 그걸 실행만 하고 결과만 받습니다. 공식문서 표현으로 “the script code itself never enters context”코드 자체는 컨텍스트에 안 들어와요.

🎯 그래서 매번 똑같이 돌아가는 일은 클로드에게 코드를 새로 짜게 하지 말고 스크립트로 박아두는 게 훨씬 쌉니다. 결과 한 줄만 들어오니까요.
새는 곳 2 · 캐시

캐시를 깨는 습관

같은 앞부분을 반복해서 보낼 때, 클로드는 그걸 캐시해둘 수 있어요. 얼마나 싸지냐면 —

구분기본 입력값 대비
캐시 읽기 (재사용)0.1배 — 10분의 1
캐시 쓰기 (5분 유지, 기본)1.25배
캐시 쓰기 (1시간 유지)2배

📄 출처: Anthropic 공식문서 Prompt caching — Pricing 섹션.

한 번 써두고 두 번 이상 재사용하면 바로 이득이에요. 문제는 캐시가 깨지는 조건입니다.

⚠️ 무너지는 순서가 정해져 있다

tools → system → messages

공식문서 표현: “Changes at each level invalidate that level and all subsequent levels.”
위쪽을 건드리면 아래가 전부 같이 날아갑니다.

  • 도구 목록을 바꿈 → 도구·시스템·대화 캐시 전부 무효
  • 시스템 프롬프트를 바꿈 → 시스템·대화 캐시 무효
  • 대화만 이어감 → 앞쪽은 살아있음 ✅
🚨 가장 흔한 자해: 시스템 프롬프트에 “현재 시각”을 넣는 것. 매 요청마다 글자가 달라지니까 매번 캐시가 통째로 깨집니다. 시간이 필요하면 시스템 프롬프트가 아니라 도구로 그때그때 물어보게 하세요.

지켜야 할 순서

⭕ 앞 → 뒤

안 변하는 것부터: 도구 → 시스템 지침 → 참고자료 → 변하는 대화는 맨 뒤

❌ 흔한 실수

매번 바뀌는 값(시각·랜덤 ID·오늘 할 일)을 앞쪽에 끼워 넣기

캐시 구간은 요청당 최대 4개까지 나눌 수 있고, 캐시가 걸리려면 최소 길이가 필요해요 — Opus 5 · Fable 5 · Mythos 5 기준 512토큰입니다. 짧은 프롬프트는 애초에 캐시 대상이 아니에요.

📄 출처: Anthropic 공식문서 Prompt caching — breakpoint 수 및 모델별 최소 캐시 길이 표.

새는 곳 3 · 대화 누적

안 쓰는 과거를 잘라내기

제일 무겁게 쌓이는 건 도구 호출 결과예요. 파일 읽기, 검색 결과, 로그 — 이게 전부 대화에 남아서 매 턴 다시 들어갑니다. 10번 전에 읽은 파일 내용을 지금도 계속 다시 읽히고 있는 거죠.

그래서 컨텍스트 편집(Context editing)이 있어요. 오래된 도구 결과를 자동으로 지웁니다.

설정기본값
trigger입력 100,000토큰이 선을 넘으면 정리 시작
keep최근 3개최근 도구 호출·결과 쌍은 남김
clear_at_least없음한 번에 최소 이만큼은 지우게
exclude_tools없음이 도구 결과는 절대 안 지움
clear_tool_inputsfalse결과뿐 아니라 호출 인자까지 지울지

📄 출처: Anthropic 공식문서 Context editingclear_tool_uses_20250919 파라미터 표.

💡 지운 자리는 빈칸으로 두지 않고 “여기 지워졌음”이라는 안내 문구로 대체됩니다. 그래서 클로드가 “원래 없었던 일”로 착각하지 않아요.

도구 없이도 되는 버전

API를 안 쓰는 사람도 효과는 똑같이 낼 수 있어요.

보너스 · 기억 파일

기억은 짧을수록 이긴다

에이전트에 "기억"을 붙이면 매 세션 시작마다 그 파일이 통째로 들어갑니다. 그래서 기억 파일에는 대개 글자 수 제한이 걸려 있어요. 헤르메스 기준으로 —

파일담는 것제한
MEMORY.md환경·규칙·알게 된 것2,200자 (약 800토큰)
USER.md사용자 프로필·선호1,375자 (약 500토큰)
헤르메스 공식 문서 Persistent Memory 페이지 — MEMORY.md와 USER.md 글자 수 제한 표

🖼 실제 화면 — 헤르메스 공식문서 Persistent Memory. 두 파일과 글자 수 제한이 표로 명시돼 있어요.

제한은 불편이 아니라 설계예요. 매번 읽히는 파일이니까 짧아야 합니다. 여기에는 "다음에 또 필요할 것"만 넣고, 나머지는 필요할 때 읽는 별도 파일로 빼세요.

💰 헤르메스 비용 통제 미니교안 →

오늘 바로 확인할 7가지

한 장 요약

❌ 토큰이 새는 습관

  • 스킬 설명을 장황하게
  • 시스템 프롬프트에 현재 시각
  • 한 대화방에서 모든 주제
  • 큰 파일을 대화에 붙여넣기
  • 같은 계산을 매번 새로 시키기

⭕ 새는 걸 막는 습관

  • 설명은 “무엇 + 언제”만
  • 바뀌는 값은 도구로 조회
  • 주제별로 대화 분리
  • 파일은 파일로 두고 읽히기
  • 반복 작업은 스크립트로

기억할 한 가지만 고른다면 — 매 턴 따라다니는 짐부터 줄이세요. 내 질문을 짧게 쓰는 건 거의 효과가 없습니다.

인용 출처 — 이 교안의 모든 수치는 아래 공식문서 원문과 1:1 대조했습니다.

· Anthropic Agent Skills (progressive disclosure 3단계 표, 스킬당 ~100토큰, Level 2 5k 미만, description 최대 1,024자)
· Anthropic Prompt caching (breakpoint 최대 4개, 캐시 읽기 0.1배 / 쓰기 1.25배·1시간 2배, 최소 512토큰 — Opus 5·Fable 5·Mythos 5 기준, 무효화 계층 tools→system→messages)
· Anthropic Context editing (clear_tool_uses_20250919 기본값: trigger 100,000 입력토큰 · keep 3)
· 헤르메스 공식문서 Persistent Memory (MEMORY.md 2,200자 · USER.md 1,375자)

· 최소 캐시 길이는 모델마다 다릅니다. 본문 수치는 Opus 5 계열 기준이며, 다른 모델은 공식문서 표를 확인하세요.
· 가격·기본값은 변경될 수 있습니다. 수업일 기준 2026-08-01 확인값입니다.

← 스터디 가이드로 돌아가기 코덱스 편 보기 →