AI와 함께 나를 소개하는 페이지를 만들기
2026.05.23

소개 시도 개요
- Claude Code와 VS Code를 활용해 나를 소개하는 미니 링크트리 페이지를 제작
- 코딩을 잘 몰라도 AI와 대화하면서 index.html 페이지를 만들 수 있는 실습을 진행
- 단순히 웹페이지를 만드는 것보다, AI에게 나를 설명하고 원하는 결과물을 요청하는 과정을 경험하는 것이 목표
- 최종적으로 이름, 한 줄 소개, 링크 버튼이 들어간 자기소개 페이지를 완성시키기
진행 방법과 활용 도구
활용 도구
- VS Code: 작업 폴더를 열고 파일을 확인하는 데 사용
- Claude Code: 자기소개 페이지 제작, 코드 생성, 수정 요청, 스킬 저장에 활용함
- CLAUDE.md: AI가 어떤 방식으로 도와주면 좋을지 정리한 학습 가이드로 사용
진행 세부 내용
CLAUDE.md파일을 생성
- 먼저 AI가 이 폴더에서 어떤 방식으로 작업하면 좋을지 정리한CLAUDE.md파일을 만들기
- AI가 강사처럼 일방적으로 알려주는 것이 아니라, 함께 만드는 학습 메이트처럼 행동하도록 설정
- 작업 방식은 Plan → Do → Check → Act 흐름으로 진행하도록 요청함.
→CLAUDE.md
사용한 프롬프트
text
이 폴더에 CLAUDE.md 파일을 만들어줘.
AI가 앞으로 이 폴더에서 작업할 때 어떻게 행동할지 정해두는 학습 가이드야.
AI는 가르치는 강사가 아니라 함께 만드는 학습 메이트처럼 행동해줘.
작업은 Plan, Do, Check, Act 방식으로 진행해줘.
자기소개 페이지 제작을 요청
- Claude Code에게index.html한 개 파일로 미니 링크트리 페이지를 만들어달라고 요청함.
- 바로 코드를 만들지 말고, 먼저 자기소개 인터뷰와 디자인 인터뷰를 해달라고 요청함.
- 이름, 한 줄 소개, 링크, 원하는 분위기 등을 답하면서 페이지 구성을 정함.
사용한 프롬프트 요약
text
미니 링크트리 자기소개 페이지를 index.html 한 개 파일로 만들고 싶어.
모바일 비율, 최대 너비 420px로 만들어줘.
원형 아바타, 이름, 한 줄 소개, 링크 버튼을 세로로 배치해줘.
바로 코드 짜지 말고 자기소개 인터뷰와 디자인 인터뷰부터 해줘.
결과물을 확인하고 수정
- Claude Code가 만든index.html파일을 브라우저에서 열어 확인
- 처음 결과물이 완전히 마음에 들지는 않아서 색감, 버튼 간격, 전체 분위기를 수정
- 마음에 안 드는 부분은 캡처해서 구체적으로 설명하며 다시 요청
→index.html
수정 요청 예시
text
카드 테두리 → 파스텔 무지개 색상으로 통일
전체 그라디언트 방향 대각 → 위-아래 방향으로 변경
아바타 원 내부, 버튼 내부 그라디언트 제거 및 단색으로 변경
배경 → 더 연한 파스텔 하늘-파랑으로 변경
아바타 이미지 넣기작업 흐름을 스킬로 저장
- 이번에 진행한 자기소개 인터뷰 → 디자인 인터뷰 → 페이지 생성 흐름을 스킬로 저장
- 다음에는/intro-page를 호출하면 같은 흐름으로 다시 자기소개 페이지를 제작하도록 설정
→index.html을 나중에 사용할 수 있도록 스킬로 저장
사용한 프롬프트 요약
text
방금 진행한 자기소개 인터뷰 → 디자인 인터뷰 → index.html 생성 흐름을
Claude Code 스킬로 저장해줘.
스킬 이름은 intro-page로 해줘.
다음에 /intro-page라고 입력하면 같은 흐름을 다시 시작하게 해줘.
결과
- 이름, 한 줄 소개, 링크 버튼이 들어간 미니 자기소개 페이지를 완성
- 디자인이 완벽하진 않았지만, AI와 함께 직접 만든 첫 페이지라는 점에서 의미가 있음
- 작업 흐름을 스킬로 저장해 다음에도 재사용 가능
시행착오
- 처음에는 원하는 디자인을 말로 설명하는 것이 어려움이 있었음
- 수정 요청을 할 때 원하지 않는 부분까지 변경되는 경우 발생
- 그래서 점점 더 구체적으로 요청하는 방식으로 바꾸어 진행
배운 점
- AI를 잘 쓰려면 내가 먼저 원하는 것을 정확하게 말해야 한다는 점을 배움
- CLAUDE.md를 활용하면 AI에게 작업 방식과 태도를 미리 알려줄 수 있다는 점이 인상적
- 처음부터 완벽하게 만들려고 하기보다, 초안을 만들고 계속 수정하며, 사용하는 방식을 익히고 원하는 결과값게 도달하는게 좋았음
- 한 번 잘 만든 작업 흐름은 스킬로 저장해두면 다음에 더 빠르게 활용 가능
앞으로의 계획
- 강의가 다 끝나는 한 달 뒤쯤 더 완성도 높은 자기소개 페이지를 다시 만들어보고 싶어요.
- claude.md 파일을 다듬어서 내가 원하는 AI 자동화를 구축하고 싶어요.


정말 고생 많으셨습니다 😊
늦은 시간까지 함께해 주시고 적극적으로 참여해 주셔서 감사해요!
앞으로도 다양한 사례글과 경험 많이 나눠주시면서 함께 성장해가면 좋겠습니다 🙌
우리 같이 더 멋진 결과 만들어봐요!
스터디장(아루나)님 화이팅!!!
22기 AI온보딩 화이팅!!!