Claude Code 토큰 절약 5가지. 솔직 회고

EDIBLOG · Phase 2-1 · 3달 운영 회고

Claude Code 토큰 절약 5가지. 솔직 회고

안녕하세요, 에디입니다. 저는 3달 운영하면서 토큰 절약 5가지를 박았어요. 솔직히 말씀드리면 5가지 다 한 번씩 망해본 다음 자리잡았어요. CLAUDE.md memory 인덱스 글에서 약속한 첫 번째 deep dive 예요.

/compact agent 분리 /clear CLAUDE.md split Skills 3개

01 · COMPACT/compact — 알람 뜨면 일단 누르고, 결과 보고 판단

결론. 저는 /compact 가 컨텍스트 alert 떴을 때 발동하는 걸 알았어요. 저는 대화를 요약 압축해서 토큰 자리를 비우는 거라고 봐요. 100% 보존은 아니에요.

3달 후 제 체감

"간혹가다 잃는 게 있어요. 중요한 정보가 없어지면 엉뚱한 결과가 나올 때가 있더라고요."

저의 패턴은 — alert 보면 일단 /compact, 그 다음 답변 한 번 시키고 이상하면 그땐 /clear 후 새로 시작해요. 무작정 신뢰 X.

저는 한계를 솔직하게 인정하는 게 좋다고 봐요. 저는 압축은 무손실이 아니라는 사실을 받아들였어요. 저는 중요한 코드 변경 직후라면 압축 전에 핵심을 한 번 더 명시해두는 습관이 생겼어요.

제 /compact 운영 패턴

# alert 보면 → /compact (1차 시도)
[Claude] context window 80% used. /compact 권장.
$ /compact
[Claude] 압축 완료 — 토큰 자리 60% 회복.

# 압축 후 즉시 검증 한 줄
$ "방금 작업한 [핵심 파일명] 내용 확인해줘"
# 이상 없으면 계속, 손실 감지되면 /clear 후 재시작

02 · AGENT중요한 건 메인 안 쓰고 별도 agent 로

결론. 저는 두 번째가 역할 분리라고 봐요. 저는 메인 클로드를 코디네이터로, 디테일 작업은 sub-agent 로 던지고 있어요.

제 분리 기준

"중요하다고 생각하는 것 — 코드 리뷰, 벤치마킹, 글 품질관리. 이런 건 메인 클로드 안 쓰고 별도 agent 한테."

저는 효과를 두 가지로 봐요. 메인 컨텍스트 보호 + 디테일 작업의 결과만 메인으로 올라옴. 저는 큰 문서 한 번 통째로 읽는 작업이 메인을 안 갉아먹는 게 가장 큰 이점이라고 봐요.

저는 자체 정의 agent 5개를 .claude/agents/ 아래 markdown 한 장씩 박아뒀어요:

monetization-analyst

수익화 분석 — VSD Pro · jessinvestment 단계 점검

opportunity-ranker

기회 순위 매기기 — 다음 sequence 후보 정렬

dev-finance-explorer

개발자 · 금융 교차 — 글감 발굴

asset-health-checker

자산 건강 점검 — 잡 · 블로그 운영 상태

저는 여기에 슬래시 커맨드 /review (코드 리뷰)와 매주 도는 weekly-blog-review 잡 (글 품질 6-AI 패널) 이 더 있다고 봐요. 이게 토큰 절감의 가장 큰 한 방이었어요.

제 agent 호출 — 메인 컨텍스트 보호 패턴

# 메인 Claude 에 묻는 게 아니라
$ Task(opportunity-ranker, "다음 글감 후보 10개 순위 매겨줘")
# → sub-agent 별도 컨텍스트에서 작업, 결과만 메인으로

# 메인은 코디네이터 역할만
# 무거운 분석 / 6-AI 패널 / 벤치마킹은 다 별도 agent

03 · CLEAR/clear — 압축이 아니라 비움

결론. 저는 세 번째로 /clear 를 적극 활용해요.

제 시점 판단

"맥락이 완전 바뀔 때 /clear 하고 컨텍스트 새로 쌓아요."

저의 예시 — 부동산 글 작업이 끝나고 매매 시스템 디버깅으로 넘어갈 때예요. 저는 두 작업의 컨텍스트가 섞이면 사고가 난다는 걸 깨달았어요.

저는 두 도구의 역할이 다르다고 봐요. 저는 /compact 가 압축, /clear 는 완전 비움이라고 알아요. 저는 clear 후 처음 메시지 보내면 CLAUDE.md 만 새로 로드되고 거기서 컨텍스트를 다시 쌓는 흐름으로 운영하고 있어요.

저는 이게 좀 의외였는데, clear 가 아까운 게 아니라 안 하는 게 더 비싼 경우가 많아요. 저는 안 비우면 매 대화마다 전체 이전 맥락에 토큰 다 써야 한다는 걸 알게 됐어요.

제 /clear 시점 판단 — 실제 체크리스트

# 다음 케이스 중 하나라도 만나면 /clear
[ ] 작업 도메인 완전 전환 (부동산 → 매매 시스템 등)
[ ] /compact 후에도 답이 어색 (압축 손실 감지)
[ ] 대화 길어서 답 점점 느려짐 (컨텍스트 비대)
[ ] 다른 블로그·프로젝트로 이동 (CLAUDE.md 폴더 분리)

# 위 1개 이상이면 /clear 망설이지 말 것
# clear 하고 CLAUDE.md 새로 로드 + 깔끔하게 다시 시작

04 · SPLITCLAUDE.md 슬림 + 별도 파일로 빼기

결론. 저는 네 번째가 CLAUDE.md 다이어트라고 봐요.

제 분리 원칙

"매 작업마다 필요한 것만 CLAUDE.md 에. 나머지는 요청별로 별도 파일 — 그래야 토큰 절약돼요."

저는 이유를 명확히 봐요. CLAUDE.md 는 매 세션 자동 로드되거든요. 저는 거기 박힌 모든 줄이 매번 토큰을 먹는다는 걸 알아요. 자주 안 보는 건 빼야 한다는 게 결론이었어요.

제 실제 분리 구조예요:

파일 종류

예시

메인 CLAUDE.md
매 세션 자동 로드

자동화/CLAUDE.md — 운영 규칙·시간·사고 기록

별도 파일
요청 시만 로드

매수기/_시리즈_가이드.md · 에디블로그/SKILL.md · docs/INFRA_2026_05.md

아카이브
한 줄 인덱스만

CLAUDE-archive-2026-04.md — 옛 사고 기록 분리

저는 옛 사고 기록을 CLAUDE-archive-2026-04.md 로 분리해서 메인 본문에서 한 줄 인덱스만 남겼어요. 저는 메인이 1000줄 넘게 부풀던 게 정리됐다는 걸 체감했어요. 저는 이게 메인 슬림 패턴의 핵심이라고 봐요.

제 CLAUDE.md 슬림 패턴 — 인덱스만 본문에

# 메인 CLAUDE.md (현재 ~80줄)

## 5. 사고 기록 (learnings)

| 날짜 | 사고 | 조치 |
|---|---|---|
| 2026-05-09 | publish 4회 실패 + 텔레그램 loop | 자가회복 4개 박음 |

> 2026-04-14 ~ 2026-04-18 사고 10건은 `CLAUDE-archive-2026-04.md` §A 로 이관
> 2026-04-21 ~ 2026-05-04 사고 8건은 `CLAUDE-archive-2026-05.md` §A 로 이관
> 본문은 05-05 이후 사고만 유지

05 · SKILLS스킬 3개 — 트리거 시만 로드

결론. 저는 마지막이 스킬이라고 봐요. 저는 자체 스킬 3개를 자동화/.claude/skills/ 아래에 두고 있어요.

A

add-launch-job

새 LaunchAgent 잡 추가 시 자동 트리거. plist TCC 정책 · FD 한도 3-레이어 방어 점검. 지난 한 주에만 잡 5개 만들 때 그대로 활용.

B

blog-style-guide

글 작성 · 검토 시 자동 트리거. 토스 9패턴 + 진화 4패턴 + reviewer 게이트 자동 적용. 4개 블로그 매일 발행에 한 곳에서 관리.

C

captcha-recovery

캡차 · 세션 오염 발생 시 자동 트리거. 텔레그램 릴레이 + 좀비 Chrome 정리 절차. 드물지만 사고 시 필수.

저는 분리 효과를 정량 측정 못 했어요. 저는 인라인이면 메인 CLAUDE.md 가 1000줄 넘게 부풀고 매 세션 풀로 로드된다고 봐요. 저는 분리하면 메인은 한 줄 인덱스만 남고 SKILL.md 는 트리거 시만 로드된다는 걸 알아요. 저는 메인 토큰 ~30% 절감을 추정해요.

메인 토큰 절감

~30%

추정 · 체감 X

자체 스킬

3

add · style · captcha

룰 변경 지점

1

SKILL.md 한 곳

제 SKILL.md 트리거 — description 키워드 매칭

---
name: blog-style-guide
description: 자동화 프로젝트 블로그 글 작성·검토·발행 시 따라야 할 토스
  스타일 가이드 9패턴 + reviewer 게이트 임계값. ediblog·jessinvestment·
  luna-pick·jesslab 발행 작업 시 또는 글 품질 검토 요청 시 사용.
---

# 자동화 프로젝트 블로그 스타일 가이드
...

# Claude 가 "글 써줘" / "검토해줘" / "발행 직전" 키워드 매칭 시
# 자동 트리거 → SKILL.md 로드 → 9패턴 적용

CODA제가 결론 한 줄로 박는다면

토큰 절약은 도구가 아니라 어디까지 메인에 박을지 를 결정하는 일이에요.

— 에디 · Phase 2-1 정리

저는 5가지 다 한 번씩 망해보고 나서야 자리잡았어요. 저는 도구를 외우는 것보다 어떤 정보가 매 세션 필요한지를 먼저 보라고 권해요. 저는 이게 토큰 절약의 본질이라고 깨달았어요.

Phase 2 · 제 다음 deep dive 시리즈

• 2-2슬래시 커맨드 deep dive — /run-daily 5블로그별 차이 (곧)
• 2-3자체 스킬 3개 deep dive — 만든 이유 · 구조
• 2-4CLAUDE.md 운영 — 사고 기록 누적 구조

CODA

자동 로드의 모든 줄은 비용이에요. 저는 매 세션 필요한 것만 메인에 박고 있어요.

출처 · References

Claude Code 공식

• Claude Code 개요
• CLAUDE.md memory — 자동 로드 동작
• Skills — 트리거 시 로드
• /compact · /clear 공식 문서

시리즈 인덱스

• 데스크탑 못 떠나요 — Claude Code 3달 6가지 (Phase 1, 시리즈 인덱스)

면책: 제 개인 3달 운영 회고예요. 광고·제휴 X.