1. 프로젝트 착수 — 저장소와 팀 규칙

이 단계에서 하는 것: 실습 폴더(moneynote)를 VS Code로 열고 Claude Code를 실행한다. AI가 가이드 문서와 회의록을 읽게 한 뒤 팀 규칙(CLAUDE.md)을 만든다. Git으로 변경 이력 관리를 시작하고 GitHub 비공개 저장소에 첫 커밋을 올린다. 필요한 명령은 AI가 실행하고, 계정 인증은 사람이 한다. 다음 단계로 넘길 것: 팀 규칙(CLAUDE.md)과 첫 커밋이 저장된 GitHub 비공개 저장소.

이 실습에서는 AI 에이전트(Claude Code)에게 개발팀의 역할별 작업을 맡긴다. 사람은 무엇을 만들지 결정하고 결과를 검토한다. 먼저 프로젝트의 공통 규칙을 작성하고 Git 저장소에 기록한다.

실무에서는 개발을 시작할 때 저장소부터 준비한다. 코드를 작성하기 전에 저장소와 커밋 규칙을 정하고, 비밀값이 담긴 파일은 .gitignore로 제외한다. 이렇게 해야 실수로 비밀값을 커밋하는 일을 줄일 수 있다.

압축을 푼 moneynote 폴더에는 세 가지 자료가 미리 들어 있다. 회사 가이드 문서(docs/가이드/), 회의록(data/킥오프_회의록.md), 문서 양식 두 개(docs/templates/PRD-템플릿.md, docs/templates/API-Spec-템플릿.md)다. 양식은 기획 단계와 API 설계 단계에서 쓴다. 팀 규칙 파일(CLAUDE.md)과 Git 저장소는 이번 단계에서 만든다. 앱 코드는 아키텍처 설계에서 폴더 구조와 기술을 정한 뒤 작성한다.

준비 확인

앞에서 Git·Node.js·VS Code·Claude Code 설치를 마쳤다.
앞 단계에서 moneynote.zip을 내려받아 압축을 풀고 moneynote 폴더를 준비했다.

따라하기

단계 1 — 프로젝트 폴더 열기

VS Code에서 File → Open Folder(폴더 열기) 를 누른다.
압축을 푼 moneynote 폴더를 선택해 연다.
왼쪽 탐색기에 docs/가이드/ 와 data/킥오프_회의록.md 가 보이는지 확인한다. (아직 CLAUDE.md도, 코드 파일도 없다. 정상이다.)

용어: 회의록은 고객·기획 회의에서 나온 요구사항을 기록한 문서다. 다음 단계에서는 AI가 data/킥오프_회의록.md를 읽고 첫 기획 문서인 PRD를 작성한다.

이렇게 나오면 성공: 왼쪽에 docs/가이드/ 문서들과 data/킥오프_회의록.md가 보인다.

단계 2 — Claude Code 실행

터미널을 연다: Terminal → New Terminal (Windows는 bash 터미널인지 확인).
아래를 입력해 Claude Code를 실행한다.

claude

이렇게 나오면 성공: Claude Code 입력창이 나타나고, 현재 열어 둔 프로젝트 폴더에서 작업할 수 있다.

단계 3 — 가이드 문서와 회의록 파악시키기

먼저 AI에게 회사 가이드 문서와 킥오프 회의록을 읽도록 요청한다. 아래 문장을 그대로 붙여 넣는다.

이 프로젝트 폴더의 docs/가이드 폴더에 있는 문서들을 훑어보고, 우리 팀이 어떤 규칙으로 개발하는지 한국어로 요약해줘.그리고 data/킥오프_회의록.md 를 읽고, 이 서비스에서 무엇을 원하는지 핵심 요구를 한국어로 정리해줘.아직 아무것도 만들지 말고, 읽고 설명만 해줘.

이렇게 나오면 성공: AI가 가이드 문서(디자인시스템·코딩컨벤션·프로젝트구조·깃커밋컨벤션)의 규칙과 회의록의 핵심 요구(회원가입/로그인·수입·지출 기록·월별 통계·AI 자동 분류·요약·프리미엄 결제 등)를 한국어로 정리한다.

단계 4 — 팀 규칙(CLAUDE.md) 직접 만들기

CLAUDE.md에는 프로젝트의 공통 규칙을 적는다. Claude Code는 작업할 때 이 파일의 내용을 참고한다. 아직 파일이 없으므로 방금 확인한 가이드 문서를 바탕으로 작성한다. 아래 문장을 그대로 붙여 넣는다.

이 프로젝트의 공통 규칙을 CLAUDE.md에 작성해줘. 방금 읽은 docs/가이드 문서를 따른다는 내용과 함께 다음 규칙을 꼭 넣어줘:1) 핵심 비즈니스 로직은 서버에서 처리한다.2) 클라이언트는 데이터베이스에 직접 접근하지 않는다.3) 비밀값은 코드에 직접 작성하지 않는다.4) 프로젝트 문서와 규칙을 우선하여 개발한다. docs/가이드 문서를 따른다.5) 한국어로 설명하고, 결정을 내리면 이유를 짧게 기록한다. 큰 변경 전에는 계획을 먼저 보여주고 내 승인을 받는다.

[실무] 실습용 규칙에서는 테스트 항목을 제외했다. 실무에서는 CLAUDE.md에 테스트 규칙을 넣어 백엔드·프론트엔드 기능을 구현할 때마다 관련 테스트도 작성하도록 한다.

이 실습에서는 강의 시간을 고려해 테스트를 뒤의 QA 엔지니어 단계에서 다룬다. 구현과 검증의 책임을 구분하는 과정도 그때 함께 살펴본다.

승인 창 읽는 법: 파일을 만들거나 명령을 실행하기 전에 Claude Code가 승인 창을 띄운다. 선택지는 보통 "Yes" / "Yes, 이 세션 동안 허용(don't ask again)" / "No"다. 파일 편집은 둘째를 고르면 이 세션에서 다시 묻지 않는다. 그러면 뒤 단계의 "퍼미션 창이 뜨고"는 뜨지 않고 바로 결과가 나온다 — 정상이다. 명령 실행(Bash)은 그때마다 읽고 승인한다.

이렇게 나오면 성공: 왼쪽 탐색기에 CLAUDE.md 가 새로 생기고, 위 규칙들이 담겨 있다. 이제부터 여는 모든 대화에서 AI가 이 규칙을 먼저 읽고 시작한다.

단계 5 — 형상관리 시작 + GitHub 비공개 저장소에 올리기

코드를 작성하기 전에 저장소에 올리면 안 되는 파일을 제외하고 저장소를 만든다.

이 단계에서는 AI가 도구 설치와 명령 실행을 맡고, 사람은 계정에 로그인해 인증한다. 아래 문장을 그대로 붙여 넣는다.

이 프로젝트의 변경 이력을 Git으로 관리해줘. README와 .gitignore 파일을 만들고, GitHub에 비공개 저장소를 생성해 코드를 올려줘.GitHub CLI를 설치하고 인증 명령까지 실행해줘. 계정 인증은 내가 할게.

Claude가 .gitignore를 만들고 커밋한 뒤, GitHub CLI(gh)를 설치하고 gh auth login까지 실행해 준다. 그러면 터미널에 인증 안내가 뜬다.

[사람] 계정 인증을 진행한다. 터미널 안내에 따라 GitHub.com → HTTPS → 브라우저로 로그인을 선택한다. 브라우저가 열리면 표시된 코드를 입력하고 승인한다. 인증이 끝나면 Claude가 저장소 생성과 push를 이어서 진행한다.

[사람 검증] GitHub 웹에서 내 눈으로 확인한다. github.com/내계정/moneynote를 열어서 — ① 저장소가 Private인지 ② docs/가이드/·data/킥오프_회의록.md·CLAUDE.md가 올라갔는지 ③ 비밀값을 막는 .gitignore가 있는지 ④ 커밋 메시지가 깃커밋컨벤션 형식인지 본다.

이렇게 나오면 성공: GitHub에 비공개 저장소가 만들어지고 첫 커밋이 표시된다.

이 단계 마무리

moneynote 폴더를 VS Code로 열었고, Claude Code가 실행됐다.
가이드 문서와 회의록을 AI가 읽고 이해했다.
팀 규칙 CLAUDE.md를 만들고, .gitignore에서 비밀값 파일을 제외한 뒤 첫 커밋을 했다.
AI는 도구 설치와 명령 실행을, 사람은 계정 인증을 맡았다. 이후 단계에서도 작업에 따라 책임을 나누어 진행한다.
GitHub 비공개 저장소에 첫 커밋을 올렸다. 이후 작성할 산출물도 이 저장소에서 관리한다.
앱 코드는 아직 작성하지 않았다. 아키텍처 설계에서 폴더 구조와 기술을 정한 뒤 해당 문서를 기준으로 구현한다.
막히면: 폴더가 안 열리거나 claude가 실행되지 않으면 앞 단계로 돌아가 설치를 다시 확인한다. gh auth login이 안 되면 브라우저 로그인 창이 떴는지, GitHub 계정이 있는지 확인한다. 저장소 이름이 이미 있다고 하면 다른 이름을 쓰거나 기존 것을 지운다.

다음 단계에서는 기획자 서브에이전트를 설정하고, 회의록을 바탕으로 PRD를 작성한다.