채널톡 아이콘

클로드코드 하네스 실전 — AI가 잊지 않고, 규칙을 지키고, 스스로 검증하게 만드는 14단계

프롬프트를 더 길게 쓰는 대신, 규칙 파일, 기록, 권한, 훅, 검증 루틴을 실제 프로젝트에서 사고가 날 때마다 하나씩 만듭니다. 닷새 동안 실제로 만들고 서버에 올린 뉴스 알림 봇으로, 화면 캡처 211장과 지시 87개를 원문 그대로.

1명 이 수강하고 있어요.

난이도 중급이상

수강기한 무제한

실습 중심
실습 중심
AI 활용법
AI 활용법
AI 코딩
AI 코딩
처음하는배포
처음하는배포
백엔드이해하기
백엔드이해하기
실습 중심
실습 중심
AI 활용법
AI 활용법
AI 코딩
AI 코딩
처음하는배포
처음하는배포
백엔드이해하기
백엔드이해하기

수강 후 이런걸 얻을 수 있어요

  • 새 세션이 어제의 결정을 잊지 않게 하는 규칙 파일과 기록 구조 (CLAUDE.md, 사실 파일, 사고 기록)

  • 세션이 하지 말라는 것을 못 하게 막는 권한 파일과 훅 셋, 그리고 정말 막혔는지 확인하는 방법

  • 「됐다」를 믿지 않고 커밋, 서비스, 회차 로그로 확인하는 검증 루틴과 배포 스킬

  • 매시간 뉴스를 읽어 키워드 기사를 텔레그램으로 보내고 아침에 AI 요약을 보내는, 서버에서 실제로 도는 봇

텍스트 강의 — PDF 282쪽, 화면 캡처 211장, 지시 87개 원문, 실습 저장소 공개

프롬프트를 더 길게 쓰는 대신, 사고가 날 때마다 장치를 하나씩 만든다

클로드코드를 며칠 써 본 사람은 같은 세 가지에 부딪힙니다. 어제 정한 규칙을 오늘 새 세션이 모릅니다. 하지 말라고 한 것을 합니다. '완료했습니다' 라는데 열어 보면 안 돼 있습니다. 이 셋을 프롬프트를 더 길게 써서 고치려다 실패한 적이 있다면 이 강의가 맞습니다.

이 강의는 이론서가 아닙니다. 빈 폴더에서 시작해 실제로 도는 봇 하나를 만듭니다 — 언론사 RSS 20곳을 매시간 읽어 내 키워드에 걸린 기사만 텔레그램으로 보내고, 아침마다 AI 요약 리포트를 보내는 봇입니다. 코드는 전부 클로드코드가 씁니다. 저자가 한 일은 지시를 내리고, 사고가 날 때 그것을 규칙 한 줄로 바꾸는 것이었습니다. 그 지시 87개가 원문 그대로 실습 저장소에 있고, 화면 캡처 211장은 전부 실제 터미널 화면입니다.

장마다 사고가 하나씩 납니다. 새 세션이 어제의 결정을 뒤집을 뻔하고(1장), 화면용 숫자가 저장까지 정하고 있고(2장), 죽은 피드 하나가 전체를 멈추고(3장), 세션이 세지 않은 숫자를 사실처럼 적고(4장), 배포는 초록불인데 알림이 안 오고(5장), 남의 서버를 초당 18번 치고(6장), '막았다' 고 믿은 것이 새어 나가고(7장), 데이터베이스가 끊기자 조용히 죽고(8장), 규칙 파일이 503줄이 되고(9장), 9초 만에 만든 요약이 텔레그램 아홉 통이 되고(10장), 「올렸다」를 세 번 들었는데 서버는 옛 코드였고(11장), 하루 만에 기록 17문장이 낡습니다(12장). 계획했는데 안 난 사고도 그대로 적었습니다.

사고마다 하네스가 하나씩 생깁니다. 규칙 파일(CLAUDE.md), 사고 기록과 사실 파일, 데이터 결정 문서, 권한 파일, 훅 셋과 git 훅, 배포 스킬, 검증 루틴 셋, 요청과 비용의 원장, 기록 린트. 마지막 장에서 그것들을 일곱 요소로 정리하고, 처음부터 다시 만든다면 첫날에 둘 것과 사고가 나야 만들어지는 것을 가릅니다.

텍스트 강의입니다. 영상 없이 PDF 282쪽(S장과 0~13장, 부록 A~G)과 수업 노트로 읽습니다. 실습 저장소: https://github.com/JCLab-coder/news-radar (공개, 코드는 MIT, 장별 태그 ch00~ch12).

강의를 듣고 나면 이런 결과물을 만들 수 있어요

  • 실제로 도는 봇. 서버(Railway)에서 매시간 뉴스를 읽고, 내 키워드에 걸린 것만 텔레그램으로 보내고, 아침마다 AI 요약 리포트를 보냅니다. 키워드만 바꾸면 그대로 쓸 수 있습니다.

  • 하네스 한 벌. 규칙 파일 하나, 프로젝트 문서 23개, 권한 파일 하나, 스킬 하나, 클로드코드 훅 셋과 git 훅 하나, 스크립트 열 개. 파일 전문과 다른 프로젝트용 템플릿은 부록에 있습니다.

  • 습관 하나. 사고가 나면 그것을 규칙 한 줄로 바꾸는 습관. 봇은 언젠가 안 쓰게 되고 규칙 파일도 프로젝트마다 다시 쓰겠지만, 이 습관은 남습니다.

첫 텔레그램 알림 (1장)

키워드에 걸린 기사만 제목과 링크로. 4,096자 상한을 줄 단위로 나눠 보내는 것도 이때 배운다.

아침 리포트의 AI 요약 (10장)

87건을 9.2초에 요약했고, 그 다음 사고가 '텔레그램 아홉 통' 이었다.

'올렸다' 의 형식 (11장)

커밋, 서비스, 회차 로그 세 조각이 붙어야 「올렸다」다. 리포트 서비스는 다음 날 아침까지 「올리는 중」.

13장 시점의 저장소

docs/facts, docs/lessons, scripts/hooks, .claude/skills — 코드보다 이 장치들이 이 저장소의 본체다.

  • 새 세션이 어제의 결정을 잊지 않게 하는 규칙 파일과 기록 구조를 직접 세울 수 있습니다 — 규칙만 남기는 CLAUDE.md, 근거와 실측을 두는 사실 파일, 사고 기록, 데이터 결정 문서.

  • 세션이 하지 말라는 것을 못 하게 권한 파일과 훅으로 막고, 「막았다」를 믿지 않고 가짜 입력으로 정말 막히는지 확인할 수 있습니다.

  • 「됐다」에 커밋, 서비스, 회차 로그가 붙어 있어야 한다는 검증 루틴을 배포 스킬과 스크립트로 굳힐 수 있습니다.

  • 남의 서버와 유료 API 를 부를 때 상한과 원장을 먼저 두는 이유를, 초당 18번 친 사고와 텔레그램 아홉 통 사고로 압니다.

  • 기록이 하루 만에 낡는다는 것을 알고, 사실 문장마다 확인 명령을 붙여 린트로 다시 확인하는 구조를 만들 수 있습니다.

학습 내용

  • 14단계(0장~13장)와 준비 장 S장, 부록 7개. 장마다 사고 → 원인 → 규칙 → 확인의 순서로 진행됩니다. 기능을 하나씩 소개하는 책이 아니라 사고가 먼저 나고 장치가 뒤따르는 순서라, 순서대로 읽어야 합니다.

  • 모든 장에 세션 화면 캡처와 저자가 실제로 입력한 지시(P 번호)가 있고, 장 끝에 독자 체크리스트가 있습니다.

1장 — 첫 규칙 파일 CLAUDE.md 가 만들어진 자리

섹션 1. 준비와 1부 — 잊지 않게 만들기 (S장, 0~2장)

준비물은 이 프로젝트 때문에 새로 만드는 것만. 규칙 파일 없는 첫 세션에서 같은 지시가 매번 다르게 짜이는 것을 보고, 새 세션이 어제를 모르는 자리에서 첫 규칙 파일이, 화면용 숫자가 저장까지 정하던 자리에서 데이터 결정 문서가 생깁니다.

섹션 2. 2부 — 규칙을 지키게 만들기 (3~7장)

죽은 피드 하나가 전체를 멈추는 데서 첫 검증 루틴, 세지 않은 숫자를 적은 데서 사고 기록, 초록불인데 알림이 안 오는 배포에서 배포 스킬, 남의 서버를 초당 18번 친 데서 상한과 원장과 권한 파일, 「막았다」가 새어 나간 데서 훅 셋과 git 훅이 생깁니다.

7장 — 훅이 .env 접근을 막는 장

11장 — 매시간 서비스가 옛 코드로 돌고 있었다

섹션 3. 3부 — 스스로 검증하게 만들기 (8~11장)

데이터베이스가 끊기자 조용히 죽은 데서 실패 처리 뼈대와 회차 상한, 503줄이 된 규칙 파일에서 기록 네 곳 분리와 리포트 서비스, 텔레그램 아홉 통에서 비용 원장과 하루 상한, 「올렸다」 세 번에 서버는 옛 코드였던 데서 커밋을 🏁 줄에 찍는 세 번째 검증 루틴이 생깁니다.

섹션 4, 5. 운영과 회고, 부록 (12~13장, 부록 A~G)

하루 만에 낡은 기록 17문장에서 기록 린트가 생기고, 마지막 장에서 하네스 일곱 요소와 '처음부터 다시 만든다면 첫날에 둘 것' 을 정리합니다. 부록은 CLAUDE.md 전문, 템플릿 다섯, 훅과 스크립트 전문, 사고→규칙 표 20건, 체크리스트 52개, 참고 자료와 저작권, 키와 환경변수와 서버 설정 총정리입니다.

12장 — 낡은 기록 17문장을 린트가 잡는다

수강 전 참고 사항

  • 이 강의는 텍스트 강의입니다. 영상이 없고, 유닛마다 PDF 와 수업 노트가 있습니다. 마지막 수업에 전체 PDF 한 권(282쪽)이 있습니다.

  • 설치, 가입, 결제 절차는 다루지 않습니다. 클로드코드 설치와 요금제, 텔레그램과 Railway 와 OpenRouter 의 가입은 각 서비스의 안내를 따릅니다.

실습 환경

  • 운영 체제: 저자는 macOS 에서 진행했습니다. 터미널과 Node.js 가 도는 환경이면 됩니다.

  • 사용 도구: 클로드코드(이미 쓰고 있어야 합니다), Node.js 20.12 이상, 로컬 PostgreSQL, 텔레그램 계정(봇 하나), git.

  • 유료: 5장부터 서버 Railway(Hobby, 월 5달러 안 — 이 책의 실습은 이틀에 단 $0.03), 10장부터 OpenRouter API 키(이 책의 10장 실습 전체가 단 $0.1).

  • PC 사양: 특별한 요구 없음. GPU 불필요.

학습 자료

  • PDF 282쪽(전체본 한 권 + 유닛별 8개, 쪽번호는 전체 기준). 본문 약 165,000자, 화면 캡처 211장.

  • 실습 저장소(공개, MIT): https://github.com/JCLab-coder/news-radar. 장이 끝날 때마다 태그(ch00~ch12)가 있어 어느 시점으로든 돌아가 새 폴더에서 돌려 볼 수 있습니다. 저자가 세션에 입력한 지시 87개가 prompts/ 에 원문 그대로 있습니다.

  • 부록에 규칙 파일 전문, 템플릿 다섯, 훅과 스크립트 전문, 사고→규칙 표, 체크리스트 총합, 준비물 총정리.

선수 지식 및 유의사항

  • 선수 지식: 클로드코드를 며칠 이상 써 봤고, 자바스크립트를 읽을 수 있으면 됩니다. 쓸 줄 몰라도 됩니다.

  • 순서대로 읽어야 합니다. 훅이 7장에 나오는 이유는 6장에서 사고가 먼저 나기 때문입니다. 직접 만드는 쪽을 권하며, 저장소는 막혔을 때 대조하는 용도입니다. 클로드코드는 같은 지시에도 매번 조금씩 다르게 짭니다 — 내 코드가 책과 다르다고 틀린 것이 아닙니다.


  • 질문은 강의 질문 게시판으로 주시면 답변합니다. 클로드코드와 각 서비스의 화면은 바뀔 수 있으며, 바뀐 부분은 새소식으로 알립니다.

  • 저작권: 본문, 화면 캡처, PDF 는 구매자 본인의 학습 용도로만 쓸 수 있으며, 다른 사람에게 전달하거나 공개된 곳에 올리는 것은 허용되지 않습니다. 실습 저장소의 코드는 저장소의 라이선스(MIT)를 따릅니다 — 코드와 책은 다른 조건입니다.

이런 분들께
추천드려요

학습 대상은
누구일까요?

  • 클로드코드를 며칠 써 봤는데, 어제 정한 규칙을 오늘 새 세션이 모르는 사람

  • 「완료했습니다」를 듣고 열어 보니 안 돼 있던 경험이 있는 사람

  • 프롬프트를 더 길게 써서 그 문제를 고치려다 실패한 사람

선수 지식,
필요할까요?

  • 클로드코드를 이미 쓰고 있어야 합니다. 설치와 요금제, 가입 절차는 다루지 않습니다.

  • 자바스크립트를 읽을 수 있으면 됩니다. 쓸 줄 몰라도 됩니다. 5장부터 Railway(월 5달러 안), 10장에 OpenRouter API 키(전체 실습 0.1달러)가 필요합니다.

안녕하세요
JC랩입니다.

커리어인증

서비스를 만들고 운영하는 개발자입니다.

Claude Code를 실무에 쓰며 겪은 일과 그때 생긴 규칙을 나눕니다. 이론보다 실제 사고와 코드 원문으로 이야기합니다.

개발, 운영, 데이터, 자동화까지 필요한 건 직접 만들어 씁니다.

수강평

아직 충분한 평가를 받지 못한 강의입니다.
모두에게 도움이 되는 수강평의 주인공이 되어주세요!

비슷한 강의

같은 분야의 다른 강의를 만나보세요!

얼리버드 할인 중

₩58

24%

₩99,000

평생교육이용권 지원 강의