Claude Code 시스템 프롬프트 80% 축소 — Opus 5가 여전히 72% 증가한 이유

서론

Anthropic은 최근 Claude Code가 최신 모델에 컨텍스트를 제공하는 방식의 큰 변화를 소개했습니다.

Claude Opus 5, Claude Fable 5 및 기타 고급 Claude 5 모델의 경우, 회사는 이전 모델을 올바르게 안내하는 데 사용되었던 시스템 프롬프트의 80% 이상을 제거했다고 밝혔습니다. Anthropic은 또한 이러한 간소화가 코딩 평가에서 측정 가능한 성능 손실을 초래하지 않았다고 말했습니다.

이는 더 강력한 모델이 덜 상세한 규칙을 필요로 한다는 직관적인 이야기처럼 들립니다.

그러나 독립 개발자 Chen Cheng(@chenchengpro)은 Claude Code가 여러 모델 버전에 대해 생성한 출력 컨텍스트를 포착하고 놀라운 시퀀스를 보고했습니다:

Opus 4.8에서 Opus 5로 이동하면서 측정된 프롬프트 내용이 약 72% 증가했습니다.

언뜻 보면 Anthropic의 "80% 이상 제거" 주장과 개발자의 "72% 증가" 결과가 모순되는 것처럼 보입니다.

그러나 그렇지 않습니다.

두 숫자는 서로 다른 기준을 사용하여 Claude Code 전환 프로세스의 서로 다른 측면을 설명합니다. Anthropic은 오래되고 고도로 규정된 프롬프트 아키텍처에서의 전환을 설명합니다. 반면 개발자는 특정 캡처 설정에서 Opus 4.8이 사용한 비정상적으로 간결한 프롬프트와 Opus 5를 비교하고 있습니다.

Claude Code는 실제로 많은 양의 기존 명령 프레임워크를 제거했습니다. 이후 Opus 5는 모델 자율성이 향상됨에 따라 더 두드러지는 행동을 제어하기 위한 작은 규모의 새로운 맞춤형 제약 조건 세트를 획득했습니다.

Anthropic이 이전 프롬프트 내용의 80% 이상을 제거한 방법

Anthropic의 공식 설명은 많은 에이전트 개발자가 인식할 문제에서 시작됩니다: 지침이 쌓이기 시작합니다.

초기 모델이 특정 오류를 반복할 때마다 제품 팀은 규칙을 추가합니다. 불필요한 주석을 작성하면 주석 규칙을 추가합니다. 불필요한 계획 문서를 만들면 문서 규칙을 추가합니다. 도구를 잘못 사용하면 도구 사용 예제를 추가합니다. 작업 결과를 확인하지 않으면 확인 지침을 추가합니다.

시간이 지남에 따라 시스템 프롬프트는 한 번에 하나의 사건만 처리하도록 만들어진 직원 핸드북처럼 되기 시작합니다.

이 접근 방식은 초기 모델에 도움이 되었지만 새로운 문제도 도입했습니다.

지침 중복으로 인한 마찰

Claude Code는 단일 프롬프트만 수신하지 않습니다. 작업 컨텍스트에는 다음이 포함될 수 있습니다:

• 제품 시스템 프롬프트
• 도구 정의
• CLAUDE.md 파일
• 규칙
• 스킬
• 메모리
• 사용자 지침
• 코드 저장소 파일
• 명령 및 도구의 출력

여러 계층의 지침이 반복되거나 서로 약간 모순될 때, 모델은 어떤 지침이 우선해야 하는지 결정하기 위해 추론 노력을 기울여야 합니다.

예를 들어, 한 계층은 적절한 경우 문서를 추가하라고 말하는 반면, 다른 계층은 명시적으로 요청하지 않는 한 주석이나 문서를 만들지 말라고 말할 수 있습니다. 그런 다음 프로젝트 파일이 동일한 동작을 다루는 세 번째 규칙을 추가할 수도 있습니다.

모델은 여전히 올바른 결과를 얻을 수 있지만, 코딩 작업이 시작되기도 전에 컨텍스트는 불필요한 작업을 수행하고 있습니다.

업데이트된 모델은 지역적 판단에 더 의존할 수 있음

Anthropic은 주석과 문서와 관련된 명확한 예를 제시했습니다.

이전 Claude Code는 품질이 낮은 주석과 불필요한 계획 파일을 차단하기 위해 엄격하고 상세한 제한을 사용했습니다. 반면 업데이트된 지침은 훨씬 간결합니다: 주변 프로젝트 스타일과 일관된 코드를 작성하되, 명명 규칙, 관용적 스타일 및 주석 밀도를 포함합니다.

이 변경은 결정 기준을 전역 규칙에서 지역적 증거로 전환했습니다.

시스템은 더 이상 Claude에게 주석이 항상 바람직하지 않다고 말하지 않습니다. 대신 리포지토리의 기존 코드가 의도를 어떻게 전달하는지 확인하도록 요구합니다.

이것이 프롬프트 간소화의 광범위한 패턴입니다:

이전 방식:
발생할 수 있는 다양한 오류를 설명하고 사전에 금지합니다.

새로운 방식:
제품 역할, 도구, 경계 및 관련 증거를 제공한 다음,
모델이 이러한 제약 조건 내에서 스스로 판단하도록 합니다.

Anthropic은 이전 시스템 프롬프트의 80% 이상을 삭제해도 코딩 평가 결과에서 측정 가능한 하락이 발생하지 않았다고 보고했습니다.

이 결과는 지침이 더 이상 중요하지 않다는 것을 의미하지 않습니다. 효과적인 지침이 변경되었음을 의미합니다.

컨텍스트 엔지니어링의 새로운 규칙

Anthropic의 재설계는 몇 가지 "과거와 현재"의 전환으로 요약될 수 있습니다.

이러한 변경 사항은 Anthropic의 내부 시스템 프롬프트에만 적용되지 않습니다. 개발자가 CLAUDE.md, 스킬, 도구 및 사용자 정의 에이전트 프레임워크를 유지 관리하는 방법에도 영향을 미칩니다.

CLAUDE.md를 프로젝트 고유의 사실에 집중하도록 유지

CLAUDE.md 파일은 Claude Code 세션이 시작될 때 로드됩니다. 따라서 Claude가 지속적으로 알아야 하는 리포지토리 정보를 배치하기에 적합합니다.

좋은 내용은 다음과 같습니다:

• 코드에서 추론할 수 없는 아키텍처 결정.
• 필요한 빌드 및 테스트 명령.
• 리포지토리 고유의 규칙.
• 중요한 디렉토리 및 소유권 경계.
• 프로젝트에서 필요로 하거나 금지하는 라이브러리.
• 명확하지 않은 보안 또는 배포 제약.

덜 유용한 내용은 다음과 같습니다:

• Claude가 이미 알고 있는 일반적인 조언.
• 가끔만 사용되는 장황한 운영 단계.
• 패키지 파일이나 소스 코드에서 직접 볼 수 있는 사실.
• 도구, 스킬 및 사용자 프롬프트에서 반복되는 동일한 지침.
• 매 요청마다 컨텍스트를 소모하는 대규모 예제.

Claude Code의 현재 문서는 CLAUDE.md를 간결하게 유지하고 절차적이거나 참조 집약적인 자료는 필요에 따라 로드되는 스킬 파일로 이동할 것을 권장합니다.

중앙 집중식 파일은 다음과 같을 수 있습니다:

# 프로젝트 가이드

- 모든 패키지 관리 명령은 pnpm을 사용합니다.
- 코드 변경 완료를 보고하기 전에 `pnpm test` 및 `pnpm lint`를 실행합니다.
- 공개 API는 `packages/sdk` 아래에 정의되어 있습니다. 호환성을 깨뜨리는 변경을 피하세요.
- 데이터베이스 마이그레이션에는 해당 롤백 파일이 포함되어야 합니다.
- `src/generated` 아래의 생성된 파일을 직접 편집하지 마세요.

일반적인 소프트웨어 엔지니어링 동작을 상세히 설명할 필요는 없습니다.

긴 단계를 스킬로 마이그레이션

스킬은 재사용 가능한 지침을 SKILL.md 파일로 패키징합니다. 스킬이 사용될 때만 전체 내용이 로드되며, 관련 없는 작업마다 컨텍스트를 소모하지 않습니다.

따라서 스킬은 다음과 같은 워크플로우에 더 적합합니다:

• 풀 리퀘스트 검토.
• 릴리스 준비.
• 보안 점검.
• 프론트엔드 검증.
• 데이터베이스 마이그레이션.
• 이벤트 조사.
• 문서 게시.

최소한의 검토 스킬은 다음과 같이 구성될 수 있습니다:

description: 풀 리퀘스트의 정확성, 회귀 문제 및 누락된 테스트를 검토합니다.

# 풀 리퀘스트 리뷰

1. 전체 차이점과 영향받는 테스트를 읽습니다.
2. 스타일 선호도보다는 구체적인 결함을 우선 식별합니다.
3. 최소한의 관련 테스트 스위트를 실행합니다.
4. 공개 동작 또는 호환성 변경 여부를 확인합니다.
5. 심각도별로 발견 사항을 보고하고 파일 참조를 첨부합니다.

이 단계는 리뷰 작업 시작 시에만 사용 가능하며, Claude에게 단순히 변수명 변경만 요청하는 경우에는 부담을 주지 않습니다.

이는 점진적 공개 방식입니다: 중요한 지점에 적절한 컨텍스트를 제공합니다.

## 중복 지침 제거

일반적으로 각 지침은 하나의 권위 있는 위치에만 존재해야 합니다.

예시:
- 제품 수준 동작은 시스템 프롬프트에 속합니다.
- 프로젝트 수준 사실은 `CLAUDE.md`에 속합니다.
- 재사용 가능한 단계는 스킬에 속합니다.
- 도구별 요구사항은 도구 정의에 속합니다.
- 결정적 실행은 훅, 권한, 테스트 또는 스크립트에 속합니다.

각 계층에서 동일한 규칙을 반복한다고 해서 반드시 효과가 강화되는 것은 아니며, 오히려 컨텍스트 크기가 증가하고 표현 차이가 발생하며 유지보수가 어려워질 수 있습니다.

새로운 지침을 추가하기 전에 스스로에게 질문하세요:

1. 이 내용이 이미 다른 곳에 표현되어 있지 않은가?
2. Claude가 코드베이스에서 추론할 수 있는가?
3. 이것은 사실, 단계, 아니면 하드 실행 요구사항인가?
4. 모든 요청마다 로드해야 하는가?
5. 텍스트 설명보다 테스트나 훅이 해당 규칙을 더 안정적으로 실행하는가?

## 더 나은 도구 설계, 더 많은 예제 작성 대신

초기 프롬프트 엔지니어링 가이드에서는 여러 도구 사용 예제를 제공할 것을 권장하는 경우가 많았습니다.

Anthropic은 예제가 고급 모델이 시연된 경로를 따르도록 제한할 수 있다고 봅니다. 모델이 현재 작업에 더 적합한 매개변수나 도구 조합을 선택하기보다 샘플을 모방할 수 있습니다.

잘 설계된 도구는 인터페이스를 통해 사용 방법을 명확하게 전달해야 합니다:
- 명확한 매개변수 이름.
- 정확한 설명.
- 명시적인 선택적 필드.
- 유용한 열거값.
- 예측 가능한 출력.
- 실행 가능한 오류 메시지.

예를 들어, 다음과 같은 열거값은:

```JSON
{
"status": "pending | in_progress | completed"
}

유효한 상태 전환 규칙을 긴 문단보다 더 직접적으로 전달합니다.

몇 가지 고정된 예제를 포함합니다.

형식이나 경계 동작이 모호할 수 있는 경우에는 예제가 여전히 유용합니다. 이 변경은 "예제를 절대 사용하지 말라"는 것이 아니라 "예제를 잘 설계된 인터페이스의 대체재로 사용하지 말라"는 의미입니다.

실행 가능한 참조 제공

새로운 Claude 모델은 더 풍부한 참조를 기반으로 직접 작업할 수 있습니다.

개발자는 모든 요구사항을 글로 설명할 필요 없이 다음을 제공할 수 있습니다:

• 기존 코드.
• 테스트 케이스.
• 실패한 명령어.
• HTML 프로토타입.
• 스크린샷.
• 패턴.
• 디자인 산출물.
• 벤치마크 스크립트.
• 샘플 입력과 예상 출력.

실행 가능한 테스트는 "구현이 올바르게 동작해야 한다"는 여러 문단의 설명보다 성공 기준을 더 명확하게 정의하는 경우가 많습니다.

이것이 컨텍스트 엔지니어링을 방대한 작업 매뉴얼 작성에서 더 나은 작업 환경 설계로 변화시킵니다.

독립 조사에서 72% 회귀 발견

Anthropic이 80% 감소를 발표한 후, 개발자 Chen Cheng은 Claude Code가 실제로 여러 Opus 모델에 전송하는 내용을 테스트했다고 보고했습니다.

그는 CLI를 로컬 서버로 리디렉션하고 아웃바운드 요청 내용을 기록했습니다. 그가 공개한 문자 수는 다음과 같습니다:

Opus 4.7: 15,225자
Opus 4.8: 4,467자
Opus 5: 7,694자

이 수치는 세 가지 다른 비교를 보여줍니다:

따라서 이번에 포착된 Opus 5 프롬프트는 Opus 4.8보다 훨씬 길지만, Opus 4.7 길이의 약 절반 정도입니다.

이는 토큰 수가 아닌 문자 수입니다. 또한 이는 포착된 하나의 Claude Code 설정만을 나타낼 뿐, 모든 요청의 일반적인 사양은 아닙니다.

Claude Code는 도구, 구성, 기능 및 제품 상태에 따라 컨텍스트를 동적으로 조합합니다. 정확한 전송 내용은 버전과 환경에 따라 달라질 수 있습니다.

왜 80%와 72% 두 숫자 모두 맞을 수 있는가

서로 다른 기준을 구분하면 이 명백한 모순은 사라집니다.

Anthropic의 숫자는 아키텍처 정리를 설명합니다

Anthropic은 구식 명령 중심 설계와 비교하여 고급 Claude 5 모델이 사용하는 시스템 프롬프트의 80% 이상을 제거했다고 밝혔습니다.

이 숫자는 더 새로운 컨텍스트 엔지니어링 아키텍처로 전환하는 과정에서 제거된 레거시 프롬프트의 양과 관련이 있습니다.

이는 모든 Opus 5 요청이 문자 수 기준으로 모든 Opus 4.8 요청보다 80% 짧다는 주장이 아닙니다.

개발자의 숫자는 두 개의 인접한 포착 결과를 비교합니다

72% 숫자는 기록된 Opus 5 요청과 개발자가 포착한 비정상적으로 작은 Opus 4.8 요청을 비교한 것입니다.

Opus 4.8은 세 모델 비교 중 최저점인 것으로 보입니다. 반면 Opus 5는

목표 지향적 지침을 추가하면서도 전체 길이는 이전 Opus 4.7 경로보다 여전히 훨씬 짧습니다.

따라서 두 주장은 공존할 수 있습니다:

레거시 프롬프트 아키텍처 → 고급 모델 프롬프트:
전체적으로 대폭 축소.

Opus 4.8 포착 → Opus 5 포착:
최소 측정 버전 대비 부분적 증가.

Claude Code는 다른 프롬프트 경로를 유지하는 것으로 보입니다

개발자의 조사는 또한 Claude Code 구현에 두 세트의 프롬프트 경로가 포함되어 있다고 보고했습니다.

라우팅 함수는 오래된 모델 식별자에는 더 상세한 레거시 프롬프트를, 최신 모델에는 단순화된 프롬프트를 선택합니다.

보고된 로직에 따르면, 레거시 Opus, Sonnet, Haiku 및 Claude 3 시리즈 등의 모델은 상세 프롬프트 경로에 있는 반면, Opus 4.8, Opus 5, Fable 5 및 기타 최신 모델은 더 짧은 아키텍처를 사용합니다.

이 라우팅 세부사항은 Anthropic의 공식 아키텍처 문서가 아닌 타사 조사에서 비롯된 것입니다.

그러나 이는 Anthropic의 공개 설명과 일치합니다. 더 강력한 모델은 덜 규범적인 프레임워크에서 작동할 수 있는 반면, 오래된 모델은 새 모델이 컨텍스트에서 추론할 수 있는 명시적 제약이 여전히 필요할 수 있습니다.

왜 Opus 5에 새로운 목표 지향적 지침이 필요한가

Claude Opus 5는 장기적인 자율 작업에서 이전 Opus 모델보다 훨씬 뛰어난 능력을 가지고 있습니다.

이러한 능력은 대규모 작업에서 유용하지만 소규모 작업에서는 비용이 많이 들거나 주의를 분산시키는 행동을 도입합니다.

Anthropic 공식 Opus 5 프롬프트 가이드는 조정이 필요할 수 있는 몇 가지 측면을 강조합니다:

• 응답 길이와 장황함
• 사용자 대상 진행 상황 업데이트
• 문서 형태 산출물의 길이
• 작업 범위
• 과도한 검증
• 하위 에이전트 위임
• 자체 수정

보고된 개발자 차이 분석에 따르면 작업 수행과 수정 처리 관련 많은 새로운 콘텐츠가 등장했습니다.

정확한 비공개 텍스트는 공식적인 공개 규범으로 간주되어서는 안 되지만, 이 범주들은 Anthropic이 발표한 Opus 5 가이드와 매우 일치합니다.

진행 업데이트가 너무 빈번해질 수 있음

장시간의 마이그레이션이나 저장소 전체 조사에서는 진행 보고서가 유용합니다.

소규모 변경의 경우 빈번한 설명이 지연과 토큰 소비를 증가시키면서 코드 개선에는 도움이 되지 않습니다.

유용한 에이전트 전략은 이 두 경우를 구분해야 합니다:

장시간의 다단계 작업에서 업데이트가 사용자의 상태 파악이나 의사 결정에 도움이 될 때 진행 상황을 보고하세요.
일상적인 도구 호출을 매번 설명하지 마세요.

목표는 침묵이 아니라 균형 잡힌 커뮤니케이션입니다.

더 강력한 모델이 작업 범위를 과도하게 확장할 수 있음

고급 코딩 에이전트는 요청된 변경을 완료하면서 관련 문제를 발견할 수 있습니다.

때로는 이러한 주도성이 가치 있습니다. 다른 때는 간단한 요청이 사용자 승인 없이 광범위한 리팩토링으로 이어질 수 있습니다.

Opus 5의 경우, 작업 경계는 모델의 능력이 더 강력하기 때문에 더욱 중요해집니다.

추가 작업을 더 잘 찾아냅니다.

명확한 요청은 다음과 같이 표현할 수 있습니다:

보고된 문제와 직접 영향을 받는 테스트를 수정하세요.
관련 없는 모듈을 리팩토링하거나 공개 API를 확장하지 마세요.

경계 조건은 각 구현 단계를 규정하지 않고 "완료"의 의미를 정의합니다.

하위 에이전트가 비용을 증가시킬 수 있음

Anthropic에 따르면 Opus 5는 이전 모델보다 하위 에이전트를 더 선호합니다.

작업이 진정으로 독립적이고 병렬 처리가 가능할 정도로 규모가 클 때 위임은 가치 있습니다. 작업이 적은 도구 호출로 직접 완료될 수 있을 때 위임은 비효율적입니다.

공식 가이드는 명확한 조건이나 결정적 제한을 제공할 것을 권장합니다.

실용적인 지침은 다음과 같습니다:

규모가 크고 독립적인 워크플로우에만 하위 에이전트를 사용하세요.
직접 완료할 수 있는 작업을 반복하거나 검증하기 위해 하위 에이전트를 만들지 마세요.
동시 에이전트 수는 적게 유지하세요.

이는 유용한 기능을 비활성화하지 않으면서 비용과 시간을 제어합니다.

반복적인 자체 수정이 낭비를 초래할 수 있음

Opus 5는 자체적으로 많은 오류를 발견하고 수정하도록 설계되었습니다.

"모든 것을 다시 확인", "다시 검증", "다른 에이전트로 재검증"을 반복 요청하는 프롬프트는 모델의 본능적 행동을 중첩시킵니다.

Anthropic은 중복 검증 명령을 제거하면 품질 저하 없이 불필요한 토큰 소비를 줄일 수 있다고 말합니다.

검증은 여전히 중요하지만, 구체적인 증거에 기반해야 합니다:

• 관련 테스트 실행
• 프로젝트 컴파일
• 렌더링 페이지 확인
• 출력을 사양과 대조
• 최종 차이점 확인

비효율적인 패턴은 객관적 검사가 이미 통과된 후에도 추가적인 추상적 반성을 요구하는 것입니다.

개발자는 이제 어떻게 조정해야 하는가

공식 가이드와 독립 테스트는 동일한 실천적 교훈을 지적합니다: 컨텍스트는 기능 중심으로 구성되어야 하며 우려 사항의 축적에 따라 구성되어서는 안 됩니다.

1. 전체 컨텍스트 스택 검토

Claude에 영향을 줄 수 있는 모든 요소를 확인하세요:

• CLAUDE.md
• 규칙
• 스킬
• 도구 설명
• 훅
• MCP 서버 지침
• 사용자 프롬프트
• 에이전트 프레임워크의 사용자 정의 시스템 프롬프트

중복, 충돌, 구식, 너무 광범위한 지침을 찾으세요.

1. CLAUDE.md에만 명확하지 않은 프로젝트 규칙 유지

Claude가 소스 파일, 패키지 목록 또는 표준 규범에서 직접 얻을 수 있는 정보는 제거하세요.

그렇지 않으면 보이지 않는 결정 내용을 유지하세요.

1. 프로세스를 스킬로 이동

특정 부분이 고정된 사실이 아닌 반복 가능한 시퀀스를 설명하는 경우 스킬로 변환하세요.

이렇게 하면 기본 컨텍스트 규모가 줄어들고 워크플로우를 재사용할 수 있습니다.

1. 도구 설명은 도구 내에 배치

시스템 프롬프트, CLAUDE.md 및 매 사용자 요청에서 도구의 매개변수 규칙을 반복하지 마세요.

도구에 명확하게 표현된 아키텍처와 정확한 설명을 제공하세요.

1. 긴 설명 대신 테스트와 참조 사용

가능하면 성공을 정의하는 실제 산출물을 제공하세요.

실패한 테스트, 프로토타입, 아키텍처 또는 예상 출력은 "결과가 어떤 모습이어야 하는지"에 대한 긴 설명보다 더 정확합니다.

1. Opus 5의 주도적 행동에 경계 설정

소규모 작업의 경우 명확히 하세요:

• 허용된 범위
• 하위 에이전트 사용의 적절성
• 진

행 설명이 얼마나 유용한지

• 필요한 검증
• 에이전트가 언제 중단해야 하는지

방대한 일반 매뉴얼을 복원하여 해결하지 마세요.

1. Claude Code 진단 도구 실행

Anthropic에 따르면 현재 모범 사례는 Claude Code 의사 워크플로우에 통합되어 있습니다.

셸에서 다음을 실행하세요:

claude doctor

Claude Code 내부에서 다음을 실행하세요:

/doctor

진단은 설치, 구성, MCP 서버 및 컨텍스트 사용을 확인할 수 있습니다. 현재 버전은 너무 크거나 유효하지 않은 컨텍스트 구성을 식별하는 데 도움이 될 수 있습니다.

프로젝트 지침을 무턱대고 삭제하지 말고 제안 사항을 검토해야 합니다.

전후 컨텍스트 예시

과부하된 구성

## CLAUDE.md

편집 전에 항상 저장소를 확인하세요.
항상 깨끗한 코드를 작성하세요.
항상 모든 변경 사항을 테스트하세요.
불필요한 주석을 추가하지 마세요.
불필요한 파일을 추가하지 마세요.
아래 예시와 정확히 일치하게 테스트 도구를 사용하세요...

[검토, 릴리스, 테스트 및 도구 설명에 대한 몇 페이지]

이 파일은 일반적인 기대, 반복 가능한 프로세스, 작업마다 적용 가능성이 다른 도구 문서를 포함합니다.

집중된 구성

## CLAUDE.md

- pnpm 사용; 이 저장소는 npm이나 yarn을 지원하지 않습니다.
- `packages/sdk`에서 공개 API 호환성 필요.
- 코드 변경 완료 전에 `pnpm test` 및 `pnpm lint` 실행.
- 릴리스 단계는 `/release-check` 스킬에 있음.
- 보안 검토 단계는 `/security-review` 스킬에 있음.

더 작은 파일은 프로젝트별 정보를 유지하고 조건부 프로세스를 스킬에 위임합니다.

이것이 프롬프트 축소의 실제 의미입니다: 더 적은 영구 명령, 더 나은 구조화된 컨텍스트.

측정 결과는 아무것도 증명하지 않음

보고서의 문자 수는 유용하지만 과도하게 해석되어서는 안 됩니다.

다음을 증명하지 않습니다:

• 모든 Opus 5 요청이 항상 정확히 7,694자를 포함함
• 시스템 프롬프트 길이가 코딩 품질을 직접 예측함
• 짧은 프롬프트가 자동으로 더 좋음
• Anthropic의 80% 데이터가 거짓임
• Opus 5가 세션당 Opus 4.8보다 72% 더 많은 총 컨텍스트를 필요로 함
• 캡처된 텍스트가 제품 사용의 모든 동적 지침을 포함함

프롬프트 길이는 변수 중 하나일 뿐입니다.

지침의 품질, 컨텍스트 순서, 프롬프트 캐싱, 도구 설계, 스킬, 저장소 증거 및 모델 능력이 결과에 영향을 미칩니다.

간결한 프롬프트는 모호할 수 있고; 긴 프롬프트는 정확할 수 있습니다. 목표는 최소 문자 수가 아니라 모델에 필요한 정보와 경계를 안정적으로 제공하는 최소 컨텍스트입니다.

에이전트 구축자를 위한 더 큰 교훈

모델이 개선됨에 따라 지침 설계는 미시 관리에서 거버넌스로 전환됩니다.

오래된 에이전트는 일반적으로 각 단계를 수행하는 방법에 대한 자세한 설명이 필요했습니다. 더 강력한 모델은 도구와 증거에서 더 많은 방법을 발견할 수 있습니다.

이것이 인간의 역할을 없애지는 않습니다. 인간 노력이 가장 가치 있는 곳을 변화시킵니다.

에이전트 구축자는 각 예상 행동을 열거하는 데 시간을 덜 쓰고 다음 정의에 더 많은 시간을 사용해야 합니다:

• 사용 가능한 도구

• 권한 경계

• 사실 출처

• 성공 기준

• 범위 제한

• 비용 제어

• 에스컬레이션 경로

• 결정적 검사

모델은 각 동작에 대해 더 적은 조언이 필요하면서, 무엇을 할 수 있는지, 무엇을 증명해야 하는지, 언제 중단해야 하는지에 대해 더 명확한 권한이 필요합니다.

자주 묻는 질문

Anthropic이 실제로 Claude Code의 시스템 프롬프트에서 80% 이상을 삭제했나요?

Anthropic은 공식적으로 Claude Opus 5 및 Claude Fable 5와 같은 고급 모델에 대한 시스템 프롬프트 내용의 80% 이상을 삭제했다고 밝혔습니다.

해당 회사는 또한 이번 변경이 코딩 평가에서 측정 가능한 손실을 초래하지 않았다고 밝혔습니다.

왜 캡처된 Opus 5 프롬프트가 Opus 4.8보다 72% 더 길까요?

72%라는 수치는 Opus 4.8을 기준으로 합니다. 개발자가 캡처한 데이터에서 Opus 4.8의 프롬프트는 4,467자로 매우 간결했던 반면, Opus 5는 추가적인 맞춤형 지침을 받은 후 7,694자로 측정되었습니다.

15,225, 4,467, 7,694라는 숫자는 Anthropic의 공식 데이터인가요?

아닙니다. 이 데이터는 Claude Code CLI를 로컬 서버로 리디렉션하고 나가는 요청을 확인한 한 독립 개발자가 보고한 것입니다. Anthropic은 이 문자 수를 고정 또는 표준 수치로 공개하지 않았습니다.

Opus 5의 프롬프트는 여전히 Opus 4.7의 프롬프트보다 짧은가요?

보고된 캡처 기준으로는 그렇습니다. Opus 5의 7,694자 프롬프트는 Opus 4.8보다 길지만, Opus 4.7의 15,225자 프롬프트보다는 약 49.5% 짧습니다.

CLAUDE.md에는 무엇을 남겨야 하나요?

모델이 리포지토리에서 안정적으로 유추할 수 없는 프로젝트 특정 사실과 규칙을 남기세요. 길고 조건부 프로세스는 스킬로 옮기고, 일반적이거나 반복되는 지침은 제거하세요.

긴 워크플로를 스킬로 만들어야 하는 이유는 무엇인가요?

스킬의 세부 내용은 필요할 때만 로드되며, 모든 요청마다 차지하지 않습니다. 이는 점진적 공개를 지원하고, 관련 없는 세션이 기본 컨텍스트에 리뷰, 배포 등의 프로세스를 포함하는 것을 방지합니다.

Opus 5는 이전 모델보다 더 엄격한 프롬프트가 필요한가요?

다른 종류의 프롬프트가 필요합니다. Anthropic은 불필요한 비용이나 시간이 발생할 때 장황함, 진행 업데이트, 작업 범위, 과도한 검증, 하위 에이전트 생성 및 자기 수정을 제어할 것을 권장합니다.

내 Claude Code 컨텍스트가 너무 큰지 어떻게 확인하나요?

셸에서 claude doctor를 실행하거나 Claude Code 내에서 /doctor를 실행하세요. 또한 CLAUDE.md, 스킬, 도구 설명 및 중복 지침을 수동으로 확인하세요. 자동 진단은 프로젝트별 요구 사항을 파악할 수 없기 때문입니다.

관련 도구

• Claude Code: 리포지토리 탐색, 편집, 테스트 및 자동화를 위한 Anthropic의 에이전트 코딩 환경
• Claude Code Skills: 재사용 가능한 워크플로와 참고 자료를 SKILL.md 파일로 패키징하여 필요 시 로드
• Claude Code 구성 디버거: 지침, 스킬, 훅, 설정 또는 MCP 서버가 작동하지 않는 이유를 진단하는 데 도움
• Claude Opus 5 프롬프트 가이드: 범위, 장황함, 진행, 하위 에이전트, 검증 등에 대한 공식 모델별 지침

수정 항목.

• Model Context Protocol: 에이전트 시스템을 외부 도구 및 데이터 소스와 연결하기 위한 개방형 표준

관련 링크

• Claude 5 모델 컨텍스트 엔지니어링의 새로운 규칙: 80% 축소와 업데이트된 컨텍스트 엔지니어링 원칙에 대한 Anthropic의 공식 설명
• Claude Opus 5 프롬프팅: 새 모델의 주도성과 에이전트 행동을 제어하는 공식 가이드
• 프롬프트 모범 사례: Anthropic의 지침, 도구, 추론, 에이전트 시스템 및 마이그레이션에 대한 광범위한 참고 자료
• 스킬로 Claude Code 확장하기: 재사용 가능한 온디맨드 컨텍스트 생성 및 구성에 대한 공식 설명
• Claude Code 기능 가이드: CLAUDE.md, 스킬, 훅, 하위 에이전트 및 관련 제어 기능 사용 시기에 대한 설명
• 개발자 측정 게시글: 보고서의 시스템 프롬프트 문자 수가 인용된 타사 스크린샷

요약

Anthropic의 80% 축소와 개발자가 보고한 72% 증가는 서로 다른 비교를 설명합니다. Claude Code는 고급 모델을 대상으로 한 방대한 레거시 및 고도로 규정적인 지침을 제거했습니다. 이후 캡처된 Opus 5 프롬프트는 매우 간결했던 Opus 4.8 버전과 비교하여 맞춤형 지침이 추가되었습니다.

보고된 Opus 5 프롬프트 길이는 여전히 캡처된 Opus 4.7 프롬프트의 약 절반입니다. 추가된 지침은 Anthropic이 공개적으로 밝힌 Opus 5의 행동과 일치합니다: 더 많은 진행 설명, 더 넓은 작업 범위, 더 빈번한 하위 에이전트 위임, 더 긴 결과물 및 반복적인 자기 수정.

개발자에게 유용한 대응은 가장 짧은 프롬프트를 추구하는 것이 아닙니다. CLAUDE.md를 집중된 상태로 유지하고, 조건부 워크플로를 스킬로 옮기고, 중복을 제거하고, 도구 인터페이스를 개선하고, 실행 가능한 참조를 제공하고, 범위, 비용 및 완료에 대한 명확한 한계를 설정하세요.

새로운 컨텍스트 엔지니어링 규칙은 '무슨 수를 써서라도 적게 말하라'가 아니라 '해당 계층에서 모델이 필요한 지침만 로드하라'입니다.