앤스로픽은 Claude Code 지침을 80% 넘게 줄였다

앤스로픽은 Claude Opus 5와 Claude Fable 5에 쓰는 Claude Code 시스템 프롬프트를 80% 넘게 줄였고, 코딩 평가에서 측정 가능한 성능 저하는 없었다고 밝혔다. Claude Code를 쓰거나 자체 에이전트를 만드는 사람이라면 지침을 더하는 대신 현재의 시스템 프롬프트와 CLAUDE.md, Skills를 간결하게 정리할 수 있다는 제안이다.

컨텍스트 엔지니어링(context engineering)은 사용자의 메시지뿐 아니라 시스템 프롬프트, Skills, CLAUDE.md 파일, 메모리 등 여러 출처에서 모델이 참고할 정보를 구성하는 일이다. 여러 요청에 두루 쓰이는 지침을 어떻게 설계할지가 핵심이다.

무엇을 바꾸라는 뜻인가?

앤스로픽의 경험을 한마디로 요약하면 모델을 세세한 규칙으로 묶기보다, 필요한 정보를 적절한 때 제공하라는 것이다. 컨텍스트는 작업에 필요한 자료를 그때그때 꺼내 쓰는 서랍장에 빗대면 이해하기 쉽다. 이 글은 최신 모델이 주변 맥락과 판단을 더 잘 활용하므로 예전 모델을 위한 제약과 중복 지침을 줄일 수 있다고 주장한다.

앤스로픽은 내부에서 Claude Code를 쓴 기록을 살펴보니 한 요청 안에 “필요하면 문서를 남겨라”와 “주석을 추가하지 마라”처럼 충돌하는 지침이 함께 들어가는 경우가 있었다고 설명한다. 과거에는 파일 삭제 같은 최악의 상황을 막기 위해 강한 규칙이 필요했지만, 이제는 여러 제약을 지우고 모델이 맥락에 따라 판단하게 할 수 있다는 것이다. Claude Code에 메모리, 아티팩트, Skills 같은 기능이 생겨 CLAUDE.md 하나에 정보와 지침을 모을 필요도 줄었다고 덧붙인다.

어떤 지침을 어떻게 바꾸나?

앤스로픽이 제시한 변화는 여섯 가지다. 이전 방식과 새 권고를 짝지으면 다음과 같다.

• 규칙을 주기보다 모델의 판단을 활용한다. 예전 시스템 프롬프트는 코드에 주석을 기본적으로 쓰지 말고, 여러 문단짜리 문서 주석이나 여러 줄 주석을 만들지 말며, 요청이 없으면 계획·결정·분석 문서를 만들지 말라고 했다. 하지만 사용자 선호나 복잡한 코드에 따라 이런 규칙이 맞지 않을 수 있다. 새 프롬프트는 주변 코드의 주석 밀도와 이름 짓기, 관용적 표현에 맞춰 코드를 작성하라고 한다.
• 도구 사용 예시를 나열하기보다 인터페이스를 설계한다. 예시가 모델의 탐색 범위를 제한할 수 있으므로 도구·스크립트·파일의 매개변수가 더 표현력 있게 구성됐는지 살펴보라고 권한다. 예를 들어 Todo 도구의 상태를 pending, in_progress, completed로 정하고 동시에 진행 중인 항목은 하나만 두도록 하면 도구의 사용 방식과 기대 행동을 정의할 수 있다.
• 모든 정보를 앞에 넣기보다 점진적으로 공개한다. 코드 검토와 검증에 관한 상세 지침은 별도 Skill로 옮겨 필요할 때 불러오게 했다. 도구도 지연 로딩 방식으로 제공할 수 있다. 이 경우 에이전트는 ToolSearch로 도구의 전체 정의를 찾아야 하며, Task 도구처럼 필요할 때까지 컨텍스트를 차지하지 않는 도구를 더 많이 둘 수 있다. CLAUDE.md와 Skill 파일도 모든 관행을 한곳에 모으기보다 필요할 때 읽을 파일 구조를 만들라고 권한다.
• 같은 지침을 반복하기보다 도구 설명을 간결하게 쓴다. 예전 모델은 컨텍스트 끝부분의 지침을 더 잘 따르거나 반복 지시가 필요할 때가 있었다. 앤스로픽은 도구 사용법을 시스템 프롬프트와 도구 설명에 중복해 쓰는 대신 도구 설명에 두면 된다고 말한다.
• 메모리를 CLAUDE.md에 직접 기록하기보다 자동 메모리를 활용한다. 이전에는 # 단축키로 메모리를 CLAUDE.md에 쓰도록 권했지만, 현재는 Claude가 작업과 사용자에게 관련 있는 메모리를 자동으로 저장한다고 설명한다.
• 단순한 명세서 대신 풍부한 참고 자료를 제공한다. 계획이나 긴 프로젝트를 위한 자료로 간단한 마크다운 문서만 쓰기보다 아티팩트 기능으로 만든 HTML, 상세한 테스트 모음, 다른 코드베이스의 함수, 평가 기준표 등을 참고 자료로 사용할 수 있다. 평가 기준표는 동적 워크플로와 검증 에이전트를 통해 특정 분야의 선호를 시험하는 데 쓸 수 있다.

직접 구성할 때 무엇을 남길까?

시스템 프롬프트에는 에이전트가 어떤 제품에서 무엇을 하는지 적는다. Claude Code에서는 사용자가 이를 수정할 일이 거의 없지만, 자체 에이전트 환경을 만든다면 이 부분에 시간을 들이라고 앤스로픽은 권한다.

CLAUDE.md는 저장소의 용도를 짧게 설명하고, 코드베이스에서 주의할 점에 토큰을 주로 쓴다. 파일과 저장소만 보면 알 수 있는 명백한 사실은 반복하지 않는 편이 좋다. 검증 방법처럼 고유한 지침이 여러 개라면 별도 Skill로 만들고 CLAUDE.md에서 참조하는 식으로 정보를 나눌 수 있다.

Skills는 Claude가 필요할 때 정보를 찾도록 돕는 간결한 안내서로 구성한다. 중요한 영역이 아니라면 지나치게 제약적으로 만들지 말고, 길이가 길면 여러 파일로 나눠 필요한 정보만 불러오게 한다. 팀이나 제품에 고유한 관점·지식·모범 사례를 담는 데 적합하다고 앤스로픽은 설명한다.

참고 자료는 @로 파일을 언급해 포함할 수 있다. 계획의 세부 정보가 담긴 명세서, 목업, 코드베이스 등을 활용할 수 있으며, 앤스로픽은 설명이나 스크린샷보다 코드로 된 자료를 우선하라고 권한다. 예를 들어 디자인을 설명하는 문장이나 스크린샷보다 HTML 목업이 더 나은 결과를 낼 수 있다고 주장한다.

Claude Code에서는 claude doctor를 실행하거나 /doctor 명령을 사용해 Skills와 CLAUDE.md의 크기를 적정하게 조정할 수 있다. 앤스로픽은 이 기능이 간소화 작업을 자동으로 돕는다고 소개한다. 더 발전된 모델을 위한 프롬프트 안내는 Fable 가이드, 컨텍스트 엔지니어링의 개요는 에이전트를 위한 효과적인 컨텍스트 엔지니어링, 동적 워크플로의 설명은 Claude Code의 작업별 하네스를 참고할 수 있다.

80% 넘게 줄였다는 결과는 앤스로픽이 자사 코딩 평가에서 측정한 값이다. 원문은 평가의 구체적인 조건이나 점수, 다른 모델·작업에서도 같은 결과가 나오는지는 밝히지 않는다.