Claude Code Harness & Graph Engineering 클로드코드 심화 CLI 하네스 엔지니어링 실무

GUI에서 Claude Code는 재밌을 수 있습니다.

그러나,CLI 의 하네스 설계에서 Claude Code는 돈이 됩니다.

이 강의는 Claude Code CLI를 단순한 AI 코딩 도구로 소개하지 않습니다. 대신 Context, Permission, Verification, Tool, Subagent, Debugging Harness라는 관점으로 Claude Code를 실제 백엔드·DevOps 워크플로우 안에 정착시키는 방법을 다룹니다. 로그 분석, 버그 수정, 테스트 복구, CLAUDE.md 설계, 세션 관리, worktree 병렬 운영까지 연결하면서, Claude가 실제 프로젝트에서 안전하게 일할 수 있는 작업 시스템을 설계하는 법을 배우게 됩니다.

이런 분들께 추천해요

수강 후에는

이 강의를 듣고 나면 Claude Code를 단순히 “프롬프트를 잘 넣는 도구”로 보지 않게 됩니다. 대신 Claude가 무엇을 봐야 하는지, 어디까지 행동할 수 있는지, 어떤 결과를 어떻게 검증해야 하는지, 세션이 오염되면 언제 clear/compact/restart 해야 하는지, worktree와 병렬 세션을 어떻게 운영해야 하는지까지 판단할 수 있게 됩니다.

구체적으로는 CLAUDE.md에 프로젝트 규칙과 금지사항을 구조적으로 고정할 수 있고, 로그·환경변수·설정 스코프 문제를 Claude가 풀 수 있는 형태로 정리할 수 있으며, Claude가 제안한 수정안을 테스트·diff·반례 검증 루프로 검토할 수 있게 됩니다. 즉, Claude Code를 GUI형 보조도구가 아니라 실제 백엔드·DevOps 작업 흐름 안에 붙일 수 있는 수준까지 끌어올리게 됩니다.

이 강의의 특징

1. 기능 설명이 아니라 논문을 기반으로 한 “하네스 엔지니어링” 관점으로 가르칩니다

이 강의는 Claude Code의 기능을 공식문서처럼 나열하지 않습니다. 대신 Claude Code가 실제 프로젝트에서 안전하게 일할 수 있도록 Context, Permission, Verification, Tool, Subagent, Debugging Harness를 설계하는 관점으로 설명합니다. 그래서 빠르게 바뀌는 버전 정보에 덜 흔들리고, 실제 프로젝트에 적용 가능한 기준이 남습니다.

2. 큰 코드베이스와 실제 실무 문제를 기준으로 다룹니다

단순한 데모 앱 제작이 아니라, 큰 코드베이스에서 Claude가 길을 잃지 않게 만드는 방법, 세션 오염을 줄이는 방법, worktree와 병렬 세션을 안전하게 운영하는 방법, GitHub Issue → PR 흐름을 Claude와 연결하는 방법까지 다룹니다. 실무에서 실제로 막히는 지점부터 출발합니다.

이런 내용을 배워요

Claude Code CLI 실무 시작하기 / 

Architecture / Memory / CLAUDE.md / Plan Mode / Skills

첫 번째 섹션에서는 GUI형 Claude와 CLI의 차이부터 분명하게 정리합니다. 단순히 인터페이스 차이를 비교하는 것이 아니라, 왜 GUI에서는 “물어보고 답을 받는 것”에 머무르기 쉽고, CLI에서는 실제 로그,테스트,Git, 배포 준비까지 연결할 수 있는지 설명합니다. 이후 Claude Code architecture를 통해 모델보다 하네스가 중요한 이유를 이해하고, 세션 간 memory와 CLAUDE.md의 역할, Plan/Thinking Mode와 Subagents, Skills와 Tool use의 차이까지 살펴봅니다.

복사해서 바로 사용하는 하네스 설정 파일

강의에서 직접 만드는 하네스 설정을 완성된 파일 형태로 모두 제공합니다.
강의를 들은 뒤 처음부터 다시 작성할 필요 없이, 자신의 프로젝트에 복사해 바로 적용할 수 있습니다.

제공되는 설정은 다음과 같습니다.

• 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 하네스 운영 매뉴얼로 구성되어 있습니다.

이 강의를 만든 사람

• 실리콘밸리 생존자 | 미국달팽이 

  Global Tech Scene의 최전선에서 쌓은 경험과 노하우를 바탕으로, 비전공자가 기술 장벽을 넘어 비즈니스의 주인이 되는 길을 제시합니다.

  • 현) 실리콘밸리 AI 코딩 에이전트 스타트업 창업자

    • 자체 개발 AI 도구 'Snailer CLI' 운영 (18K+ 다운로드)

    • Google for Startups Program 선정

  • 전) 미국 빅테크 및 유망 스타트업 엔지니어 커리어

    • Amazon 최종 단계, 창업 위해 포기

    • 실리콘밸리 AI 핀테크 스타트업 엔지니어

    • OpenAI / Meta / Apple / Adobe / Amazon 풀스택 펠로우십

    • 국내 검색엔진 포털, 핀테크 개발

    • AI 스타트업 AR/B2B/SDK 개발

  • 검증된 교육 역량

    • 인서울 4년제 컴퓨터공학/경영학 복수 전공 및 다수의 창업 경험

    • 누적 수강생 1700+배출, SNS 스레드 4.5K+ / Substack 팔로워 470+ 보유

    • 스레드: https://www.threads.com/@rich_l_2024?igshid=NTc4MTIwNjQ2YQ==

    • Substack 서브스택: https://open.substack.com/pub/1234373801

궁금한 점이 있나요?

수강 전 참고 사항