프로젝트 다루기

프로젝트를 만드는 도구는 standarda-devtools(줄여서 devtools) 라는 폴더에 들어 있습니다. 이 폴더를 서버의 내 홈에 한 번 받아 둡니다.

VS Code 서버 터미널에 아래를 입력합니다.

# 🖥️ 서버 터미널
gildong@ip-172-31-39-132:~$ git clone https://github.com/popupstudio-ai/standarda-devtools.git ~/standarda-devtools

• 앞 강의에서 GitHub 로그인을 했기 때문에, 비공개 저장소인 이 폴더도 바로 받아집니다.
• 이 명령은 지금 어느 위치에서 치든 항상 내 홈 아래 standarda-devtools 폴더로 받습니다(엉뚱한 곳에 받아질 걱정이 없습니다). 명령 끝의 ~ 가 내 홈을 가리킵니다.
• 만약 already exists 오류가 나면 이미 받아 둔 것이니, 새로 받을 필요 없이 넘어갑니다.

• 핵심 정리: git clone ... ~/standarda-devtools 로 프로젝트 생성 도구가 든 standarda-devtools 를 내 홈에 받았습니다.
• 다음 시간: 프로젝트 생성.

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 안이 아니라 터미널과 편집기에서 합니다.)

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

# 🖥️ 서버 터미널
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)는 나중에 개발 챕터에서 채웁니다.

프로젝트 안(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 를 먼저 치는 이유입니다.
• 다음 시간: 이미 있는 프로젝트를 가져오기.

새로 만드는 것(앞 강의)이 아니라, 이미 GitHub 에 있는 프로젝트(내가 전에 만든 것, 또는 팀의 다른 프로젝트)를 이 서버로 가져올 때 씁니다.

standarda-devtools 폴더에서 Claude Code 를 켜고, 가져올 프로젝트 주소를 말로 시킵니다. 주소(https://github.com/...)는 팀에서 받습니다.

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

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

clone-repo 로 https://github.com/popupstudio-ai/my_project.git 가져와줘

프로젝트가 내 홈(~/my_project/src) 에 표준 구조로 받아지고, 필요한 준비(전용 환경·설치)까지 자동으로 됩니다. 다 받아지면 Claude Code 를 나갑니다.

/exit

가져온 프로젝트에서 작업할 때는 프로젝트 안(src)에서 Claude Code 를 켭니다.

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

• 핵심 정리: cd ~/standarda-devtools 에서 claude 로 clone-repo 를 실행해 기존 프로젝트를 서버로 가져왔습니다.
• 주의 사항: 새 프로젝트는 create-project(앞 강의), 이미 있는 프로젝트는 clone-repo(이 강의)입니다.
• 다음 시간: 프로젝트 업데이트(최신 코드 받기).

팀원들이 같은 프로젝트를 고쳐 GitHub 에 올리고, 회사 공용 코드·설정도 새 버전이 나옵니다. 그래서 작업을 시작하기 전에 아래를 최신으로 맞춰 둡니다.

• 내 프로젝트 코드: 팀의 다른 사람이 올린 최신 변경.
• 공용 자산
  • standarda-core: AI·구글 연동 코드
  • standarda-template: 공통 설정·규칙
  • standarda-devtools: 프로젝트 생성 도구

프로젝트 안(src)에서 Claude Code 를 켜고 요청합니다. my_project 는 본인 프로젝트 폴더 이름입니다.

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

최신 코드 받아줘

• 충돌이 나도 직접 손대지 말고 "충돌 해결해줘" 라고 하면 Claude Code 가 정리해 줍니다.

끝나면 Claude Code 를 나옵니다.

/exit

프로젝트 생성 도구도 최신으로 받아 둡니다.

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

프로젝트 안(src)에서 Claude Code 를 켜고 차례로 요청합니다.

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

standarda-core 를 최신 버전으로 올려줘

update-from-template 로 최신 템플릿 반영해줘

update-from-template 은 무엇을 반영할지 등급(A/B/C) 으로 물어봅니다.

• A (도구·워크플로우): 서비스 동작에 영향 없어 안전. 반영.
• B·C (설정·규칙): 상황에 따라 다름. 헷갈리면 팀에 확인.

보통 A만 반영하면 됩니다. 내 데이터 구조(모델)는 위험해서 자동으로 제외됩니다.

끝나면 Claude Code 를 나옵니다.

/exit

• 핵심 정리: 작업 전 내 코드 · devtools · core · template 를 최신으로 맞췄습니다.
• 주의 사항: 코드 충돌은 Claude Code 에 "충돌 해결해줘"로 맡깁니다. template 은 헷갈리면 A 만 반영하세요.
• 다음 시간: 프로젝트 삭제하기.

연습하다 보면 프로젝트를 여러 개 만들게 됩니다. 폴더만 지우면 데이터베이스·포트·도메인 같은 부수 자원이 서버에 남아 쌓입니다. delete-project 는 이걸 한 번에 정리합니다.

지우려는 프로젝트 안에서 Claude Code 를 켜 둔 상태라면, 먼저 나옵니다.

/exit

GitHub 저장소까지 한 번에 지우려면, 먼저 삭제 권한을 더해 둡니다(최초 1회만, 이미 한 적 있으면 건너뜁니다). 터미널에서:

# 🖥️ 서버 터미널
gildong@ip-172-31-39-132:~$ gh auth refresh -h github.com -s delete_repo

(GitHub 로그인 때처럼 브라우저 승인이 한 번 뜹니다.)

standarda-devtools 폴더에서 Claude Code 를 켜고 말로 시킵니다. my_project 는 지울 프로젝트 이름입니다.

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

delete-project 로 my_project 지워줘

• 되돌릴 수 없는 작업이라, 지울 자원 목록을 먼저 보여 주고 확인을 받은 뒤에만 삭제합니다. 목록을 눈으로 확인한 뒤, 아래를 입력합니다.

yes

• 핵심 정리: cd ~/standarda-devtools 에서 claude 로 delete-project 를 실행해 프로젝트와 부수 자원을 정리했습니다. 저장소 삭제는 최초 1회 gh auth refresh ... delete_repo.
• 다음 시간: 이제 프로젝트를 다룰 줄 아니, 개발(AI 에이전트 만들기)로 넘어갑니다.