Skip to main content

​
CLAUDE.md란?

CLAUDE.md는 Project 지침 파일입니다. Happycapy가 같은 Project로 돌아왔을 때 무엇을 기억하고, 어떻게 작업하고, 어떤 규칙을 따라야 하는지 알려줄 때 사용합니다. 코드처럼 다룰 필요는 없습니다. 이 파일은 Project의 지속적인 brief라고 생각하면 됩니다. 대상 독자, 톤, 출력 규칙, 파일 위치, 리뷰 습관처럼 session이 바뀌어도 유지되어야 하는 내용을 담습니다. Happycapy가 CLAUDE.md를 만들거나 업데이트하도록 요청할 수 있습니다. Files를 열어 파일을 선택한 뒤 직접 편집할 수도 있습니다. Project를 만들고 작업을 시작한 뒤 Files를 열면 Project workspace를 볼 수 있습니다. CLAUDE.md는 업로드한 원본 파일과 생성된 출력물 옆에 있으므로, 이후 session에서도 같은 지침을 다시 사용할 수 있습니다.
Files
Project workspace
›memory/
›outputs/
›uploads/
CLAUDE.md
CLAUDE.md편집 가능
Project instructions

이 Project에서 Happycapy가 기억하고 따라야 할 내용을 알려줍니다.

안정적인 Project 규칙을 아래에 추가하세요.

​
언제 사용하나요

같은 Project의 이후 session에 도움이 될 내용이라면 CLAUDE.md에 추가하세요. 좋은 이유는 다음과 같습니다.
  • Happycapy에게 같은 문제를 두 번 이상 수정해 주었습니다.
  • 매번 반복해서 말하고 싶지 않은 Project 규칙이 있습니다.
  • 이후 작업에도 같은 대상 독자, 톤, 파일 위치, 리뷰 기준이 필요합니다.
  • 다른 사람이 이 Project를 열었을 때 이 맥락이 있어야 유용한 결과를 얻을 수 있습니다.
일회성 작업 세부사항은 현재 메시지에 남겨 두세요. 안정적인 Project 맥락은 CLAUDE.md에 넣습니다.

​
Happycapy가 따르기 쉬운 지침 작성하기

CLAUDE.md는 Happycapy를 안내합니다. 강제 스위치가 아니므로, 넓은 선호보다 명확하고 구체적인 지침이 더 안정적으로 작동합니다. 유용한 CLAUDE.md는 보통 짧고, 제목으로 그룹화되어 있으며, 훑어보기 쉽습니다.
Happycapy에게 파일을 검토하게 할 수도 있습니다.

​
Project 지침과 전역 지침

대부분의 Project는 Project workspace 안에 CLAUDE.md 하나만 있으면 충분합니다. 더 넓은 위치는 범위 구분이 중요할 때만 사용하세요.
같은 선호를 여러 Project에 적용하고 싶나요? Happycapy에게 /home/node/.claude/CLAUDE.md를 업데이트해 달라고 요청하세요. 예: “Set my global CLAUDE.md so Happycapy defaults to Korean, keeps progress updates concise, and asks before changing public-facing copy.”
어디에 넣어야 할지 모르겠다면 Project의 CLAUDE.md에서 시작하세요. 이 파일은 해당 Project의 이후 대부분의 작업에 적용될 지침에 집중하도록 유지하세요.

​
관련 리소스

  • Projects: ongoing work에 맞춰 sessions와 파일을 구성합니다
  • Files: 업로드한 파일과 생성된 파일을 관리합니다
  • Skill Store: 재사용 가능한 workflow를 설치합니다
  • Automations: 반복 작업을 예약합니다