---
title: "CLAUDE.md 시스템 프롬프트, 60-70% 압축하는 방법"
published: 2026-02-24T22:51:44.000Z
canonical: https://jeff.news/article/1162
---
# CLAUDE.md 시스템 프롬프트, 60-70% 압축하는 방법

CLAUDE.md 파일의 마크다운 장식과 장황한 산문을 compact notation으로 바꾸면 60-70% 압축이 가능함. 인간 가독성은 떨어지지만 Claude가 주 독자인 이상 기계 가독성 최적화가 합리적이라는 주장임.

## CLAUDE.md 파일, 60-70% 압축할 수 있음

- Matt Pocock이 "Never Run claude /init"이라는 영상을 올렸는데, 핵심은 `claude /init`이 생성하는 장황한 보일러플레이트가 컨텍스트 윈도우를 잡아먹으니 직접 관리하라는 것임
- 이 글의 저자는 여기서 한 발 더 나감. CLAUDE.md에 들어가는 내용 중 실제로 기계를 위한 건 얼마나 되고, 인간 가독성을 위한 장식은 얼마나 되는지 파고든 것임

## 문제: 시스템 프롬프트에 불필요한 노이즈가 너무 많음

- Claude Code는 프로젝트 CLAUDE.md, 글로벌 `~/.claude/CLAUDE.md`, persistent memory 파일까지 전부 시스템 프롬프트로 주입함. 매 대화마다 이 모든 문자가 컨텍스트를 차지함
- 컨텍스트 윈도우가 커졌다고 해도 무한은 아니고, signal-to-noise ratio가 높을수록 모델 성능이 좋다는 건 이미 알려진 사실임
- 마크다운 헤더, 볼드, 테이블 정렬 행, "이 섹션은~을 포함합니다" 같은 프레이밍 문장 전부 인간을 위한 장식이지 Claude한테는 노이즈임

## 압축 방법: 장식 제거하고 표기법으로 전환

- 핵심 규칙 5가지: 마크다운 장식 제거 / 산문을 key-value 표기로 압축 / 중복 프레이밍 삭제 / 파일 간 중복 제거 / 테이블 포맷 압축
- 디렉토리 인덱스 테이블 예시가 인상적임. 마크다운 테이블 전체를 `Dirs: src/=application source | infra/=terraform+ansible | docs/=architecture docs` 한 줄로 바꿈. "When to read" 컬럼은 Claude가 이름만 보고 추론 가능하니까 통째로 삭제함
- 메모리 시스템 지시사항도 마찬가지. 볼드, 헤더, 불릿 리스트로 된 설명을 `session-start: read _index.md` 같은 compact notation으로 바꾸니 문자 수가 절반 이하로 줄어듦

## 결과: 파일별 36~72% 감소

- `skills.md`: 16,176 → 5,353자 (67% 감소)
- `career-timeline.md`: 17,882 → 5,027자 (72% 감소)
- `discoveries.md`: 11,260 → 5,609자 (50% 감소)
- `_index.md`: 3,560 → 2,036자 (43% 감소)
- `~/.claude/CLAUDE.md`: 2,350 → 1,495자 (36% 감소)
- 전체 메모리 시스템 합산 약 60,264자, 60-70% 줄어든 셈임. 토큰 절감도 문자 수 절감과 거의 비례함

## 트레이드오프와 적용 가이드

- 당연히 사람이 읽기는 어려워짐. 근데 솔직히 이 파일들 직접 얼마나 자주 읽음? Claude가 세션 시작할 때 읽고, 끝날 때 업데이트하는 machine-to-machine 통신이니 기계 가독성에 최적화하는 게 맞음
- 적용 순서: 먼저 context rot 감사(이것만으로 20-30% 절감 가능) → 마크다운 장식 식별 → 산문을 표기법으로 압축 → 파일 간 중복 제거 → 압축 후 세션 돌려보며 검증

> 저자의 핵심 비유가 좋음: "기계어에 주석 안 달고, 와이어 프로토콜에 pretty-printing 안 함. CLAUDE.md는 사람이 읽을 수 있는 형식에 저장된 기계 명령어 세트임"

- 시스템 프롬프트가 가벼우면 대화 컨텍스트에 여유가 생기고, 긴 세션에서 Claude의 일관성이 향상됨. Claude Code를 일상 도구로 쓰는 사람이라면 한번 해볼 만한 최적화임

## 핵심 포인트

- CLAUDE.md의 마크다운 헤더, 볼드, 테이블 등 인간용 장식이 컨텍스트 윈도우를 불필요하게 차지함
- 산문을 key-value 표기, 파이프 구분 리스트로 바꾸면 파일별 36~72% 문자 수 감소 가능
- skills.md 67%, career-timeline.md 72% 등 전체 60-70% 압축 달성
- 시스템 프롬프트가 가벼울수록 대화 컨텍스트 여유가 생기고 긴 세션에서 모델 일관성 향상

## 인사이트

CLAUDE.md를 '사람이 읽는 문서'가 아니라 '기계가 읽는 명령어 세트'로 인식 전환하는 게 핵심. context window 효율이 중요해지는 시점에서 실용적인 팁임.