Nicolai NielsenIndustry

Claude Code와 Coolify를 활용한 AI 학습 플랫폼 구축 및 배포 가이드

Claude Code 에이전트를 사용하여 AI 기반 학습 앱을 개발하고, 오픈소스 Coolify 플랫폼을 통해 Hostinger VPS에 배포 및 관리하는 전체 워크플로를 다룹니다.

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

Claude Code와 같은 에이전트를 사용하면 복잡한 인프라 설정 없이도 풀스택 앱을 빠르게 구축할 수 있습니다. Coolify를 활용하면 월 5달러 수준의 VPS에서도 상용 PaaS와 유사한 수준의 배포 관리 환경을 구축할 수 있습니다.

배경

전통적인 클라우드 서비스(Azure, AWS)의 높은 비용 부담을 해결하기 위해 저렴한 VPS와 오픈소스 관리 도구를 결합한 대안적인 배포 방식이 주목받고 있습니다.

대상 독자

저비용으로 자신의 AI 프로젝트를 배포하고 싶은 개발자, AI 엔지니어 지망생, 1인 창업자

의미 / 영향

이 영상은 고비용 클라우드 인프라에 의존하지 않고도 AI 에이전트와 오픈소스 도구만으로 상용 수준의 서비스를 운영할 수 있음을 보여준다. 개발자는 인프라 운영 지식이 부족하더라도 Claude Code와 Coolify의 조합을 통해 아이디어를 실제 제품으로 빠르게 전환할 수 있다. 이는 1인 개발자나 스타트업의 MVP 출시 비용과 시간을 획기적으로 단축시키는 실무적 변화를 가져올 것이다.

챕터별 상세

00:00

프로젝트 아키텍처 및 도구 소개

월 5달러의 Hostinger VPS를 기반으로 모든 소프트웨어 시스템을 구축하고 배포하는 전체 시스템을 소개한다. 앱 관리를 위해 오픈소스 PaaS인 Coolify를 사용하며, 코드 생성은 Claude Code 에이전트가 담당한다. 이 조합은 Azure나 AWS 같은 대형 클라우드 플랫폼의 높은 비용을 회피하면서도 수백 명의 사용자를 처리할 수 있는 효율적인 구조를 제공한다.

01:06

Claude Code를 활용한 앱 스캐폴딩

터미널에서 Claude Code를 실행하여 Duolingo 스타일의 학습 플랫폼 구축을 시작한다. React 프론트엔드, FastAPI 백엔드, PostgreSQL 데이터베이스를 포함하는 기술 스택을 지정한다. 에이전트는 사용자의 요구사항을 분석하여 프로젝트 구조를 설계하고 필요한 모든 파일을 자동으로 생성한다.

Claude Code는 Anthropic에서 개발한 터미널 기반의 AI 코딩 에이전트로, 파일 시스템 접근 및 명령 실행 권한을 가집니다.

04:17

Hostinger VPS 및 Coolify 설정

Hostinger 제어판에서 KVM 2 플랜의 VPS를 생성하고 운영체제로 Ubuntu 24.04 기반의 Coolify를 선택한다. 원클릭 설치 기능을 통해 복잡한 리눅스 명령 없이도 관리 플랫폼을 즉시 활성화한다. 생성된 VPS의 IP 주소와 루트 비밀번호를 확인하여 향후 배포를 위한 준비를 마친다.

Coolify는 Heroku나 Vercel의 오픈소스 대안으로 불리는 자체 호스팅 가능한 PaaS 플랫폼입니다.

08:45

Coolify 리소스 및 데이터베이스 구성

Coolify 대시보드에서 새로운 프로젝트를 생성하고 PostgreSQL 데이터베이스 리소스를 추가한다. 단 한 번의 클릭으로 도커 컨테이너 기반의 데이터베이스 서버가 구동되며, 외부 접속을 위한 환경 변수와 포트 설정이 자동으로 이루어진다. 이를 통해 백엔드 앱이 데이터를 저장하고 관리할 수 있는 영구 저장소를 확보한다.

11:13

Claude Code를 이용한 기능 구현 및 버그 수정

생성된 코드의 환경 변수(.env) 파일을 설정하고 OpenAI API 키를 연결한다. 도커 컴포즈를 사용하여 로컬 환경에서 앱을 빌드하고 실행하는 과정에서 발생하는 데이터베이스 연결 오류를 Claude Code가 실시간으로 감지하여 수정한다. 에이전트는 오류 로그를 분석하고 소스 코드를 직접 수정하여 정상 작동을 보장한다.

13:47

GitHub 연동 및 자동 배포 파이프라인 구축

로컬에서 완성된 코드를 GitHub 저장소에 푸시하고 Coolify와 연동한다. Coolify의 'Public Repository' 기능을 사용하여 GitHub URL을 등록하고 도커 컴포즈 빌드 팩을 선택한다. 이제 GitHub의 메인 브랜치에 코드가 푸시될 때마다 Coolify가 이를 감지하여 VPS에 자동으로 재배포하는 CI/CD 환경이 완성된다.

17:12

커스텀 도메인 및 DNS 연결

사용 중인 도메인 관리자 페이지(one.com)에서 VPS의 IP 주소를 가리키는 A 레코드를 추가한다. Coolify 설정에서 해당 도메인 이름을 입력하면 Traefik이 자동으로 Let's Encrypt SSL 인증서를 발급하여 HTTPS 보안 접속을 활성화한다. 프론트엔드와 API 서버를 위한 서브도메인을 각각 할당하여 외부에서 접근 가능한 상용 수준의 URL을 확보한다.

A 레코드는 도메인 이름을 특정 IP 주소로 매핑하는 DNS 설정의 가장 기본적인 레코드 타입입니다.

19:30

최종 앱 테스트 및 기능 시연

배포된 도메인으로 접속하여 AI 기반 학습 플랫폼의 기능을 검증한다. 사용자가 '투자 101' 또는 '양자 역학'과 같은 주제를 입력하면 LLM이 즉석에서 커리큘럼과 퀴즈를 생성한다. Duolingo 스타일의 UI에서 문제를 풀면 XP가 쌓이고 진행 상황이 저장되는 것을 확인하며 전체 파이프라인의 성공적인 작동을 입증한다.

언급된 리소스

DemoHostinger VPS

문서Coolify Documentation

GitHubClaude Code GitHub

AI 분석 전체 내용 보기

AI 요약 · 북마크 · 개인 피드 설정 — 무료

출처 · 인용 안내

원문 발행 2026. 05. 01.수집 2026. 05. 01.출처 타입 YOUTUBE

인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.