54 lines
2.1 KiB
Markdown
54 lines
2.1 KiB
Markdown
# Claude Code 설정
|
|
|
|
## 신규 컴퓨터 셋업
|
|
|
|
클론 후 아래 명령을 한 번 실행하면 (1) Claude 메모리 연결 + (2) git 훅 활성화 가 끝납니다.
|
|
|
|
```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"
|
|
|
|
# git hooks (post-commit: 커밋 로그 + [TBD-CODE] 자동 치환 + .commit-notice 마커)
|
|
git config core.hooksPath .githooks
|
|
```
|
|
|
|
> **주의**: 위 경로(`-Users-cha-Works-Projects-qcast3-qcast-front`)는 이 프로젝트의 절대경로 인코딩입니다.
|
|
> 프로젝트를 `/Users/cha/Works/Projects/qcast3/qcast-front` 에 clone 했을 때 그대로 사용하면 됩니다.
|
|
|
|
## git hooks (`.githooks/`)
|
|
|
|
`.githooks/` 는 git 으로 추적되는 훅 디렉토리입니다. `git config core.hooksPath .githooks` 가 한 번 설정되면 자동 실행됩니다.
|
|
|
|
- `post-commit` — 커밋 로그 append, `[TBD-CODE]` placeholder 를 새 short hash 로 자동 치환, `.claude/.commit-notice` 마커 작성 (Claude 의 UserPromptSubmit hook 이 다음 프롬프트에 컨텍스트로 주입)
|
|
|
|
## 메모리 구조
|
|
|
|
`.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 + 서버 로그 파일
|
|
```
|