프로젝트 폴더의 규칙을
CLAUDE.md에 적어 갑니다.

사전 질문

다음 질문을 먼저 풀어보세요. 레슨에서 각 개념의 답과 이유를 확인합니다.

Claude는 똑똑한 신입 직원이다

Claude는 능력이 있어도 내 프로젝트를 처음 봅니다. 배경과 작업 기준을 설명해야 합니다.

• 배경 왜 이 작업을 하는가
• 관련 파일 무엇을 읽어야 하는가
• 원하는 결과 어떤 형식인가
• 금지사항 무엇을 하면 안 되는가
• 완료 기준 무엇을 확인해야 하는가

프로젝트 폴더란 무엇인가

신입 직원에게 자리를 마련해 주듯, 프로젝트 폴더는 Claude가 읽고 수정할 작업 공간입니다. 무엇을 봐도 되는지부터 정합니다.

• 읽어도 되는 것 현재 문제와 관련된 파일
• 수정해도 되는 것 이번 작업의 대상 파일
• 보면 안 되는 것 비밀값·개인정보·무관한 파일

CLAUDE.md에 둘 것

매 세션 같은 설명을 반복하지 않도록, 프로젝트의 사실과 규칙을 CLAUDE.md에 적어 둡니다. Claude는 시작할 때마다 이 파일을 읽습니다.

• 프로젝트 목적 이 폴더가 해결하는 문제
• 구조 주요 폴더와 파일의 역할
• 실행 방법 실행·테스트 명령
• 검증 방법 완료를 판단하는 기준

규칙은 작업하며 쌓입니다

처음부터 완벽한 CLAUDE.md를 쓰지 않습니다. 같은 지시를 두 번 하게 되면 그때 한 줄 적습니다.

• 초안 /init을 치면 Claude가 폴더를 읽고 CLAUDE.md 초안을 만든다
• 반복된 지시 같은 말을 두 번 했다면 CLAUDE.md에 한 줄 추가한다
• 틀린 가정 Claude가 잘못 짐작한 사실을 적는다 (예: 결과물 저장 위치)
• 정리 더 이상 맞지 않는 규칙은 지운다

# 카드뉴스 프로젝트
- 결과물은 output/ 폴더에 날짜별로 저장한다
- 글은 한 슬라이드에 한 문장, 존댓말
- 이미지 생성 전에 반드시 주제를 확인받는다

대화와 프로젝트 기억 구분하기

대화는 임시 작업 공간이고, 프로젝트 파일과 규칙이 실제로 다시 이어갈 수 있게 해줍니다.

컨텍스트와 사용량 관리

컨텍스트 사용량과 플랜 사용량은 다른 개념입니다.

• 컨텍스트 대화·파일·명령 결과가 현재 문맥에 쌓임
• 플랜 사용량 요금제의 사용량 창
• /context 현재 컨텍스트 확인
• /usage 플랜 사용량 확인
• /compact 긴 대화 요약

사용량 HUD를 직접 달아 봅니다

방금 본 컨텍스트 사용량을 폴더·브랜치와 함께 상태줄에 항상 띄우는 HUD입니다. 수업에서 쓰는 것과 같은 것입니다.

📂 my-repo | 🔀 main | █░░░░░░░░░ 12% of 200k

이 폴더는 Claude Code 상태줄에 사용량 HUD를 다는 패키지야.
README.md와 스크립트를 읽고 내 OS에 맞게 설치해 줘.
설치 전에 무엇을 바꾸는지 계획부터 보여주고, settings.json은 백업한 뒤 수정해.
끝나면 새 세션에서 HUD가 보이는지 확인하는 방법을 알려 줘.

세션을 나누고 인수인계하기

조사·구현·검증을 한 세션에 모두 쌓지 않아도 됩니다.

완료한 것:
현재 상태:
남은 작업:
중요한 결정:
다음에 확인할 것:

필요하면 /clear로 새 작업을 시작하고 /resume으로 이전 세션을 이어갑니다.

후속 질문

이번 레슨에서 배운 주요 내용과 세부 사항을 확인합니다.