
【Claude Code】초보자에게 '답을 통째로 받지 않고' 한 단계씩 가르쳐주는 설정 템플릿 제작
요약
이 글은 Claude Code를 활용하여 프로그래밍을 학습하는 초보자들을 위한 '교사(멘토)' 역할 설정 템플릿 제작 방법을 공유합니다. 완성된 코드를 한 번에 받기보다, 단계별로 코드의 의미와 작성 위치를 명시하며 스스로 코딩하도록 유도하는 것이 핵심입니다.
핵심 포인트
- 완성 코드 대신 단계별 학습을 목표로 합니다.
- 코드 설명 시 '줄 | 의미 대응표' 방식으로 구체화합니다.
- TEACHING.md, CLAUDE.md, PROGRESS.md 3개 파일 분리가 중요합니다.
프로그래밍을 Claude Code와 함께 진행할 때
완성된 코드를 전부 돌려받아도 공부가 안 됩니다.
- 사람이 알고 있다는 전제하에 이야기를 진행합니다.
등의 경험 없으신가요?
저는 정말 많이 겪었습니다.
그래서 Claude에게 '교사(멘토)' 역할을 맡기는 설정 파일을 만들었으니 공유합니다.
참고로, 이미 스스로 빠르게 코딩할 수 있거나 코드의 의미를 몰라도 대충 진행하는 분께는 추천하지 않습니다. 왜냐하면? 왜??가 많이 나오는 타입의 분에게 추천합니다.
이런 세밀한 단계로, 한 단계씩 나아갑니다.
리포지토리
template/
폴더를 그대로 복사해서 사용해 주세요. 수정 및 재배포는 가능합니다.
-
완성 코드를 한 번에 주지 않습니다. '이번 한 단계'만 보여줍니다.
직접 치게 합니다 - 여러 줄의 코드는 반드시
줄 | 의미 대응표로 설명합니다. - '어떤 파일의 몇 번째 줄에 쓸 것인지'를 매번 명시합니다 (초보자가 길을 잃지 않도록). -
작성한 후에는
구문 체크로 확인→ OK면 다음 단계로 넘어갑니다. - 본인이 자주 하는 실수를 기록하여,
미리 방지합니다 -
템플릿의 3개 파일을 학습 프로젝트의 루트에 배치합니다.
-
Claude에게
CLAUDE.md를 자신의 프로젝트 정보로 대체하게 합니다. - Claude에게 '계속 진행해 줘'라고 말만 하면 됩니다.
Claude Code는 리포지토리 루트의 CLAUDE.md를 자동으로 읽어들이고,
거기서 TEACHING.md / PROGRESS.md를 참조하므로, 3가지를 배치하면 효과가 있습니다.
| 파일 | 역할 |
|---|---|
TEACHING.md | 가르치는 방법・어조・진행 방식의 틀 (본체) |
CLAUDE.md | 무엇을・어떤 구성으로 만들고 있는지 |
PROGRESS.md | 로드맵과 현재 위치 (매번 업데이트) |
역할을 3가지로 나눈 것이 핵심입니다. 하나의 파일에 전부 쓰면
'가르치는 방법'과 '진행 상황'이 섞여 모순되기 쉽기 때문에 분리했습니다.
'AI에게 답을 받게 하는 것'이 아니라 'AI에게 배우고 스스로 작성하게 하는'ための 설정입니다.
신입 교육으로 고민하는 분이나 똑같이 초보자를 함께 진행하고 싶은 분들에게 도움이 되면 좋겠습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기