Claude Code · 2026년 7월 25일 ★★★★

앤트로픽이 클로드 코드 시스템 프롬프트를 80% 넘게 걷어냈어요 — 이제 CLAUDE.md도 줄이라고 권해요

앤트로픽이 2026년 7월 24일 공식 블로그에서, 클로드 오푸스 5·페이블 5용 클로드 코드 시스템 프롬프트를 80% 넘게 걷어냈는데도 자체 코딩 평가에서 성능이 떨어지지 않았다고 밝혔어요. 예전에는 '주석은 기본적으로 달지 마라', '여러 문단짜리 문서 주석은 절대 금지', '계획·분석 문서를 만들지 마라' 같은 못 박은 금지 규칙을 넣어뒀는데, 이런 규칙들이 스킬·사용자 요청과 서로 부딪히면서 모델을 필요 이상으로 묶어두고 있었다는 게 이유예요. 그 자리를 '주변 코드와 같은 결로 써라. 주석 밀도·이름·관용구를 맞춰라'는 한 줄 원칙이 대신했고, 글은 사용자가 관리하는 CLAUDE.md도 가볍게 유지하면서 코드만 봐도 알 수 있는 내용 대신 코드베이스의 함정 위주로 쓰라고 권해요.

용어 풀이
시스템 프롬프트
모델이 대화를 시작하기 전에 미리 받아두는 기본 지시문
CLAUDE.md
클로드 코드가 프로젝트마다 자동으로 읽어들이는 지침 파일
운영자 인사이트

모델이 좋아질수록 지침은 쌓는 게 아니라 덜어내는 쪽이 맞다는 신호예요. 그동안 손으로 불려온 CLAUDE.md와 규칙 파일이 지금은 오히려 발목을 잡고 있을 수 있으니, /doctor 명령으로 한 번 정리해 볼 만해요.

여러 관점으로 보기
  • 공식 발표 클로드 코드 시스템 프롬프트를 80% 넘게 지웠는데도 자체 코딩 평가에서 눈에 띄는 성능 손실이 없었다고 밝혔어요. Anthropic
  • 바로 해볼 것 /doctor 명령이 저장소에 넣어둔 CLAUDE.md에서 디렉터리 구조·의존성 목록·아키텍처 개요처럼 코드만 봐도 아는 부분을 잘라내고, 함정과 이유, 기본값과 다른 관례만 남겨줘요. Claude Code Docs
  • 배경 설명 예시를 빼는 게 특히 도움이 됐다는데, 모델이 사람이 준 예시보다 더 창의적이라 예시가 오히려 탐색 범위를 좁혔기 때문이래요. Simon Willison
  • 흐름 정리 짧은 프롬프트에서 긴 프롬프트로 갔다가 다시 짧아지는 한 바퀴를 돌았다고 짚었어요. The Decoder

원본 보기 (hn:claude-code)