brew install claude-code

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

claude --version

claude
# → 브라우저가 열리며 OAuth 인증 진행
# → Pro/Max 구독자는 자동으로 연결됨

claude config
# → API 키 입력 (sk-로 시작하는 키)

claude /doctor

# 현재 위치 확인: macOS/Linux는 pwd, Windows는 cd
cd ~/my-project   # 작업할 프로젝트 폴더로 이동
claude             # Claude Code 시작!

claude /init
# → 프로젝트를 스캔하고 초안을 만들어 줌
# → 불필요한 줄 삭제 + 우리 프로젝트에 맞게 수정

# 1. 빈 프로젝트 폴더 생성 후 진입
mkdir my-new-project && cd my-new-project
git init
claude

# 2. PRD 작성 요청
> 사용자 대시보드 웹앱을 만들 건데,
  PRD(제품 요구사항 문서)를 먼저 작성해줘.
  기능 목록, 기술 스택 추천, 마일스톤까지 포함해서.

# 3. PRD 기반으로 CLAUDE.md + 프로젝트 구조 생성
> 이 PRD 기반으로 CLAUDE.md를 만들고, 프로젝트 초기 구조를 잡아줘.

# 프로젝트명

## 아키텍처
- **Frontend**: Next.js 14 + TypeScript
- **Backend**: Node.js + Express
- **DB**: PostgreSQL + Prisma ORM
- **배포**: Vercel (프론트), Railway (백엔드)

## 핵심 명령어
- `npm run dev`   — 개발 서버 시작
- `npm run build` — 프로덕션 빌드
- `npm run test`  — 테스트 실행
- `npm run lint`  — 린트 체크

## 코딩 컨벤션
- TypeScript strict mode 사용
- 함수형 컴포넌트 선호
- 변수명은 설명적으로 (한 글자 변수 금지, 루프 제외)
- 공개 함수에는 JSDoc 주석 필수
- 컴포넌트는 200줄 이내

## 테스트 가이드
- Jest + React Testing Library 사용
- 코드 커버리지 80% 이상 목표
- 엣지 케이스 반드시 포함

프로젝트 루트/
├── CLAUDE.md              ← 전체 프로젝트 공통
├── src/
│   ├── CLAUDE.md          ← src 하위 특화 규칙
│   └── components/
│       └── CLAUDE.md      ← 컴포넌트 특화 규칙

# 기본 문법
claude mcp add <이름> --scope <범위> -- npx -y <패키지>

# scope 옵션:
# --scope user   : 모든 프로젝트에서 사용 (글로벌)
# --scope local  : 현재 프로젝트, 나만 사용 (기본값)
# --scope project: 현재 프로젝트, 팀 공유 (.mcp.json에 저장)

claude mcp add github \
  --scope user \
  -- npx -y @modelcontextprotocol/server-github
#            ↑ 이 -- 구분자 반드시 넣기!

# 환경변수에 GitHub PAT 설정 필요
export GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxxx

claude mcp add context7 \
  --scope user \
  -- npx -y @upstash/context7-mcp

/mcp

# 출력 예시:
# ✔ MCP server "github" connected (8 tools)
# ✔ MCP server "context7" connected (2 tools)

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$CLAUDE_TOOL_INPUT_FILE_PATH\""
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo \"$CLAUDE_TOOL_INPUT\" | grep -qE 'rm -rf|DROP TABLE' && exit 2 || exit 0"
          }
        ]
      }
    ],
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo '{\"additionalContext\": \"Current branch: '$(git branch --show-current)'\"}"
          }
        ]
      }
    ]
  }
}

# 코드 리뷰

다음 기준으로 코드 리뷰를 진행해주세요:

1. **보안**: 취약점 체크
2. **성능**: 최적화 포인트
3. **가독성**: 코드 구조와 명확성
4. **테스트**: 커버리지 개선 제안
5. **컨벤션**: 프로젝트 표준 준수 여부

포커스 영역: $ARGUMENTS

# 배포 전 체크리스트

다음을 순서대로 확인하고 결과를 리포트해주세요:

1. `npm run lint`  실행 — 린트 에러 0건 확인
2. `npm run test`  실행 — 모든 테스트 통과 확인
3. `npm run build` 실행 — 빌드 성공 확인
4. 환경변수 누락 체크
5. 미커밋 변경사항 확인

/review src/auth/login.ts
/deploy-check

/context   # 현재 토큰 사용량, 잔여량, 카테고리별 분류 표시

/compact                          # 컨텍스트 압축
/compact 코드 변경사항과 테스트 결과에 집중해줘  # 커스텀 압축
/clear                            # 완전 초기화
/cost                             # 현재 세션 토큰 사용량 + 비용 확인

claude --version            # 현재 버전 확인
brew upgrade claude-code    # Homebrew 업데이트
claude update               # Native Installer 업데이트
claude /doctor              # 진단 (중복 설치 등 확인)

# 1. 먼저 현재 상태를 Git에 커밋
git add -A && git commit -m "checkpoint before YOLO"

# 2. YOLO 모드로 작업
claude --dangerously-skip-permissions "이 모듈 리팩토링해줘"

# 3. 결과 확인 후 문제 있으면 롤백
git diff                  # 변경사항 확인
git reset --hard HEAD     # 문제 시 원복

# alias 설정 (자주 쓴다면)
alias clauded="claude --dangerously-skip-permissions"