Claude Desktop이 아니라 Claude Code를 사용해야 하는 이유

실제 상황:
1. "Spring Boot 프로젝트에 User 엔티티 만들어줘" → 코드 생성
2. "Repository도 만들어줘" → 코드 생성
3. "Service 레이어도..." → 코드 생성
4. "컨트롤러도..." → 코드 생성
5. "테스트 코드도..." → [대화 제한 도달!]
6. 새 대화 시작 → "어떤 프로젝트였죠...?"

나: "src/main/kotlin/com/example/domain/user 폴더에 User.kt 파일이 있어"
Claude: "알겠습니다. 어떤 내용인가요?"
나: [파일 내용 복사/붙여넣기]
Claude: "이제 Repository를 만들어드리겠습니다"
나: "잠깐, 우리 프로젝트는 QueryDSL 쓰는데..."

일반적인 작업 플로우:
1. Claude Desktop: "여기 코드입니다..."
2. 나: Cmd+C (복사)
3. IntelliJ로 전환
4. 새 파일 생성
5. Cmd+V (붙여넣기)
6. import 에러 발생
7. Claude Desktop으로 돌아가서 "import 에러가..."
8. 무한 반복

$ claude

Claude> Spring Boot 프로젝트 구조 분석해줘
[프로젝트 전체 분석...]

Claude> User 관련 CRUD API 전체 구현해줘
[파일들 자동 생성 및 수정...]

Claude> 테스트 코드도 추가해줘
[이전 작업 기억하며 테스트 추가...]

# 몇 시간 후...
Claude> 아까 만든 User API에 검색 기능 추가해줘
[이전 작업 완벽히 기억하고 수정...]

# Claude가 실행하는 명령들
$ ls -la src/
$ find . -name "*.kt" -type f
$ grep -r "@Repository" src/
$ cat build.gradle.kts
$ cat src/main/resources/application.yml

# 새 파일 생성
Creating: src/main/kotlin/com/example/repository/UserRepository.kt
Creating: src/test/kotlin/com/example/repository/UserRepositoryTest.kt

# 기존 파일 수정
Modifying: src/main/kotlin/com/example/config/QueryDslConfig.kt
Modifying: build.gradle.kts

# CLAUDE.md

## 프로젝트 개요
- Kotlin + Spring Boot 3.2
- JDK 17
- 멀티모듈 구조 (api, domain, infrastructure)

## 코딩 컨벤션
- 들여쓰기: 4 spaces
- 한글 주석 사용
- REST API는 모두 /api/v1 prefix

## 중요 규칙
- 모든 엔티티는 soft delete 적용
- 모든 API는 페이징 기본 지원
- 테스트는 BDD 스타일로 작성

# Desktop의 MCP 설정을 Code로 가져오기
$ claude --import-mcp-from-desktop

Claude> 지금까지 작업한 내용 커밋해줘

# Claude가 실행하는 명령들
$ git status
$ git add .
$ git commit -m "feat: User CRUD API 구현

- User 엔티티 및 DTO 생성
- Repository, Service, Controller 구현
- 통합 테스트 추가
- API 문서 자동 생성 설정"

Claude> PR 만들어줘

$ git push -u origin feature/user-api
$ gh pr create --title "User CRUD API 구현" --body "..."

Claude> 테스트 실행해봐

$ ./gradlew test

# 에러 발생 시
Claude가 에러를 분석하고 즉시 수정:
- UserServiceTest.kt 15번 줄 수정
- 의존성 주입 문제 해결
- 테스트 재실행 → 성공!

Claude> Order 도메인 전체 구현해줘

동시 진행:
├─ Order.kt 생성
├─ OrderItem.kt 생성
├─ OrderRepository.kt 생성
├─ OrderService.kt 생성
├─ OrderController.kt 생성
├─ OrderMapper.kt 생성
└─ 테스트 파일 6개 생성

총 12개 파일을 30초 만에 생성/수정

1. "검색 기능 추가하는 코드 작성해줘"
2. 코드 받아서 복사
3. 어느 파일에 넣지...? 🤔
4. Controller 파일 찾아서 열기
5. 적당한 위치 찾아서 붙여넣기
6. import 에러... 😫
7. "import 어떻게 하지?"
8. Service 메서드 없다는 에러
9. "Service 코드도 줘"
10. 또 복사-붙여넣기
11. Repository 메서드도 없네...
12. 무한 반복 🔄

1. "User 검색 API 추가해줘. 이름과 이메일로 검색 가능하게"
2. 완료! ✨

Claude가 자동으로:
- Controller에 searchUsers 메서드 추가
- Service에 검색 로직 구현
- Repository에 QueryDSL 검색 쿼리 추가
- DTO 생성
- 테스트 코드 작성
- API 문서 업데이트

# CLAUDE.md - 팀 공통 설정

## 코드 리뷰 체크리스트
- [ ] 단위 테스트 커버리지 80% 이상
- [ ] API 문서 자동 생성 확인
- [ ] 성능 테스트 통과
- [ ] 보안 취약점 스캔 통과

## 금지 사항
- System.out.println 사용 금지
- TODO 주석 남기기 금지
- 하드코딩된 값 사용 금지

// 기존 코드 스타일을 분석해서
class UserService(
    private val userRepository: UserRepository,
    private val passwordEncoder: PasswordEncoder
) {
    // 동일한 스타일로 새 메서드 추가
    fun searchUsers(
        name: String?,
        email: String?,
        pageable: Pageable
    ): Page<UserDto> {
        // ...
    }
}

# macOS
brew install claude

# Windows
winget install claude

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

claude login

cd /path/to/your/project
claude

Claude> 이 프로젝트 분석해서 CLAUDE.md 파일 만들어줘

Claude> commit 전에 자동으로 lint와 test 실행하는 git hook 설정해줘

# ~/.zshrc 또는 ~/.bashrc
alias cc="claude"
alias ccc="claude && git add . && git commit"

# 작업 시작 시
Claude> 오늘 할 일 정리해줘

# 작업 중
Claude> 이 부분 리팩토링해줘

# 작업 완료 시  
Claude> 지금까지 작업 내용 정리해서 커밋해줘