Claude Code로 스케줄러 프로그램 만들기
들어가며
최근 생성형 AI의 발전으로 누구나 프로그램을 직접 만들 수 있는 시대가 열리고 있습니다. 특히 Claude Code와 같은 AI 기반 개발 도구는 복잡한 프로그래밍 지식이 없어도 간단한 프로그램을 직접 만들어 볼 수 있게 해줍니다. 하지만 여전히 많은 비개발자들에게 “프로그램 개발”이라는 단어는 어렵고 낯설게 느껴질 수 있습니다.
이번 글에서는 이러한 장벽을 조금 낮추기 위해 Claude Code를 활용하여 간단한 스케줄 관리 프로그램을 직접 만들어 보는 과정을 단계별로 소개하려고 합니다. 특히 다음과 같은 흐름을 중심으로 설명합니다.
VS Code에서 프로젝트 폴더를 설정하는 방법
Claude Code에게 전달할 PRD(Product Requirement Document) 작성 방법
AI가 만든 프로그램을 실행하고 수정하는 과정
이 과정을 한 번 경험해 보면, 단순히 AI에게 질문을 하는 수준을 넘어 AI와 협업하여 실제 프로그램을 만들어 보는 경험을 할 수 있습니다. 그럼 이제 Claude Code를 활용하여 간단한 스케줄러 프로그램을 만들어보겠습니다.
1. 스케쥴러 프로그램 프로젝트 폴더 지정하기
이제, Claude Code를 활용하여 간단한 프로그램을 직접 개발해 보겠습니다. 먼저 VS Code에서 프로그램을 개발할 프로젝트 폴더를 생성해야 합니다. 저의 경우 여러 프로젝트를 관리하기 위해 'workspace'라는 폴더를 사용하고 있습니다.
VS Code 상단 메뉴에서 [파일] → [폴더 열기]를 클릭한 뒤 프로젝트를 관리할 폴더를 선택합니다. 여기서는 'workspace' 폴더를 작업 공간으로 사용하겠습니다. 작업 폴더가 열리면 VS Code 왼쪽 메뉴에서 탐색기(Explorer) 아이콘을 클릭합니다. 탐색기 창에서는 현재 작업 중인 폴더 구조를 확인하고 새로운 파일이나 폴더를 생성할 수 있습니다. 이제 'workspace' 폴더에서 마우스 오른쪽 버튼을 클릭합니다. 그러면 여러 메뉴가 나타나는데 여기서 [새 폴더]를 선택합니다. 새 폴더를 생성하면 이름을 입력할 수 있는 상태가 됩니다.
여기서는 예제 프로그램을 만들기 위해 'plan'이라는 이름의 프로젝트 폴더를 생성하겠습니다. 폴더 이름을 입력한 뒤 Enter를 누르면 'workspace' 폴더 안에 'plan'이라는 새로운 프로젝트 폴더가 생성됩니다. 이제 해당 폴더가 Claude Code로 프로그램을 개발할 프로젝트 작업 공간이 됩니다. 마지막으로 VS Code 상단 메뉴에서 다시 [파일] → [폴더 열기]를 클릭한 뒤 방금 생성한 plan 폴더를 선택하여 프로젝트 폴더를 활성화합니다.
새 작업 폴더를 지정하면 아래 창에서 실행 중이던 Claude Code CLI가 종료됩니다. 이 경우에는 터미널 창에서 다시 'Claude' 명령어를 입력하여 Claude Code를 다시 실행하면 됩니다.
2) 스케쥴러 프로그램 개발을 위한 PRD 작성하기
이제 스케줄을 기록하기 위한 프로그램을 만들어 보겠습니다. 모든 프로그램 개발에서는 개발의 방향성과 일관성을 확보하기 위해 PRD(Product Requirement Document)를 작성하는 것이 중요합니다. PRD는 프로그램이 어떤 기능을 가져야 하는지, 어떤 방식으로 동작해야 하는지를 정리한 개발 설계 문서라고 볼 수 있습니다. 저는 웹 버전 Claude에게 아래와 같은 프롬프트를 전달하여 PRD 작성을 요청했습니다.
Claude Code에 전달할 스케쥴링 프로그램 PRD를 만들어줘.
- 달력에 클릭을 해서 각 일마다 스케쥴을 작성할 수 있게 해줘.
- 일정 추가 버튼을 클릭해서 범위를 정하고 할일을 넣으면 한번에 캘린더가 채워지게 해줘.
- 현재 날짜가 몇일인지 알수 있게 하고, 당일이 되면 어떤일을 해야하는지 알람도 뜰수 있게 해줘.
- 브라우저에서 실시할수 있게 하고, 데이터는 저장되고 다음에도 볼수 있도록 해줘.
- 프로프트는 순서대로 3번에 나눠서 첫번째 다 완료되고 나서 두번째, 두번째 다 완료되고 나서 세번째를 넣을수 있게 해줘.
Claude Code에 전달할 PRD는 구체적으로 작성해줘야돼.
프롬프트를 입력하니 Claude Code에게 3번에 거쳐서 입력할 수 있도록 PRD 파일을 작성해 주었습니다. PRD 파일이 아니라 직접 제공하는 경우에는 직접 복사해서 바로 Claude Code로 프롬프트를 전달해 주면 됩니다. 이번의 경우에는 파일로 작성을 해주었으므로, '다운로드'를 클릭하여 PRD 워드파일을 다운로드 받고 워드파일을 실행하여 1단계부터 3단계까지 단계별 프롬프트를 순서대로 Claude Code에 입력하여 프로그램 개발을 진행하였습니다.
PRD의 1단계 프롬프트를 복사하여 Claude Code에 붙여 넣기 하면 Claude Code가 해당 요구사항에 맞게 개발을 시작합니다. Claude Code 창에 텍스트를 붙여 넣으면 아래와 같이 [Pasted text #1 +18 lines]와 같은 표시가 나타날 수 있습니다. 이는 텍스트가 길기 때문에 요약해서 표시되는 것으로, 정상적으로 입력된 상태입니다. 이 상태에서 Enter 키를 눌러 실행하면 Claude Code가 작업을 시작합니다.
Claude Code를 사용하다 보면 아래와 같이 사용자의 의사를 확인하는 질문이 나타나기도 합니다. 이 과정은 Human-in-the-Loop 방식으로, 프로그램이 파일을 수정하거나 생성하기 전에 사용자에게 작업 진행 여부를 확인하는 절차입니다. 대부분의 경우 "Yes"를 선택하여 진행하면 됩니다. 만약 모든 작업을 자동으로 진행하고 싶다면 "Yes, allow all edits during this session" 옵션을 선택한 뒤 Enter를 누르면 됩니다.
첫 번째 작업이 완료되면 PRD의 두 번째 Prompt를 복사하여 다시 Claude Code에 입력합니다. 이후 동일한 방식으로 세 번째 Prompt도 전달하면 Claude Code가 단계적으로 프로그램을 완성합니다.
작업이 진행되면 왼쪽 프로젝트 폴더 창에 새로운 파일 혹은 하위 폴더들이 생성됩니다. 이번 프로젝트에서는 index.html 파일이 생성되었습니다. 이 파일이 포함된 폴더로 이동하여 실행하면 아래와 같은 프로그램을 직접 실행할 수 있습니다. 이번 프로젝트는 비교적 간단한 구조이기 때문에 실행 방법이 명확하지만, 프로그램이 복잡해질 경우 여러 개의 파일이 생성되어 실행 방법이 헷갈릴 수 있습니다. 이럴 경우 Claude Code에게 다음과 같이 질문하면 됩니다.
"이 프로그램을 실행하려면 어떤 파일을 실행해야 하나요?"
Claude Code는 실행 방법을 설명해 주며, 해당 안내에 따라 프로그램을 실행하면 됩니다. 이번 프로젝트에서는 index.html을 실행하였더니 아래와 같은 프로그램 실행화면이 활성화되었습니다. 프로그램 개발 중간 단계에서도 프로그램을 실행하여 진행단계를 확인할 수 있습니다.
3. 스케쥴러 프로그램 완성을 위한 디버깅 실시하기
PRD에 따라 Claude Code가 프로그램을 완벽하게 만들어주면 좋겠지만, 실제로는 사용자가 의도한 기능이 완전히 구현되지 않는 경우도 있습니다. 이럴 때는 프로그램을 실행하며 부족한 부분을 수정하는 작업이 필요합니다. 이 과정을 디버깅(Debugging)이라고 합니다. 이번 프로젝트에서도 PRD만으로 모든 기능이 한 번에 구현되지는 않았고, 몇 가지 버그가 발생했습니다. 이 프로그램에서는 다음과 같은 기능을 구현하려고 했습니다.
3월 23일부터 3월 25일까지 일정이 지속되는 경우 시작일과 종료일을 설정하면 해당 기간 전체에 같은 일정이 자동으로 입력되는 기능
하지만 실제로 실행해 보니 시작일과 종료일을 설정해도 다음 단계가 활성화되지 않는 문제가 발생했습니다. 따라서 해당 버그를 다음과 같은 절차를 통해 디버깅하였습니다.
1️⃣ 프로그램 실행 화면을 캡처합니다.
2️⃣ 그림판을 이용해 이미지를 파일로 저장합니다.
3️⃣ 해당 이미지를 Claude Code 창으로 드래그하여 업로드합니다.
이미지가 정상적으로 업로드되면 아래와 같이 [image #1] 표시가 나타납니다. 그다음 해당 문제 상황을 텍스트로 설명하며 프로그램 수정 요청을 전달합니다.
Claude Code가 코드를 수정한 뒤 프로그램을 다시 실행해 보니, 이제 시작일과 종료일을 선택하면 일정 입력 팝업 창이 정상적으로 활성화되고 해당 기간 전체에 동일한 일정이 자동으로 적용되는 것을 확인할 수 있었습니다. 이처럼 Claude Code는 텍스트뿐 아니라 이미지 기반으로도 문제 상황을 이해하고 코드 수정에 활용할 수 있습니다.
나가며
이번 글에서는 Claude Code를 활용하여 간단한 스케줄러 프로그램을 직접 만들어보는 과정을 살펴보았습니다. 이 과정에서 중요한 점은 단순히 프로그램을 만드는 것 자체가 아니라, AI와 협업하는 방식으로 문제를 해결하는 경험이라고 생각합니다. 예전에는 프로그램을 개발하려면 프로그래밍 언어를 오랜 시간 공부해야 했습니다. 하지만 이제는 AI에게 요구사항을 설명하고, PRD를 작성하고, 결과를 테스트하며 개발 과정을 함께 만들어 갈 수 있는 환경이 마련되었습니다.
물론 아직 AI가 완벽한 프로그램을 한 번에 만들어주지는 않습니다. 하지만 작은 프로그램이라도 직접 만들어보고, 오류를 수정하고, 기능을 개선하는 과정을 반복하다 보면 AI와 함께 개발하는 새로운 작업 방식에 익숙해질 수 있습니다. 앞으로 이러한 방식은 개발자뿐 아니라 HR, 행정, 기획, 연구 등 다양한 직무에서도 활용될 가능성이 높습니다. 작은 프로젝트라도 직접 만들어 보면서 AI와 함께 일하는 새로운 경험을 해보시기를 바랍니다.
바이브 코딩 관련 HRKIM 콘텐츠 읽을거리
https://brunch.co.kr/@publichr/179
https://brunch.co.kr/@publichr/177
https://brunch.co.kr/@publichr/176