Claude Code 튜토리얼
개발 워크플로우에서 Claude Code를 효과적으로 사용하기 위한 실용적인 예제와 패턴
이 가이드는 Claude Code를 사용한 일반적인 워크플로우에 대한 단계별 튜토리얼을 제공합니다. 각 튜토리얼에는 Claude Code를 최대한 활용할 수 있도록 명확한 지침, 예제 명령어 및 모범 사례가 포함되어 있습니다.
목차
- 새로운 코드베이스 이해하기
- 효율적으로 버그 수정하기
- 코드 리팩토링하기
- 테스트 작업하기
- 풀 리퀘스트 생성하기
- 문서 처리하기
- 고급 git 워크플로우 사용하기
- 이미지 작업하기
- 프로젝트 메모리 설정하기
- 유닉스 스타일 유틸리티로 Claude 사용하기
- Model Context Protocol (MCP) 설정하기
새로운 코드베이스 이해하기
코드베이스 빠른 개요 얻기
사용 시기: 새 프로젝트에 참여했고 그 구조를 빠르게 이해해야 할 때.
프로젝트 루트 디렉토리로 이동
Claude Code 시작
상위 수준 개요 요청
특정 컴포넌트 자세히 살펴보기
팁:
- 광범위한 질문으로 시작한 다음 특정 영역으로 좁혀가기
- 프로젝트에서 사용된 코딩 규칙과 패턴에 대해 문의하기
- 프로젝트 특정 용어 용어집 요청하기
관련 코드 찾기
사용 시기: 특정 기능이나 기능과 관련된 코드를 찾아야 할 때.
Claude에게 관련 파일 찾기 요청
컴포넌트 상호 작용 방식에 대한 컨텍스트 얻기
실행 흐름 이해하기
팁:
- 찾고자 하는 것에 대해 구체적으로 명시하기
- 프로젝트의 도메인 언어 사용하기
효율적으로 버그 수정하기
오류 메시지 진단
사용 시기: 오류 메시지가 발생했고 그 원인을 찾아 수정해야 할 때.
Claude와 오류 공유
수정 권장사항 요청
수정사항 적용
팁:
- Claude에게 문제를 재현하고 스택 트레이스를 얻는 명령어 알려주기
- 오류를 재현하는 단계 언급하기
- 오류가 간헐적인지 일관적인지 Claude에게 알려주기
코드 리팩토링
레거시 코드 현대화
사용 시기: 오래된 코드를 현대적인 패턴과 관행을 사용하도록 업데이트해야 할 때.
리팩토링할 레거시 코드 식별
리팩토링 권장사항 얻기
안전하게 변경사항 적용
리팩토링 검증
팁:
- Claude에게 현대적 접근 방식의 이점 설명 요청
- 필요한 경우 하위 호환성 유지 요청
- 작고 테스트 가능한 단위로 리팩토링 수행
테스트 작업하기
테스트 커버리지 추가
사용 시기: 테스트되지 않은 코드에 대한 테스트를 추가해야 할 때.
테스트되지 않은 코드 식별
테스트 스캐폴딩 생성
의미 있는 테스트 케이스 추가
테스트 실행 및 검증
팁:
- 엣지 케이스와 오류 조건을 다루는 테스트 요청
- 적절한 경우 단위 테스트와 통합 테스트 모두 요청
- Claude에게 테스트 전략 설명 요청
풀 리퀘스트 생성하기
포괄적인 PR 생성
사용 시기: 변경사항에 대한 잘 문서화된 풀 리퀘스트를 생성해야 할 때.
변경사항 요약
Claude로 PR 생성
검토 및 개선
테스트 세부정보 추가
팁:
- Claude에게 직접 PR 생성 요청
- 제출하기 전에 Claude가 생성한 PR 검토
- Claude에게 잠재적 위험이나 고려사항 강조 요청
문서 처리하기
코드 문서 생성
사용 시기: 코드에 대한 문서를 추가하거나 업데이트해야 할 때.
문서화되지 않은 코드 식별
문서 생성
검토 및 개선
문서 검증
팁:
- 원하는 문서 스타일 지정 (JSDoc, docstrings 등)
- 문서에 예제 요청
- 공개 API, 인터페이스 및 복잡한 로직에 대한 문서화 요청
이미지 작업하기
이미지와 스크린샷 분석
사용 시기: 코드베이스에서 이미지 작업을 하거나 Claude의 도움을 받아 이미지 내용을 분석해야 할 때.
대화에 이미지 추가
다음 방법 중 하나를 사용할 수 있습니다:
Claude에게 이미지 분석 요청
컨텍스트를 위해 이미지 사용
시각적 콘텐츠에서 코드 제안 얻기
팁:
- 텍스트 설명이 불명확하거나 번거로울 때 이미지 사용
- 더 나은 컨텍스트를 위해 오류, UI 디자인 또는 다이어그램의 스크린샷 포함
- 대화에서 여러 이미지로 작업 가능
- 이미지 분석은 다이어그램, 스크린샷, 목업 등에서 작동
프로젝트 메모리 설정하기
효과적인 CLAUDE.md 파일 생성
사용 시기: 중요한 프로젝트 정보, 규칙 및 자주 사용하는 명령어를 저장하기 위해 CLAUDE.md 파일을 설정하고 싶을 때.
코드베이스용 CLAUDE.md 부트스트랩
팁:
- 반복적인 검색을 피하기 위해 자주 사용하는 명령어(빌드, 테스트, 린트) 포함
- 코드 스타일 선호도와 명명 규칙 문서화
- 프로젝트에 특화된 중요한 아키텍처 패턴 추가
- Claude를 실행하는 폴더, 상위 디렉토리(Claude가 자동으로 읽음) 또는 하위 디렉토리(Claude가 필요에 따라 가져옴)에 CLAUDE.md 파일을 추가할 수 있음
유닉스 스타일 유틸리티로 Claude 사용하기
검증 프로세스에 Claude 추가
사용 시기: Claude Code를 린터나 코드 리뷰어로 사용하고 싶을 때.
단계:
빌드 스크립트에 Claude 추가
파이프 인, 파이프 아웃
사용 시기: Claude에 데이터를 파이프로 입력하고 구조화된 형식으로 데이터를 다시 받고 싶을 때.
Claude를 통해 데이터 파이프
Model Context Protocol (MCP) 설정하기
Model Context Protocol (MCP)은 LLM이 외부 도구와 데이터 소스에 접근할 수 있게 해주는 오픈 프로토콜입니다. 자세한 내용은 MCP 문서를 참조하세요.
제3자 MCP 서버는 자신의 책임 하에 사용하세요. MCP 서버를 신뢰할 수 있는지 확인하고, 특히 인터넷과 통신하는 MCP 서버를 사용할 때는 프롬프트 인젝션 위험에 노출될 수 있으므로 각별히 주의하세요.
MCP 서버 구성
사용 시기: Model Context Protocol을 사용하여 특수 도구와 외부 서버에 연결함으로써 Claude의 기능을 향상시키고 싶을 때.
MCP Stdio 서버 추가
MCP 서버 관리
팁:
-s
또는--scope
플래그를project
(기본값) 또는global
과 함께 사용하여 구성이 저장되는 위치 지정-e
또는--env
플래그로 환경 변수 설정 (예:-e KEY=value
)- MCP는 Claude Code(클라이언트)가 여러 특수 서버에 연결할 수 있는 클라이언트-서버 아키텍처를 따름
Postgres MCP 서버에 연결
사용 시기: Claude에게 쿼리와 스키마 검사를 위한 PostgreSQL 데이터베이스에 대한 읽기 전용 액세스 권한을 부여하고 싶을 때.
Postgres MCP 서버 추가
Claude로 데이터베이스 쿼리
팁:
- Postgres MCP 서버는 안전을 위해 읽기 전용 액세스를 제공
- Claude는 데이터베이스 구조를 탐색하고 분석 쿼리를 실행하는 데 도움을 줄 수 있음
- 이를 사용하여 익숙하지 않은 프로젝트의 데이터베이스 스키마를 빠르게 이해할 수 있음
- 연결 문자열이 최소한의 필요한 권한을 가진 적절한 자격 증명을 사용하는지 확인
다음 단계
Claude Code 참조 구현
개발 컨테이너 참조 구현을 클론하세요.
Was this page helpful?