Claude Code 사용법 가이드 (.NET WinForms + MSVS 2022)

Claude Code 사용법 가이드 (.NET WinForms + MSVS 2022)

1. 프로젝트 구조 분석

터미널에서 프로젝트 루트 디렉토리로 이동 후 claude 명령으로 실행합니다.

# 전체 솔루션 구조 파악
> .sln 파일과 .csproj 파일을 읽고 프로젝트 전체 구조를 분석해줘

# 폼과 컨트롤 구조 파악
> 모든 Form 클래스와 UserControl을 찾아서 화면 구성을 설명해줘

# 데이터 레이어 분석
> 데이터베이스 연결 및 데이터 처리 관련 클래스를 모두 찾아서 정리해줘

2. 기능 추가 명령 방법 (WinForms 특화)

새 폼 추가:

> 사용자 로그인 기능을 위한 LoginForm을 만들어줘.
  기존 프로젝트의 코딩 스타일을 참고하고,
  MainForm에서 호출할 수 있도록 연결해줘

컨트롤 추가:

> MainForm에 DataGridView를 추가하고
  기존 데이터 모델(Model 폴더 참고)과 바인딩해줘

비즈니스 로직 추가:

> Services 폴더의 구조를 파악하고
  동일한 패턴으로 ExportService 클래스를 새로 만들어줘

3. 주요 슬래시 명령어

명령어설명

/init	프로젝트 분석 후 CLAUDE.md 자동 생성
/clear	대화 컨텍스트 초기화
/compact	컨텍스트 압축 (긴 작업 시 활용)
/memory	CLAUDE.md 내용 편집
/cost	현재 세션 토큰 사용량 확인
/doctor	환경 설정 진단

4. CLAUDE.md 설정 (MSVS 2022 환경)

프로젝트 루트의 CLAUDE.md 에 아래 내용을 추가해두면 매번 설명 없이도 맥락이 유지됩니다.

## 빌드 환경
- IDE: Visual Studio 2022
- Framework: .NET 6/8 (또는 .NET Framework 4.x)
- 빌드 명령: dotnet build 또는 msbuild YourSolution.sln

## 프로젝트 규칙
- Designer 파일(*.Designer.cs)은 직접 수정하지 말 것
- 이벤트 핸들러는 Form 코드 파일에만 작성
- 비즈니스 로직은 Services/ 레이어에 분리

5. 실제 작업 순서 (단계별 지시)

# Step 1 - 현황 파악
> 현재 프로젝트에서 [추가할 기능]과 관련된
  파일들을 모두 찾아서 기존 구현 방식을 분석해줘

# Step 2 - 설계 확인
> 분석 결과를 바탕으로 [기능]을 추가하기 위해
  어떤 파일을 수정/생성해야 하는지 계획을 먼저 설명해줘

# Step 3 - 구현
> 계획대로 코드를 작성해줘.
  Designer.cs 파일은 건드리지 말고
  코드 파일만 수정해줘

6. WinForms 작업 시 주의사항

• *.Designer.cs 파일은 Visual Studio 자동생성 파일 → Claude Code가 수정하지 않도록 명시
• UI 변경이 필요할 경우, 변경할 속성 값만 알려달라고 요청 후 VS에서 직접 수정
• 대규모 리팩토링 전 반드시 Git 커밋 후 진행 권장