Claude Code 101 — 한국어 입문 가이드를 만든 이유
"그거 어떻게 하는 거예요?"
요즘 저는 바이브 코딩(Vibe Coding)에 빠져 있습니다. Claude Code를 켜고 자연어로 대화하면서 앱을 만들고, 버그를 잡고, PR을 올립니다. 코드를 한 줄 한 줄 타이핑하는 대신, "이런 기능 만들어줘"라고 말하면 Claude가 알아서 파일을 만들고, 테스트를 돌리고, 커밋까지 해줍니다.
이걸 옆에서 보신 분들이 하나둘 물어보기 시작했습니다.
"그거 뭐예요? 나도 해보고 싶은데 어떻게 시작해요?"
개발자분들만 물어보신 게 아닙니다. 기획자, 디자이너, 비개발 직군 분들도 "나도 저렇게 앱 만들 수 있어?"라고 물어보셨습니다.
처음에는 직접 알려드리려고 했습니다. 그런데 막상 가르치려니 난감했습니다. 어디서부터 시작해야 하지? 얼마나 알려드려야 하지?
개발자분에게는 설치법만 알려드리면 되지만, 터미널을 처음 보는 분에게는 "터미널이 뭔지"부터 설명해야 합니다. 그렇다고 모든 걸 한 번에 설명하자니 너무 우당탕입니다. 한두 시간 옆에 앉아서 보여드려도, 돌아가서 혼자 하시면 다시 막히기 마련입니다.
그래서 생각했습니다 — 잘 정리된 자료가 하나 있으면 되겠다.
직접 따라가며 실습할 수 있고, 모르는 부분은 다시 돌아와서 확인할 수 있는 가이드. 그게 Claude Code 101을 만든 이유입니다.
코드를 몰라도 됩니다
바이브 코딩의 본질은 **"코드를 몰라도 앱을 만들 수 있다"**는 것입니다.
"할 일 목록 앱 만들어줘"라고 말하면 Claude Code가 알아서 만듭니다. 여러분은 무엇을 만들지만 설명하면 됩니다. 기획자가 프로토타입을 직접 만들고, 디자이너가 인터랙션을 바로 구현하고, 비개발 창업자가 MVP를 혼자 만드는 — 이런 시대가 이미 왔습니다.
그래서 이 가이드는 개발자만을 위한 자료가 아닙니다. 터미널을 한 번도 열어본 적 없는 분도 처음부터 따라갈 수 있도록 만들었습니다.
왜 기존 자료로는 부족한가
1. 한국어 자료가 없다
Anthropic은 공식 교육 과정을 운영하고 있습니다. Claude 101은 claude.ai 웹 사용법, Claude Code in Action은 Claude Code 개발 과정입니다.
둘 다 좋은 코스지만, 영어입니다.
Claude Code를 처음 접하는 한국 사용자가 설치부터 실전까지 따라갈 수 있는 한국어 자료는 사실상 없었습니다. 공식 문서를 번역한 글은 있어도, "이걸 어떤 순서로, 어떻게 실습해야 하는지"를 안내하는 체계적인 가이드는 찾기 어려웠습니다.
2. 비개발자는 시작조차 어렵다
기존 자료는 전부 "터미널을 열고"에서 시작합니다. 하지만 터미널이 뭔지 모르는 분에게는 그 첫 문장부터 벽입니다.
이 사이트에는 사전 준비(Pre) 모듈이 있습니다:
- 터미널이 뭔지, 어떻게 여는지
pwd,ls,cd,mkdir— 꼭 필요한 명령어 5개- Homebrew, Node.js 설치 (복사-붙여넣기만 하면 됨)
- "왜 웹이 아니라 터미널에서 하는지" 이유 설명
이 모듈을 끝내면 개발 경험이 없어도 다음 모듈로 자연스럽게 넘어갈 수 있습니다.
3. 흩어진 정보를 하나로
Claude Code를 제대로 쓰려면 알아야 할 게 많습니다:
- 설치와 로그인 (brew? npm? winget?)
- 권한 모드 (Plan / Normal / Auto-Accept)
- CLAUDE.md로 프로젝트 컨텍스트 설정
- 효과적인 프롬프트 작성법
- MCP 서버로 외부 도구 연결
- 커스텀 에이전트와 Skills
- Hooks로 자동화
- Git/PR 워크플로우
- 비용 관리와 모델 선택 전략
- 컨텍스트 윈도우 이해
이 개념들이 공식 문서, 블로그, 유튜브, 레딧에 조각조각 흩어져 있습니다. 처음 시작하는 사람이 이걸 하나하나 찾아서 조합하는 건 비효율적입니다.
하나의 페이지에서, 순서대로, 실습과 함께 — 이게 제가 원했던 형태입니다.
4. Anthropic 공식 코스와의 차이
Anthropic의 코스를 직접 비교해봤습니다:
| Claude 101 (Anthropic) | Claude Code in Action (Anthropic) | Claude Code 101 (이 사이트) | |
|---|---|---|---|
| 대상 | 모든 사용자 | 개발자 | 비개발자 ~ 개발자 |
| 도구 | claude.ai 웹 | Claude Code CLI | Claude Code CLI |
| 언어 | 영어 | 영어 | 한국어 |
| 깊이 | 일반 AI 활용 | 7개 모듈 (Skills 중심) | 12개 모듈 (터미널 기초~실전 프로젝트) |
| 사전 지식 | 없음 | CLI 기초 필요 | 없음 (터미널부터 가르침) |
Claude Code in Action은 Skills 빌드에 초점을 맞춘 훌륭한 코스입니다. 하지만 터미널을 처음 접하는 사람은 시작할 수 없고, "Claude Code를 처음 쓰는 사람이 알아야 할 모든 것"을 다루지는 않습니다.
이 사이트는 터미널을 처음 여는 순간부터 실전 프로젝트 완성까지, 빠진 개념 없이 다루는 것을 목표로 만들었습니다.
무엇을 다루나
12개 모듈, 16~22시간 분량입니다:
Pre. 터미널이 처음이라면 — 터미널 기초, 개발 환경 설치 (비개발자용)
00. Claude Code가 뭔가요? — 개념, 역사, 기존 도구 비교
01. 설치 & 첫 실행 — 환경설정, 로그인, IDE 연동
02. 기본 사용법 마스터 — 명령어, 권한 모드, 비용/모델 관리
03. CLAUDE.md — 프로젝트 메모리 설정
04. 효과적인 프롬프팅 — 패턴, Plan Mode, 컨텍스트 윈도우
05. MCP 서버 연결 — 외부 도구 통합
06. 서브에이전트 & 커스텀 에이전트
07. Skills & Hooks — 자동화
08. 실전 워크플로우 — Git, PR, 디버깅
09. 고급 기능 — Worktree, Teleport
10. 실전 프로젝트 — DailyMemo 앱 처음부터 완성
터미널을 처음 열어보는 분은 Pre 모듈부터, 이미 개발 경험이 있는 분은 00 모듈부터 시작하면 됩니다. 모든 모듈에 Step-by-Step 실습 가이드와 체크리스트가 포함되어 있고, 진행률은 브라우저에 자동 저장됩니다.
특히 신경 쓴 부분
비개발자도 따라갈 수 있게
Pre 모듈에서 터미널이 뭔지, 어떻게 여는지, 기본 명령어 5개를 배웁니다. "비밀번호를 입력해도 화면에 안 보이는 게 정상"처럼, 처음 겪으면 당황할 수 있는 상황까지 미리 안내합니다. 그리고 가장 중요한 질문 — "왜 웹이 아니라 터미널에서 하는지"에 대한 답도 여기서 다룹니다.
비용 관리를 처음부터 가르친다
Claude Code는 무료가 아닙니다. 구독($20~$200/월)이든 API(종량제)든 돈이 듭니다.
초보자가 가장 먼저 겪는 문제가 "생각보다 비용이 많이 나온다"입니다. 그래서 모듈 02에서부터 구독 vs API 과금 차이, 모델별 토큰 단가, /cost와 /compact 사용법을 다룹니다. 구독은 한도 초과 시 속도만 느려지고 추가 과금이 없지만, API는 쓴 만큼 청구되므로 반드시 예산 한도를 설정해야 합니다.
컨텍스트 윈도우를 이해시킨다
"대화가 길어지면 Claude가 이상해진다"는 경험, 누구나 합니다. 이게 왜 발생하는지, 언제 /compact하고 언제 새 세션을 시작해야 하는지 — 이 원리를 모르면 Claude Code를 제대로 쓸 수 없습니다.
실전 프로젝트로 끝낸다
개념만 알아서는 쓸 수 없습니다. 마지막 모듈에서 DailyMemo 앱을 처음부터 끝까지 Claude Code로 만듭니다. CLAUDE.md 작성 → 설계 → 구현 → 코드 리뷰 → 테스트 → Git/PR까지, 앞에서 배운 모든 것을 종합합니다.
이런 분들에게 추천합니다
- 주변에서 바이브 코딩하는 걸 보고 "나도 해보고 싶다"는 분
- 터미널을 한 번도 써본 적 없는 비개발자 — 기획자, 디자이너, 창업자
- Claude Code를 설치는 했는데 뭘 해야 할지 모르겠는 분
- Copilot/Cursor를 쓰다가 Claude Code로 넘어오려는 분
- 영어 문서 읽기가 부담스러운 한국어 사용자
- 에이전틱 코딩이 뭔지 직접 체험해보고 싶은 분
마무리
사실 저도 누군가에게 "이거 보세요"라고 링크 하나 보내드리고 싶었을 뿐입니다. 그런데 보내드릴 만한 한국어 자료가 없었습니다. 개발자용 영어 자료는 있어도, 터미널을 처음 열어보는 분까지 포함한 한국어 가이드는 없었습니다.
그래서 직접 만들었습니다.
Claude Code는 단순한 코드 생성기가 아닙니다. 제대로 쓰면 개발 경험이 없어도 자신의 아이디어를 직접 만들어볼 수 있습니다. 주변에 Claude Code를 시작하고 싶어하는 분이 있다면 — 개발자든 아니든 — 이 링크를 보내드리세요.
