저는 새로운 기술을 좋아하는 사람입니다. 카메라, 스마트폰, VR 글래스, AR 글래스... 새로 나온 기기라면 일단 눈이 가는 사람이죠. 그러다 3년 전쯤, 딱 눈에 들어온 게 있었습니다. 'AI'. 진짜 사람처럼 대화가 된다고? 엄청난 지식이 학습되어 있다고?

GPT 3.5를 처음 써봤을 때, 솔직히 바로 실망했습니다. 그때 사람들이 주로 하던 건 '너 이것도 알아?' 식의 퀴즈 같은 질문들이었습니다. 엉뚱한 대답이 나오면 실망하고 끝. 저도 똑같았습니다. 그래서 그때는 AI를 그냥 덮어뒀습니다.

그런데 2~3년 사이, 어마어마하게 발전했습니다. LLM들이 발전하면서 이제는 LLM을 통해 LLM을 학습시키는 단계가 됐습니다. 더 나은 AI가 또 더 나은 AI를 발전시키니... 무슨 복리의 마법처럼 AI가 엄청난 속도로 발전하고 있습니다.

제가 취미로 만들어 본 것들을 잠깐 소개할게요. 대단한 게 아니라, 그냥 "있으면 좋겠다" 싶은 걸 재미로 하나씩 만들어 본 것들입니다. 자랑이 아니라, 코드를 몰라도 이런 게 된다는 걸 보여드리려는 겁니다.

앞의 것들은 개인 서비스, 아래는 실제 회사에서 업무용으로 개발한 시스템입니다. 이미 현업에서 쓰이는 것도 있고, 개발은 끝났지만 아직 사내 공개 전인 것도 섞여 있습니다. 전부 바이브코딩으로 만들었습니다.

AI를 안 쓰는 이유가 뭘까요? 싫어서? 무서워서? 아니요. 대부분은 'AI로 뭘, 어떻게, 얼마나 할 수 있는지'를 모르기 때문입니다. What · How · How much를 모르는 거죠. 이 책은 그 세 가지를 알려드리는 책입니다.

마케터가 3개월 만에 사용자 1만 명짜리 서비스를 만들었습니다. 코딩을 한 줄도 배운 적 없는 사람이요. 세계 최대 스타트업 육성기관인 와이컴비네이터(Y Combinator)가 최근 선발한 스타트업의 25%는, 서비스 코드의 95% 이상을 AI로 만들었습니다. 이건 먼 미래 이야기가 아닙니다. 지금 이 순간 벌어지고 있는 일입니다.

맞습니다. 그 불안한 마음, 당연한 것입니다. 저도 40이 넘도록 코딩은 '나랑은 다른 세계 이야기'라고만 생각했습니다. 어려운 용어에 공포를 느끼지 마세요. 용어는 그냥 이름표입니다. API(프로그램끼리 대화하는 통로), 프레임워크(미리 만들어둔 뼈대), 서버(다른 사람이 접속할 수 있게 켜 놓는 컴퓨터). 하나도 어렵지 않습니다.

사람들이 멀리 있는 사람에게 소식을 전하는 방법을 생각해보세요. 처음엔 편지였습니다. 직접 손으로 쓰고, 마차에 실어 보냈죠. 며칠에서 몇 주가 걸렸습니다. 그다음엔 전보가 나왔습니다. 짧은 글자를 전신으로 보내는 방식이었는데, 그래도 훨씬 빨라졌죠. 이후 전화가 등장하면서 목소리로 직접 대화할 수 있게 됐습니다. 그리고 이메일, 마지막으로 카카오톡. 지금은 사진, 동영상, 파일까지 실시간으로 보낼 수 있습니다.

코딩의 역사도 정확히 같은 패턴입니다. 처음엔 기계가 이해하는 방식에 사람이 맞춰야 했습니다. 그런데 기술이 발전할수록 점점 사람의 방식에 가까워졌고, 지금은 그냥 말하면 됩니다.

2023년, 테슬라 AI 총괄이자 OpenAI 공동창립자인 안드레이 카파시가 이런 말을 했어요.

2025년 2월, 카파시는 새로운 단어를 만들었습니다. 바이브코딩(Vibe Coding). "코드가 존재한다는 사실조차 잊어버리고, 바이브에 몸을 맡기세요." 이 포스트는 450만 뷰를 기록했고, Collins 사전은 "바이브코딩"을 올해의 단어로 선정했습니다.

어떤 이동수단을 쓰느냐에 따라 갈 수 있는 범위가 완전히 달라지듯, AI도 어떻게 쓰느냐에 따라 차원이 달라집니다. 이 책은 여러분을 4단계 자가용까지 끌어올리는 게 목표입니다.

사브린 마토스(Sabrine Matos). 브라질 출신 마케터입니다. 코딩 경험? 제로. 그런 사브린이 AI 코딩 도구를 써서 Plinq라는 서비스를 만들었습니다. 3개월 만에 사용자 1만 명, 연매출 $456K(약 6억 원)을 기록했습니다. BayouSwap이라는 가상의 예시 서비스는 기술 배경 없는 창업자가 AI로 4주 만에 MVP를 만든 사례를 보여줍니다.

이 사람들은 천재가 아닙니다. 다만 한 가지 공통점이 있습니다. "이걸 만들고 싶다"는 명확한 아이디어가 있었다는 것. 나머지는 AI가 해줬습니다.

2024년 한 해에만 AI가 생성한 코드가 2,560억 줄(업계 추정치)입니다. 이해를 돕기 위한 비유로 들자면, 위키피디아 전체 텍스트의 64배가 넘는 양입니다.

한국 정부는 AI 인재 양성에만 1.4조 원을 투자하고 있습니다(2026년 전체 AI 예산은 약 10조 원 규모). 2025년 초등 3~4학년에 이어 2026년에는 5~6학년까지 AI 교육이 도입됐습니다. 2026년 1월에는 AI 기본법이 시행됐습니다. 유행이 아니라 국가 정책입니다.

방에 서랍장이 있다고 상상해보세요. 파일은 서류 한 장입니다. 글이 적혀 있을 수도, 그림일 수도 있습니다. 폴더는 서랍입니다. 서류들을 종류별로 분류해서 넣어두는 곳입니다. 서랍 안에 더 작은 칸막이(하위 폴더)를 만들 수도 있습니다.

파일이 어디 있는지 알려주는 주소를 경로(Path)라고 합니다.

/Users/민수/Documents/my-project/index.html
│        │      │           │         └─ 파일
│        │      │           └─ my-project 폴더
│        │      └─ Documents 폴더
│        └─ 민수의 홈 폴더
└─ 최상위 루트

슬래시(/)가 칸막이 역할을 합니다. 왼쪽에서 오른쪽으로 갈수록 더 깊은 서랍을 여는 것입니다. 마치 "서울시 / 강남구 / 역삼동 / 123번지"처럼요.

CLAUDE.md, README.md 같은 중요한 파일이 전부 마크다운입니다. 간단한 기호로 글을 꾸미는 문법입니다. # 제목, **굵게**, - 목록. 이 세 가지만 알아도 80%는 읽을 수 있습니다.

Claude Code는 터미널이라는 곳에서 동작합니다. 컴퓨터에게 글자로 명령하는 창입니다. 마우스로 아이콘을 더블클릭하는 대신, 글자를 타이핑해서 컴퓨터에게 일을 시키는 방식입니다.

Claude Code를 쓸 때는 터미널을 열고 claude라고 한 단어만 치면 끝입니다. 그다음부터는 한국어로 말하면 됩니다. 카카오톡처럼요. 그냥 글자 치고 보내기 누르면 됩니다.

명령어 한 줄이면 설치가 끝납니다. 아래 3단계를 순서대로 해보세요. 관리자 권한은 필요 없습니다.

irm https://claude.ai/install.ps1 | iex

공식 네이티브 인스톨러입니다. Node.js 없이 동작하고, 설치 후에는 백그라운드에서 자동으로 업데이트됩니다.

claude

필수는 아닙니다. 설치해두면 Claude가 'Bash 도구'로 셸 명령을 실행하고, 없으면 PowerShell로 대신 동작합니다(둘 다 정상). 8장에서 배울 버전 관리(Git)도 함께 쓰게 되니 설치를 권합니다. → git-scm.com/downloads/win 접속 후 기본 옵션으로 Next.

로그인까지 끝났다면, 실제 코딩은 늘 이 흐름입니다. 각 단계는 뒤에서 자세히 다룹니다.

Claude Code는 "지금 열려 있는 폴더" 안에서 일합니다. 그래서 시작 전에 프로젝트를 담을 폴더를 정하고, 그 폴더에서 claude를 켜는 게 진짜 첫걸음입니다. 아무 데서나 켜면 파일이 엉뚱한 곳에 흩어집니다.

Claude Code 설치만으로 Claude와 대화는 됩니다. 하지만 Claude가 만들어 준 프로그램을 실제로 돌리려면 그 언어의 실행기가 따로 필요할 때가 있습니다. 설치(claude) ≠ 실행 환경 — 이 둘은 다릅니다.

프롬프트가 길어질 때 내용물에 라벨을 붙이면 Claude가 각 역할을 정확히 이해합니다.

<instructions>
  블로그 글을 써줘. 1500자 내외.
</instructions>

<context>
  주제: 재택근무 생산성 높이기
  대상: 30대 직장인
</context>

<examples>
  "아침에 일어나서 바로 노트북을 열면..."
  "커피 한 잔의 힘을 과소평가하지 마세요"
</examples>

가장 강력한 프롬프트는 바로 이 한 줄입니다.

이 한 줄을 대화 맨 처음에 넣으면 Claude의 모든 답변이 달라집니다. 전문 용어 대신 쉬운 말을 쓰고, 단계를 더 잘게 나누고, 중간중간 확인을 해줍니다. 이를 컨텍스트 프라이밍이라고 합니다.

글로 설명하기 어려운 건 그냥 이미지를 보여주세요. "이 화면처럼 만들어줘", "이 디자인 따라 해줘" — Claude는 이미지를 읽고 그대로 반영합니다.

새 회사에 입사하면 사규(사내 규정)를 받죠. "출근은 9시", "문서는 구글 드라이브에", "코드 리뷰 없이 배포 금지." Claude Code에도 똑같은 게 있습니다. 바로 CLAUDE.md입니다. Claude가 프로젝트를 시작할 때마다 이 파일을 자동으로 읽습니다. 매번 같은 말을 반복할 필요가 없어집니다.

가장 쉬운 방법이 있습니다. Claude Code를 실행하고 이렇게만 하면 됩니다.

/init

Claude가 프로젝트를 분석해서 CLAUDE.md를 자동으로 만들어줍니다. 빌드 명령어, 프로젝트 구조, 기술 스택까지 알아서 파악합니다. 생성된 내용을 확인하고 필요한 부분만 수정하면 됩니다.

CLAUDE.md가 자연어로 쓴 '지시서'라면, settings.json은 실제 동작을 바꾸는 '설정 스위치'입니다 — 허용·차단할 명령, 기본 모델, 훅, 환경변수 등. 이 설정도 적용 범위에 따라 두는 위치가 다릅니다.

{
  "permissions": {
    "allow": ["Bash(npm run *)"],
    "ask":   ["Bash(git push *)"],
    "deny":  ["Bash(rm -rf *)"]
  }
}

새 프로젝트를 시작하거나 기존 구조를 정리할 때 아래 레이아웃을 따르면 설정이 한눈에 정돈됩니다. Claude에게 "이 구조로 .claude 폴더 만들어줘"라고 하면 그대로 생성해줍니다.

your-project/
├── CLAUDE.md               # 프로젝트 지침 (커밋·매 세션 로드)
├── .mcp.json               # 팀 공유 MCP 서버 (커밋)
└── .claude/
    ├── settings.json       # 권한·훅·모델 (커밋, 강제 적용)
    ├── settings.local.json # 개인 설정 (자동 gitignore)
    ├── rules/              # 주제별 모듈 지침
    ├── skills/             # 재사용 워크플로우 (/이름)
    ├── commands/           # 단일 파일 슬래시 커맨드
    └── agents/             # 서브에이전트 (독립 컨텍스트)

Claude Code는 도구(Tool)를 사용해서 일합니다. 여러분이 도구 이름을 외울 필요는 없습니다. Claude가 알아서 골라 씁니다. 핵심 도구 몇 가지만 알아두면 "아, 지금 파일을 읽는구나" 하고 이해할 수 있습니다.

"에러 찾아서 고쳐줘" 한 마디에 Claude는 도구 네 개를 순서대로 씁니다.

Git 명령어를 외울 필요 없습니다. Claude Code에게 말만 하면 됩니다.

커밋이 '내 컴퓨터 안의 세이브'라면, GitHub는 '인터넷에 올려두는 백업 + 배포의 출발점'입니다. 뒤에서 배울 무료 배포(Vercel·GitHub Pages)도 전부 GitHub에서 시작합니다. 계정 하나만 만들어두면 됩니다.

작업 중 Shift+Tab을 누르면 모드가 순환 전환됩니다. 외울 건 초보자가 실제로 쓰는 세 가지입니다.

AI 코딩 툴 덕분에 코딩을 몰라도 앱을 뚝딱 만드는 시대가 됐습니다. 그런데 최근 해외에서 이 흥분이 꽤 심각한 사고로 이어진 일이 있었습니다.

제작자가 나쁜 의도를 가진 건 아니었습니다. 아무도 "이 앱 안전해? 법적으로 문제없어?"라고 물어보지 않았을 뿐입니다.

개인정보를 수집하는 앱은 개인정보보호법 제15조에 따라 아래 4가지를 반드시 고지·동의 받아야 합니다.

체크리스트 3번 "API 키는 .env에만"이 무슨 뜻인지 풀어봅니다. API 키·비밀번호 같은 비밀은 코드 안에 직접 적으면 안 됩니다 — GitHub에 올리는 순간 전 세계에 공개되니까요. 대신 .env라는 별도 파일에 모으고, 그 파일은 업로드에서 제외합니다.

서비스가 여러 개로 늘어나니 API 키 관리가 골칫거리였습니다. 서비스마다 키를 심어두면 키가 코드 곳곳에 흩어지고, 누가 얼마나 썼는지도 알기 어렵습니다. 그래서 AI 게이트웨이를 직접 만들었습니다. 개념은 은행 창구와 같습니다. 내 진짜 키(현금)는 금고에 맡겨두고, 각 서비스에는 창구 번호표(게이트웨이 코드)만 나눠 줍니다.

이 두 단어가 책에 자주 나오는데 헷갈리기 쉽습니다. 딱 한 줄로 구분하면 이렇습니다.

단골 카페에서 "아이스 아메리카노, 샷 추가, 얼음 적게"를 매일 반복하는 대신 앱의 "나의 주문" 버튼 하나로 끝내는 것과 같습니다. Claude Code의 스킬이 그것입니다.

.claude/skills/fix/
└── SKILL.md          ← 지시 내용이 담긴 파일

~/.claude/skills/     ← 모든 프로젝트에서 사용
.claude/skills/       ← 이 프로젝트에서만 사용

구조를 봤으니 실제로 하나 만들어봅니다. 손으로 짤 필요 없이 Claude에게 시키면 됩니다.

"어떤 스킬을 만들면 좋을까?" 고민된다면 이 목록에서 골라보세요. 처음에는 하나만 만들어보세요.

Claude는 똑똑하지만, 기본 상태에서는 내 노션·DB·깃허브 안으로 직접 들어갈 '손'이 없습니다. MCP(Model Context Protocol)가 바로 그 연결선입니다 — Claude에게 전화기를 쥐어주는 셈이죠. 한 번 연결해두면 "이번 달 방문자 수 분석해줘"라고 말만 해도 Claude가 직접 그 서비스에 접속해 가져옵니다. MCP가 없으면 데이터를 일일이 복사·붙여넣어야 합니다.

MCP 연결은 설정 파일을 직접 짜는 게 아닙니다. 명령어 한 줄이나 말 한마디면 됩니다. (설정 파일이 실제로 어떻게 생겼는지는 다음 페이지에서 '참고'로 보여드립니다.)

claude mcp add fs -- npx -y @modelcontextprotocol/server-filesystem ~/projects
claude mcp add --transport http 이름 https://서버주소/mcp
claude mcp list           # 연결된 서버 목록
claude mcp remove fs      # 제거

직접 짤 필요는 없습니다. 앞 페이지의 claude mcp add fs ... 명령이 실제로는 아래 설정 파일에 이렇게 기록될 뿐입니다. "안이 어떻게 돌아가나" 궁금할 때만 펼쳐 보세요.

{
  "mcpServers": {
    "fs": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "~/projects"]
    }
  }
}

스킬·커맨드·MCP·훅·서브에이전트를 하나씩 만드는 대신, 누군가 미리 묶어둔 플러그인(plugin)을 한 번에 설치할 수 있습니다. "앱 하나 깔면 관련 기능이 통째로 따라오는" 것과 같습니다.

/plugin marketplace add anthropics/claude-code   # 마켓플레이스 등록
/plugin install 이름@마켓플레이스                  # 플러그인 설치
/plugin                                          # 둘러보기·켜고 끄기

컨텍스트 윈도우(기본 약 200,000 토큰, 모델에 따라 더 큼)에는 대화 내용, 읽은 파일, 도구 실행 결과가 쌓입니다. 80% 차면 자동 컴팩션이 일어납니다. /compact로 직접 정리할 수도 있습니다.

작업하다 컴퓨터를 끄거나 터미널을 닫아도 괜찮습니다. Claude Code는 대화를 저장해두기 때문에 다음에 그대로 이어서 할 수 있습니다. 매번 처음부터 다시 설명할 필요가 없습니다.

앞에서 --continue로 어제 대화를 이어갈 수 있다고 했지만, 저는 한 가지를 더 합니다. 매일 코딩을 마칠 때, 그날 한 작업을 문서로 남깁니다. 오늘 뭘 바꿨는지, 왜 그렇게 했는지, 다음에 이어서 할 일은 무엇인지를 짧게 정리해 두는 거죠.

이유는 단순합니다. 다음 날 다시 앉았을 때, 저도 Claude도 1분 안에 어제의 맥락을 되찾고 바로 오늘 작업에 들어가기 위해서입니다. 기억에만 의존하면 "내가 어디까지 했더라"부터 헤매게 됩니다.

서브에이전트가 "조수"라면, 오케스트레이터는 "팀장(Tech Lead)"입니다. 직접 코드를 쓰지 않고, 요구사항을 정리해 여러 전문 에이전트에게 일을 나눠준 뒤 각자의 결과물을 모아 하나의 완성품으로 종합합니다.

"로그인 시스템 만들어줘" 한 마디면, 팀장이 7명의 전문가를 순차·병렬로 부려 기획부터 검증까지 끝냅니다.

Tech Lead (오케스트레이터)  ← 요구사항을 브리프로 정리
   ▼ ① PRD 작성자 — 무엇을 만들지 문서화
   ▼ ② UX 디자이너  ∥  백엔드 개발자   (동시 진행)
   ▼ ③ 프론트엔드 개발자
   ▼ ④ QA 엔지니어  ∥  보안 엔지니어   (동시 진행)
   ▼ ⑤ 마케팅 어드바이저
   ▼ Tech Lead — 결과 종합 후 최종 보고

/dev-team 같은 팀장 에이전트도 직접 만들 수 있습니다. 핵심은 "직접 일하지 말고, 나눠주고, 모은다"를 규칙으로 적어두는 것입니다.

.claude/agents/
├── orchestrator.md   ← 팀장: 분배·종합 규칙
├── backend.md        ← 전문 역할들
└── frontend.md
.team/                ← 공유 작업판(산출물 파일)

PRD(제품 요구사항 문서)는 "무엇을·왜·어떻게 만들지"를 적은 설계도입니다. 작은 연습은 그냥 시켜도 되지만, 진짜 내 서비스를 만들 땐 PRD가 있으면 Claude가 헤매지 않고 내 의도대로 만듭니다. 같은 "앱 만들어줘"라도 PRD 유무로 결과가 완전히 달라집니다.

코딩 지식이 없어도 됩니다. 한국어로 대화만 하면 Claude가 코드를 쓰고, 파일을 만들고, 실행까지 해줍니다. 예상 소요 시간: 1~2시간.

"이 사이트를 무료로 인터넷에 올리고 싶어"라고 말하면 Claude가 방법을 안내해줍니다. 세 가지 옵션이 있습니다.

배포 후에도 수정은 쉽습니다. "아메리카노 가격 5,000원으로 바꿔줘" → Claude가 코드 수정 → "인터넷에도 반영해줘" → Claude가 commit + push. 1~2분 후 반영됩니다. 도메인 연결은 가비아·후이즈 등에서 구입 후 "내 도메인 연결해줘"라고 하면 Claude가 안내해줍니다.

앞에서 만든 건 '읽기 전용 전단지' 같은 정적 사이트였습니다. 하지만 로그인·회원가입·예약·글 저장 같은 기능을 넣으려면 데이터를 어딘가에 보관해야 합니다. 그게 데이터베이스(DB)와 백엔드입니다.

초보자에게 가장 추천하는 서비스입니다. 데이터베이스(PostgreSQL), 로그인(인증), 파일 저장, 자동 API를 클릭 몇 번으로 제공합니다. 어려운 서버 코드를 거의 쓰지 않아도 됩니다. "Supabase로 회원가입 기능 만들어줘"라고 하면 Claude가 테이블 설계부터 연결까지 안내합니다.

만든 앱을 인터넷에 올려 24시간 돌아가게 하는 것을 호스팅(배포)이라고 합니다. Vercel이 가장 쉽습니다. GitHub에 코드를 올리면 자동으로 배포되고 주소도 바로 생깁니다. (앞 페이지의 배포가 '정적 사이트'였다면, 여기선 데이터가 살아 있는 '진짜 앱'입니다.)

전문 개발자도 매일 수십 번 에러를 만납니다. 에러가 나는 건 뭔가를 만들고 있다는 증거입니다. 빨간 글씨가 뜨면 그냥 Claude에게 보여주세요.

지금까지 배운 걸 하나로 이으면 실제로 이렇게 흘러갑니다. 초보자가 그대로 따라 칠 수 있는 예시입니다.

2026년 최신 버전 기준. 외울 필요 없이, 필요할 때 펼쳐 보는 총정리입니다.

우선순위: 관리정책 > 사용자(~/.claude/CLAUDE.md) > 프로젝트(.claude/CLAUDE.md) > 로컬(CLAUDE.local.md). 본문에서 @경로로 다른 파일을 불러오고, /memory로 편집, #로 즉석 추가.

Read · Write · Edit · Bash · Grep · Glob · WebFetch · WebSearch. 읽기·검색은 자동, 수정·실행은 확인이 기본 안전 원칙입니다.

화면·입력 사용성이 크게 좋아졌습니다. 대부분 자동으로 적용되니, "이렇게 동작하는구나" 정도만 알아두면 됩니다.

초보자가 가장 많이 막히는 것들을 모았습니다. 대부분 한 줄짜리 해결입니다.