# 프로젝트 컨텍스트 설계 코스 > 같은 저장소에서 같은 모델을 쓰는데도 결과 품질이 사람마다 다르다면, 원인은 프롬프트 실력보다 무엇이 세션에 실리는지를 아무도 설계하지 않았다는 데 있습니다. 메모리 계층·조건부 규칙·압축 생존성·경계 확장을 판단 기준으로 정리해, 규칙이 실제로 적재되고 지켜지는 저장소를 만듭니다… - Canonical: https://learning.reopt.ai/courses/claude-code-project-context - Language: ko-KR - HTML: https://learning.reopt.ai/courses/claude-code-project-context --- [Claude Code 입문](/tracks/claude-code-foundations) # 프로젝트 컨텍스트 설계 CLAUDE.md와 컨텍스트 예산으로 결과를 재현하기 같은 저장소에서 같은 모델을 쓰는데도 결과 품질이 사람마다 다르다면, 원인은 프롬프트 실력보다 무엇이 세션에 실리는지를 아무도 설계하지 않았다는 데 있습니다. 메모리 계층·조건부 규칙·압축 생존성·경계 확장을 판단 기준으로 정리해, 규칙이 실제로 적재되고 지켜지는 저장소를 만듭니다. 코스를 마치면 우리 팀의 컨텍스트 고정비와 강제 지점을 문서 한 장으로 설명할 수 있습니다. 중급 8레슨 515 XP 약 89분 출처 · 핸드북 · Claude Code 고급 활용, 명령어 마스터 · 원문 검토 2026-07-25 선수 코스를 먼저 완료해 주세요 [안전한 작업 흐름](/courses/claude-code-safe-workflow) 완료 후 이 코스를 시작할 수 있어요. [선수 코스 학습하기](/courses/claude-code-safe-workflow) ![터미널 창과 슬래시 명령 타일이 하나의 시작 플랫폼 위에 놓인 모습을 표현한 일러스트](/images/home/track-claude-code-foundations.png) 0% 코스 진행률 9개 학습 단계 기준 ## 이 코스를 마치면 - 관리 정책·사용자·프로젝트·로컬 메모리의 로드 순서와 적재 시점을 구분해 규칙을 배치할 수 있다 - 준수를 기대하는 규칙과 보장해야 하는 규칙을 나눠 CLAUDE.md와 PreToolUse 훅에 배분할 수 있다 - paths: 조건부 규칙으로 시작 적재량을 줄이고 압축 후 생존 여부까지 함께 설계할 수 있다 - --add-dir의 설정 로딩 비대칭과 자동 메모리 범위를 전제로 세션 경계와 정리 절차를 정할 수 있다 1 ## 1. 메모리 계층: 무엇이 먼저 실리는가 네 겹의 메모리가 어떤 순서로 이어 붙는지 확인하고 규칙의 자리를 정합니다. - 덮어쓰기가 아니라 이어 붙이기 관리 정책·사용자·프로젝트·로컬 메모리의 로드 순서와 적재 시점 개념 45 XP - 메모리 계층 판별 퀴즈 어디에 저장되고 언제 적재되는지 구분하기 퀴즈 50 XP 2 ## 2. 지침과 강제의 경계 준수를 기대할 규칙과 보장해야 할 규칙을 서로 다른 자리에 배치합니다. - CLAUDE.md는 왜 가끔 무시되는가 전달 방식의 차이로 결정되는 강제력과 훅의 역할 개념 45 XP - 실전: 지켜지지 않는 규칙을 옮겨라 문서·시스템 프롬프트·훅·REVIEW.md 중 어디에 둘지 결정 시나리오 60 XP 3 ## 3. 조건부 로딩과 압축 생존성 시작 적재량을 실제로 줄이면서 압축 후에도 남을 규칙을 설계합니다. - 언제 실릴지가 언제 사라질지를 정한다 paths: 조건부 규칙의 절약 효과와 /compact 이후의 손실 개념 45 XP - 컨텍스트 예산 점검표 지금 세션에서 바로 확인할 수 있는 적재·생존 항목 체크리스트 55 XP 4 ## 4. 경계 확장과 흔적 정리 --add-dir로 범위를 넓힐 때의 비대칭과 세션 종료 후 남는 상태를 다룹니다. - 접근을 넓히는 것과 설정을 상속하는 것은 다르다 추가 디렉토리의 로딩 비대칭, 자동 메모리의 범위, 로컬 상태 정리 개념 45 XP - 워크북: 멀티 루트 세션과 종료 절차 교차 분석 범위·신뢰 검토·메모리 감사·정리 런북을 한 장으로 워크북 70 XP ## 최종 챌린지 코스에서 배운 내용을 업무에 재사용할 수 있는 산출물로 완성하세요. - 최종 챌린지 · 우리 저장소 컨텍스트 예산 설계서 로드 인벤토리부터 강제 지점과 운영 규칙까지 한 장으로 정리 레슨 완료 후 100 XP --- 에이전트용 사이트 안내: https://learning.reopt.ai/llms.txt · 사이트맵: https://learning.reopt.ai/sitemap.xml · 문의: https://learning.reopt.ai/contact