Claude 5 세대 모델의 컨텍스트 엔지니어링 변화와 Context Engineering 설계 전략

Claude 5에서는 왜 Context Engineering 방식이 달라졌을까?

대규모 언어 모델(LLM)을 활용하는 개발 환경에서는 프롬프트(Prompt) 작성만큼 중요한 것이 Context Engineering입니다. 사용자가 입력한 프롬프트뿐 아니라 시스템 프롬프트(System Prompt), Skills, CLAUDE.md, 메모리(Memory), 각종 참조 자료(References) 등이 함께 모델의 판단 근거가 되기 때문입니다.

Anthropic은 Claude 5 세대 모델을 개발하면서 기존 Claude Code의 시스템 프롬프트를 80% 이상 제거했음에도 코딩 성능 저하가 발생하지 않았다고 밝혔습니다. 이는 최신 모델이 단순한 규칙을 따르는 수준을 넘어, 주변 문맥과 상황을 스스로 판단하는 능력이 크게 향상되었음을 의미합니다.

이번 글에서는 Anthropic이 공개한 Claude 5 세대의 새로운 Context Engineering 원칙과 이를 실제 에이전트 및 Claude Code 설계에 어떻게 적용할 수 있는지 살펴보겠습니다.

반응형

---

Context Engineering이란?

많은 사람들이 AI 활용 시 프롬프트만 중요하다고 생각하지만 실제로 Claude가 사용하는 정보는 훨씬 많습니다.

Claude가 응답을 생성할 때 활용하는 대표적인 컨텍스트는 다음과 같습니다.

• System Prompt
• Skills
• CLAUDE.md
• Memory
• References
• 사용자 Prompt

프롬프트는 매 요청마다 달라질 수 있지만, Context Engineering은 여러 요청에서 공통적으로 활용되는 환경을 설계하는 작업입니다.

즉,

"모델에게 무엇을 말할 것인가"보다 "모델이 어떤 환경에서 판단하도록 만들 것인가"가 더 중요해지고 있습니다.

---

Claude 5에서 달라진 핵심 변화

Anthropic은 기존의 Context Engineering 방식 중 상당수가 최신 Claude 모델에서는 더 이상 최적의 방법이 아니라고 설명합니다.

다음은 대표적인 변화입니다.

---

1. 규칙을 많이 주기보다 모델의 판단을 신뢰한다

기존 방식

초기 Claude Code에서는 다양한 최악의 상황을 방지하기 위해 매우 강한 규칙을 사용했습니다.

예를 들어

• 주석은 작성하지 말 것
• 여러 줄 Docstring 작성 금지
• 분석 문서 생성 금지

등과 같은 명시적인 제약을 시스템 프롬프트에 포함했습니다.

하지만 실제 프로젝트에서는 이러한 규칙이 항상 맞는 것은 아닙니다.

예를 들어

• 복잡한 코드에는 상세한 주석이 필요할 수도 있고
• 팀마다 문서화 정책이 다를 수도 있습니다.

새로운 방식

Claude 5에서는 이러한 규칙 대신

주변 코드 스타일을 읽고 그에 맞게 작성하라

정도의 간결한 지침만 제공합니다.

즉,

규칙(Rules) 중심에서 판단(Judgement) 중심으로 변화한 것입니다.

---

2. 사용 예시보다 인터페이스 설계가 중요하다

과거에는 Tool 사용법을 알려주기 위해 예제를 많이 제공했습니다.

예를 들어

Todo 생성 예시

status = pending
status = in_progress
status = completed

처럼 사용 예시를 반복적으로 제공했습니다.

하지만 최신 Claude에서는 예시가 오히려 탐색 범위를 제한하는 경우가 발생했습니다.

새로운 접근 방식

Anthropic은 예제를 늘리는 대신

도구 자체를 명확하게 설계하는 것이 더 중요하다고 설명합니다.

예를 들어

• 명확한 파라미터 이름
• Enum 타입 정의
• 상태(State) 구조 설계

등이 Claude가 올바르게 도구를 사용하는 데 더 큰 도움을 줍니다.

즉,

Prompt Engineering보다 Interface Engineering이 중요해지고 있습니다.

---

3. 필요한 정보만 필요한 시점에 제공한다

예전에는 모든 정보를 시스템 프롬프트에 담으려는 경향이 있었습니다.

예를 들어

• 코드 리뷰 방법
• 검증 절차
• 프로젝트 규칙

등을 모두 포함했습니다.

하지만 대부분의 요청에서는 이러한 정보가 필요하지 않습니다.

Progressive Disclosure

Claude 5에서는 필요한 순간에 필요한 정보만 불러오는 Progressive Disclosure 방식을 적극 활용합니다.

예를 들어

• 코드 리뷰가 필요하면 Review Skill 호출
• 검증이 필요하면 Verification Skill 호출
• 특정 Tool은 사용 시점에만 로드

이처럼 컨텍스트를 단계적으로 제공하여 불필요한 정보로 모델의 판단을 방해하지 않습니다.

---

4. 중복된 설명을 제거한다

이전 Claude 모델에서는 동일한 지침을 여러 곳에 반복 작성하는 경우가 많았습니다.

예를 들어

• System Prompt
• Tool 설명
• Skill

모두에 같은 내용을 포함하기도 했습니다.

하지만 최신 Claude에서는 이러한 중복을 제거하고,

각 Tool 내부 설명만으로도 충분히 동작하도록 개선되었습니다.

즉,

동일한 내용을 여러 번 반복하기보다, 필요한 위치에 한 번만 명확하게 작성하는 것이 효과적입니다.

---

5. CLAUDE.md 대신 자동 메모리 활용

기존에는 중요한 정보를 CLAUDE.md 파일에 저장하는 방식을 많이 사용했습니다.

하지만 Claude는 이제

• 사용자 관련 정보
• 작업 관련 정보
• 반복적으로 필요한 정보

등을 자동으로 메모리에 저장할 수 있습니다.

따라서 CLAUDE.md는

프로젝트의 핵심 특징이나 주의사항 정도만 간략하게 유지하는 것이 권장됩니다.

---

6. 단순 문서보다 풍부한 참조 자료를 활용한다

이전에는 긴 Markdown 문서를 Specification으로 사용하는 경우가 많았습니다.

하지만 Claude 5는 더욱 다양한 형태의 참조 자료를 이해할 수 있습니다.

예를 들어

• HTML Artifact
• 코드 자체
• 테스트 코드
• 다른 프로젝트 코드
• Rubric(평가 기준)

등을 모두 참조 자료로 사용할 수 있습니다.

특히 코드 기반 참조는 자연어 설명보다 더 정확한 정보를 전달할 수 있습니다.

---

Claude가 제안하는 Context Engineering 구조

Anthropic은 Context를 다음과 같은 구조로 설계할 것을 권장합니다.

구성 요소	역할
System Prompt	제품의 역할과 동작 환경 정의
CLAUDE.md	프로젝트 특징과 주의사항만 간결하게 작성
Skills	특정 작업 수행을 위한 전문 지침
References	코드, 명세서, 테스트 등 상세 참조 자료
Memory	사용자와 작업에 대한 지속적인 정보 저장

이 구조를 활용하면 불필요한 토큰 사용을 줄이면서도 필요한 정보를 적절한 시점에 제공할 수 있습니다.

---

CLAUDE.md 작성 시 권장 사항

Anthropic은 CLAUDE.md를 다음과 같이 구성할 것을 권장합니다.

포함하면 좋은 내용

• 저장소(Repository)의 목적
• 프로젝트만의 규칙
• 코드베이스에서 주의해야 하는 구조
• 개발자가 반드시 알아야 하는 특이사항

피해야 할 내용

• 파일 구조만 보면 알 수 있는 내용
• 일반적인 개발 상식
• 과도하게 상세한 사용법
• 모든 상황을 나열한 긴 규칙

즉,

Claude가 이미 알 수 있는 내용은 제거하고, 프로젝트 고유의 정보만 남기는 것이 중요합니다.

---

Skills 설계 시 고려할 점

Skill은 특정 작업이 필요할 때 호출되는 가벼운 가이드 역할을 합니다.

효과적인 Skill은 다음과 같은 특징을 가집니다.

• 필요한 경우에만 호출
• 프로젝트 특화 지식 포함
• 팀의 개발 방식 반영
• Progressive Disclosure 적용
• 과도한 제약 최소화

특히 긴 Skill 하나를 만드는 것보다 목적별로 여러 Skill로 나누는 방식이 권장됩니다.

---

References 활용 전략

Claude는 다양한 참조 자료를 활용할 수 있습니다.

대표적인 예시는 다음과 같습니다.

• HTML 디자인 시안
• 코드베이스
• 테스트 코드
• 명세 파일
• API 설계 문서
• Rubric(품질 기준)

특히 코드 형태의 참조는 자연어 설명보다 더 높은 정확도를 제공할 수 있으므로 우선적으로 활용하는 것이 좋습니다.

---

Context Engineering 설계 예시

다음은 권장되는 Context 구성 예시입니다.

System Prompt
    ↓
CLAUDE.md
    ↓
Skill
    ↓
Reference(Code, HTML, Spec)
    ↓
Memory

이처럼 각 구성 요소가 서로의 역할을 분담하면 불필요한 정보 중복을 줄이고, 모델이 필요한 정보를 적시에 활용할 수 있습니다.

---

728x90

Claude 5 세대 모델의 가장 큰 변화는 더 많은 규칙을 제공하는 것이 아니라, 더 적절한 환경을 설계하는 것에 있습니다.

Anthropic은 실제 Claude Code의 시스템 프롬프트를 80% 이상 줄였음에도 성능 저하가 없었다는 경험을 바탕으로 다음과 같은 방향을 제시합니다.

• 규칙보다 모델의 판단을 신뢰한다.
• 예시보다 인터페이스를 명확하게 설계한다.
• 필요한 정보만 필요한 시점에 제공한다.
• 중복된 지침을 제거한다.
• CLAUDE.md는 간결하게 유지하고 자동 메모리를 활용한다.
• 코드, 테스트, HTML 등 풍부한 참조 자료를 적극 활용한다.

결국 최신 Claude 모델에서는 Prompt Engineering을 넘어 Context Engineering이 핵심 경쟁력으로 자리 잡고 있습니다. 시스템 프롬프트, Skills, 메모리, 참조 자료를 적절히 설계하고 단순화할수록 모델은 더욱 효율적으로 문맥을 이해하고, 상황에 맞는 판단을 내릴 수 있습니다. 이러한 설계 원칙은 Claude Code뿐 아니라 자체 AI 에이전트를 구축하는 환경에서도 효과적인 Context Engineering 전략으로 활용될 수 있습니다.

300x250

https://claude.com/blog/the-new-rules-of-context-engineering-for-claude-5-generation-models

The new rules of context engineering for Claude 5 generation models | Claude by Anthropic