본문으로 건너뛰기
피드

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

유튜브, AI 생성 영상에 자동 라벨 붙인다

유튜브가 사실적으로 보이거나 의미 있게 AI로 변경·생성된 콘텐츠에 더 눈에 띄는 라벨을 적용하고, 제작자가 AI 사용 여부를 밝히지 않아도 내부 신호로 감지되면 자동 라벨을 붙이겠다고 밝혔다. 다만 라벨만으로 추천 노출이나 수익화 자격이 바뀌지는 않으며, 제작자는 YouTube Studio에서 잘못된 판정을 수정할 수 있다.

ai-ml

테크 CEO들의 'AI 만능론', 숫자는 아직 그렇게 말하지 않는다

테크 업계에서 AI를 이유로 한 대규모 감원과 조직 재편이 이어지는 가운데, Box 창업자 애런 레비는 CEO들이 실제 업무의 마지막 1마일을 모른 채 AI 에이전트의 능력을 과대평가하고 있다고 지적했다. 2026년 첫 5개월 동안 이미 11만5430명이 해고됐고, 여러 연구는 AI 도입이 체감 생산성만큼 실제 생산성을 끌어올렸다는 근거가 아직 약하다고 말한다.

ai-ml

오픈AI와 앤트로픽, 코딩 에이전트로 드디어 돈 되는 시장을 찾은 듯

사이먼 윌리슨은 오픈AI와 앤트로픽이 코딩 에이전트와 기업용 과금으로 진짜 제품-시장 적합성을 찾았다고 봐. 개인 구독자에게는 월 100달러 플랜이 싸게 느껴지지만, 기업 고객은 이제 사용량 기준 토큰 가격을 그대로 내기 시작했고 이게 대형 고객 예산을 빠르게 흔들고 있다는 얘기야.

ai-ml

컴팔과 GMI 클라우드, 대규모 추론용 AI 인프라 구축 협력

컴팔이 실리콘밸리 기반 AI 인프라 기업 GMI 클라우드와 협력해 대규모 추론과 에이전틱 AI 워크로드에 맞춘 GPU 서버 인프라를 구축한다고 발표했어. COMPUTEX 2026에서는 NVIDIA HGX B300을 지원하는 Compal SGX30-2 같은 고성능 AI 서버 플랫폼도 선보일 예정이야.

ai-ml

AI 쓰면 편해진다더니, 직장인들은 ‘AI 과부하’에 지쳐가는 중

국내 직장인들이 AI 전환 압박, AI 답변 검증 부담, 대체 불안 때문에 피로감을 호소하고 있어. 중앙일보 설문에서는 5284명 중 31.6%가 ‘AI 답변 검증에 시간이 더 걸릴 때’를 가장 지치는 순간으로 꼽았고, 기업들은 무작정 AI 사용량을 밀어붙이는 방식에서 업무 방식 재설계로 넘어가야 한다는 지적이 나와.