Claude Code로 나만의 챗봇 만들기 — 비전공자 완전 정복 가이드

코드를 전혀 모르는 비전공자도 Claude Code 하나로 실제 동작하는 챗봇을 만들 수 있습니다. 이 글에서는 터미널 명령어부터 API 연동, 파일 저장까지 단계별로 실습합니다. 명령어를 그대로 따라 입력하면 오늘 안에 나만의 챗봇이 완성됩니다.

목차

1. Claude Code란 무엇인가
2. 개발 환경 설정 — 10분 안에 끝내기
3. 첫 번째 챗봇 만들기 실전 실습
4. 챗봇 기능 확장하기
5. 자주 묻는 질문
6. 오늘 바로 시작하는 5분 실습

Claude Code란 무엇인가

Claude Code는 Anthropic이 만든 AI 코딩 도구입니다. 터미널 안에서 대화하듯 지시하면 AI가 코드를 직접 작성하고 실행합니다. 기존 코딩 교육처럼 문법을 외울 필요가 없습니다. “파이썬 파일을 하나 만들어서 안녕하세요를 출력해줘”라고 입력하면 Claude가 코드를 작성하고 즉시 실행합니다.

바이브 코딩(Vibe Coding)은 이 방식을 극단까지 밀어붙입니다. 개발자처럼 코드 한 줄 한 줄 이해하려 애쓰지 않고, 원하는 결과를 자연어로 설명해서 AI가 생성한 코드를 검증하고 배포합니다. 2025년 기준 Claude Code를 사용하는 팀의 평균 개발 속도는 기존 대비 3~5배 빨라졌다는 보고가 있습니다.

바이브 코딩이 비전공자에게 유리한 이유

• 문법 암기 없이 결과물 중심으로 개발
• 에러 메시지를 그대로 AI에게 붙여넣어 해결
• 아이디어에서 프로토타입까지 시간이 기존의 10분의 1
• 코드 리뷰, 리팩토링도 대화로 처리

개발 환경 설정 — 10분 안에 끝내기

Claude Code를 시작하려면 Node.js와 Claude Code CLI가 필요합니다. 아래 명령어를 순서대로 실행하세요. Mac과 Windows(WSL) 모두 동일합니다.

1단계: Node.js 설치 확인

node --version
# 출력 예: v20.11.0 (18 이상이면 OK)

npm --version
# 출력 예: 10.2.4

Node.js가 없으면 nodejs.org에서 LTS 버전을 내려받아 설치합니다. 설치 후 터미널을 재시작하고 위 명령어로 확인합니다.

2단계: Claude Code 설치

npm install -g @anthropic-ai/claude-code

설치가 완료되면 claude 명령어를 입력해서 로그인합니다.

claude
# 처음 실행 시 Anthropic 계정 로그인 안내가 표시됩니다
# 브라우저에서 승인하면 자동으로 API 키가 등록됩니다

3단계: 작업 폴더 만들기

mkdir my-chatbot
cd my-chatbot
claude

이제 Claude Code가 이 폴더 안에서 파일을 만들고 수정합니다. 폴더 이름은 원하는 대로 변경할 수 있습니다.

첫 번째 챗봇 만들기 실전 실습

Claude Code 터미널에서 대화하듯 지시하면 됩니다. 아래는 실제 챗봇을 만드는 과정입니다. Claude Code 프롬프트(>) 뒤에 다음 내용을 입력합니다.

챗봇 기본 뼈대 생성

> 파이썬으로 간단한 콘솔 챗봇을 만들어줘.
  사용자가 질문을 입력하면 미리 설정한 답변 목록에서
  키워드를 찾아 응답하는 방식으로 해줘.
  기본 질문 5가지와 답변을 포함하고,
  모르는 질문에는 죄송합니다 라고 응답해줘.

Claude가 자동으로 chatbot.py 파일을 생성합니다. 생성된 코드 예시:

responses = {
    "안녕": "안녕하세요! 무엇을 도와드릴까요?",
    "시간": "현재 시간은 시스템에서 확인해 주세요.",
    "가격": "가격은 main.duonedu.net에서 확인하실 수 있습니다.",
    "주소": "서울시 강남구에 위치합니다.",
    "전화": "010-3343-4000으로 문의해 주세요."
}

def get_response(user_input):
    for keyword, response in responses.items():
        if keyword in user_input:
            return response
    return "죄송합니다, 담당자에게 문의해 주세요."

while True:
    user_input = input("질문: ")
    if user_input == "종료":
        break
    print("챗봇:", get_response(user_input))

챗봇 실행 및 테스트

> 방금 만든 chatbot.py를 실행해줘

Claude Code가 직접 실행합니다. 실행 결과 예시:

질문: 안녕
챗봇: 안녕하세요! 무엇을 도와드릴까요?

질문: 가격 알려줘
챗봇: 가격은 main.duonedu.net에서 확인하실 수 있습니다.

질문: 뭐하니
챗봇: 죄송합니다, 담당자에게 문의해 주세요.

이 시점에서 이미 실제로 동작하는 챗봇이 완성됐습니다. 코드를 직접 작성한 줄은 0줄입니다.

챗봇 기능 확장하기

기본 챗봇에 기능을 추가합니다. Claude Code 대화창에 이어서 입력합니다.

대화 기록 저장 기능 추가

> chatbot.py에 대화 내용을 날짜별로 log.txt에 저장하는 기능을 추가해줘.
  저장 형식은 날짜 시간 | 질문: xxx | 답변: xxx 형태로 해줘.

Claude가 파일 입출력 코드를 자동으로 추가합니다. 저장된 log.txt 예시:

2025-03-06 13:05 | 질문: 안녕 | 답변: 안녕하세요! 무엇을 도와드릴까요?
2025-03-06 13:06 | 질문: 가격 알려줘 | 답변: 가격은 main.duonedu.net에서 확인하실 수 있습니다.

웹 인터페이스로 업그레이드

> 이 챗봇을 웹 브라우저에서 사용할 수 있게 Flask로 바꿔줘.
  챗봇 화면은 흰색 배경에 말풍선 형태로 만들어줘.
  포트는 5000번으로 해줘.

Claude가 app.py와 HTML 템플릿을 생성합니다. 이어서 실행을 요청합니다:

> 필요한 패키지 설치하고 app.py 실행해줘

터미널에 다음이 출력되면 성공:

* Running on http://127.0.0.1:5000
* Press CTRL+C to quit

브라우저에서 http://localhost:5000을 열면 나만의 웹 챗봇이 완성됩니다. 전체 과정에 걸린 시간은 약 15분입니다.

자주 발생하는 에러 처리 방법

에러가 발생하면 에러 메시지 전체를 복사해서 Claude에게 붙여넣습니다:

> 이런 에러가 났어:
  ModuleNotFoundError: No module named flask
  어떻게 고쳐?

Claude가 즉시 해결책을 제시하고 명령어를 실행합니다. 에러를 직접 이해할 필요가 없습니다.

자주 묻는 질문

Q. 파이썬을 전혀 모르는데 이 방법으로 실제 서비스를 만들 수 있나요?

A. 가능합니다. 다만 서비스 규모가 커질수록 기본 개념을 알면 Claude에게 더 정확하게 지시할 수 있습니다. 미래이음연구소의 바이브 코딩 강의는 코딩 지식 없이 서비스를 만드는 방법을 실전 중심으로 가르칩니다.

Q. Claude Code는 유료인가요?

A. Claude Code 자체는 무료로 설치할 수 있지만, Anthropic API 사용량에 따라 비용이 발생합니다. 개인 학습 및 소규모 프로젝트 수준에서는 월 5~10달러 수준입니다. Claude Pro 구독($20/월)을 사용하면 별도 API 키 없이 Claude Code를 사용할 수 있습니다.

Q. 만든 챗봇을 다른 사람도 쓸 수 있게 배포하려면 어떻게 하나요?

A. Claude Code에 이 Flask 앱을 Railway 또는 Render에 무료로 배포하는 방법을 알려줘 라고 입력하면 단계별 안내를 받을 수 있습니다. Railway 기준 무료 플랜으로 월 500시간 실행이 가능합니다.

Q. 대화 내용이 Anthropic 서버에 저장되나요?

A. Anthropic의 공개 정책에 따르면 API를 통한 대화 내용은 모델 학습에 사용하지 않습니다. 민감한 업무 데이터는 기업용 API(Enterprise)를 사용하거나 로컬 모델을 검토하는 것을 권장합니다.

Q. 챗봇에 실제 AI 응답을 붙이고 싶어요

A. Claude Code에 Anthropic API를 연동해서 사용자 질문에 Claude가 직접 답변하는 챗봇으로 바꿔줘 라고 입력하면 됩니다. API 키는 console.anthropic.com에서 발급받을 수 있습니다.

오늘 바로 시작하는 5분 실습

1. node --version 명령어로 Node.js 설치 여부 확인
2. npm install -g @anthropic-ai/claude-code 실행
3. mkdir my-chatbot && cd my-chatbot && claude 실행
4. Claude Code 대화창에 파이썬으로 간단한 콘솔 챗봇을 만들어줘 입력
5. 생성된 파일을 Claude Code에 실행 요청 후 동작 확인

5분이면 첫 챗봇이 완성됩니다. 막히는 부분은 에러 메시지를 그대로 Claude에게 붙여넣으면 해결됩니다.

---

바이브 코딩은 코딩을 배우는 새로운 방법이 아닙니다. 아이디어를 빠르게 현실로 만드는 새로운 일하는 방식입니다. 두온교육(main.duonedu.net)에서는 AI 도구를 활용한 디지털 역량 교육을 진행하고 있으며, 미래이음연구소(lab.duonedu.net)에서는 Claude Code와 AntiGravity를 활용한 바이브 코딩 실전 강의를 제공합니다. 강의 문의는 010-3343-4000으로 연락 주세요.