실전 클로드코드

💡 Claude Code를 처음 켰을 때의 질문은 “무엇을 시킬 수 있을까”입니다. 한 달쯤 지나면 질문이 조용히 바뀝니다 — “나는 왜 같은 말을 매번 다시 하고 있을까.” 이 책은 그 두 번째 질문에 도착한 사람을 위해 썼습니다.

이런 분을 위해 썼습니다

• 매일 쓰는 개인 개발자 — 이번 주에 세 번 이상 친 프롬프트가 있다면 이미 대상 독자입니다. 2장 하나만 따라 해도 그 문장은 다시 칠 일이 없어집니다.

• 팀의 규칙을 세우는 사람 — 리뷰 관점과 릴리스 절차가 사람의 기억에만 남아 있는 팀이라면, 그 합의를 문서가 아니라 실행되는 파일로 옮기는 방법을 3장과 5장에서 다룹니다.

• 자동화를 설계하는 사람 — 사람이 지켜보지 않아도 도는 흐름을 만들려면 권한과 컨텍스트를 먼저 갈라야 합니다. 5장의 권한 사다리와 6장의 분업 경계가 그 출발점입니다.

이런 분께는 권하지 않습니다

• Claude Code를 아직 설치해 보지 않으신 분 — 며칠 써 보면서 “무엇이 반복되는지”를 먼저 발견하시는 편이 낫습니다.

• 프롬프트 잘 쓰는 요령을 찾는 분 — 이 책은 잘 쓴 프롬프트를 어디에 보관하고 언제 자동으로 꺼내 쓸 것인가를 다룹니다.

목차

Part I — 구조를 이해합니다

• 1·1 반복과 대기, 두 가지 낭비 p.2

• 1·2 스킬 — 이름을 붙여 부르는 절차 p.3

• 1·3 커스텀 서브에이전트 — 컨텍스트를 갈라 쓰는 분신 p.4

• 1·4 CLAUDE.md와는 무엇이 다른가 p.6

• 1·5 어디에 둘 것인가 — 개인용과 팀 공유용 p.7

Part II — 스킬을 만듭니다

• 2·1 긴 프롬프트를 SKILL.md로 옮깁니다 p.10

• 2·2 절차와 규칙으로 결과를 고정합니다 p.12

• 2·3 헤더 레퍼런스 p.14

• 2·4 서포트 파일과 인수 p.15

• 2·5 등록 상태와 비용을 확인합니다 p.18

• 3·1 릴리스 준비 — 조건을 만족하지 못하면 멈춥니다 p.21

• 3·2 코드 점검 — 일부러 고치지 못하게 만듭니다 p.23

• 3·3 문서 갱신 — 남의 문장을 덮어쓰지 않게 만듭니다 p.25

• 3·4 온보딩 브리핑 — 사람을 위한 산출물 p.27

• 4·1 원칙 1~5 p.31

• 4·2 자주 보이는 실패 다섯 가지 p.32

• 4·3 스킬을 별도 세션에서 — context: fork p.33

Part III — 병렬로 일합니다

• 5·1 서브에이전트란 무엇인가 p.36

• 5·2 이미 쓰고 있던 내장 서브에이전트 p.37

• 5·3 권한을 설계합니다 — 3단계 사다리 p.38

• 5·4 code-reviewer를 만들고 실행합니다 p.39

• 5·5 포그라운드와 백그라운드 p.44

• 5·6 제약과 활용처 p.45

• 6·1 팀 리더와 공유 태스크 리스트 p.48

• 6·2 활성화와 실행 p.49

• 6·3 파일 소유권으로 경계를 나눕니다 p.51

Part IV — 정리합니다

• 7·1 선택 기준과 요약 p.55

• 7·2 부록 — 치트시트 · 도입 체크리스트 p.56

이 책이 반복해서 말하는 것

⚠️ 스킬의 규칙은 부탁이고, 서브에이전트의 권한은 보증입니다.

수록 레시피

읽는 법

• 처음 읽는다면 — 1장 → 2장 → 4장. 스킬 하나만 만들어도 들인 시간은 회수됩니다.

• 이미 쓰고 있다면 — 3장의 레시피, 5장의 권한 설계, 7장의 치트시트만 골라 읽어도 됩니다.

시리즈 안내

• Practical AI Engineering Series — Vol.01 LangChain 실무 마스터 · Vol.02 RAG 시스템 설계와 평가(준비중) · Vol.03 벡터 검색 엔진의 원리와 구현(준비중) · Vol.04 LLM 서빙(준비중)

• Vibe Coding Series — Vol.01 실전 클로드 코드

📌 본문의 화면 출력·파일 경로·기능 플래그는 집필 시점(2026년) 기준입니다.