Claude Code 설정

신규 컴퓨터 셋업

클론 후 아래 명령을 한 번 실행하면 (1) Claude 메모리 연결 + (2) git 훅 활성화 가 끝납니다.

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 — 모듈/회로

로컬 개발

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 + 서버 로그 파일

2.1 KiB Raw Blame History