Claude Code CLAUDE.md 작성법: /memory와 /context로 적용 확인하기

Claude Code에 매번 같은 작업 규칙을 설명하고 있다면, 프로젝트의 CLAUDE.md에 적어둘 수 있습니다. 예를 들어 CSV를 정리하는 폴더라면 ‘원본은 그대로 두고 결과를 output에 저장한다’는 기준을 함께 전달하는 식입니다.

여기서는 작은 CSV 작업 폴더를 예로 들어 규칙을 작성하고 확인하는 순서를 정리합니다. 공식 문서를 바탕으로 만든 따라 하기 예제이며, 특정 환경에서 실행한 성능 측정이나 적용 보장 사례는 아닙니다.

1. 프로젝트 폴더에 CLAUDE.md 두기

Claude Code를 사용하는 프로젝트의 최상위 폴더에 CLAUDE.md를 만듭니다. 이미 파일이 있다면 현재 내용을 읽고 필요한 항목을 추가합니다.

sample-work/
  CLAUDE.md
  input/
  output/

공식 문서에서는 프로젝트용 파일 위치로 ./CLAUDE.md와 ./.claude/CLAUDE.md를 안내합니다. 이 예제에서는 눈에 바로 보이는 첫 번째 위치를 사용합니다.

2. 파일에 넣을 짧은 예제

아래 내용은 CSV 파일을 정리하는 연습 프로젝트를 가정한 예시입니다. 자기 폴더에 맞게 경로와 확인 기준을 바꿔 사용하세요.

# CSV 정리 작업

## 입력과 출력
- 입력 파일은 input/에 있다.
- 원본 파일은 수정하지 않는다.
- 결과는 output/에 새 파일로 저장한다.
- 같은 이름의 결과가 있으면 덮어쓰기 전에 확인한다.

## 데이터 처리
- customer_code는 문자열로 읽고 앞자리 0을 유지한다.
- 중복 제거는 이번 요청에서 지정한 경우에만 수행한다.
- 빈 값이나 읽을 수 없는 값은 임의로 채우지 않는다.
- 처리 기준을 정할 수 없으면 해당 파일과 행을 알려준다.

## 완료 확인
- 입력과 출력의 데이터 행 수를 각각 보고한다.
- 제외하거나 바꾼 행이 있으면 이유를 함께 적는다.
- 결과 파일을 다시 읽어 요청한 기준과 대조한다.
- 저장 경로와 실제 확인한 결과를 알려준다.

이렇게 쓰면 ‘완료 확인’이 무엇인지 결과물과 대조할 수 있습니다. 아직 없는 테스트 명령을 형식상 넣을 필요는 없습니다. 사용하는 프로젝트에 실행 가능한 테스트가 생기면 그 명령을 추가하면 됩니다.

3. /memory는 편집, /context는 로딩 확인

파일을 저장한 뒤 해당 프로젝트에서 새 Claude Code 세션을 시작합니다. 그다음 아래 명령을 입력합니다.

/context

공식 문서 기준으로 Memory files 항목에서 현재 세션에 실제로 읽힌 파일을 확인합니다. 여기에 의도한 프로젝트의 CLAUDE.md가 보이는지 살펴보세요.

파일 위치를 찾아 열거나 내용을 수정할 때는 다음 명령을 사용합니다.

/memory

/memory에는 아직 만들지 않은 파일의 위치도 나타날 수 있습니다. 따라서 목록에 이름이 보인다는 사실만으로 현재 세션에 로딩됐다고 판단하지 않고, /context를 함께 확인합니다.

명령 화면은 설치 버전에 따라 달라질 수 있습니다. 표시가 다르면 해당 버전의 도움말과 공식 문서를 먼저 대조하세요.

4. 작은 요청으로 실제 동작 대조하기

파일 로딩을 확인한 다음에는 아래처럼 범위가 작은 요청을 해봅니다.

input 폴더의 CSV 목록과 각 파일의 데이터 행 수를 확인해 주세요.
아직 파일은 만들거나 수정하지 마세요.
이번 프로젝트에서 결과 저장과 중복 처리를 어떻게 할지
읽은 규칙을 기준으로 짧게 설명해 주세요.

확인할 것은 답변의 표현보다 실제 작업 내용입니다. 입력 파일이 그대로인지, 이번 요청에서 허용한 조회만 했는지, 중복 처리를 별도로 정해야 한다고 이해했는지를 대조합니다. 이후 결과 생성을 요청했을 때도 출력 경로와 행 수를 확인합니다.

단계	확인할 내용
파일 저장	현재 프로젝트에 CLAUDE.md가 있는가
세션 로딩	/context의 Memory files에 보이는가
규칙 이해	입력 보존·출력 경로·중복 기준을 설명하는가
실제 실행	원본과 결과가 요청한 기준에 맞는가

CLAUDE.md는 모델이 읽는 작업 지침입니다. 파일 접근 권한이나 실행을 강제하는 설정과는 구분됩니다. 로딩됐다는 사실과 모든 작업에서 지켜졌다는 사실도 각각 확인해야 합니다.

5. 규칙을 추가할 때 확인할 범위

이 예제는 프로젝트 파일 한 곳에서 시작합니다. 여러 프로젝트에 공통으로 적용할 개인 설정은 ~/.claude/CLAUDE.md처럼 범위가 다릅니다. 먼저 지금 작업하는 폴더에 필요한 기준을 정리하고, 자주 반복되는 내용인지 확인한 뒤 공통 규칙으로 옮겨보세요.

참고한 공식 문서: Claude Code 프로젝트 기억과 CLAUDE.md. 위치·명령 설명 확인일: 2026년 9월 9일.