본문으로 건너뛰기

Claude Code 활용 흐름 검증: /init, 계획 수립, 수정 반복을 활용한 소규모 페이지 제작 사례

윤스케어

2026.05.17

Claude Code 활용 흐름 검증: /init, 계획 수립, 수정 반복을 활용한 소규모 페이지 제작 사례 본문 이미지

소개

이번 사례에서는 Claude Code를 학습하고 활용하는 과정에서 어떤 작업 시작 방식이 실질적으로 유효한지 확인하기 위해, 대규모 구현 과제 대신 범위가 작은 페이지 제작 과제를 대상으로 작업 흐름을 검증했습니다.

접근 방식은 기존 파일의 부분 수정이 아니라, 새 폴더를 만들고 Claude Code에서 /init으로 CLAUDE.md를 생성한 뒤 초보 수강생도 따라올 수 있는 안내 페이지를 설계·생성·수정하는 전 과정을 처음부터 다시 수행하는 형태였습니다. 이 방식을 선택한 이유는 Claude Code 활용의 핵심이 명령어를 많이 아는 데 있기보다, 어떻게 시작하고, 어떤 기준을 세우고, 어떤 방식으로 반복 수정하는가에 있다고 보았기 때문입니다.

따라서 이번 실험의 대상은 스터디 참가자가 바로 활용할 수 있는 소규모 안내 페이지로 한정했고, 이를 통해 실제 학습과 실습에 연결 가능한 작업 흐름을 점검했습니다.

진행 방법

먼저 새 프로젝트 폴더를 만들고 Claude Code를 실행했습니다.

mkdir claude-code-mini-project
cd claude-code-mini-project
claude

초기 단계에서는 코드 생성을 바로 요청하지 않고, 우선 정보 구조와 페이지 구성안을 제안하도록 했습니다.

지금은 바로 만들지 말고,
초보 수강생용 안내 페이지를 만든다면
어떤 구조가 좋을지 먼저 제안해줘.

포함하고 싶은 건:
1. 이 페이지가 누구를 위한 것인지
2. 가장 먼저 알아야 할 것
3. 바로 써볼 수 있는 예시
4. 자주 하는 실수
5. 오늘 바로 해볼 것

이후 /init을 실행해 CLAUDE.md를 생성하고, 후속 작업에 적용할 기준을 명시했습니다.

/init

⚠️ 단, 이 시점엔 아직 코드가 없어서 /init이 분석할 대상이 적었습니다. 이 단계의 CLAUDE.md는 "기준 초안"에 가깝고,

▎ index.html을 만든 뒤 /init을 한 번 더 실행하면 훨씬 구체적인 문서가 됩니다.

다음 단계에서는 아래 기준에 맞춰 페이지를 생성하도록 요청했습니다.

  • 초보자 대상

  • 쉬운 문장 사용

  • 정적 HTML로 간단하게 만들기

  • 표와 리스트 중심 정리

  • 한 페이지 안에서 바로 따라할 수 있게 구성하기

실제 파일 생성을 요청할 때 사용한 프롬프트는 다음과 같았습니다.

index.html 파일을 만들어줘.

목표:
Claude Code를 처음 접하는 사람이
바로 읽고 따라할 수 있는 간단한 안내 페이지

반드시 포함:
1. 이 페이지 소개
2. 가장 먼저 알아야 할 명령 3~4개
3. 첫 요청문 예시
4. 자주 하는 실수
5. 오늘 바로 해볼 것

초안 생성 이후에는 결과를 그대로 확정하지 않고, 초보자 관점에서 이해도와 가독성을 다시 점검하도록 요청했습니다.

좋아. 이제 이 페이지를 초보 수강생 입장에서 다시 점검해줘.

1. 이해하기 어려운 부분
2. 너무 길거나 덜 중요한 부분
3. 더 눈에 띄게 바꿔야 하는 부분

을 먼저 말해주고,
그다음 실제로 index.html을 수정해줘.

이 과정을 통해 확인한 점은, Claude Code 활용의 핵심이 단발성 완성본 산출에 있기보다 계획 → 기준 설정 → 초안 생성 → 수정의 반복 가능한 흐름을 구축하는 데 있다는 것이었습니다.

이번 실험의 직접 산출물이 곧바로 이번 스터디 페이지가 된 것은 아니지만, 이 과정에서 점검한 작업 방식은 이후 스터디용 4주차 구성 앱을 만들고 1주차 페이지 안의 수강생 가이드 구성을 정리하는 과정에도 참고 기준으로 활용했습니다. 그 흐름을 확인할 수 있는 페이지는 아래와 같습니다.

  • 클로드코드 학습 가이드 앱 :

    이 점에서, 소규모 실험을 통해 정리한 흐름이 실제 스터디 운영 자료를 구성하는 데에도 충분히 활용 가능하다는 것을 확인할 수 있었습니다.

결과와 배운 점

이번 실험을 통해 Claude Code는 단순 코드 생성 도구라기보다, 작업 흐름을 설계하고 보조하는 도구에 가깝다는 점을 확인했습니다.

좋았던 점은 계획부터 시작할 수 있고, /init으로 기준을 남길 수 있으며, 초안 생성과 수정 반복이 자연스럽다는 점이었습니다. 특히 안내 자료나 실습 페이지처럼 범위가 비교적 작은 결과물에 효과적이었습니다.

반면 요청이 막연하면 결과도 막연해지고, 사용자가 방향을 계속 조정해야 하며, 한 번에 완성본을 기대하면 아쉬울 수 있다는 한계도 있었습니다. 결국 핵심은 무엇을 만들지보다 어떻게 요청할지에 더 가까웠습니다.

정리하면, Claude Code는 거대한 프로젝트보다 범위가 명확한 작은 과제부터 시작할 때 활용성이 더 잘 드러났습니다. 이 사례의 프롬프트 역시 완성본을 그대로 복제하기 위한 것이 아니라, 각자가 아이디어를 더해 자신만의 결과물로 발전시키는 출발점에 가깝습니다.

이 흐름은 이후 주차별 자료 정리, 강의용 실습 페이지 제작, 4주차 구성 앱 정리, 1주차 페이지 안의 수강생 가이드 구성까지 확장해 적용하고 있습니다.

도움 받은 글 (옵션)

Claude Code 관련 오픈소스와 운영 정리 노트

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

이은진 소피아(shopia) 프로필 이미지

역시흐름이중요.

도로시J 프로필 이미지
도로시J2026.05.20

플랜부터 초안완성까지, 흐름의 최고의 어시스턴트죠^^
오늘 잘 부탁드립니다

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기