Opus 5 이후의 CLAUDE.md: 긴 지침이 이제 Claude를 방해하는 이유

Ailoot 사용 방법은 문서에서 확인할 수 있습니다.

Opus 5 출시 후 Claude는 어떻게 달라졌나요?#

Opus 5는 2026년 7월 24일에 출시되었고, Claude Code의 기본 모델이 되었습니다. 모델 자체의 가격, 벤치마크, effort 모드는 별도의 가이드 “Claude Opus 5로 바꿔야 할까요?”에서 자세히 다룹니다. 이 글은 다른 주제를 다룹니다. 모델 출시와 함께 효과적으로 대화하는 방법도 바뀌었습니다.

Anthropic은 Claude 블로그에 분석 글을 게시했습니다. 핵심은 다음과 같습니다.

핵심 표현은 “너무 많은 제약을 둔다”입니다. 모델이 더 약했을 때는 발판이 필요했습니다. 이걸 해라, 저건 하지 마라, 여기 예시가 있다, 한 번 더 반복한다 같은 지침 말입니다. Opus 5에는 더 이상 그런 발판이 필요하지 않습니다. 오히려 방해가 되기 시작할 수도 있습니다. Anthropic은 새 원칙을 간단히 설명합니다. Claude가 스스로 판단하게 하세요.

실제로 여러분에게는 어떤 의미일까요?

• 여러분의 CLAUDE.md는 프로젝트를 위한 시스템 프롬프트와 같은 종류입니다. Anthropic이 자체 프롬프트를 80% 줄였다면, 여러분의 파일도 아마 지나치게 길 것입니다.
• 긴 규칙 목록이 더 이상 지침 준수를 보장하지 않습니다. 오히려 줄이 많을수록 모델이 규칙을 덜 충실하게 따릅니다(아래에서 문서에 나온 수치와 함께 자세히 설명합니다).
• 새로운 메커니즘인 자동 메모리와 스킬이 등장해, 예전에는 CLAUDE.md에 일일이 적어야 했던 작업 일부를 대신합니다.

핵심은 프롬프트 이전에 가장 중요한 일이 일어난다는 것입니다. 첫 요청을 하기 전에 모델의 컨텍스트에 무엇을 넣느냐가 중요합니다. Opus 5 업데이트는 사실상 Anthropic이 같은 생각을 공식적으로 확인한 것입니다. 이번에는 구체적인 수치와 새로운 도구도 함께 제시했습니다. 하나씩 살펴보겠습니다.

긴 CLAUDE.md는 왜 이제 방해가 되나요?#

작동 방식은 이렇습니다. CLAUDE.md는 Claude가 모든 세션 시작 시 읽는 규칙 파일입니다. 별도 가이드 “CLAUDE.md 설정 방법”에서는 처음부터 파일을 만드는 방법을 설명합니다. 이 글은 반대 방향, 즉 이제 무엇을 삭제할지 다룹니다. 여기에 작성한 모든 내용은 첫 요청 이전에 컨텍스트에 들어가 대화 내내 남아 있습니다. 컨텍스트는 무한하지 않습니다. 규칙이 한 줄 늘어날 때마다 작업에 쓸 수 있는 공간이 줄어듭니다.

Claude Code 문서는 이 점을 단도직입적으로 말합니다.

두 번째 요점이 첫 번째보다 중요합니다. 긴 파일은 지침 준수율을 낮춥니다. 모델이 지침에 덜 귀를 기울이기 시작합니다. 거의 모든 초보자가 빠지는 함정입니다. 논리는 빈틈없어 보입니다. Claude가 내 말을 잘 듣게 하고 싶으니 규칙을 더 많이 쓰겠다는 것입니다. 실제로는 그 반대가 일어납니다. 목록이 길수록 모델의 주의가 흩어지고 규칙을 건너뛰는 일이 잦아집니다.

접근 방식은 다음과 같이 달라졌습니다.

두 번째 문제도 있습니다. 모순입니다. 파일이 커질수록 서로 충돌하는 규칙이 거의 필연적으로 쌓입니다. 한 곳에서는 “항상 테스트를 작성하라”고 하고, 다른 곳에서는 “tests 폴더를 건드리지 마라”고 합니다. 문서에 따르면 규칙 두 개가 모순될 경우 Claude는 둘 중 하나를 무작위로 선택할 수 있습니다. 다시 말해 파일이 지나치게 길면 모델의 행동이 덜 예측 가능해집니다.

간단한 규칙은 이렇습니다. CLAUDE.md는 Claude가 스스로 추론할 수 없는 내용을 짧게 적어 두는 곳입니다. 그 밖의 내용은 주의만 빼앗습니다.

CLAUDE.md에 무엇을 남기고 무엇을 삭제해야 하나요?#

문서는 어떤 규칙이 CLAUDE.md에 들어갈 자격이 있는지 판단할 명확한 기준을 제시합니다. 다음에 해당하면 추가하세요.

1. Claude가 같은 실수를 두 번째로 했습니다.
2. 코드 검사에서 모델이 이 프로젝트에 대해 알고 있어야 했던 내용을 놓친 것이 드러났습니다.
3. 채팅에서 같은 수정을 두 번째로 입력하고 있습니다.
4. 팀의 새 구성원이 프로젝트를 망가뜨리지 않으려면 같은 맥락을 알아야 합니다.

일반 원칙은 프로젝트별 함정은 남기고 명백한 내용은 삭제하는 것입니다. Claude Code에는 지나치게 길어진 CLAUDE.md를 정리하도록 제안하는 기본 검사 기능 claude doctor도 있습니다. 코드베이스에서 모델이 추론할 수 있는 세부 정보, 즉 폴더 구조, 의존성 목록, 아키텍처 개요는 덜어 내고 함정, 근거, 기본값과 다른 관례는 남깁니다.

두 번째로 중요한 규칙은 구체성입니다. 모호한 표현은 효과가 없습니다. 다음을 비교해 보세요.

차이는 간단합니다. 모델은 “제대로 포맷하세요”를 원하는 대로 해석할 수 있습니다. “2칸 들여쓰기를 사용하세요”는 모호함 없이 확인할 수 있습니다. CLAUDE.md의 모든 규칙은 따랐는지 여부를 확인하고 눈으로 볼 수 있어야 합니다.

셋째로, 명백한 내용을 삭제하세요. CLAUDE.md에 “깔끔한 코드를 작성하세요”나 “모범 사례를 따르세요”라고 적는다면 잡음입니다. 모델은 이미 알고 있고, 그 문장은 공간을 차지하며 주의를 분산시킵니다. Anthropic은 명백한 내용에 컨텍스트를 쓰지 말라고 명시적으로 권합니다.

CLAUDE.md에 맞지 않는 규칙은 어디로 옮겨야 하나요?#

여기서 가장 과소평가된 도구가 등장합니다. 예전에는 모든 지침을 CLAUDE.md에 둬야 했다면, 이제 긴 절차를 담을 별도의 공간이 생겼습니다. 바로 스킬입니다. 별도의 가이드 “Claude Code 스킬 선택 방법”에서는 스킬을 너무 많이 추가하지 않으면서 적절한 스킬을 선택하는 방법을 설명합니다.

차이는 근본적입니다. CLAUDE.md는 모든 세션 시작 시 전체가 로드됩니다. 스킬은 그렇지 않습니다. 문서는 이렇게 설명합니다.

이를 점진적 공개라고 합니다. 필요할 때 정보를 로드하는 방식입니다. 모델에 적절한 순간에 필요한 만큼 나누어 컨텍스트를 제공한다는 뜻입니다. Anthropic은 코드 리뷰 지침 같은 상세 지침을 스킬로 옮기고 시스템 프롬프트에서는 삭제했습니다.

무엇을 스킬로 옮길지 판단하는 기준은 간단합니다. CLAUDE.md의 한 섹션이 사실에서 절차로 바뀌었는가입니다. “빌드는 npm run build로 실행한다”라는 한 줄 메모는 사실이므로 CLAUDE.md에 두면 됩니다. “프로젝트 게시 방법”에 관한 열 단계는 절차이므로 스킬에 두면 됩니다.

실용적인 원칙은 두어 번 이상 하는 일을 스킬에 맡기는 것입니다. 예를 들어 주간 고객 보고서를 작성하는 방법을 한 번 설명하고, 그 설명을 스킬로 바꾸면 다시 설명할 필요가 없습니다. 스킬은 컨텍스트를 차지하지 않은 채 보관되며 /otchet 같은 명령으로 이름을 불러 사용할 수 있습니다.

스킬로 옮기면 유용한 내용은 다음과 같습니다.

• 여러 단계로 이루어진 절차(게시, 보고서 작성, 릴리스 전 점검).
• 자주는 아니지만 전체가 필요한 긴 지침.
• 한 채팅에서 다른 채팅으로 두 번째나 세 번째 복사한 모든 내용.

중간 선택지도 있습니다. 폴더별 규칙입니다. 지침이 프로젝트의 일부에만 해당한다면 .claude/rules/에 넣고 관련 파일과 연결할 수 있습니다. 그러면 항상 컨텍스트에 남는 대신 Claude가 해당 파일을 다룰 때만 로드됩니다.

자동 메모리란 무엇이고 2026년에 왜 사용해야 하나요?#

CLAUDE.md의 부담을 덜어 주는 두 번째 새 메커니즘은 자동 메모리입니다. Claude는 사용자가 쓴 내용뿐 아니라 스스로 알아낸 내용도 기억합니다. 별도 가이드 “Claude 메모리와 CLAUDE.md 비교”에서는 두 기능의 작동 방식이 어떻게 다른지 설명합니다.

두 종류의 메모리 차이:

작동 방식은 이렇습니다. Claude는 작업을 수행하면서 빌드를 실행하는 명령, 디버깅이 막힌 지점, 사용자가 다르게 해 달라고 요청한 내용처럼 유용한 세부 사항을 알아차리고 메모에 저장합니다. 다음 세션에서 이를 다시 불러옵니다. 중요한 점은 앞으로 유용하다고 판단하는 내용만 선택적으로 저장한다는 것입니다.

메모는 프로젝트마다 별도의 폴더에 저장되며 MEMORY.md라는 색인 파일이 있습니다. /memory 명령으로 확인하고 편집할 수 있습니다. 일반 텍스트 파일이므로 언제든 읽거나, 편집하거나, 삭제할 수 있습니다.

실제로 달라지는 점은 이렇습니다. 예전에는 실수할 때마다 직접 CLAUDE.md에 추가했던 내용 중 일부를 이제 Claude가 기록합니다. 그러면 규칙 파일이 더 짧아집니다. 좋은 일입니다.

Opus 5는 왜 지침에 반박하나요?#

여기에는 이면도 있습니다.

판단을 허용받은 모델은 맥락상 더 나은 선택지가 보이면 경직된 명령에 때때로 반대할 수밖에 없습니다.

Opus 5로 업그레이드한 뒤 문제가 생겼다면 다음을 확인하세요.

1. 기존 스킬과 플러그인을 다시 점검하세요. 이전 모델용 설정은 새로운 논리와 충돌할 수 있습니다. 예전에는 잘 작동하던 것도 다시 테스트해 볼 필요가 있습니다.
2. 가장 경직된 표현을 제거하세요. 5세대 모델은 “절대로 X를 하지 말고, 항상 Y만 하라” 같은 명령보다 이유를 설명하는 유연한 표현을 더 잘 처리합니다.
3. 모델이 너무 일찍 멈추는 경우를 살펴보세요. 지침이 서로 모순되거나 지나치게 길어진 CLAUDE.md의 규칙과 충돌한다는 신호일 수 있습니다.

Opus 5에 맞게 CLAUDE.md를 다시 작성하는 단계별 방법#

이전 모델에서 물려받은 CLAUDE.md를 정리하는 절차는 다음과 같습니다.

1. 기본 검사 실행

   프로젝트에서 claude doctor를 입력하세요. 비대해진 파일에서 무엇을 삭제하고 무엇을 남길지 제안합니다.

2. 명백한 내용 삭제

   Claude가 코드에서 추론할 수 있는 모든 줄을 삭제하세요. 폴더 구조, 라이브러리 목록, “깔끔한 코드를 작성하라” 같은 일반적인 문구가 여기에 포함됩니다.

3. 모순 제거

   파일을 처음부터 끝까지 살펴보며 서로 충돌하는 규칙을 찾으세요. 하나는 남기고 충돌하는 규칙은 삭제하세요.

4. 절차를 스킬로 이동

   사실에서 단계별 지침으로 바뀐 내용은 별도의 스킬로 옮기세요. CLAUDE.md에는 한 줄짜리 링크를 남기세요.

5. 나머지 규칙을 구체적으로 작성

   각 규칙을 확인할 수 있도록 다시 표현하세요. “제대로 포맷하라”는 “2칸 들여쓰기를 사용하라”로 바꿉니다.

6. 자동 메모리를 켜고 길이 확인

   자동 메모리가 작동하는지 확인하고(/memory), 파일이 200줄 미만인지 확인하세요. 그렇지 않다면 옮길 내용이 더 있다는 뜻입니다.

첫 검토를 직접 하지 않으려면 Claude에게 맡기세요. 다음 프롬프트를 시작점으로 사용할 수 있습니다. 복사해서 프로젝트에서 연 세션에 붙여 넣으세요.

내 CLAUDE.md와 코드를 읽어 보세요. 당신의 작업은 5세대 모델에 더 짧고 유용하도록 CLAUDE.md를 다듬는 것입니다.

파일을 살펴보고 모든 규칙을 세 그룹으로 나누세요.

유지 - 프로젝트에만 해당하는 함정과 코드만으로는 추론할 수 없는 관례.

삭제 - 이미 알고 있는 명백한 내용과 코드에서 추론할 수 있는 모든 것.

스킬로 이동 - 현재 CLAUDE.md에 텍스트로 들어 있는 여러 단계의 절차.

그룹 1의 경우, 모호한 규칙을 구체적이고 검증할 수 있도록 다시 표현하세요.
서로 모순되는 규칙을 찾아 별도로 보여 주세요.
200줄 미만의 새 CLAUDE.md 버전과 스킬로 옮기자고 제안하는 항목 목록을 반환하세요.
내가 확인할 때까지 파일을 변경하지 마세요.

마지막 줄에 주목하세요. “내가 확인할 때까지 아무것도 변경하지 마세요.” 이제 모델이 스스로 판단하므로 이 점이 중요합니다. 먼저 계획을 보여 달라고 하고 최종 결정은 여러분이 내리세요.

프롬프트보다 컨텍스트가 더 중요한 이유는 무엇인가요?#

Opus 5에 대한 세부 사항은 제쳐 두고 더 큰 그림을 보면, 이 분석 전체는 한 가지 생각에 관한 것입니다. 컨텍스트가 프롬프트보다 중요하다는 것입니다. 가장 중요한 일은 요청하기 전에, 모델이 작업할 환경을 구성할 때 일어납니다.

CLAUDE.md, 스킬, 자동 메모리는 모두 한 가지에 속합니다. Claude가 첫 메시지를 보내기 전에 보는 내용입니다. 요청 문구를 끝없이 다듬을 수 있지만, 컨텍스트가 잘못 구성되어 있다면—지나치게 긴 CLAUDE.md, 서로 모순되는 규칙, 구조의 부재—결과는 여전히 일관되지 않습니다.

간단히 점검해 보세요. 첫 번째 뇌가 없으면 두 번째 뇌도 도움이 되지 않습니다. 여기서 “두 번째 뇌”는 모델이 모든 요청 때 읽는 프로젝트 지식 구조를 뜻합니다. 하지만 이는 여러분이 작업을 명확히 이해하고 있을 때만 작동합니다. 도구는 여러분의 사고를 증폭하며, 그 역할은 거기까지입니다.

Opus 5 업데이트는 이 논리를 더욱 선명하게 보여 줬습니다. Anthropic은 모델이 충분히 똑똑해지면 규칙을 더하는 것이 오히려 해가 되고, 컨텍스트를 세심하게 구성한 사람에게 이점이 돌아간다는 사실을 직접 보여 줬습니다. Opus 6이든 다른 모델이든 앞으로 나올 모든 모델에 적용할 수 있는 역량입니다.

지금 무엇부터 시작해야 하나요?#

“언젠가”로 미루지 마세요. 지금 CLAUDE.md를 열고 모든 줄을 솔직하게 살펴보는 것이 가장 간단한 첫 단계입니다. Claude가 추론할 수 없는 함정인가요, 아니면 혹시 몰라서 추가한 명백한 내용인가요? 두 번째에 해당하는 것은 모두 삭제 후보입니다.

다음으로 앞 절의 프롬프트로 파일을 검토하고, 긴 절차를 스킬로 옮기고, 자동 메모리가 활성화되어 있는지 확인하세요. 저녁 한 번의 작업으로 컨텍스트가 모델을 위한 간결하고 정확한 기반이 됩니다.

자신의 실제 프로젝트에 CLAUDE.md, 두 번째 뇌, 작업별 스킬을 적용해 볼 수 있습니다.

Ailoot을 알아보세요.