Claude 로 코드 읽기
몇 분 안에 코드베이스 하나 이해하기
⏱ 예상 ~8분
01 · 읽기
Claude Code의 가장 강력한 활용 중 하나는 여러분이 쓰지 않은 코드를 이해하는 것 이에요. 모든 엔지니어가 늘 필요로 하는 스킬이에요 — 새 팀에 합류할 때, 오픈소스 프로젝트를 탐색할 때, 몇 달 만에 자기 코드로 돌아왔을 때.
Claude Code가 나오기 전엔 새 코드베이스를 이해하려면 몇 시간 동안 파일을 읽고, 함수 호출을 따라가고, 모든 게 어떻게 연결되는지 짜맞춰야 했어요. 이제는 그냥 물어보면 돼요.
Claude 로 코드 읽기를 연습해 봐요. 있는 아무 프로젝트에서 Claude Code를 시작하세요 — Level 7 의 그거나, 파일이 몇 개 있는 아무 프로젝트가 이상적이에요.
💡 상상해 봐요지도 없이 새 도시에 떨어졌다고 상상해 봐요. 몇 시간 동안 돌아다니면서 모든 게 어디 있는지 찾아낼 수 있어요. 아니면 거리를 모두 아는 현지인한테 물어볼 수 있어요. Claude Code가 그 현지인이에요 — 코드 한 줄 한 줄을 아는 사람이라는 점만 빼면요.
02 · 프롬프트 템플릿
큰 그림부터 시작해요. Claude 한테 전체 프로젝트 개요를 달라고 해요 — 뭘 하는 건지, 어떻게 조직됐는지요.
이 프로젝트를 대략적으로 설명해 줘 — 뭘 하는 거고, 구조는 어떻게 짜여 있어?
03 · 프롬프트 템플릿
이제 가까이서 보세요. 프로젝트의 메인 파일을 골라서 Claude 한테 한 줄씩 풀어 달라고 해요.
메인 파일이 뭘 하는지 줄별로 설명해 줘
04 · 프롬프트 템플릿
프로젝트에 package.json 이 있으면 Claude 한테 의존 패키지를 설명해 달라고 해요. 없으면 이 단계는 건너뛰세요.
이 프로젝트는 어떤 패키지들을 쓰고 있고, 각각 어디에 쓰여?
05 · 퀴즈
Claude Code 한테 프로젝트의 어떤 함수를 설명해 달라고 했을 때, 같은 코드를 Claude.ai 에 붙여넣는 것보다 가장 큰 장점은 뭐예요?
- 자동으로 코드를 실행해서 설명을 확인할 수 있어요
- 함수가 의존하는 다른 모든 파일을 읽어서 컨텍스트를 가져요
- 웹 앱보다 응답이 빨라요
- Claude.ai 보다 더 강력한 모델을 써요
06 · 빈칸 채우기
Claude 한테 지금 보고 있는 파일을 설명해 달라고 할 때, 영어로 흔히 쓰는 표현은 'Explain what _____ does' 인데, 빈칸엔 보통 'this file' (이 파일) 이 들어가요. 빈칸에 들어갈 영어는?
07 · 읽기
이게 진짜 엔지니어들이 매일 하는 일이에요. 회사에 합류하면 본 적 없는 파일이 수천 개 있는 코드베이스에 던져져요. 첫 임무는 그걸 이해하는 거예요.
AI 도구가 나오기 전엔 몇 주가 걸릴 수 있는 일이었어요. 엔지니어들은 문서가 있다면 그걸 읽고, 코드를 손으로 따라가고, 동료들에게 물었어요. Claude Code 는 이 과정을 엄청 빠르게 만들어요.
경력 있는 엔지니어도 이 패턴을 계속 써요. 코드를 이해하는 건 코드를 쓰는 것만큼 중요해요.
08 · 퀴즈
동료가 본 적 없는 GitHub repo 링크를 보냈어요. Claude Code로 이 프로젝트가 뭘 하는지 가장 빨리 이해하는 방법은?
- repo 를 clone, cd 로 들어가서, claude 실행, 프로젝트 개요 물어보기
- 각 파일을 손으로 읽기, README 부터 시작
- 각 파일을 하나씩 Claude.ai 에 복붙하기
- 프로젝트 이름을 구글에 검색, 블로그 글 읽기
09 · 빈칸 채우기
Claude Code 는 진짜 여러분의 _____ 를 읽어서 정확한 답을 줘요, 추측하는 게 아니에요.
⚠ 전체 인터랙티브 경험에는 JavaScript가 필요해요. JavaScript를 켜고 새로 고침해 주세요.
※ 이 사이트는 독립 운영되는 교육 프로젝트로, Anthropic의 공식 제품이 아니에요. Claude™ 는 Anthropic, PBC 의 상표예요.