[TIL] Claude 5의 컨텍스트 엔지니어링

2026. 07. 26.Yeji Kim

들어가며

이 글은 GeekNews의 Claude 5 모델을 위한 새로운 컨텍스트 엔지니어링 규칙과 원문 트윗을 읽고 요약한 내용이다. Anthropic이 최신 모델(Claude Opus 5, Fable 5)에 맞춰 컨텍스트를 구성하는 방식에 대한 새 가이드를 내놓았고, 그 핵심 원칙을 정리한 글이다.

가장 인상적인 문장은 이거였다. Claude Code의 시스템 프롬프트를 80% 이상 줄였는데도 측정 가능한 성능 저하가 없었다. 그동안 프롬프트에 규칙을 빽빽하게 채우는 게 당연했는데, 최신 모델에서는 오히려 덜어내는 게 낫다는 이야기다.


핵심 원칙

1. 과도한 제약을 줄이기

예전에는 시스템 프롬프트, Skills, CLAUDE.md, 사용자 요청이 겹치면서 서로 충돌하는 규칙을 만들어 냈다. 최신 모델은 이런 상황을 스스로 더 잘 판단하기 때문에, 딱딱한 규칙보다 맥락에 맡기는 편이 낫다.

2. 점진적 공개 (Progressive Disclosure)

정보를 미리 다 넣어 두는 대신, 필요할 때 드러나게 한다.

  • 검증 지침 같은 건 별도 Skills 파일로 옮기기
  • 도구는 지연 로딩(lazy-loading)으로 불러와 컨텍스트 부담 줄이기

3. 규칙 기반이 아니라 맥락 기반으로

구체적인 금지 규칙을 맥락적 안내로 바꾼다. 예를 들어 여러 줄 주석을 절대 쓰지 마 대신 주변 코드 스타일에 맞춰 작성해 같은 식이다.


컴포넌트별 역할 정리

새 가이드는 각 구성 요소가 맡아야 할 역할을 이렇게 나눈다.

  • 시스템 프롬프트: 제품 맥락. 사용자가 거의 건드리지 않는 부분
  • CLAUDE.md: 저장소 고유의 함정만. 가볍게 유지
  • Skills: 필요할 때 정보를 찾는 방법을 안내. 과하게 제약하지 않기
  • 참고 자료: 스펙, 테스트 스위트, HTML 목업, 채점 기준(rubric) 등

이전 방식이 명시적 예시와 광범위한 제한에 기댔다면, 새 방식은 표현력 있는 인터페이스와 동적인 워크플로를 지향한다. claude doctor 명령이 컨텍스트를 자동으로 단순화하는 데 도움을 준다고 한다.


댓글에서 나온 반응

무조건 받아들이기보다 곱씹어 볼 만한 반응들이 있었다.

  • 80% 감축의 해석: 그 컨텍스트가 정말 불필요했다는 증거인지, 아니면 애초에 효과가 없었던 건지 되묻는 시각
  • 벤더 락인 우려: 설정을 이식 가능한 .md에서 Anthropic 전용 도구(Skills, 자동 메모리)로 옮기면 종속성이 커진다는 걱정
  • 실사용 경험: 자동 메모리를 끄니 성능이 좋아졌다는 사람, 벤치마크는 좋아도 이전보다 실수가 늘었다는 사람, 새 방식은 계속 손봐야 한다는 사람

정리하며

핵심은 모델이 똑똑해질수록 사람이 규칙으로 다 통제하려 들면 오히려 방해가 된다는 것이다. 프롬프트를 채우는 대신, 필요한 맥락을 필요한 시점에 주고 판단은 모델에 맡기는 방향으로 무게가 옮겨가고 있다.

프론트엔드에서 컴포넌트 API를 설계할 때 옵션을 잔뜩 열어 두기보다 합리적인 기본값을 주는 게 나은 것과 비슷하게 느껴졌다. 다만 댓글의 지적처럼 락인과 재현성 문제는 별개로 따져봐야 할 부분이다.


참고