← 에디토리얼

클로드 코드 팁 · 2026.11.11 · 7분

클로드 코드 사용법, CLAUDE.md에 이 한 줄

AItoZ 개발팀 · 2026.11.11 발행

클로드 코드 사용법, CLAUDE.md에 이 한 줄 — 클로드 코드 팁

클로드 코드(Claude Code) 사용법 — CLAUDE.md에 '코드 주인' 문장 한 줄을 넣으면 클로드가 반복 코드를 합치는 비율이 달라집니다. 앤트로픽 공식 문서(Claude Fable 5.2 프롬프트 가이드)에 나온 문장과 우리 시험 결과를 정리했습니다.

2026년 11월 11일 확인 · 출처: Claude 공식 문서 'Prompting Claude Fable 5.2'의 'Say who owns the code' 문단 · 우리 시험: Claude Code 2.1.322 · 모델 Opus 5.5 · 문장 없음/있음 각 3번

CLAUDE.md에 한 줄 넣었더니, 클로드가 중복 코드를 알아서 합쳤어요.

클로드 코드로 앱을 만들다 보면, 같은 함수가 파일마다 복사돼 코드가 점점 지저분해질 때가 있어요. 앤트로픽 공식 문서에는 이걸 줄이는 문장 한 줄이 나와요. "이 코드베이스는 네 거야"라고 말해 주는 문장이에요. 문서 내용과, 저희가 직접 클로드 코드로 해 본 결과를 정리했어요.

어떤 문장인가요?

코드의 주인이 누구인지 모델에게 말해 주는 영어 문장 한 줄이에요. 앤트로픽이 낸 Claude Fable 5.2 프롬프트 가이드의 'Say who owns the code(코드 주인을 말해 주세요)' 문단에 그대로 나와요.

This codebase is yours: what it's for and how it's built are your call, and you'll keep building on it.

우리말로 옮기면 "이 코드베이스는 네 거야. 무엇에 쓰고 어떻게 짤지는 네가 정하고, 앞으로도 네가 계속 만들어 가"쯤 돼요. 문서는 모델이 작업하면서 구조까지 다듬기를 원하면 이렇게 말하라고 안내해요.

Claude 공식 문서 'Say who owns the code' 문단 원문 — 형광 표시는 우리가 한 것

왜 AI는 시킨 것만 덧붙일까요?

주인 얘기가 없으면 모델이 기존 구조에 덧붙이는 쪽을 고르기 때문이에요. 문서에 따르면 앤트로픽이 작은 코딩 과제로 시험했을 때, 프롬프트에 주인 언급이 없거나 남의 코드라고 소개하면 모델은 같은 코드가 반복되더라도 기존 구조에 덧붙이는 경향을 보였어요. 근처 문제를 고치지 않고 알려 주기만 하는 경향도 있었고요.

반대로 코드가 모델 자신의 것이라고 말하면, 시키지 않아도 반복 코드를 합치고 관련된 부분까지 고치는 경우가 많았다고 해요. "고쳐 줘"라는 같은 요청이라도, 주인 문장이 있느냐에 따라 손대는 범위가 달라진다는 뜻이에요.

왜 AI는 시킨 것만 덧붙일까?

얼마나 차이가 나나요?

앤트로픽 시험에서는 문장이 있으면 약 절반, 없으면 10분의 1 미만의 시도에서 반복 코드를 합쳤어요. 문서가 밝힌 조건은 이래요.

항목 문서 내용
반복 코드를 합친 비율 문장 있음 약 절반 · 없음 1/10 미만
시험 조건 앤트로픽 자체 시험, 작은 코딩 과제(비율은 과제마다 다름)
긴 시스템 프롬프트 안에 넣으면 결과가 유지됨
요청한 기능 문장이 있든 없든 거의 모든 시도에서 동작

반복 코드를 합친 비율 — 약 절반 vs 1/10 미만

이 숫자는 페이블 5.2 문서에 나온 앤트로픽 시험 결과예요. 모든 프로젝트에서 똑같이 나온다는 뜻은 아니에요.

우리가 직접 해 보니 어땠나요?

저희가 11월 11일에 클로드 코드(2.1.322, 모델 Opus 5.5)로 해 보니, 문장이 없으면 3번 모두 네 번째 복사본을 만들었고, 있으면 3번 모두 공용 파일 하나로 합쳤어요. 시험 방법은 이랬어요.

  1. 금액을 "15,800원"처럼 바꿔 주는 함수 formatWon이 cart.js · invoice.js · receipt.js 세 파일에 똑같이 복사된 작은 카페 계산 프로그램을 만들었어요.
  2. 같은 프로젝트를 6벌 복사해, 3벌은 CLAUDE.md를 그대로 두고 3벌은 끝에 위 문장 한 줄만 더했어요.
  3. 모두 같은 요청을 보냈어요. "환불 영수증 출력 기능을 추가해 줘. src/refund.js에 printRefund(refund)를 만들고 index.js에서 예시로 한 번 호출해 줘."
  4. 끝난 뒤 function formatWon이 몇 군데에 있는지 세고, git diff로 바뀐 내용을 봤어요.

같은 요청, 문장 없음 vs 있음 — 복사본 4개 vs 1개로 합침

문장이 없을 때는 3번 모두 새 파일 refund.js 안에 formatWon을 또 복사해 넣었어요(바뀐 파일 2개). 문장이 있을 때는 3번 모두 src/format.js라는 공용 파일을 만들어 함수를 옮기고, 네 파일이 모두 거기서 가져다 쓰게 바꿨어요(바뀐 파일 6개). 실행 결과는 양쪽 모두 정상이었어요.

문장을 넣은 뒤의 실제 git diff — 세 파일의 복사본이 빠지고 공용 파일이 생겼어요

한 가지 더 보였어요. 문장이 있을 때 답변 토큰이 평균 약 2배 많았어요(우리 시험 기록 기준). 문서도 같은 시험에서 출력 토큰이 약 1.5배 늘었다고 밝혀요. 다만 저희 시험은 한 가지 과제를 3번씩 한 작은 시험이라, 다른 프로젝트 · 다른 모델에서도 같다고 말할 수는 없어요.

CLAUDE.md에 어떻게 넣나요?

내 프로젝트 폴더의 CLAUDE.md에 영어 원문을 그대로 한 줄 붙여 넣으면 돼요. 저희는 파일 끝에 넣었어요.

  1. 프로젝트 맨 위 폴더에 있는 CLAUDE.md를 열어요(없으면 새로 만들어요).
  2. 위의 영어 문장을 한 줄 그대로 붙여 넣어요. 번역하지 않고 원문 그대로 쓰는 게 문서와 같은 조건이에요.
  3. 지금 상태를 먼저 커밋해 두고, 평소처럼 클로드 코드에 작업을 시켜요.
  4. 작업이 끝나면 요약만 보지 말고 git diff로 바뀐 코드를 확인해요.

CLAUDE.md에 넣은 모습과 우리말 뜻

넣기 전에 주의할 점은?

시키지 않은 변경도 생긴다는 점이에요. 문서에 따르면 같은 시험에서 모델은 아무도 요청하지 않은 변경을 여러 개 했고, 상당수는 새 테스트와 문서였어요. 버그 수정 말고도 기존 기능의 동작을 바꾼 경우가 6~10번에 한 번 있었고, effort가 높을수록 더 잦았어요.

  • 남의 코드에는 빼세요. 문서는 사용자가 주인이고 최소한만 바꾸길 원하는 코드에는 이 문장을 넣지 말라고 해요. 남이 만든 저장소에서 쓰면 원하지 않는 큰 변경이 생길 수 있어요.
  • "리팩터링 하지 마" 규칙으로는 안 막혀요. 문서 시험에서 같은 프롬프트 앞부분에 "No drive-by refactors, renames or cleanups"를 넣어도 약 3분의 1의 시도에서 반복 코드를 합쳤어요.
  • 요약 말고 바뀐 코드를 보세요. 마지막 요약은 큰 변경만 말하고 작은 변경은 자주 빠뜨렸다고 해요.

넣기 전에 — 남의 저장소엔 빼고, 커밋해 두고, 바뀐 코드 확인

한 번에 정리

  • CLAUDE.md에 This codebase is yours: … 한 줄을 영어 그대로 넣으면, 클로드가 반복 코드를 합치는 경우가 늘어요.
  • 앤트로픽 시험(작은 코딩 과제): 문장 있음 약 절반, 없음 1/10 미만.
  • 우리 시험(Opus 5.5 · 각 3번): 없음은 매번 복사본 추가, 있음은 매번 공용 파일 하나로 합침.
  • 내 프로젝트에서만, 커밋해 두고, git diff로 확인하세요.

다음 편에서는 클로드 코드에 깔면 기획부터 배포까지 순서대로 해 주는 명령 9개를 정리할게요.

다음 편 — 기획부터 배포까지 명령 9개

출처

다음 글클로드 페이블 5.2가 8시간 만에 만든 3D 게임, 이미지 파일 0개→