Anthropic이 Claude Code의 시스템 프롬프트를 대폭 줄이고 CLAUDE.md 사용을 권장함. 솔직히 옳은 결정이라 생각함.
Anthropic cut most of Claude Code's system prompt and told us to put the rest in CLAUDE.md. Honestly I think this is the right call.
핵심 요약
Anthropic이 Claude Code의 기본 시스템 프롬프트를 줄이고 사용자 정의 CLAUDE.md 활용을 유도하는 변화를 단행했습니다.
- 시스템 프롬프트 축소 — 불필요한 범용 지침을 제거하고 사용자 정의 영역으로 전환함
- CLAUDE.md 활용 — 개별 프로젝트에 특화된 동작 방식을 사용자가 직접 관리하게 됨
- 모델 성능 향상 — 최신 모델에 불필요한 '전문가 엔지니어' 식의 관성적 지침을 배제함
- 설정의 투명성 — 동작 방식을 사용자가 직접 확인하고 수정할 수 있는 구조로 변경됨
혹시 놓친 분들을 위해 말씀드리자면, Anthropic이 Claude Code의 내장 시스템 프롬프트 상당 부분을 삭제했습니다. 거의 대부분을 덜어냈다고 봐도 무방합니다. 이제는 많은 동작 지침을 모두에게 일괄 적용하는 대신, 각자의 CLAUDE.md에 직접 작성하라는 것이 기본 가이드라인입니다.
처음에는 저도 짜증이 났습니다. "Claude가 어떻게 행동해야 하는가"에 대한 부담이 저에게 더 넘어왔기 때문이죠. 하지만 시간이 지날수록 이 결정이 옳다는 생각이 듭니다. 기존의 내장 프롬프트 절반은 최신 모델에는 더 이상 필요 없는 범용적인 지침이었고, "너는 전문가 엔지니어다" 같은 카고 컬트(cargo-cult)식 문구는 이미 효과를 잃은 지 오래였습니다. 모든 사용자에게 그걸 짊어지게 하는 건 아무런 이득 없이 토큰만 낭비하고 유연성만 떨어뜨리는 일이었습니다.
긍정적인 점은 이제 동작 방식의 상당 부분을 숨겨진 상태가 아니라 직접 확인하고 수정할 수 있게 되었다는 것입니다. 부정적인 점은 많은 사람들의 설정이 하룻밤 사이에 조금 나빠졌을 텐데, 그 이유를 모를 수 있다는 겁니다. 왜냐하면 그들의 CLAUDE.md가 사라진 기본값들에 조용히 의존하고 있었기 때문이죠.
이번 변화 이후 여러분의 설정도 다르게 느껴지시나요? 그리고 당연히 처리될 거라 생각했던 것들 중, CLAUDE.md에 다시 추가해야 했던 것은 무엇인가요?


