참고팁X
CLAUDE.md/AGENTS.md 가이드가 실제 코드와 충돌할 때 해결책
LLM이 가이드 파일보다 기존 코드 컨벤션을 우선하도록 프롬프트를 추가해 코드 오염을 방지할 수 있습니다.
요약
최근 연구 결과, AI 에이전트인 Claude Code와 Codex가 CLAUDE.md 및 AGENTS.md 파일의 지침을 실제 코드보다 우선시하여 코드 오류를 유발하는 현상이 발견되었습니다. 연구진이 40개의 프로젝트를 대상으로 실험한 결과, Claude Code는 코드와 문서가 충돌할 때 80번의 실행 중 79번이나 구식 문서 지침을 따랐으며, Codex는 20번이나 정상 작동하던 코드를 문서에 맞춰 수정해 17번의 테스트 실패를 야기했습니다. 이는 모델이 코드보다 지침(Instruction)을 더 신뢰하도록 학습되었기 때문입니다. 이를 해결하기 위해서는 CLAUDE.md나 AGENTS.md 파일에 '코드와 문서가 충돌할 경우 기존 코드의 규칙을 따르고, 불일치 사항을 보고하라'는 지침을 추가해야 합니다. 해당 문구를 추가한 결과, 에이전트의 코드 우선 준수율이 4.2%에서 91.4%로 대폭 상승했으며 모든 테스트가 정상 통과되었습니다.
AI가 원문을 요약한 내용으로, 부정확할 수 있습니다.
원문 제목 @undefinedKi: Your outdated CLAUDE.md is breaking your code. Researchers found Claude Code and Codex follow stale CLAUDE.md and AGENTS.md files
원문 보기 ↗