🚀 FDE · 온보딩 · 프로젝트 다루기 · L02

프로젝트 생성하기

작성일자 2026-07-23  ·  수정일자 2026-07-23  ·  예상소요 25분

목표 이 강의가 끝나면 학습자가 새 프로젝트를 만들어 웹 주소로 접속할 수 있다.

1. 프로젝트 만들기

standarda-devtools 폴더에서 Claude Code 를 켜고, 만들 프로젝트 이름을 말로 시킵니다. my_project 자리에 원하는 이름을 넣습니다.

# 🖥️ 서버 터미널
gildong@ip-172-31-39-132:~$ cd ~/standarda-devtools
gildong@ip-172-31-39-132:~/standarda-devtools$ claude

Claude Code 가 열리면 아래처럼 자연어로 요청합니다.

create-project 로 'my_project' 만들어줘

프로젝트 한 벌이 내 홈(~/my_project) 에 만들어집니다(서버 포트 할당까지 자동). 다 만들어지면 Claude Code 를 나갑니다.

/exit

(다음 단계부터는 Claude Code 안이 아니라 터미널과 편집기에서 합니다.)


2. 준비 스크립트 실행

방금 만든 프로젝트 폴더로 들어가 준비 스크립트를 돌립니다. 앞부분은 자동으로 지나가고, 세 군데서 멈추고 물어봅니다(아래 ← 대로 답합니다).

# 🖥️ 서버 터미널
gildong@ip-172-31-39-132:~$ cd ~/my_project
gildong@ip-172-31-39-132:~/my_project$ ./setup.sh

  PostgreSQL 'ubuntu' 사용자 비밀번호:            ← 관리자에게 받은 DB 비밀번호 (쳐도 화면엔 안 보임)
  >>> 나머지 .env 항목(API 키 등)을 편집해주세요: ~/my_project/src/.env
  >>> 편집 완료 후 Enter를 누르면 계속 진행합니다.   ← 지금은 그냥 Enter (API 키는 개발 챕터에서 채웁니다)
  User id:                                       ← 원하는 관리자 아이디 (예: admin)
  Password:                                      ← 관리자 비밀번호 (2번, 화면엔 안 보임)
  Password (again):

  셋업 완료!
  • 비밀번호는 쳐도 화면에 안 보이는 게 정상입니다(관리자에게 받은 값). 너무 단순하면 Bypass ... [y/N] 를 물어보면 y 를 누릅니다.
  • 셋업 완료! 가 뜨면 준비가 끝난 것입니다. API 키(.env)는 나중에 개발 챕터에서 채웁니다.

3. 웹으로 띄우기

프로젝트 안(src)에서 Claude Code 를 켜고, 개발 서버를 말로 띄웁니다.

# 🖥️ 서버 터미널
gildong@ip-172-31-39-132:~$ cd ~/my_project/src
gildong@ip-172-31-39-132:~/my_project/src$ claude

Claude Code 안에서 자연어로 요청합니다.

개발 서버 띄워줘

끝나면 Claude Code 가 접속 주소를 알려 줍니다. 그 주소를 브라우저에서 열어 화면이 뜨면 성공입니다.

  • 주소는 https://my-project-dev.popupstudio.ai 형태입니다. (프로젝트 이름 자리에 본인 이름이 들어가고, 이름 속 _ 는 주소에서 - 로 바뀝니다. 예: my_project → my-project-dev)

마무리

  • 핵심 정리: cd ~/standarda-devtools 에서 claude 로 create-project 실행 → ./setup.sh → 프로젝트 안에서 '개발 서버 띄워줘'로 웹에 띄웠습니다.
  • 주의 사항: Claude Code 는 항상 정해진 폴더에서 켜세요. 프로젝트를 만들 때는 ~/standarda-devtools, 서버를 띄울 때는 ~/my_project/src. 앞에 cd 를 먼저 치는 이유입니다.
  • 다음 시간: 이미 있는 프로젝트를 가져오기.