Claude Code가 멍청한 게 아니라,
너 멘탈 모델이 틀렸다.
Claude Code 본체가 직접 쓴 한국어 in-depth 실전 가이드.
멀티에이전트·KB·MCP·skill까지.
너만 그런 거 아니야
Claude Code를 처음 받아본 한국 개발자 대부분이 같은 길을 걷는다.
처음 며칠은 감탄한다. "리포 전체를 보고 답한다", "테스트를 직접 돌려본다", "커밋도 직접 한다." 그리고 일주일쯤 지나면 같은 말을 한다.
"생각보다 멍청하다."
이 표현이 나오는 순간, 이미 멘탈 모델이 한 번 틀어진 상태다.
진짜 문제 — "AI 에이전트"라는 단어가 만든 함정
업계는 Claude Code 같은 도구를 "AI 에이전트"라고 부른다. 이 단어가 한국어로 번역되면서 의미가 한 단계 더 부풀어 오른다.
"에이전트" = "스스로 알아서 해주는 것" = "내가 일을 시키면 결과만 받는 것"
이 등식이 머릿속에 박힌 채 도구를 켜면, 30분 뒤 50개 파일을 망친 diff를 보고 후회한다. 도구를 닫는다.
진짜 문제는 도구가 아니라 멘탈 모델이다.
Claude Code는 자율 에이전트가 아니다. 자율적 행동은 가능하지만 자율 운영에 최적화되지 않은 도구. 두 모드 사이를 빠르게 전환할 수 있다.
- 협업자(collaborator) 모드 — 의도를 한 단계씩 확인, 작은 변경을 함께
- 에이전트(agent) 모드 — 큰 목표를 던지고 알아서 진행
두 모드를 의도적으로 섞어 쓰는 법. 영어권에는 자료가 차고 넘친다. 한국어로는?
"설치법", "프롬프트 잘 쓰는 법" 정도가 끝이다.
목차 — 50~80p PDF + GitHub companion repo
- 1 Claude Code 멘탈 모델 협업자 vs 에이전트, 도구 호출 단위
- 2 CLAUDE.md 디자인 패턴 글로벌·프로젝트·페르소나 분리
- 3 Sub-Agent 오케스트레이션 페르소나 디자인, 멀티 워크스페이스
- 4 KB(Knowledge Base) 구축 auto-resume, 정본 분리
- 5 MCP 실전 Notion·Obsidian·Supabase 연동 + 직접 만들기
- 6 Skills TDD·code review skill 실전
- 7 Hook으로 자동화 session-start, pre/post-tool-use
- 8 한국 개발 컨텍스트 네이버·카카오·토스·국내 ERP
- 9 실전 워크플로우 1인 개발, 사이드, 멀티 레포
- 10 다음 단계 비대면·자동화 1인 비즈니스
왜 이걸 사야 하나
- 본체가 작성 — Claude Code(저자가 아니라 도구 본체)가 본문을 직접 쓰고 사람이 큐레이션한다.
- 한국어 in-depth — 번역이 아니라 한국 워크플로우 맥락(Notion·카카오·네이버·토스 API) 포함.
- 'Hello World' 수준 X — 실제 multi-agent + 자동화 패턴 위주.
- GitHub companion repo — 모든 예제 실행 가능. 템플릿 그대로 가져다 쓸 수 있음.
가격
| 시점 | 가격 |
|---|---|
| 사전예약 (오늘~D+9) | $14 |
| Publish 후 (D+10~) | $19 |
| 미래 챕터 추가 시 | $24 |
사전예약 시 publish 즉시 다운로드 링크 + companion repo 액세스. 7일 환불 보장.
사전예약 / 무료 waitlist
지금 메일 한 번 보내면 D+5 사전예약 페이지 오픈 시 가장 먼저 알림.
사전예약 알림 받기또는 직접 메일: h.company.sean@gmail.com · 제목 "일사령 사전예약 알림"
FAQ
- Gumroad 결제 한국에서 가능한가?
- 신용카드·체크카드·PayPal 다 됨. 한국 본인인증 불필요.
- 환불 정책?
- 7일 내 무조건 환불. 다운로드 후에도.
- Cursor·Codex 사용자도 도움 되나?
- 1·3·4·6장은 도구 무관(에이전트 멘탈 모델·KB·skill). 2·5·7장은 Claude Code 특화.
- 한국어로 정확히 무엇이 다른가?
- 영어 가이드 번역 아님. 한국 dev 컨텍스트(Notion·카카오·네이버·토스·국내 ERP) 케이스 스터디 포함.
- 업데이트는?
- Publish 후 분기 1회 무료 업데이트 (Claude Code v1.x 기준).