Claude Code 사용법 및 주요 명령 (필요하신 스터디원분들은 참고하세요!)

# npm으로 설치
npm install -g @anthropic-ai/claude-code

# 또는 공식 인스톨러
curl -fsSL https://claude.ai/install.sh | bash

# 프로젝트 디렉토리로 이동 후 실행
cd my-project
claude

# 특정 모델 지정
claude --model claude-opus-4-7
claude --model claude-sonnet-4-6

# 대화창에서
/login

! ls -la
! git status
! npm test

# 이 프로젝트는 항상 TypeScript strict mode 사용
# 커밋 메시지는 Conventional Commits 규칙 준수

@src/index.ts 이 파일 리팩터링해줘
@package.json 의 dependencies 분석해줘
@docs/ 폴더 전체 검토

# Plan Mode 진입
Shift+Tab을 눌러 "Plan mode"로 전환

# 작업 지시
"인증 시스템을 OAuth로 마이그레이션할 계획 세워줘"

# Claude가 계획 제시 → 승인 → 실행

# 프로젝트 컨벤션

## 코드 스타일
- TypeScript strict mode
- 함수형 우선, 클래스는 최소화
- 2 스페이스 들여쓰기

## 테스트
- Vitest 사용
- 통합 테스트는 실제 DB 사용 (mock 금지)

## Git
- 커밋 메시지: Conventional Commits
- main 브랜치 직접 푸시 금지

/init

---
name: code-reviewer
description: 코드 리뷰 전문가. PR이나 변경된 파일을 리뷰할 때 자동 실행
tools: Read, Grep, Bash
---

당신은 시니어 코드 리뷰어입니다.
다음 관점에서 리뷰하세요:
1. 보안 취약점
2. 성능 이슈
3. 가독성
4. 테스트 커버리지

/agents                    # 에이전트 목록/관리
"코드 리뷰해줘"              # description 매칭 시 자동 호출

---
name: pdf-reader
description: PDF에서 텍스트 추출. "PDF 읽어줘" 시 자동 실행
---

# PDF Reader

1. 사용자가 지정한 PDF 파일을 읽기
2. `pdf_to_text.py` 스크립트로 텍스트 추출
3. 같은 폴더에 `.md` 파일로 저장

"이 PDF 요약해줘"          # description 매칭 시 자동 실행
/skill-name                # 직접 호출 (슬래시 명령으로 등록된 경우)

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "prettier --write $CLAUDE_FILE_PATH"
          }
        ]
      }
    ]
  }
}

/mcp                          # MCP 관리 메뉴
claude mcp add <name> <url>   # CLI에서 추가

1. /init                              # 처음이면 CLAUDE.md 생성
2. Shift+Tab → Plan Mode
3. "사용자 인증 기능을 JWT로 추가해줘"
4. 계획 검토 → 승인
5. Shift+Tab → Auto-accept Mode
6. 실행 자동 진행
7. ! npm test                         # 직접 테스트
8. "커밋 메시지 작성하고 커밋해줘"

1. git checkout feature-branch
2. claude
3. /review                            # 전체 변경 리뷰
4. /security-review                   # 보안 검토

1. @logs/error.log @src/api/handler.ts
2. "이 에러의 원인 찾아줘"
3. ! npm run debug                    # 디버그 모드 실행
4. Claude가 로그 분석 후 수정 제안

1. Plan Mode 진입
2. "전역 상태관리를 Redux에서 Zustand로 마이그레이션 계획 세워줘"
3. 단계별 계획 검토
4. 각 단계마다 분리 실행 (한 번에 다 하지 말 것)
5. 단계별 git commit

/compact                  # 요약 후 계속
/clear                    # 완전 초기화 (새 작업 시작 시)

Esc Esc                   # 이전 메시지로 돌아가서 수정
# 잘못된 동작이 반복되면 → 명확하게 설명 추가

/permissions              # 자주 쓰는 명령 allowlist 추가
또는 /fewer-permission-prompts 스킬 실행

/cost                     # 실시간 사용량 확인
/model                    # Haiku 등 저렴한 모델로 전환
/compact                  # 컨텍스트 줄이기

claude --resume           # 또는 /resume

@src/**/*.ts            # 글롭 패턴 가능
@README.md @CHANGELOG.md  # 여러 파일 동시

! curl -s https://api.example.com/data | jq .

# 여러 서브에이전트를 병렬 호출하여 빠른 분석
"code-reviewer와 security-reviewer를 병렬로 돌려줘"