Claude 논문 필수 내용 재구성 학습 자료는 지금까지 수강생분들의 공개 요청을 검토하여
필수적인 내용들만 재구성하여 학습 및 결정 근거로 사용하실 수 있도록
섹션 8 CodeCraft 실습 섹션에서 다운로드 받으실 수 있습니다.
또한, 모델별 강의 Opus 4.8/Fable5/Opus5 강의
그리고, Graph Engineering 그래프 엔지니어링 강의가 추가 되었습니다.
<CodeCraft 실습 자료 업데이트 공지>
Graph Engineering & CodeCraft 실습 및 학습 자료에 대한 프라이빗 Github 깃헙 레포지토리 입니다.
OpenAI 고졸 연구원으로 화제가 된 인물은 스웨덴 출신의 가브리엘 피터슨입니다. 그는 고등학교를 중퇴하고 챗GPT를 활용한 자기주도적 학습과 실전 프로젝트를 통해 박사급 연구원들이 모인 OpenAI 소라팀에 합류했습니다.
가브리엘 피터슨이 이야기한 top-down 학습법 요소들을 사용해서 학습 자료를 제작했습니다.
github CodeCraft 깃헙 코드크래프트 실습 (모델별 프롬프트 가이드 포함) 자료 제공
강의 특성상 수강생분들에게만 제공하기 위해 Private 레포지토리로 실습 자료를 사용하실 수 있도록 합니다.
양해의 말씀드리며, google form 을 통해 인프런 수강 닉네임과 github
username, full name, or email 3가지중 하나를 작성하여 제출해주시면
Collaborator 로 추가해드릴 예정입니다.
https://forms.gle/xNjsfF98hnM963HE9
<CodeCraft 실습 자료 일부 안내, 자세한 사항은 Readme 를 통해 보실 수 있습니다.>
복사해서 바로 사용하는 하네스 설정 파일
강의에서 직접 만드는 하네스 설정을 완성된 파일 형태로 모두 제공합니다.
강의를 들은 뒤 처음부터 다시 작성할 필요 없이, 자신의 프로젝트에 복사해 바로 적용할 수 있습니다.
제공되는 설정은 다음과 같습니다.
CLAUDE.md
Claude가 프로젝트에서 따라야 할 작업 규칙을 정의합니다.codecraft-harness/SKILL.md
짧고 모호한 한 문장짜리 요청을 구체적인 설계와 구현 계획으로 변환합니다.solid-review/SKILL.md
구현을 시작하기 전에 책임 분리가 적절한지, 불필요하게 복잡한 설계는 아닌지 점검합니다.block-sensitive-paths.sh
.env, SSH Key, 프로젝트 상위 폴더처럼 민감한 파일과 경로에 접근하지 못하도록 차단합니다.run-tests-after-edit.sh
Claude가 파일을 수정할 때마다 관련 테스트를 자동으로 실행합니다.block-stop-without-tests.sh
테스트를 실행하지 않았거나 테스트가 실패한 상태에서는 작업을 완료했다고 보고하지 못하게 합니다.guard.sh
허용되지 않은 외부 네트워크 요청까지 차단해 안전한 실행 환경을 구성합니다.
강의에 포함된 Hook은 단순한 예제 코드가 아닙니다.
모두 실제 환경에서 실행하고 동작을 확인했습니다.
설정 파일을 등록하면 Claude가 코드를 수정할 때마다 자동으로 테스트가 실행되고, 테스트가 실패한 상태에서는 임의로 “작업을 완료했습니다”라고 종료할 수 없습니다.
즉, 프롬프트로 Claude에게 검증을 요청하는 수준을 넘어, 검증 절차를 시스템이 강제로 실행하도록 만드는 방법을 배우게 됩니다.
3. 모델별 프롬프트 플레이북
같은 하네스를 사용하더라도 모델마다 잘 따르는 지시와 놓치기 쉬운 지시가 다릅니다.
이 강의에서는 모든 모델에 동일한 프롬프트를 사용하는 대신, 각 모델의 특성에 맞게 어떤 지시는 제거하고 어떤 지시는 추가해야 하는지 정리한 복사용 프롬프트 블록 5종을 제공합니다.
Opus 5
모델이 자체적으로 수행하는 검증 지시는 줄여 불필요한 중복 작업을 방지합니다.Opus 4.8
필요한 도구를 정확한 시점에 사용하도록 도구 실행 조건을 더 명확하게 지정합니다.Sonnet 5
수정해야 하는 파일과 적용 범위를 문자 그대로 구체적으로 작성하는 방법을 다룹니다.Haiku 4.5
effort 옵션이 없는 모델에서도 안정적으로 작업할 수 있도록 실행 절차를 단계별로 펼쳐 작성합니다.Fable 5
모델에 지나치게 많은 지시를 주지 않고, 필요한 처방만 남기는 방식을 참고용으로 제공합니다.
각 플레이북에는 다음 내용도 함께 포함됩니다.
요청 시
400 Error가 발생하는 파라미터 조합모델별 기본 파라미터와 동작 차이
effort 값을 변경하며 결과를 비교하는 기록표
동일한 프롬프트를 여러 모델에 실행하고 결과를 비교하는 Lab 04 실습
단순히 “어떤 모델이 더 좋다”를 설명하는 것이 아니라, 같은 작업을 반복 실행하고 결과를 기록하면서 모델별 최적 설정을 직접 찾는 방법을 익히게 됩니다.
Graph Engineering 실습 자료 — Lab 05
복잡한 작업을 한 번에 순서대로 처리하는 방식과, 여러 작업을 의존 관계에 따라 나누어 처리하는 Graph Engineering 방식을 직접 비교합니다.
인터랙티브 학습 시트
별도의 설치나 서버 실행 없이 HTML 파일을 브라우저로 열어 사용할 수 있습니다.
같은 요청이 다음 두 방식에서 어떻게 다르게 처리되는지 단계별로 재생해볼 수 있습니다.
하나의 흐름을 반복하는 루프형 실행
작업을 여러 노드와 의존 관계로 나누는 그래프형 실행
각 단계를 선택하면 해당 동작을 만든 설정 파일도 함께 확인할 수 있어, 실행 결과와 설정의 관계를 바로 이해할 수 있습니다.
단계별 학습 가이드
총 645줄 분량의 학습 가이드를 제공합니다.
처음부터 이론을 길게 설명하지 않고 다음 순서로 구성했습니다.
결론 확인 → 30분 실습 → 핵심 개념 → 심화 이론
비전공자를 위한 학습 경로와 개발 경험이 있는 수강생을 위한 학습 경로도 분리되어 있습니다.
바이브 코딩으로 Claude Code를 처음 사용하는 분도 실습부터 시작할 수 있고, 개발자는 내부 동작과 설계 원리까지 더 깊게 학습할 수 있습니다.
직접 실행할 수 있는 데모 프로젝트 3종
설정 파일만 읽고 끝나는 것이 아니라, 실제 프로젝트 폴더에서 claude를 실행하며 Hook이 작업을 차단하고 검증하는 과정을 직접 확인합니다.
각 프로젝트에는 다음 문제가 의도적으로 포함되어 있습니다.
타입 오류
테스트 실패
겉으로는 정상처럼 보이는 로직 버그
수강생은 다음 흐름을 직접 경험하게 됩니다.
문제 감지 → 작업 차단 → 코드 수정 → 테스트 실행 → 검증 통과
루프형 프로젝트와 그래프형 프로젝트는 동일한 코드를 사용하며, 하네스 설정만 다르게 구성되어 있습니다.
따라서 코드 차이 때문이 아니라 작업을 조직하는 방식의 차이로 결과가 어떻게 달라지는지 정확하게 비교할 수 있습니다.
참고 문서
강의를 수강한 뒤에도 프로젝트를 구성하거나 문제를 해결할 때 찾아볼 수 있도록 실무용 문서를 함께 제공합니다.
환경 설정 가이드
실행 환경 준비, Hook 등록 방법, 자주 발생하는 오류와 해결 방법을 정리합니다.Skill / Hook / CLAUDE.md / Test 역할 구분
각 구성 요소가 무엇을 담당하며, 어떤 문제에 어떤 도구를 사용해야 하는지 설명합니다.하네스 점검 체크리스트
프롬프트, 설계, 구현, 테스트, 완료 조건이 빠지지 않았는지 확인할 수 있습니다.질문 카드와 테스트 카드
요구사항이 모호할 때 사용할 질문, 테스트 설계 기준, 검증표 템플릿을 제공합니다.모델별 플레이북 문서
모델별 파라미터, 동작 특성, 프롬프트 작성 기준을 한곳에 정리합니다.모델 평가 기록표
같은 작업을 여러 모델과 설정으로 실행한 뒤 결과를 비교하고 기록할 수 있습니다.
이 자료들은 단순한 강의 부록이 아니라, 실제 프로젝트에서 반복해서 사용할 수 있는 Claude Code 하네스 운영 매뉴얼로 구성되어 있습니다.
<중요>
추가로 github 에 접근하게 되면
CodeCraft
/labs
/05-graph-engineering
/graph-engineering-study.html 경로로 그래프 엔지니어링과 루프의 차이 데모를 직접 눈으로 보셔서
학습하실수 있도록 했습니다.
여기서 오른쪽 버튼중에 Raw 버튼 기준 오른쪽으로 두번째 내려받기 버튼으로 html 파일을 다운로드 하신후 더블클릭으로 브라우저에서 열리게 되면 바로 확인하실 수 있습니다.