Claude 5 버전 신규 프롬프트 가이드: 'Context Engineering' 기법

2026년 7월 24일,
Anthropic이 Claude 5 세대 모델용 컨텍스트 엔지니어링 가이드를 올렸다.
꽤나 많은 변화가 있는듯하여 일단 정리해봤다.

Opus 5, Fable 5 대상으로 Claude Code 시스템 프롬프트의 80% 이상을 지웠는데,
자체 코딩 평가에서 측정 가능한 손실이 없었다.

4/5를 지웠는데 결과가 같다는 건,
그게 일을 안 하고 있었다는 뜻이다.
안전하게 만든다고 넣어둔 지침이 오히려 발목을 잡고 있었던 거다.
(만들어둔 스킬이나 지침을 다 바꿔야 하는 나🤦‍♂️)

---

Context Engineering이란

프롬프트는 모델이 보는 정보의 일부일 뿐이다.
나머지는 시스템 프롬프트, 스킬, CLAUDE.md, 메모리, 툴 정의에서 조립된다.
이 스택 전체를 설계하는 걸 컨텍스트 엔지니어링이라고 부른다.

프롬프트와 다른 점은 하나다.
컨텍스트는 수많은 요청에 재사용되기 때문에 그만큼 구체적일 수 없다.

지우는 게 왜 이득이냐면,
컨텍스트는 애초에 유한한 자원이라서 그렇다.
토큰이 늘어날수록 그 안에서 정확히 뽑아내는 능력이 떨어진다.
이건 작년 Anthropic에서 공개한 가이드 원론 글에서 context rot이라고 부른 현상이다.

---

왜 지울 수 있었나

숫자보다 진단이 중요하다.
한 요청 안에서 지시들이 서로 충돌하고 있었다고 한다.

한쪽은 문서를 적절히 남기라고 하고,
다른 쪽은 주석을 절대 달지 말라고 한다.

모델은 대체로 의도를 파악해서 옳은 답에 도달한다.
문제는 파일 하나 건드리기 전에 어느 지시가 이겼는지 판정하는 데 추론을 쓴다는 거다.

---

6가지 전환

Then	Now
규칙을 준다	판단에 맡긴다
예시를 준다	인터페이스를 설계한다
전부 앞에 넣는다	점진적 공개
반복해서 강조한다	툴 설명에 한 번만
CLAUDE.md에 메모리	자동 메모리
단순한 스펙	풍부한 레퍼런스

규칙 → 판단

예전엔 항상 참은 아닌 규칙을 강하게 박았다.
파일을 지우거나 코드가 지저분해지는 최악의 경우를 막으려다 보니
주석 쓰지 마라,
여러 줄 주석 블록 금지 등등
이런 식으로 작성을 했었다.

지금은 이렇게 바뀌었다.

주변 코드처럼 읽히는 코드를 쓸 것.
주석 밀도, 네이밍, 관용구를 맞춰라.

케이스를 열거하는 대신 기존 코드 기반으로 판정 원칙을 준 것이다.

예시 → 인터페이스 설계

제일 반직관적인 부분이다.
작년까지만 해도 정규 예시를 큐레이션하라는 게 정석이었는데,
최신 모델에선 예시가 오히려 탐색 공간을 가둔다고 한다.

대신 툴 설계 자체를 고민하라는 것이다.
status를 pending / in_progress / completed enum으로 두면 사용법이 암시된다.
"in_progress는 하나만 유지" 제약 하나가 동작을 정의한다.
예시 코드 블록은 필요 없다.

툴 설명에 한 문단짜리 해설이 필요하면,
설명이 부족한 게 아니라 툴 설계가 틀린 거다..!!

전부 앞에 → 점진적 공개

필요한 정보를 필요한 시점에 로드하는 방식이다.
전부 앞에 넣는 대신 입구만 열어두고 모델이 찾아 들어가게 한다.

스킬이 이미 이렇게 돌아간다.
모델이 항상 들고 있는 건 목차뿐이고,
실제 내용은 필요해질 때 그 파일을 연다.
툴도 일부는 검색해야 정의가 로드돼서 쓰기 전까지 컨텍스트를 안 먹는다.

SKILL.md도 안에서 목차 역할만 하고 상세한 건 별도 파일로 빼라는 얘기다.

반복 → 단순한 툴 설명

예전 모델은 지시를 반복해줘야 했다.
지금은 툴 사용법을 툴 설명에만 두면 된다.
같은 지시가 두 곳에 있으면 한 곳을 지운다.

CLAUDE.md 메모리 → 자동 메모리

예전엔 # 핫키로 CLAUDE.md에 기록하라고 했다.
지금은 모델이 알아서 저장한다.
CLAUDE.md는 더 이상 메모리 저장소가 아니다.

단순 스펙 → 풍부한 레퍼런스

이제 마크다운 플랜보다 복잡한 레퍼런스를 다룰 수 있다.
테스트 스위트가 스펙이 될 수 있고,
다른 코드베이스의 함수를 그대로 던져도 된다.
루브릭을 주고 검증 에이전트를 띄우는 것도 된다.

제일 실용적인 문장은 이거다.
디자인은 설명이나 스크린샷보다 HTML 목업이 더 나은 결과를 낸다.
코드가 모델이 제일 잘 아는 언어라서 그렇다.

---

계층별 적용 정리

CLAUDE.md

• 레포 용도는 간단히만 쓴다.
• 토큰 대부분은 코드베이스 내부의 gotcha에 쓴다.
• 파일 보면 알 수 있는 뻔한 건 안 쓴다.
• 검증 지침이 여럿이면 스킬로 빼고 참조만 한다.

나는 디렉토리 구조를 트리로 그려서 넣어뒀다.
ls 한 번이면 아는 걸 매 세션 토큰으로 사고 있었다.🤦‍♂️

Skills

• 필요할 때 찾아가는 가벼운 가이드다.
• 길면 여러 파일로 쪼갠다.
• 개인·팀·제품에 고유한 노하우를 담을 때 제일 잘 작동한다.

References
@ 멘션으로 넣는다.
가능하면 코드 형태를 고른다.

---

/doctor

claude doctor 커맨드가 같이 나왔다.
스킬이랑 CLAUDE.md를 적정 크기로 진단해준다.
변경 전에 뭘 자를지 먼저 보고해서 리스크가 거의 없다고 한다.

---

마무리

이번 Anthropic에서 제공한 5버전 가이드의 한 줄 요약은
CLAUDE.md가 아직 규칙집처럼 읽힌다면 모델을 방해하고 있다는 거다.

내가 써넣은 제약들은 그 가드레일이 필요했던 모델을 위한 거였다.
모델이 바뀌었으면 걷어내는 게 맞다.

다만 80%는 자체 평가 수치고,
어떤 태스크에서 유지됐는지는 공개 안 됐다.
"판단을 믿어라"는 조언은 취미 프로젝트랑 규제 코드베이스에서 다르게 작동한다.

그래서 전부 지우기보단 한 섹션씩 지우면서 보는 것이 좋을 것 같다.
규칙 하나 지우고 결과가 유지되면 그건 과잉 제약이었던 거다.!

---

참고

https://claude.com/blog/the-new-rules-of-context-engineering-for-claude-5-generation-models
https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents