클로드 코드로 새 프로젝트 뼈대 10분 만에 완성하기
새 프로젝트를 시작할 때마다 이런 생각이 드신 적 있으신가요? “폴더를 어떻게 나눠야 하지?”, “파일 이름은 뭘로 해야 깔끔하지?”, “일단 구글에서 보일러플레이트 찾아볼까…” 이렇게 세팅에만 30분, 1시간을 쓰다 보면 정작 코딩할 에너지가 빠져나가 버리죠.
클로드 코드(Claude Code)를 쓰면 이 고민이 사라집니다. 빈 폴더 하나에서 자연어로 몇 마디 건네면, AI가 프로젝트 뼈대를 척척 만들어 줍니다. 이번 7편에서는 파이썬(Python), Node.js, 웹 프로젝트 세 가지 실습 예제를 통해 AI와 함께 초기 세팅을 빠르게 끝내는 방법을 단계별로 안내해 드리겠습니다.
1. 시작 전에: 클로드 코드가 프로젝트 생성을 어떻게 도울까요?
클로드 코드는 단순한 코드 자동완성 도구가 아닙니다. 터미널 안에서 파일을 만들고, 폴더를 생성하고, 내용을 채우는 것까지 한 번에 처리합니다. 특히 새 프로젝트를 시작할 때 강력한 두 가지 방법이 있습니다.
| 방법 | 설명 | 언제 쓰나요? |
|---|---|---|
| 자연어 지시 | “파이썬 웹 스크래퍼 프로젝트 만들어줘”처럼 말로 요청 | 처음부터 새 프로젝트 시작할 때 |
/init 명령어 |
이미 파일이 조금 있을 때 AI가 구조를 분석해 CLAUDE.md 자동 생성 | 기존 코드에 클로드 코드를 도입할 때 |
CLAUDE.md란? 프로젝트 설계서 역할을 하는 파일입니다. 클로드 코드에게 “이 프로젝트는 파이썬 3.11을 쓰고, 테스트는 pytest로 해줘”처럼 규칙을 알려두는 텍스트 파일입니다. 한 번 만들어두면 이후 모든 대화에 자동으로 적용됩니다.
2. 파이썬 프로젝트 뼈대 만들기 실습
빈 폴더에 터미널을 열고 클로드 코드를 실행한 뒤, 아래처럼 입력해 보세요.
파이썬으로 뉴스 기사를 수집하는 웹 스크래퍼 프로젝트를 만들어줘.
requirements.txt, .gitignore, README.md도 포함하고,
src 폴더 안에 scraper.py와 utils.py를 넣어줘.
클로드 코드가 몇 초 안에 아래와 같은 구조를 생성합니다.
news-scraper/
├── src/
│ ├── scraper.py ← 핵심 크롤링 로직
│ └── utils.py ← 공통 유틸리티 함수
├── tests/
│ └── test_scraper.py ← 기본 테스트 파일
├── .gitignore
├── README.md
└── requirements.txt
각 파일 안에는 기본 코드 틀(임포트, 클래스 선언 등)까지 채워져 있어서 바로 작업을 이어갈 수 있습니다.
팁: 더 구체적으로 요청할수록 더 좋은 결과가 나옵니다.
– “가상환경 설정 방법도 README에 써줘”
– “Python 3.11 기준으로 작성해줘”
– “requests와 BeautifulSoup 라이브러리를 쓸 예정이야”
3. Node.js / 웹 프로젝트 뼈대 만들기
이번엔 Node.js 프로젝트를 만들어 보겠습니다.
Express.js로 간단한 REST API 서버 프로젝트를 만들어줘.
라우터 파일, 미들웨어 폴더, .env 예시 파일(.env.example)도 포함해줘.
생성되는 구조 예시입니다.
my-api/
├── src/
│ ├── routes/
│ │ └── index.js ← API 라우터
│ ├── middlewares/
│ │ └── auth.js ← 인증 미들웨어
│ └── app.js ← Express 앱 진입점
├── .env.example ← 환경변수 샘플
├── .gitignore
├── package.json
└── README.md
순수 HTML·CSS·JS 웹 페이지라면 이렇게 요청할 수도 있습니다.
랜딩 페이지용 기본 웹 프로젝트 폴더 구조 만들어줘.
css/style.css, js/main.js, index.html 포함해줘.
4. /init 명령어로 기존 프로젝트에 CLAUDE.md 생성하기
이미 어느 정도 파일이 있는 프로젝트에 클로드 코드를 도입할 때는 /init 명령어를 사용합니다.
/init
클로드 코드가 프로젝트 폴더를 스캔해서 다음을 자동으로 파악합니다.
- 사용 중인 언어 및 프레임워크 (Python, Node.js, React 등)
- 패키지 목록 (package.json, requirements.txt 기반)
- 기존 폴더 구조와 파일 패턴
그 결과를 바탕으로 CLAUDE.md를 생성해 주는데, 이후 모든 대화에서 클로드 코드가 프로젝트 맥락을 기억한 상태로 도와줍니다.
5. 더 잘 활용하는 3가지 요령
새 프로젝트 생성 시 더 좋은 결과를 얻는 노하우를 정리해 드립니다.
- 목적을 먼저 말하기: “쇼핑몰 API 서버야”, “데이터 분석 노트북 프로젝트야”처럼 프로젝트 성격을 먼저 알려주면 더 적합한 구조가 나옵니다.
- 제약 조건 명시하기: 파이썬 버전, 사용할 라이브러리, 코딩 스타일(PEP8 준수 등)을 미리 알려주세요.
- 단계별로 요청하기: 뼈대 생성 → 기본 코드 채우기 → 테스트 파일 추가 순서로 나눠서 요청하면 각 단계를 꼼꼼히 확인할 수 있습니다.
자주 묻는 질문 (FAQ)
Q. 클로드 코드가 만든 파일을 마음에 안 들면 어떻게 하나요?
A. “routes 폴더 이름을 api로 바꿔줘”, “테스트 파일은 빼줘”처럼 바로 수정을 요청하면 됩니다. 대화를 이어가며 구조를 계속 다듬을 수 있습니다.
Q. 어떤 언어와 프레임워크를 지원하나요?
A. Python, JavaScript, TypeScript, Go, Rust, Java 등 대부분의 주요 언어를 지원합니다. React, Next.js, FastAPI, Django, Express 등 주요 프레임워크도 인식합니다.
Q. 만들어진 파일을 실제로 실행해도 되나요?
A. 뼈대 코드는 문법적으로 올바르지만, 비즈니스 로직은 직접 채워야 합니다. 바로 실행하기보다 “이 코드 실행해서 오류 없는지 확인해줘”라고 클로드 코드에게 추가 요청하는 것을 권장합니다.
한 줄 요약: 클로드 코드는 자연어 한 문장으로 프로젝트 폴더 구조 전체를 자동 생성해 주며,
/init명령어로 기존 프로젝트에도 즉시 적용할 수 있습니다.
참고 자료
– Claude Code 빠른 시작 — 공식 한국어 문서
– The Ideal Project Structure for Claude Code (sidsaladi.substack.com)
– Claude Code Project Structure Best Practices (Medium)