이 강의는 Claude Code의 기능을 공식문서처럼 나열하지 않습니다. 대신 Claude Code가 실제 프로젝트에서 안전하게 일할 수 있도록 Context, Permission, Verification, Tool, Subagent, Debugging Harness를 설계하는 관점으로 설명합니다. 그래서 빠르게 바뀌는 버전 정보에 덜 흔들리고, 실제 프로젝트에 적용 가능한 기준이 남습니다.
단순한 데모 앱 제작이 아니라, 큰 코드베이스에서 Claude가 길을 잃지 않게 만드는 방법, 세션 오염을 줄이는 방법, worktree와 병렬 세션을 안전하게 운영하는 방법, GitHub Issue → PR 흐름을 Claude와 연결하는 방법까지 다룹니다. 실무에서 실제로 막히는 지점부터 출발합니다.
강의에서 직접 만드는 하네스 설정을 완성된 파일 형태로 모두 제공합니다.
강의를 들은 뒤 처음부터 다시 작성할 필요 없이, 자신의 프로젝트에 복사해 바로 적용할 수 있습니다.
제공되는 설정은 다음과 같습니다.
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에게 검증을 요청하는 수준을 넘어, 검증 절차를 시스템이 강제로 실행하도록 만드는 방법을 배우게 됩니다.
같은 하네스를 사용하더라도 모델마다 잘 따르는 지시와 놓치기 쉬운 지시가 다릅니다.
이 강의에서는 모든 모델에 동일한 프롬프트를 사용하는 대신, 각 모델의 특성에 맞게 어떤 지시는 제거하고 어떤 지시는 추가해야 하는지 정리한 복사용 프롬프트 블록 5종을 제공합니다.
Opus 5
모델이 자체적으로 수행하는 검증 지시는 줄여 불필요한 중복 작업을 방지합니다.
Opus 4.8
필요한 도구를 정확한 시점에 사용하도록 도구 실행 조건을 더 명확하게 지정합니다.
Sonnet 5
수정해야 하는 파일과 적용 범위를 문자 그대로 구체적으로 작성하는 방법을 다룹니다.
Haiku 4.5
effort 옵션이 없는 모델에서도 안정적으로 작업할 수 있도록 실행 절차를 단계별로 펼쳐 작성합니다.
Fable 5
모델에 지나치게 많은 지시를 주지 않고, 필요한 처방만 남기는 방식을 참고용으로 제공합니다.
각 플레이북에는 다음 내용도 함께 포함됩니다.
요청 시 400 Error가 발생하는 파라미터 조합
모델별 기본 파라미터와 동작 차이
effort 값을 변경하며 결과를 비교하는 기록표
동일한 프롬프트를 여러 모델에 실행하고 결과를 비교하는 Lab 04 실습
단순히 “어떤 모델이 더 좋다”를 설명하는 것이 아니라, 같은 작업을 반복 실행하고 결과를 기록하면서 모델별 최적 설정을 직접 찾는 방법을 익히게 됩니다.
복잡한 작업을 한 번에 순서대로 처리하는 방식과, 여러 작업을 의존 관계에 따라 나누어 처리하는 Graph Engineering 방식을 직접 비교합니다.
별도의 설치나 서버 실행 없이 HTML 파일을 브라우저로 열어 사용할 수 있습니다.
같은 요청이 다음 두 방식에서 어떻게 다르게 처리되는지 단계별로 재생해볼 수 있습니다.
하나의 흐름을 반복하는 루프형 실행
작업을 여러 노드와 의존 관계로 나누는 그래프형 실행
각 단계를 선택하면 해당 동작을 만든 설정 파일도 함께 확인할 수 있어, 실행 결과와 설정의 관계를 바로 이해할 수 있습니다.
총 645줄 분량의 학습 가이드를 제공합니다.
처음부터 이론을 길게 설명하지 않고 다음 순서로 구성했습니다.
결론 확인 → 30분 실습 → 핵심 개념 → 심화 이론
비전공자를 위한 학습 경로와 개발 경험이 있는 수강생을 위한 학습 경로도 분리되어 있습니다.
바이브 코딩으로 Claude Code를 처음 사용하는 분도 실습부터 시작할 수 있고, 개발자는 내부 동작과 설계 원리까지 더 깊게 학습할 수 있습니다.
설정 파일만 읽고 끝나는 것이 아니라, 실제 프로젝트 폴더에서 claude를 실행하며 Hook이 작업을 차단하고 검증하는 과정을 직접 확인합니다.
각 프로젝트에는 다음 문제가 의도적으로 포함되어 있습니다.
타입 오류
테스트 실패
겉으로는 정상처럼 보이는 로직 버그
수강생은 다음 흐름을 직접 경험하게 됩니다.
문제 감지 → 작업 차단 → 코드 수정 → 테스트 실행 → 검증 통과
루프형 프로젝트와 그래프형 프로젝트는 동일한 코드를 사용하며, 하네스 설정만 다르게 구성되어 있습니다.
따라서 코드 차이 때문이 아니라 작업을 조직하는 방식의 차이로 결과가 어떻게 달라지는지 정확하게 비교할 수 있습니다.
강의를 수강한 뒤에도 프로젝트를 구성하거나 문제를 해결할 때 찾아볼 수 있도록 실무용 문서를 함께 제공합니다.
환경 설정 가이드
실행 환경 준비, Hook 등록 방법, 자주 발생하는 오류와 해결 방법을 정리합니다.
Skill / Hook / CLAUDE.md / Test 역할 구분
각 구성 요소가 무엇을 담당하며, 어떤 문제에 어떤 도구를 사용해야 하는지 설명합니다.
하네스 점검 체크리스트
프롬프트, 설계, 구현, 테스트, 완료 조건이 빠지지 않았는지 확인할 수 있습니다.
질문 카드와 테스트 카드
요구사항이 모호할 때 사용할 질문, 테스트 설계 기준, 검증표 템플릿을 제공합니다.
모델별 플레이북 문서
모델별 파라미터, 동작 특성, 프롬프트 작성 기준을 한곳에 정리합니다.
모델 평가 기록표
같은 작업을 여러 모델과 설정으로 실행한 뒤 결과를 비교하고 기록할 수 있습니다.
이 자료들은 단순한 강의 부록이 아니라, 실제 프로젝트에서 반복해서 사용할 수 있는 Claude Code 하네스 운영 매뉴얼로 구성되어 있습니다.
실리콘밸리 생존자 | 미국달팽이
Global Tech Scene의 최전선에서 쌓은 경험과 노하우를 바탕으로, 비전공자가 기술 장벽을 넘어 비즈니스의 주인이 되는 길을 제시합니다.
현) 실리콘밸리 AI 코딩 에이전트 스타트업 창업자
자체 개발 AI 도구 'Snailer CLI' 운영 (18K+ 다운로드)
Google for Startups Program 선정
전) 미국 빅테크 및 유망 스타트업 엔지니어 커리어
Amazon 최종 단계, 창업 위해 포기
실리콘밸리 AI 핀테크 스타트업 엔지니어
OpenAI / Meta / Apple / Adobe / Amazon 풀스택 펠로우십
국내 검색엔진 포털, 핀테크 개발
AI 스타트업 AR/B2B/SDK 개발
검증된 교육 역량
인서울 4년제 컴퓨터공학/경영학 복수 전공 및 다수의 창업 경험
누적 수강생 1900+배출, SNS 스레드 4.5K+ / Substack 팔로워 480+ 보유
스레드: https://www.threads.com/@rich_l_2024?igshid=NTc4MTIwNjQ2YQ==
Substack 서브스택: https://open.substack.com/pub/1234373801
