# Claude Code 설정

## 신규 컴퓨터 셋업

클론 후 아래 명령을 한 번 실행하면 Claude 메모리가 이 프로젝트 폴더와 연결됩니다.

```bash
PROJ=$(pwd)
MEM_DIR="$HOME/.claude/projects/-Users-cha-Works-Projects-qcast3-qcast-front"
mkdir -p "$MEM_DIR"
rm -rf "$MEM_DIR/memory"
ln -s "$PROJ/.claude/memory" "$MEM_DIR/memory"
```

> **주의**: 위 경로(`-Users-cha-Works-Projects-qcast3-qcast-front`)는 이 프로젝트의 절대경로 인코딩입니다.
> 프로젝트를 `/Users/cha/Works/Projects/qcast3/qcast-front` 에 clone 했을 때 그대로 사용하면 됩니다.

## 메모리 구조

`.claude/memory/` 폴더가 Claude 의 프로젝트 메모리입니다. git 으로 관리됩니다.

- `MEMORY.md` — 메모리 인덱스 (항상 로드됨)
- `feedback_*.md` — 작업 방식 피드백
- `project_*.md` — 프로젝트 상태 및 결정 사항
- `reference_*.md` — 외부 시스템 참조

## 인수인계서

`docs/` 폴더의 `*_HANDOVER.md` 파일들을 참고하세요.

- `docs/HANDOVER_INDEX.md` — 진입점 인덱스 (먼저 읽기)
- `docs/SK_MOVEMENT_HANDOVER.md` — SK 라인 이동 (최우선)
- `docs/UI_MODAL_HANDOVER.md` — 모달/UI
- `docs/API_STABILITY_HANDOVER.md` — API 안정화
- `docs/MODULE_CIRCUIT_HANDOVER.md` — 모듈/회로

## 로컬 개발

```bash
npm run dev              # 기본 (dev API)
npm run dev:local-api    # localhost:8080 API
npm run dev:log          # 기본 + 서버 로그 파일
npm run dev:log:local-api # localhost:8080 + 서버 로그 파일
```