이 가이드는 Anthropic 블로그 The new rules of context engineering for Claude 5 generation models(2026-07-24)의 내용을 정리한 것입니다.
무엇이 달라졌나
지금까지 컨텍스트 설계는 “더 정확히, 더 많이 지시하기”에 가까웠습니다. 주석을 쓰지 마라, 문서는 이렇게 써라, 도구는 이 순서로 호출해라. 모델이 실수하면 규칙을 한 줄 더 추가하는 식이었습니다.
Claude 5 세대에서는 이 방식이 역효과를 냅니다. Anthropic은 Claude Opus 5, Claude Fable 5 같은 모델을 대상으로 Claude Code 시스템 프롬프트를 80% 넘게 제거했고, 코딩 평가에서 측정 가능한 손실이 없었다고 밝혔습니다. 원인은 단순합니다. 과하게 제약된 지시는 사용자의 실제 의도와 자주 충돌하고, 모델은 그 충돌을 푸는 데 자원을 씁니다.
블로그는 이 상태를 “Claude를 과하게 묶어두고 있었다”고 표현합니다. 예를 들어 “주석을 절대 쓰지 마라, 여러 줄 주석 금지”라는 규칙은 상당수 상황에서 그냥 틀린 지시가 됩니다. 그런데 사용자는 “문서를 적절히 남겨줘”라고 요청합니다. 모델은 두 메시지 사이에서 시간을 낭비합니다.
6가지 전환
원문의 핵심은 “예전 방식 → 지금 방식” 여섯 쌍입니다. 표로 압축하면 이렇습니다.
| 영역 | 예전 | 지금 |
|---|---|---|
| 지시 방식 | 경직된 규칙을 나열 | 모델의 판단에 맡김 |
| 도구 사용 | 예시를 잔뜩 제공 | 파라미터가 명확한 인터페이스를 설계 |
| 정보 제공 | 시스템 프롬프트에 미리 다 넣음 | 필요한 시점에 꺼내는 점진적 공개 |
| 중복 | 시스템 프롬프트와 도구 설명에 같은 말 반복 | 도구 설명에만 적음 |
| 메모리 | # 단축키로 사용자가 저장 | Claude가 관련 내용을 자동 저장 |
| 참조 자료 | 계획을 적은 단순 마크다운 | 코드, 테스트 스위트, HTML 아티팩트 |
여섯 줄이 결국 한 문장으로 모입니다. 무엇을 하지 말라고 적기보다, 판단에 필요한 재료를 좋은 형태로 놓아둡니다.
오늘 적용할 3가지
1. CLAUDE.md를 줄입니다. 프로젝트가 무엇을 하는 곳인지는 짧게 적고, 분량의 대부분은 모르면 실수하기 쉬운 지점을 적는 데 씁니다. 코드만 봐서는 눈치채기 어려운 것들입니다. 예를 들면 이런 것입니다.
- “이 함수는 겉보기와 달리 캐시를 건드리므로 테스트 전에 초기화해야 한다”
- “결제 모듈은 레거시라 새 패턴을 적용하면 안 된다”
- “빌드는 반드시
web/에서 실행해야 한다”
반대로 디렉토리 목록이나 파일 구조처럼 Claude가 직접 열어보면 아는 내용은 뺍니다. 원문도 “Claude가 파일 시스템이나 리포를 보면 알 수 있는 뻔한 내용은 적지 말라”고 권합니다.
2. 스킬을 쪼갭니다. 스킬은 규칙집이 아니라 필요할 때 정보를 찾아가는 가벼운 안내서로 봅니다. 스킬이 길어지면 한 파일에 몰아넣지 말고 여러 파일로 나눠 점진적 공개를 적용합니다. 과한 제약은 정말 중요한 영역에만 남깁니다.
3. 같은 말을 두 번 적지 않습니다. 도구 사용법은 도구 설명에만 둡니다. 시스템 프롬프트, CLAUDE.md, 스킬에 같은 지시가 흩어져 있으면 서로 어긋날 때 모델이 판단을 낭비합니다.
시스템 프롬프트는 제품을 설명하는 자리
원문은 계층을 이렇게 정리합니다. 시스템 프롬프트는 제품 맥락에 묶인 자리로, Claude가 어떤 제품 안에서 무엇을 하고 있는지를 알려줍니다. Claude Code 사용자라면 여기를 건드릴 일이 거의 없습니다. 다만 자체 에이전트 하네스를 만든다면, 시간을 많이 쓸 곳이 바로 여기입니다.
다음 단계
먼저 지금 쓰는 CLAUDE.md를 열어 “Claude가 파일만 봐도 아는 내용”에 줄을 그어보세요. 대개 절반 가까이 지워집니다. 블로그에 따르면 이 베스트 프랙티스가 claude doctor에 반영되어 있어, Claude Code에서 /doctor로 스킬과 CLAUDE.md 분량을 점검할 수 있습니다.
작성 원칙 자체가 궁금하다면 CLAUDE.md 잘 쓰는 법을, 스킬을 나누는 방법은 스킬 직접 만들기를 이어서 보세요. 원문 전체는 Anthropic 블로그에서 확인할 수 있습니다.