홈
1주차클로드 코드 시작하기목요일

넘겨받은 디렉터리 분석 및 조치

1. 디렉터리 분석

실무에서는 다른 사람이 만든 프로젝트를 넘겨받거나, 오래된 레거시 코드를 유지보수해야 하는 경우가 많습니다. 문서도 없고, 담당자도 없는 코드를 처음 마주쳤을 때 클로드 코드는 강력한 분석 도구가 됩니다.

처음 진입 시 전체 파악

새로운 프로젝트 디렉터리에 들어가면 먼저 전체 구조를 파악합니다:

cd 넘겨받은-프로젝트/
claude

그런 다음 클로드 코드에게 물어보세요:

> 이 프로젝트의 전체 구조를 파악하고, 어떤 기술 스택을 사용하는지,
  무엇을 하는 프로젝트인지 설명해줘

핵심 파일 식별

> 이 코드베이스에서 가장 중요한 파일이 뭐야?
  진입점(entry point)은 어디야?
> 설정 파일들이 뭐가 있어? 각각 어떤 역할을 해?
> 데이터베이스 스키마나 모델 정의가 어디 있어?

의존성 분석

> package.json (또는 requirements.txt)을 분석해서
  이 프로젝트가 어떤 외부 라이브러리에 의존하는지 설명해줘
  혹시 오래되거나 취약점이 알려진 패키지가 있으면 알려줘

코드 품질 빠르게 파악하기

> 이 코드에서 잠재적인 버그나 문제가 될 것 같은 부분을 찾아줘
> 테스트 코드가 있어? 테스트 커버리지가 어떻게 돼?
> 환경 변수나 설정값 중에 하드코딩된 것들이 있어?

git 히스토리 분석

git 저장소라면 히스토리도 분석할 수 있습니다:

> 최근 3개월간의 커밋 메시지를 보고 이 프로젝트가 어떻게 발전해왔는지 요약해줘
> 어떤 파일이 가장 자주 변경됐어? 왜 그럴 것 같아?

아키텍처 다이어그램 생성

> 이 프로젝트의 주요 컴포넌트와 데이터 흐름을 Mermaid 다이어그램으로 그려줘

클로드 코드가 코드를 분석해서 Mermaid 문법의 다이어그램을 만들어줍니다. VS Code Mermaid 확장 또는 mermaid.live에서 시각화할 수 있습니다.

보안 점검

> 이 코드베이스에서 보안 취약점을 찾아줘. 특히 다음을 확인해:
  - 하드코딩된 API 키나 비밀번호
  - SQL 인젝션 가능성
  - XSS 취약점
  - 안전하지 않은 의존성

API 문서 역추출

문서가 없는 프로젝트의 API를 코드에서 직접 추출할 수 있습니다:

> 이 프로젝트의 모든 API 엔드포인트를 찾아서 문서화해줘.
  각 엔드포인트의 HTTP 메서드, 경로, 요청/응답 형식, 인증 필요 여부를 정리해줘

서브에이전트를 활용한 분석

대규모 코드베이스를 분석할 때는 서브에이전트 활용이 효과적입니다. 메인 대화의 컨텍스트를 오염시키지 않고 탐색할 수 있습니다:

> 서브에이전트를 사용해서 이 프로젝트의 인증 시스템이 토큰 갱신을
  어떻게 처리하는지, 기존 OAuth 유틸리티가 있는지 조사해줘

2. 학습 계획 수립

넘겨받은 프로젝트를 이해했다면 이제 무엇을 해야 할지 계획을 세워야 합니다. 클로드 코드는 분석 결과를 바탕으로 구체적인 액션 플랜도 제안해줄 수 있습니다.

현황 정리 문서 만들기

> 지금까지 파악한 내용을 바탕으로 프로젝트 현황 보고서를 작성해줘.
  다음 항목을 포함해줘:
  - 프로젝트 개요
  - 기술 스택
  - 주요 기능
  - 알려진 문제점
  - 즉시 해결해야 할 이슈

우선순위 파악

> 이 코드베이스에서 가장 먼저 손봐야 할 부분이 어디야?
  리스크 순서로 우선순위를 정해줘

개인 학습 계획

이 프로젝트를 완전히 이해하기 위한 학습 계획도 세울 수 있습니다:

> 나는 Python은 알지만 Django는 처음이야.
  이 Django 프로젝트를 이해하기 위해 어떤 순서로 공부하면 좋을까?
  각 단계에서 이 코드베이스의 어떤 파일을 보면 좋을지 알려줘

실습 프로젝트로 해보기

오늘은 이 과정(claude-code-learn)의 소스 코드를 직접 분석해봅시다:

cd ~/Desktop/claude-code-learn
claude
> 이 프로젝트는 어떤 프로젝트야?
  기술 스택과 폴더 구조를 설명해주고,
  새로운 레슨 페이지를 추가하려면 어떤 파일을 수정해야 하는지 알려줘

팀 인수인계 문서 자동 생성

> 이 프로젝트를 새로 합류하는 개발자에게 넘겨줘야 해.
  다음 내용을 포함한 인수인계 문서를 만들어줘:
  1. 프로젝트 개요 및 목적
  2. 기술 스택 및 아키텍처
  3. 로컬 개발 환경 설정 방법
  4. 주요 디렉터리 및 파일 설명
  5. 빌드/배포 프로세스
  6. 알려진 이슈 및 기술 부채

핵심 교훈

클로드 코드를 통해 낯선 코드베이스를 분석하는 것은 마치 경험 많은 선임 개발자와 페어 프로그래밍을 하는 것과 같습니다. 코드를 보면서 "이건 왜 이렇게 만들었을까?", "이 부분이 이해가 안 가는데"라고 자유롭게 물어보세요.

Tip: 큰 코드베이스는 "전체를 분석해줘"보다 범위를 좁혀서 물어보는 것이 훨씬 정확합니다./clear 후 모듈별로 나눠서 분석하면 컨텍스트 오염 없이 깊이 있는 분석을 받을 수 있습니다.
내 메모
📝내 메모