> ## Documentation Index
> Fetch the complete documentation index at: https://docs.happycapy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLAUDE.md

> CLAUDE.md를 사용해 Happycapy에 Project용 안정적인 지침을 제공합니다.

## CLAUDE.md란?

`CLAUDE.md`는 Project 지침 파일입니다. Happycapy가 같은 Project로 돌아왔을 때 무엇을 기억하고, 어떻게 작업하고, 어떤 규칙을 따라야 하는지 알려줄 때 사용합니다.

코드처럼 다룰 필요는 없습니다. 이 파일은 Project의 지속적인 brief라고 생각하면 됩니다. 대상 독자, 톤, 출력 규칙, 파일 위치, 리뷰 습관처럼 session이 바뀌어도 유지되어야 하는 내용을 담습니다.

Happycapy가 `CLAUDE.md`를 만들거나 업데이트하도록 요청할 수 있습니다. **Files**를 열어 파일을 선택한 뒤 직접 편집할 수도 있습니다.

Project를 만들고 작업을 시작한 뒤 **Files**를 열면 Project workspace를 볼 수 있습니다. `CLAUDE.md`는 업로드한 원본 파일과 생성된 출력물 옆에 있으므로, 이후 session에서도 같은 지침을 다시 사용할 수 있습니다.

<div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(240px, 1fr))', gap: '0', margin: '1.25rem 0 1.5rem', border: '1px solid rgba(46, 41, 41, 0.12)', borderRadius: '8px', overflow: 'hidden', background: '#fff' }}>
  <div style={{ borderRight: '1px solid rgba(46, 41, 41, 0.1)', background: '#fbfaf7', minHeight: '260px' }}>
    <div style={{ padding: '14px 16px', borderBottom: '1px solid rgba(46, 41, 41, 0.1)' }}>
      <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px', padding: '8px 12px', borderRadius: '8px', background: '#eeece9', color: '#2e2929', fontWeight: 650 }}>
        <span style={{ color: '#6f6a64', display: 'inline-flex', alignItems: 'center' }}>
          <svg aria-hidden="true" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" style={{ flex: 'none' }}>
            <path d="M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z" />
          </svg>
        </span>

        Files
      </span>
    </div>

    <div style={{ padding: '16px' }}>
      <div style={{ marginBottom: '12px', color: '#a09a93', fontSize: '0.78rem', fontWeight: 750, letterSpacing: '0.08em', textTransform: 'uppercase' }}>Project workspace</div>

      <div style={{ display: 'grid', gap: '4px', color: '#6e6861', fontSize: '0.95rem' }}>
        <div style={{ display: 'flex', alignItems: 'center', gap: '8px', padding: '6px 8px' }}><span>›</span><span>memory/</span></div>
        <div style={{ display: 'flex', alignItems: 'center', gap: '8px', padding: '6px 8px' }}><span>›</span><span>outputs/</span></div>
        <div style={{ display: 'flex', alignItems: 'center', gap: '8px', padding: '6px 8px' }}><span>›</span><span>uploads/</span></div>

        <div style={{ display: 'flex', alignItems: 'center', gap: '8px', padding: '7px 8px', borderRadius: '8px', background: '#f1efec', color: '#2e2929', fontWeight: 650 }}>
          <span style={{ color: '#6f6a64', display: 'inline-flex', alignItems: 'center' }}>
            <svg aria-hidden="true" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" style={{ flex: 'none' }}>
              <path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z" />

              <path d="M14 2v4a2 2 0 0 0 2 2h4" />

              <path d="M10 9H8" />

              <path d="M16 13H8" />

              <path d="M16 17H8" />
            </svg>
          </span>

          <span>CLAUDE.md</span>
        </div>
      </div>
    </div>
  </div>

  <div style={{ minHeight: '260px', background: '#ffffff' }}>
    <div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: '12px', padding: '14px 18px', borderBottom: '1px solid rgba(46, 41, 41, 0.1)' }}>
      <span style={{ color: '#8a8178', fontSize: '0.9rem' }}>CLAUDE.md</span>
      <span style={{ padding: '3px 8px', borderRadius: '999px', background: '#edf7f3', color: '#14745f', fontSize: '0.74rem', fontWeight: 700 }}>편집 가능</span>
    </div>

    <div style={{ padding: '22px 24px' }}>
      <div style={{ margin: '0 0 16px', color: '#111', fontSize: '1.55rem', lineHeight: 1.1, fontWeight: 650 }}>Project instructions</div>
      <p style={{ margin: 0, color: '#4f4a45', lineHeight: 1.65 }}>이 Project에서 Happycapy가 기억하고 따라야 할 내용을 알려줍니다.</p>
      <div style={{ marginTop: '24px', paddingTop: '16px', borderTop: '1px dashed rgba(46, 41, 41, 0.22)', color: '#8a8178', fontSize: '0.92rem' }}>안정적인 Project 규칙을 아래에 추가하세요.</div>
    </div>
  </div>
</div>

## 언제 사용하나요

같은 Project의 이후 session에 도움이 될 내용이라면 `CLAUDE.md`에 추가하세요.

좋은 이유는 다음과 같습니다.

* Happycapy에게 같은 문제를 두 번 이상 수정해 주었습니다.
* 매번 반복해서 말하고 싶지 않은 Project 규칙이 있습니다.
* 이후 작업에도 같은 대상 독자, 톤, 파일 위치, 리뷰 기준이 필요합니다.
* 다른 사람이 이 Project를 열었을 때 이 맥락이 있어야 유용한 결과를 얻을 수 있습니다.

일회성 작업 세부사항은 현재 메시지에 남겨 두세요. 안정적인 Project 맥락은 `CLAUDE.md`에 넣습니다.

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

`CLAUDE.md`는 Happycapy를 안내합니다. 강제 스위치가 아니므로, 넓은 선호보다 명확하고 구체적인 지침이 더 안정적으로 작동합니다.

| 모호함              | 더 나은 지침                          |
| ---------------- | -------------------------------- |
| 더 좋은 문구로 써줘.     | 고객용 문구를 명확하고 간결한 한국어로 작성합니다.     |
| 적절한 곳에 파일을 저장해줘. | 최종 파일은 `/outputs`에 저장합니다.        |
| 작업을 확인해줘.        | 완료 전에 변경한 파일과 남은 위험을 나열합니다.      |
| 브랜드를 따라줘.        | 업로드된 브랜드 가이드를 톤과 용어의 기준으로 사용합니다. |

유용한 `CLAUDE.md`는 보통 짧고, 제목으로 그룹화되어 있으며, 훑어보기 쉽습니다.

```text theme={null}
이 Project의 CLAUDE.md에 다음 내용을 추가하세요:

## Writing
- 고객용 문구를 명확하고 간결한 한국어로 작성합니다.
- 구체적인 사용자 작업과 연결되지 않은 과장 표현은 피합니다.

## Files
- 최종 결과물은 /outputs에 저장합니다.
- 보고서와 내보내기 파일 이름에 날짜를 포함합니다.

## Review
- 가격, 법무, 공개 출시 문구를 변경하기 전에 먼저 확인합니다.
- 완료 전에 변경한 파일과 남은 위험을 나열합니다.
```

Happycapy에게 파일을 검토하게 할 수도 있습니다.

```text theme={null}
Review this Project's CLAUDE.md. Tell me what instructions are unclear, stale, or too broad.
```

## Project 지침과 전역 지침

대부분의 Project는 Project workspace 안에 `CLAUDE.md` 하나만 있으면 충분합니다. 더 넓은 위치는 범위 구분이 중요할 때만 사용하세요.

| 위치                             | 용도                                                                         | 넣지 말 것                         |
| ------------------------------ | -------------------------------------------------------------------------- | ------------------------------ |
| Project 안의 `CLAUDE.md`         | 하나의 Project를 위한 지침                                                         | 모든 Project에 영향을 주어야 하는 개인 기본값  |
| `/home/node/.claude/CLAUDE.md` | Happycapy가 여러 Project에서 재사용하기를 원하는 개인 기본값. 예: 언어, 톤, 요약 스타일, 진행 상황 업데이트 방식 | Project 사실, 고객 데이터, 임시 작업 세부사항 |

<Tip>
  같은 선호를 여러 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."
</Tip>

어디에 넣어야 할지 모르겠다면 Project의 `CLAUDE.md`에서 시작하세요. 이 파일은 해당 Project의 이후 대부분의 작업에 적용될 지침에 집중하도록 유지하세요.

## 관련 리소스

* [Projects](/ko/features/projects): ongoing work에 맞춰 sessions와 파일을 구성합니다
* [Files](/ko/features/files): 업로드한 파일과 생성된 파일을 관리합니다
* [Skill Store](/ko/features/skill-store): 재사용 가능한 workflow를 설치합니다
* [Automations](/ko/features/automations): 반복 작업을 예약합니다