1강. 클로드 코드로 SaaS가 된다고요? - [대면 강의] 클로드 코드로 SaaS 만들기: 아이디어에서 첫 결제까지

한 줄 요약 — 클로드 코드는 대화만 하는 AI가 아니라 내 컴퓨터의 폴더 안에서 파일을 읽고, 고치고, 명령을 실행해서 결과까지 확인하는 AI입니다. 오늘은 설치하고 첫 질문에 답을 받는 데까지 갑니다.

클로드 코드로 아이디어에서 첫 결제까지 가는 16강 여정을 그린 1부 일러스트

이번 강의에서 만들 것

결과물: 터미널에서 claude가 실행되고, 내 폴더에 대한 첫 질문에 답이 나옵니다.
걸리는 시간: 25분(설치 대기 시간 포함). 이 강의는 무료 미리보기입니다. 설치와 로그인까지만 해 보고, 계속할지 정하셔도 됩니다.

먼저 알아둘 것

채팅 AI와 클로드 코드는 무엇이 다른가

	채팅 AI(웹·앱 대화창)	클로드 코드
일하는 곳	대화창 안	내 프로젝트 폴더
결과물	답변 글, 복사해서 붙여 넣을 코드	폴더 안의 파일이 직접 만들어지고 고쳐짐
확인	사람이 직접 실행해 보고 오류를 다시 붙여 넣음	클로드가 빌드·테스트 같은 명령을 스스로 실행해 보고 고침
기억	대화가 끝나면 사라짐	`CLAUDE.md` 같은 규칙 파일에 적어 두면 다음 세션에도 읽음(3강)

비유하면, 채팅 AI는 전화로 조언해 주는 전문가이고 클로드 코드는 내 작업장에 와서 같이 손을 움직이는 전문가입니다. 대신 내 작업장에 들어오는 만큼, 무엇을 허락할지 사람이 정해야 합니다. 그래서 이 강의는 권한 설정(3강)과 사람이 반드시 볼 것(매 강)을 계속 강조합니다.

이 강의에서 만드는 서비스: 「리뷰답글」

동네 가게 사장님이 배달앱·지도의 리뷰를 붙여넣으면, 가게 말투에 맞는 답글 초안 3가지를 AI가 써 주는 월 구독 서비스입니다. 설계(2~3강) → 화면·구글 로그인(4~6강) → DB·AI 답글·자동 검증(7~10강) → 요금제와 토스페이먼츠 결제·약관(11~13강, 무료 월 10건 / 프로 월 9,900원 월 300건은 예시) → 배포·운영·첫 고객(14~16강) 순서로 만듭니다. 스택은 Next.js + TypeScript + Tailwind + PostgreSQL(Drizzle ORM), 로그인은 Auth.js, 배포는 Vercel + Neon입니다. 이름이 낯설어도 괜찮습니다. 그때그때 클로드가 만들고, 저는 무엇을 확인해야 하는지를 알려 드립니다. 내 아이디어로 바꿔 따라 해도 됩니다.

따라 하기

1단계. 계정과 요금 고르기

클로드 코드는 Claude Pro, Max, Team, Enterprise 또는 Console 계정이 필요하고, 무료 claude.ai 플랜에는 포함되지 않습니다(공식 문서 기준). 요금과 한도는 자주 바뀌므로 숫자는 쓰지 않습니다. claude.com/pricing에서 직접 확인하세요(2026년 10월 기준, 공개 전 재확인).

상황	추천
처음이라 써 보고 정하고 싶다	가장 낮은 구독 플랜(Pro)으로 시작해서, 한도에 자주 걸리면 올립니다
매일 몇 시간씩 쓸 것 같다	더 높은 플랜(Max)을 검토합니다. 10강에서 한도 관리법을 다룹니다
토큰 쓴 만큼만 내고 싶다	Console 계정(API 사용량 선결제). 구독과 비용 구조가 다르니 공식 요금 페이지에서 직접 비교하세요

2단계. 터미널 열기

macOS: Cmd + Space → Terminal 입력 → Enter.
Windows: Win + X → Windows PowerShell(또는 Terminal) 선택. 줄 앞에 PS C:\가 보이면 PowerShell입니다.

3단계. 설치하기

공식 문서의 네이티브 설치(권장) 명령입니다. 붙여 넣고 Enter를 누른 뒤, 진행 표시가 없어도 끝날 때까지 기다리세요.

macOS(그리고 Linux, WSL):

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

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

Windows CMD(줄 앞에 PS가 없을 때):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

대안: macOS는 brew install --cask claude-code, Windows는 winget install Anthropic.ClaudeCode. 두 방법은 자동 업데이트가 되지 않아 직접 업그레이드해야 합니다.
Windows는 Git for Windows를 함께 설치하면 좋습니다(없어도 PowerShell로 동작). 3강에서 Git을 쓰니 지금 설치해 두세요.
지원 환경: macOS 13.0 이상, Windows 10 1809 이상, 램 4GB 이상, 인터넷 연결.

이렇게 보이면 성공: 새 터미널 창을 열고 아래를 실행했을 때 버전 번호가 나옵니다.

claude --version

4단계. 첫 실행과 로그인

아직 프로젝트가 없으니, 연습용 폴더를 만들어 그 안에서 실행합니다.

mkdir review-reply
cd review-reply
claude

처음 실행하면 로그인을 요청하고 브라우저가 열립니다. 안내에 따라 로그인하세요. 나중에 계정을 바꾸려면 클로드 코드 안에서 /login을 입력합니다.

이렇게 보이면 성공: 입력창과 함께 버전, 모델, 작업 폴더가 표시됩니다.

5단계. 첫 질문 해 보기

아래를 그대로 붙여 넣으세요. 폴더가 비어 있어도 괜찮습니다.

나는 코딩을 전혀 모르는 사람이야. 이 폴더는 비어 있어.
1) 너는 지금 무엇을 할 수 있고 무엇을 할 수 없는지 5줄 이내로 알려줘.
2) 내가 "소상공인이 리뷰 답글을 쉽게 쓰는 웹 서비스"를 만들고 싶다면, 처음 해야 할 일을 번호로 5개만 알려줘.
3) 아직 파일은 아무것도 만들지 마.

이렇게 보이면 성공: 클로드가 파일을 만들지 않고 글로만 답합니다. 중간에 멈추고 싶으면 Esc를 누르고, 끝내려면 /exit를 입력합니다. /help로 명령 목록을 볼 수 있습니다.

6단계. 이 강의를 진행하는 규칙 4가지

프롬프트는 복사해서 붙여 넣습니다. 글 안의 text 상자가 클로드에게 그대로 보내는 말입니다. 내 서비스에 맞게 바꿀 곳은 대괄호 [ ]로 표시합니다.
개발 서버(npm run dev)는 내가 직접 실행하고 끝냅니다. 클로드에게 시키지 않습니다. 클로드에게는 빌드·테스트처럼 끝나는 명령만 맡깁니다. 서버를 대신 켜 두면 포트가 겹치고 정리되지 않는 일이 생깁니다.
비밀값은 붙여 넣지 않습니다. API 키, DB 비밀번호, 결제 시크릿 키를 대화창에 쓰지 마세요. 환경변수 파일(.env)에 직접 넣고, 클로드에게는 "변수 이름만 정해 줘"라고 합니다. AI API 키는 ANTHROPIC_API_KEY, 모델 이름은 AI_MODEL로 서버에서만 씁니다.
운영 DB는 절대 reset하지 않습니다. 지우거나 되돌리는 명령은 내 눈으로 확인한 뒤에만 허락합니다.

막혔을 때

증상	대처
`claude`를 찾을 수 없음(`command not found`, `not recognized`)	새 터미널 창을 열어 다시 시도합니다. 그래도 안 되면 설치 위치가 PATH에 없는 것이니 공식 설치 문서의 "Fix your PATH"를 따릅니다
`irm`을 인식하지 못한다고 나옴	CMD에 있는 것입니다. PowerShell을 열거나 CMD용 명령을 쓰세요
`&&`가 올바른 구문이 아니라고 나옴	PowerShell에서 CMD용 명령을 붙인 것입니다. PowerShell용 명령을 쓰세요
설치 중 HTML 문구나 `syntax error`가 나옴	한 번 더 실행하고, 계속되면 Homebrew·WinGet으로 설치합니다. 지원 국가 밖이면 설치할 수 없습니다
로그인했는데 사용할 수 없다고 나옴	무료 claude.ai 플랜에는 클로드 코드가 없습니다. 플랜을 확인하세요
설치 점검이 필요함	`claude doctor`를 실행하면 설치·설정 진단이 나옵니다

클로드에게 맡겨도 되는 것 / 사람이 반드시 볼 것

클로드에게 맡겨도 되는 것	사람이 반드시 볼 것
폴더 구조 설명, 할 일 목록 정리	요금제 선택과 결제(내 돈이 나가는 결정)
설치 오류 메시지 해석	설치 명령은 공식 문서 주소에서 복사했는지(출처 모를 명령 금지)
파일 만들기·고치기(허락 후)	파일 생성·삭제 허락창의 내용
첫 질문에 대한 답변 초안	API 키·비밀번호를 대화창에 붙이지 않았는지

내 서비스로 바꾸기

5단계 질문의 "소상공인이 리뷰 답글을 쉽게 쓰는 웹 서비스"를 내가 만들고 싶은 서비스 한 줄로 바꾸세요.
폴더 이름 review-reply는 내 서비스 이름(영문 소문자, 띄어쓰기 없이)으로 바꿔도 됩니다.

숙제와 체크리스트

claude --version으로 버전 번호를 확인했다
로그인하고 첫 질문에 답을 받았다
Esc로 중단, /exit로 종료하는 법을 해 봤다
요금 페이지를 직접 열어 보고 내 플랜을 정했다
개발 서버는 내가 직접 실행한다는 규칙을 기억한다
내가 만들고 싶은 서비스를 한 문장으로 적었다(2강에서 사용)

다음 강의

2강에서는 클로드에게 인터뷰를 받아 아이디어를 한 장짜리 설계서(docs/prd.md)로 만듭니다.