본문으로 건너뛰기
피드

CLAUDE.md 시스템 프롬프트, 60-70% 압축하는 방법

ai-ml 약 5분
vote
0
댓글
북마크

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

  • 1

    CLAUDE.md의 마크다운 헤더, 볼드, 테이블 등 인간용 장식이 컨텍스트 윈도우를 불필요하게 차지함

  • 2

    산문을 key-value 표기, 파이프 구분 리스트로 바꾸면 파일별 36~72% 문자 수 감소 가능

  • 3

    skills.md 67%, career-timeline.md 72% 등 전체 60-70% 압축 달성

  • 4

    시스템 프롬프트가 가벼울수록 대화 컨텍스트 여유가 생기고 긴 세션에서 모델 일관성 향상

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

댓글

댓글

댓글을 불러오는 중...

ai-ml

애플 새 음성 인식 API, 온디바이스 영어 전사에서 위스퍼 스몰까지 이겼다

애플의 새 음성 인식 API인 스피치애널라이저가 리브리스피치 벤치마크에서 기존 SFSpeechRecognizer는 물론 위스퍼 스몰보다도 낮은 단어 오류율을 기록했어. 깨끗한 음성에서는 2.12%, noisy 음성에서는 4.56%로, 기존 애플 API 대비 오류율을 3.5~4배 줄였고 위스퍼 스몰보다 약 3배 빠르게 돌았어. 다만 영어·애플 플랫폼·OS 26 조건의 결과라, 다국어와 크로스플랫폼에서는 여전히 위스퍼의 장점이 남아 있어.

ai-ml

AI를 진짜 잘 쓰는 기업, 미국 증시에서 연 30% 프리미엄 받는다는 연구

예일대와 로체스터대 연구진이 기업의 실제 대형 언어 모델 사용 데이터를 분석했더니, AI 활용도가 높은 상위 20% 기업이 하위 20%보다 주당 평균 0.64% 높은 초과수익률을 냈다. 단순히 AI 기업이냐가 아니라, 업무에 AI를 얼마나 깊게 쓰는지가 시장 가치에 반영되고 있다는 얘기다.

ai-ml

ZTE, AI 에이전트폰으로 스마트폰 재도전…진짜 승부처는 앱 생태계

ZTE가 바이트댄스의 더우바오를 탑재한 AI 에이전트 스마트폰으로 시장 재진입을 노린다. 핵심은 사용자가 명령하면 AI가 여러 앱을 직접 열고 조작하는 방식인데, 위챗·타오바오·알리페이 같은 플랫폼과 충돌하면서 생태계 문제가 가장 큰 변수로 떠올랐다.

ai-ml

노벨상 학자들까지 “AI 경제 충격, 지금 제도 안 만들면 늦다”

노벨 경제학상 수상자 15명을 포함한 학자와 기술 업계 인사 약 200명이 AI가 향후 10년 안에 경제를 급격히 바꿀 수 있다며 정책 대응을 촉구했다. 이들은 산업혁명보다 큰 변화가 훨씬 짧은 시간에 올 수 있고, 대규모 일자리 대체와 생활 수준 향상이라는 양면성이 동시에 존재한다고 봤다.

ai-ml

NHN, AI 데이터센터 매출 기대감에 목표주가 5만6000원으로 상향

한국투자증권이 NHN의 목표주가를 4만5000원에서 5만6000원으로 올리고 투자의견 매수를 유지했다. 핵심 근거는 양평 AI 데이터센터 가동, 공공·민간 GPU 클러스터 수주 확대, 클라우드 사업부 신규 매출 반영이다.