비전공자도 할 수 있다: Claude Code 첫 실습 완전 가이드

Claude Code란 무엇인가

2025년을 기점으로 개발자들의 작업 방식이 근본적으로 바뀌고 있습니다. 그 중심에 있는 것이 바로 바이브 코딩(Vibe Coding)입니다. 바이브 코딩은 코드를 한 줄 한 줄 직접 타이핑하는 대신, AI에게 원하는 것을 자연어로 설명하고 AI가 코드를 생성하도록 하는 개발 방식입니다.

그리고 이 흐름의 중심에 Claude Code가 있습니다. Anthropic이 만든 Claude Code는 터미널(명령줄)에서 직접 실행하는 AI 코딩 에이전트입니다. 단순히 코드 조각을 생성하는 것을 넘어, 파일을 읽고 수정하고, 명령어를 실행하고, 오류를 스스로 디버깅하는 능력을 갖추고 있습니다.

비전공자 입장에서 보면 이런 질문이 생깁니다. “AI가 코드를 다 짜준다면, 나는 뭘 배워야 하나?” 정답은 간단합니다. 무엇을 만들고 싶은지 정확하게 설명하는 능력입니다. Claude Code 시대에는 프로그래밍 언어 문법보다 문제를 구조화하고 명확하게 전달하는 능력이 훨씬 더 중요합니다.

설치 및 환경 준비

Claude Code를 시작하기 위해 필요한 것은 세 가지입니다. Node.js 설치, npm을 통한 Claude Code 설치, 그리고 Anthropic API 키입니다. 하나씩 살펴보겠습니다.

Node.js 설치 확인

터미널을 열고 아래 명령어를 입력해 Node.js가 설치되어 있는지 확인합니다.

node --version

버전 번호(예: v18.0.0 이상)가 표시되면 이미 설치된 것입니다. 만약 설치되어 있지 않다면 nodejs.org에서 LTS 버전을 내려받아 설치합니다.

Claude Code 설치

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

설치가 완료되면 아래 명령어로 정상 설치를 확인합니다.

claude --version

API 키 설정

Anthropic 콘솔(console.anthropic.com)에서 API 키를 발급받은 뒤, 환경변수로 등록합니다.

Mac / Linux 사용자:

export ANTHROPIC_API_KEY="sk-ant-여기에키입력"

매번 입력하지 않으려면 홈 디렉토리의 .zshrc 또는 .bashrc 파일에 위 줄을 추가합니다.

echo 'export ANTHROPIC_API_KEY="sk-ant-여기에키입력"' >> ~/.zshrc
source ~/.zshrc

Windows 사용자는 시스템 환경변수 설정에서 ANTHROPIC_API_KEY를 추가합니다.

첫 번째 실습: 간단한 웹페이지 만들기

이제 실제로 Claude Code를 사용해봅시다. 빈 폴더를 하나 만들고 그 안에서 claude를 실행합니다.

mkdir my-first-vibe-project
cd my-first-vibe-project
claude

Claude Code가 실행되면 프롬프트 창이 뜹니다. 이제 자연어로 원하는 것을 입력하면 됩니다.

간단한 개인 소개 웹페이지를 만들어줘.
이름은 "김민준"이고, 직업은 "교육 컨텐츠 기획자"야.
취미는 독서와 여행이고, 연락처 섹션도 넣어줘.
디자인은 깔끔하고 모던하게, 배경은 흰색 기반으로 해줘.

Claude Code는 이 요청을 받아 index.html 파일을 자동으로 생성합니다. 생성된 파일을 브라우저로 열어보면 완성된 웹페이지를 확인할 수 있습니다.

수정 요청하기

생성된 결과가 마음에 들지 않으면 바로 추가 요청을 합니다.

헤더 배경색을 남색(#1a365d)으로 바꿔주고,
폰트는 Noto Sans KR로 변경해줘.
모바일에서도 잘 보이도록 반응형으로 수정해줘.

이것이 바이브 코딩의 핵심입니다. 코드를 직접 수정하는 것이 아니라, 원하는 변경사항을 대화하듯 전달하는 것입니다.

비전공자를 위한 핵심 프롬프트 작성법

Claude Code를 효과적으로 활용하려면 프롬프트 작성 요령을 익혀야 합니다. 비전공자가 가장 많이 실수하는 부분이 바로 모호한 요청입니다.

나쁜 프롬프트 vs 좋은 프롬프트

나쁜 예시:

웹사이트 만들어줘

좋은 예시:

학원 홈페이지를 만들어줘.
- 상단 네비게이션: 홈, 강의소개, 강사소개, 수강신청, 문의
- 메인 배너: "AI 시대, 나도 코딩할 수 있다" 문구와 수강신청 버튼
- 수강료: 월 99,000원
- 연락처: 010-1234-5678
- 색상 테마: 보라색과 흰색
- HTML, CSS, JavaScript로만 만들어줘 (프레임워크 없이)

구체적인 프롬프트 작성 4원칙

1. 목적을 명확히 — 무엇을 만들고 왜 필요한지 설명합니다.
2. 제약 조건 명시 — 사용할 기술, 금지 사항, 디자인 가이드를 적습니다.
3. 예시 제공 — “이런 느낌으로” 대신 참고 사이트 URL이나 구체적인 수치를 씁니다.
4. 단계적 요청 — 한 번에 모든 것을 요구하기보다 기능별로 나눠서 요청합니다.

오류 발생 시 대처법

Claude Code가 코드를 생성했는데 오류가 발생했을 때는 오류 메시지를 그대로 붙여넣으면 됩니다.

실행했더니 이런 오류가 났어:
TypeError: Cannot read properties of undefined (reading 'map')
    at App.js:45:23

어떻게 수정해야 해?

Claude Code는 오류를 분석하고 자동으로 해당 파일을 수정해줍니다.

실전 응용: 자동화 스크립트 만들기

웹페이지를 넘어 실제 업무에 활용할 수 있는 자동화 스크립트도 만들 수 있습니다. 예를 들어 엑셀 파일을 읽어서 데이터를 처리하는 Python 스크립트를 만들어보겠습니다.

Python 스크립트를 만들어줘.
- 기능: 현재 폴더의 모든 CSV 파일을 읽어서 하나로 합치기
- 합쳐진 파일은 merged_output.csv로 저장
- 중복된 행은 제거
- 완료 후 몇 개 파일을 처리했는지, 총 몇 행인지 출력
- 필요한 라이브러리 설치 명령어도 알려줘

Claude Code가 생성한 스크립트 예시:

import pandas as pd
import glob
import os

def merge_csv_files():
    csv_files = glob.glob('*.csv')
    
    if not csv_files:
        print("CSV 파일을 찾을 수 없습니다.")
        return
    
    dataframes = []
    for file in csv_files:
        df = pd.read_csv(file, encoding='utf-8-sig')
        dataframes.append(df)
        print(f"읽기 완료: {file} ({len(df)}행)")
    
    merged_df = pd.concat(dataframes, ignore_index=True)
    before_dedup = len(merged_df)
    merged_df = merged_df.drop_duplicates()
    after_dedup = len(merged_df)
    
    merged_df.to_csv('merged_output.csv', index=False, encoding='utf-8-sig')
    
    print(f"
처리 완료!")
    print(f"처리한 파일 수: {len(csv_files)}개")
    print(f"총 행 수: {after_dedup}행 (중복 {before_dedup - after_dedup}개 제거)")

if __name__ == "__main__":
    merge_csv_files()

이 스크립트를 실행하려면 먼저 라이브러리를 설치합니다.

pip install pandas

설치 후 스크립트를 실행합니다.

python merge_csv.py

이처럼 반복적이고 시간이 걸리는 작업을 Claude Code를 통해 몇 분 만에 자동화할 수 있습니다. 프로그래밍 경험이 없어도 됩니다. 원하는 기능을 명확하게 설명할 수 있으면 충분합니다.

자주 묻는 질문 (Q&A)

Q. 프로그래밍을 전혀 모르는데 Claude Code를 쓸 수 있나요?
A. 네, 가능합니다. 다만 기본 개념(파일, 폴더, 터미널이 무엇인지)은 알아두면 더 원활하게 사용할 수 있습니다. Claude Code가 코드를 생성하더라도, 어디에 파일을 저장하고 어떻게 실행하는지 정도는 이해해야 합니다.

Q. API 비용이 많이 드나요?
A. Claude Sonnet 기준으로 입력 토큰 1M당 약 3달러, 출력 1M당 약 15달러입니다. 개인 프로젝트 수준이라면 월 1~5달러 내외로 사용할 수 있습니다. 처음에는 소량의 크레딧으로 시작해보는 것을 권장합니다.

Q. Claude Code와 ChatGPT의 차이는 무엇인가요?
A. ChatGPT는 대화창에서 코드를 알려주는 방식이지만, Claude Code는 실제 터미널에서 파일을 직접 생성하고 수정하며 명령어를 실행합니다. 즉, ChatGPT는 “조언자”이고 Claude Code는 “실행자”입니다. 작업의 연속성과 실제 파일 조작 능력에서 차이가 큽니다.

Q. 만든 코드를 안전하게 믿을 수 있나요?
A. AI가 생성한 코드는 반드시 검토해야 합니다. 특히 서버나 데이터베이스를 다루는 코드, 외부 API 호출 코드는 실행 전에 무엇을 하는지 Claude Code에게 설명을 요청하는 것이 좋습니다. “이 코드가 정확히 무엇을 하는지 한국어로 설명해줘”라고 물어보면 됩니다.

Q. 회사 프로젝트에도 사용해도 되나요?
A. 민감한 데이터나 소스코드가 포함된 경우 주의가 필요합니다. Anthropic의 개인정보처리방침을 확인하고, 회사 보안 정책에 따라 판단하세요. 개인 학습용이나 사이드 프로젝트에는 자유롭게 활용할 수 있습니다.

Q. Claude Code가 실수를 하면 어떻게 되나요?
A. Claude Code는 중요한 파일을 삭제하거나 변경하기 전에 확인을 요청합니다. 하지만 만약의 경우를 대비해 작업 전에 항상 Git으로 변경 이력을 관리하거나 중요 파일을 백업해두는 습관을 들이세요.

오늘 5분 실습

나의 독서 기록을 관리하는 간단한 HTML 페이지를 만들어줘.
- 책 제목, 저자, 읽은 날짜, 별점(1-5), 한줄평을 입력할 수 있는 폼
- 입력한 기록이 아래 목록으로 표시됨
- 기록은 브라우저 localStorage에 저장해서 새로고침해도 유지
- 디자인은 깔끔하게, 색상은 자유롭게 선택해줘
- 파일 하나(index.html)로만 만들어줘

이 한 번의 프롬프트로 완전한 기능을 갖춘 독서 기록 앱이 완성됩니다. 결과물을 보고 마음에 들지 않는 부분을 추가로 요청하며 수정해보세요. 이것이 바이브 코딩의 실제 흐름입니다.

마무리

Claude Code는 비전공자에게 새로운 기회를 열어줍니다. 이제 코드를 배우는 것이 목표가 아니라, AI와 협력해 원하는 것을 만들어내는 능력이 핵심입니다. 중요한 것은 시작하는 것입니다. 오늘 소개한 5분 실습부터 바로 해보세요.

바이브 코딩과 AI 도구 활용에 대한 더 많은 실전 교육 콘텐츠는 두온교육(main.duonedu.net)에서 확인하세요. 미래이음연구소(lab.duonedu.net)에서는 소규모 실습 중심의 강의를 통해 여러분의 첫 바이브 코딩 프로젝트를 함께 완성해드립니다.