직접 코딩 0% — CLAUDE CODE로 진짜 서비스 만들고 배포·운영까지
0장. 이 책의 사용 설명서
코딩을 배우지 않고, AI를 지휘해 서비스를 만드는 여정의 출발점
당신은 코딩을 모릅니다.
이 책을 다 읽어도 코딩 문법을 외우지 않습니다.
그런데 당신이 만든 서비스에
친구가 접속합니다.
0장의 흐름
오늘 다룰 여섯 가지
0.1 이 책에서 코딩을 다루지 않는 이유
0.2 AI가 코드를 작성하고, 사람이 통제한다
0.3 학습을 마쳤을 때 손에 쥐게 되는 것
0.4 학습 구조 — 말하기 · 확인하기 · 통제하기 3단계
0.5 학습 난이도 — 산을 오르듯 배포·운영에 도달하기
0.6 준비물과 비용 — 배낭을 미리 꾸립니다
0장 학습목표
오늘의 학습목표
수업을 마치면 할 수 있는 것
① 의미 설명
‘직접 코딩 0%’가 의미하는 것과 의미하지 않는 것을 구분한다.
② 역할 구분
AI의 작성과 사람의 목표·검증·승인 책임을 구분한다.
③ 절차 적용
말하기 → 확인하기 → 통제하기를 사례에 적용한다.
④ 경로 선택
목표에 맞는 도달 지점과 필요한 계정·비용을 설명한다.
평가 초점: 코드 암기가 아니라 지시·검증·통제의 과정
0.1 코딩을 다루지 않는 이유
비전공자가 흔히 만나는 첫 번째 장벽
첫 100쪽
변수, 함수, 반복문… for 문, if-else, 클래스가 쏟아진다
50쪽쯤에서
책을 덮는다. “역시 나는 안 되나 봐.”
이 책은 그 100쪽을 통째로 건너뜁니다.
0.1 코딩을 다루지 않는 이유
건너뛸 수 있는 이유
생성형 AI 시대 — 코딩은 더 이상 사람만 하는 일이 아닙니다.
“모임 정산 앱 만들어줘”라는 한 문장으로 AI가 첫 초안을 만들고, 사람이 보완·검증합니다.
목표: 독자가 직접 코딩하는 비율 0%
0.1 코딩을 다루지 않는 이유
배우지 않는 것 vs 배우는 것
Python·JavaScript 문법 암기→자연어로 요구사항 전달
코드 직접 작성·수정→결과를 실행하고 수정 지시
알고리즘·자료구조 이론→규칙·경계·검증 기준 설계
HTML·CSS 문법 학습→완성 서비스를 공개·운영
코드 문법 암기보다 기능·정확성·증거·안전장치를 확인합니다. 평가의 중심은 지시·검증·통제 과정입니다.
0.2 AI가 작성하고, 사람이 통제한다
택시를 탄다고 생각해 봅시다
AI는 면허를 가진 전문 기사가 아닙니다. 도착했다고 말해도 사람이 결과와 경로를 확인합니다.
0.2 AI가 작성하고, 사람이 통제한다
이 책에서 익히는 다섯 가지 능력
02＋도구 연결
AI의 작업 범위를
필요한 만큼 확장
목적지 설명 → 도구 요청 → 경로 지정 → 안전 기준 → 다른 사람에게 공개
많은 학습자가 1번부터 시작합니다. 이 책은 1번을 다듬고 1~5번 전부를 다룹니다.
0.2 AI가 작성하고, 사람이 통제한다
미리 만나는 열쇳말 — 하네스 엔지니어링
하네스(Harness) = 말에게 씌우는 마구·고삐
코드가 아니라 규칙과 구조로 AI를 통제하는 방법. 규칙 · 울타리 · 검증 · 안전벨트 · 모니터링 — 다섯 장치로 불확실한 AI에 고삐를 채웁니다.
프롬프트 엔지니어링
원하는 작업을 명확히 전달하는 법
하네스 엔지니어링
규칙·범위·검증·복구 구조를 설계하는 법
0.3 손에 쥐게 되는 것
Part마다 실제 결과물이 남습니다
PART 1 · 시작하기AI 명함 생성기 · 오늘의 한 줄 영감 카드 — 카톡 링크로 친구에게 전송
PART 2 · 일 맡기기모임 정산 앱 · 한글 문서 100개 자동 생성 · 엑셀 일괄 처리 · 감정 일기장 · 사내 문서 Q&A
PART 3 · 통제하기익명 Q&A 게시판 · 맛집 추천 챗봇 — 욕설·도배·오답·서버다운을 고삐로 해결
PART 4 · 배포하기내 컴퓨터를 꺼도 접속되는 공개 URL — “장난감”이 “진짜 서비스”로 진화
0.3 손에 쥐게 되는 것
어디서 멈춰도 괜찮습니다
- Part 1까지 — 내가 만든 명함 생성기·영감 카드를 친구에게 전송
- Part 2까지 — 한글·엑셀 자동화, 내 PC에서 AI가 일함
- Part 3까지 — AI에게 고삐 채우는 법 습득
- Part 4까지 — 서비스를 세상에 공개하고 운영
개인 학습에서는 어느 지점까지 가도 성과가 남습니다. 수업에서는 공통 도달점과 선택 도전과제를 따릅니다.
나의 학습 경로
나는 어디까지 갈 것인가?
A · AI 활용형
Part 1 — 대화로 결과물 제작
B · 업무 자동화형
Part 2 — 내 PC의 파일과 작업 처리
C · AI 통제형
Part 3 — 검증과 안전장치 설계
D · 서비스 운영형
Part 4 — 공개·배포·운영 완주
이번 과정에서 만들고 싶은 결과물과 도달 지점을 한 문장으로 적어보세요.
0.4 학습 구조
모든 실습은 같은 리듬으로 — 3단계
1단계
말하기
코드가 아닌 "문장"으로
AI에게 지시한다
→
2단계
확인하기
결과·증거를 검증한다
경계값과 동작을 확인한다
→
3단계
통제하기
규칙을 추가한다
하지 말아야 할 것을 적는다
그리고 만족할 때까지 반복합니다 ↺
0.4 학습 구조 — 미리보기: AI 명함 생성기
3단계가 실제로 굴러가는 모습
1 말하기
"이름·직업·연락처를 넣으면 세련된 디지털 명함을 만들어주는 웹페이지를 만들어줘."
2 확인하기
명함이 생성되는지 직접 입력해 본다 — "배경이 너무 어둡네?" "글씨가 작네?" → 바로 수정 지시
3 통제하기
"전화번호 형식이 이상하면 명함을 만들지 말고 재입력을 안내해줘." → '010'만 넣으면 경고가 뜨는지 재확인
0.4 미니 활동
말하기 · 확인하기 · 통제하기로 나누어 보세요
“학생 이름과 이메일을 입력하면 수강 확인증을 만들어주는 페이지를 만들어줘.”
정답 하나를 찾기보다, 검증 기준이 구체적인가를 확인합니다.
0.4 학습 구조
당신이 집중할 것은 세 가지뿐
내가 쓴 지시 → 나온 결과 → 추가한 규칙
- 코드를 읽을 필요가 없습니다
- 문법을 외울 필요가 없습니다
- 무슨 언어로 코딩했는지 몰라도 됩니다
눈은 결과와 증거를 확인하고, 손은 지시·규칙·검증 기준을 씁니다.
0.5 학습 난이도
이 책의 등산 지도
난이도 = 프로그래밍의 어려움이 아니라, 낯선 도구를 처음 만날 때의 어색함의 정도.
0.5 학습 난이도
숨이 차는 구간이 나오면
그 구간이 원래 오르막인 겁니다. 당신이 못하고 있는 게 아닙니다.
- 3~4장 첫 오르막: 터미널·Claude Code — 한 번만 지나가면 되는 구간
- 6~8장 고비: 욕설·도배·오답·서버다운을 해결하며 고삐 채우기
- 9~11장 마지막 길: GitHub 보관 → Vercel 공개 → 로그·비용·보안
오르막은 실패의 신호가 아니라, 실제 서비스에 가까워지고 있다는 신호.
막히면 Claude 웹에 질문하되, 설치·비용·보안은 공식 안내와 함께 확인합니다.
0.6 준비물과 비용
배낭 꾸리기 — 계정과 비용의 전부
| 구간 | 필요한 것 | 비용 | 시점 |
|---|
| Part 1 (0~2장) | Claude 계정 | 무료로 시작 가능* | 1.5절 |
| Part 2 (3~5장) | Claude Pro 구독 | 월 20달러 (약 3만 원) | 4.1절 |
| Part 3 (6~8장) | Claude API 크레딧 (선불) | 5달러 수준으로 시작 | 7.8절 |
| Naver 개발자 계정 | 무료 | 8.3절 |
| Part 4 (9~11장) | GitHub 계정 (코드 금고) | 무료 | 9.2절 |
| Vercel 계정 (배포 플랫폼) | 무료 | 10.2절 |
| Upstash 데이터베이스 | 무료 플랜 | 10.3절 |
| 부록 (선택) | 나만의 도메인 | 연 1~2만 원 | 부록 C |
0.6 준비물과 비용
비용에 대한 세 가지 안심 포인트
① 유료는 Part 2부터
Claude Code를 쓰는 시점부터 Pro 요금제 필요 — 그 전까지는 무료로 체험합니다.
② API는 5달러 선불로 시작
후반 챗봇 실습에서만 사용량 비용 발생. 소규모 실습은 무료 플랜으로 시작할 수 있습니다. 한도·정책은 가입 시점에 확인합니다.
③ 지갑에 자물쇠를 채웁니다
7장과 11장에서 API 비용이 폭주하지 않도록 지출 한도·알림 설정법까지 함께 다룹니다.
한국 카드 결제 시 해외 온라인 결제가 허용된 카드가 필요할 수 있고, 실제 청구액은 환율·세금·수수료에 따라 달라질 수 있습니다.
0장 요약
세 문장으로 정리하면
1. 코드는 AI가 작성하지만, 목표·검증·승인의 책임은 사람에게 있습니다.
2. 모든 실습은 말하기 → 확인하기 → 통제하기의 반복입니다.
3. 결과물 생성에 그치지 않고 배포·운영 가능한 서비스까지 나아갑니다.
1분 점검
설명할 수 있으면 0장 완료
1 ‘직접 코딩 0%’는 무엇을 배우지 않는다는 뜻인가?
2 AI가 “완료했다”고 말하면 무엇을 먼저 확인하는가?
3 말하기 → 확인하기 다음 단계는 무엇인가?
4 코드 암기 대신 평가할 세 가지 과정은 무엇인가?
출구 티켓 · 오늘 이해한 핵심 1가지 / 아직 불안하거나 준비가 필요한 것 1가지
NEXT
1장. AI는 '다음 단어를 예측하는 전문가'
같은 질문에 매번 다른 답이 나오는 이유 (토큰·확률·온도)
AI가 확신에 찬 오답을 내놓는 이유 (할루시네이션)
그래서 왜 '통제'가 필요한가
준비: 1.5절에서 Claude 무료 계정을 만듭니다