목차
Claude Code란 무엇인가
바이브 코딩(Vibe Coding)의 핵심 도구 중 하나인 Claude Code는 Anthropic이 만든 터미널 기반 AI 코딩 에이전트다. 일반 AI 챗봇과 결정적으로 다른 점이 있다. 단순히 코드를 “제안”하는 것이 아니라, 직접 파일을 읽고, 수정하고, 명령어를 실행하고, 결과를 확인한다. 쉽게 말해 당신 옆에 시니어 개발자가 앉아서 실제로 코드를 짜주는 것과 같다.
비전공자 입장에서 가장 중요한 것은 이것이다: 코드를 몰라도 된다. 원하는 것을 한국어로 설명하면, Claude Code가 코드를 작성하고, 실행하고, 오류가 나면 스스로 고친다. 당신이 할 일은 방향을 잡아주는 것뿐이다.
2026년 현재 Claude Code는 claude-3-7-sonnet, claude-opus-4 등의 모델을 지원하며, 실제 업무 자동화, 데이터 처리, 웹 스크래핑, 문서 생성 등 다양한 분야에서 활용되고 있다. 특히 코딩 경험이 전혀 없는 직장인들이 반복 업무를 자동화하는 용도로 빠르게 확산 중이다.
설치와 첫 실행 – 10분이면 충분
필요한 것
- 컴퓨터 (Windows / Mac / Linux 모두 가능)
- Anthropic API 키 (console.anthropic.com에서 발급)
- Node.js 18 이상 (nodejs.org에서 무료 다운로드)
설치 방법
터미널(명령 프롬프트)을 열고 다음 명령어를 입력한다:
npm install -g @anthropic-ai/claude-code설치가 완료되면 API 키를 환경변수로 설정한다.
Mac / Linux의 경우:
export ANTHROPIC_API_KEY="sk-ant-여기에당신의키를입력"Windows (PowerShell)의 경우:
$env:ANTHROPIC_API_KEY="sk-ant-여기에당신의키를입력"이제 작업할 폴더로 이동해서 Claude Code를 실행한다:
mkdir my-first-project
cd my-first-project
claude이 명령어를 실행하면 대화형 인터페이스가 열린다. 여기서 한국어로 자유롭게 원하는 것을 말하면 된다.
첫 번째 대화 시도하기
Claude Code 인터페이스에서 다음과 같이 입력해보자:
현재 폴더에 test.txt 파일을 만들고, "안녕하세요 Claude Code입니다"라고 적어줘Claude Code는 즉시 파일을 생성하고 결과를 보여준다. 처음 실행했을 때 이 단순한 동작이 얼마나 강력한 것인지 체감하게 된다. 코드를 한 줄도 이해하지 못해도 원하는 결과가 나온다는 것, 그것이 바이브 코딩의 출발점이다.
첫 번째 프로젝트: 파일 정리 자동화 스크립트
비전공자가 가장 많이 활용하는 케이스부터 시작하자. 바탕화면이나 다운로드 폴더에 파일이 뒤섞여 있을 때, 확장자별로 자동 정리하는 스크립트를 만드는 것이다. 이 작업을 수작업으로 하면 30분이 걸리지만, Claude Code와 함께하면 5분 만에 영구적인 자동화 도구가 생긴다.
Claude Code에게 요청하는 방법
다운로드 폴더에 있는 파일들을 자동으로 정리하는 파이썬 스크립트를 만들어줘.
- 이미지 파일(jpg, png, gif, webp)은 "이미지" 폴더로
- 문서 파일(pdf, docx, xlsx, pptx)은 "문서" 폴더로
- 영상 파일(mp4, mov, avi)은 "영상" 폴더로
- 나머지는 "기타" 폴더로 이동시켜줘
- 같은 이름 파일이 있으면 덮어쓰지 말고 숫자를 붙여줘Claude Code가 생성하는 스크립트는 대략 이런 형태다:
import os
import shutil
from pathlib import Path
def organize_files(target_dir):
categories = {
'이미지': ['.jpg', '.jpeg', '.png', '.gif', '.webp'],
'문서': ['.pdf', '.docx', '.xlsx', '.pptx', '.hwp'],
'영상': ['.mp4', '.mov', '.avi', '.mkv'],
'기타': []
}
target = Path(target_dir)
for file in target.iterdir():
if file.is_file():
moved = False
for folder, extensions in categories.items():
if file.suffix.lower() in extensions:
dest_folder = target / folder
dest_folder.mkdir(exist_ok=True)
dest = dest_folder / file.name
counter = 1
while dest.exists():
dest = dest_folder / f"{file.stem}_{counter}{file.suffix}"
counter += 1
shutil.move(str(file), str(dest))
moved = True
break
if not moved:
dest_folder = target / '기타'
dest_folder.mkdir(exist_ok=True)
shutil.move(str(file), str(dest_folder / file.name))
print("파일 정리 완료!")
organize_files(os.path.expanduser("~/Downloads"))이 코드를 이해하지 못해도 된다. 중요한 것은 실행했을 때 원하는 결과가 나오느냐다. Claude Code에게 “방금 만든 스크립트 실행해줘”라고 하면 직접 실행까지 해준다. 오류가 나면? 그냥 “오류 났어”라고 말하면 된다. Claude Code가 알아서 원인을 찾아 고쳐준다.
스크립트를 더 스마트하게 만들기
기본 스크립트가 작동하면 이렇게 추가 요청을 해보자:
정리한 파일 목록을 날짜별로 log.txt에 기록해줘.
그리고 정리 전에 "X개 파일을 정리하려고 합니다. 계속할까요?" 라고 물어보게 해줘이런 식으로 대화를 이어가면서 스크립트를 점점 고도화할 수 있다. 코드를 배우는 것이 아니라, 원하는 것을 정확히 말하는 능력을 키우는 것이 바이브 코딩의 핵심 역량이다.
실전 심화: CSV 데이터 처리 자동화
조금 더 실용적인 예제로 넘어가자. 엑셀에서 내보낸 CSV 파일을 분석하고 보고서를 자동으로 만드는 것이다. 이것은 사무직 비전공자에게 특히 유용하다. 매월 똑같은 데이터 정리 작업을 하고 있다면, 한 번만 Claude Code와 함께 자동화 스크립트를 만들어두면 앞으로는 클릭 한 번으로 끝낼 수 있다.
시나리오 설정
월별 매출 데이터가 담긴 CSV 파일이 있다고 가정하자. 날짜, 상품명, 수량, 단가, 합계 컬럼으로 구성된 데이터에서 월별 합계, 최고 판매 상품, 일별 평균 매출을 계산하고 텍스트 보고서로 저장하는 작업이다.
Claude Code에게 요청하기
sales_data.csv 파일이 있어.
컬럼은 날짜, 상품명, 수량, 단가, 합계야.
이 파일을 읽어서:
1. 월별 총 매출 합계
2. 가장 많이 팔린 상품 TOP 5
3. 일별 평균 매출
를 계산해서 sales_report.txt로 저장해줘Claude Code는 pandas 라이브러리를 활용해 데이터를 처리하는 코드를 작성한다:
import pandas as pd
from datetime import datetime
df = pd.read_csv('sales_data.csv', encoding='utf-8-sig')
df['날짜'] = pd.to_datetime(df['날짜'])
df['월'] = df['날짜'].dt.to_period('M')
monthly_sales = df.groupby('월')['합계'].sum()
top_products = df.groupby('상품명')['수량'].sum().nlargest(5)
daily_avg = df.groupby('날짜')['합계'].sum().mean()
report = []
report.append("=== 매출 분석 보고서 ===")
report.append(f"생성일: {datetime.now().strftime('%Y-%m-%d')}")
report.append("")
report.append("[ 월별 매출 합계 ]")
for month, sales in monthly_sales.items():
report.append(f" {month}: {sales:,.0f}원")
report.append("")
report.append("[ 판매 상위 상품 TOP 5 ]")
for i, (product, qty) in enumerate(top_products.items(), 1):
report.append(f" {i}. {product}: {qty:,}개")
report.append("")
report.append("[ 일별 평균 매출 ]")
report.append(f" {daily_avg:,.0f}원")
with open('sales_report.txt', 'w', encoding='utf-8') as f:
f.write('
'.join(report))
print("보고서 생성 완료: sales_report.txt")오류가 났을 때 대처법
pandas가 설치되지 않았다는 오류가 날 수 있다. 이때 Claude Code에게 그냥 이렇게 말하면 된다:
pandas 없다고 오류 났어. 해결해줘Claude Code는 자동으로 pip install pandas를 실행하고 다시 시도한다. 비전공자가 오류 메시지를 이해하지 못해도 Claude Code가 알아서 해결한다는 것이 핵심이다. 오류를 무서워하지 말 것. 오류는 Claude Code가 더 정확한 답을 찾아가는 과정일 뿐이다.
자주 묻는 질문 Q&A
Q. 코딩을 전혀 모르는데 Claude Code를 쓸 수 있나요?
A. 충분히 가능하다. 실제로 바이브 코딩의 핵심 철학이 “코드 문법보다 원하는 결과를 명확히 말하는 능력”을 더 중시한다는 것이다. 다만 기본적인 컴퓨터 사용 능력과 터미널 창을 여는 것에 두려움이 없어야 한다. 이 부분은 한 번만 해보면 금방 익숙해진다. 미래이음연구소의 바이브 코딩 입문 강의는 터미널을 처음 여는 단계부터 시작한다.
Q. 비용은 얼마나 드나요?
A. Anthropic API 사용량에 따라 과금된다. 일반적인 학습과 개인 프로젝트 수준에서는 월 5~20달러 수준으로 충분하다. claude.ai Pro 구독(월 20달러)을 이용하면 Claude Code를 포함해 더 많은 기능을 활용할 수 있다. 처음에는 소액으로 시작해서 사용 패턴을 파악한 뒤 조정하는 것을 권장한다.
Q. 제 컴퓨터 파일이 외부 서버로 올라가나요?
A. Claude Code가 파일을 읽을 때 해당 내용이 API 요청에 포함되어 Anthropic 서버로 전송된다. 민감한 개인정보나 회사 기밀이 담긴 파일은 사용 전에 반드시 확인이 필요하다. Anthropic의 API 이용약관에 따르면 API 사용자의 데이터는 모델 학습에 사용하지 않는다고 명시되어 있다. 업무용으로 사용 전 소속 기관의 데이터 정책을 먼저 확인하자.
Q. Windows에서도 잘 작동하나요?
A. 작동한다. 다만 Windows는 WSL2(Windows Subsystem for Linux)를 설치하면 훨씬 안정적으로 사용할 수 있다. Mac이나 Linux 환경이 더 원활한 것은 사실이지만, Windows에서도 기본 기능은 모두 동작한다. WSL2 설치 방법도 Claude Code에게 물어보면 단계별로 안내해준다.
Q. AntiGravity와 Claude Code의 차이점은 무엇인가요?
A. Claude Code는 터미널 기반의 범용 AI 코딩 에이전트다. 어떤 언어, 어떤 프로젝트에도 사용할 수 있다. AntiGravity는 바이브 코딩을 위해 특화된 GUI 기반 도구로, 코드 없이 앱을 만드는 데 최적화되어 있다. 둘 다 바이브 코딩 생태계의 핵심 도구지만 용도와 인터페이스가 다르다. 처음 시작한다면 Claude Code로 시작해서 흥미가 생기면 AntiGravity로 확장하는 것을 권장한다.
Q. 만든 스크립트를 다른 컴퓨터에서도 쓸 수 있나요?
A. 가능하다. Python 스크립트는 파일 하나로 이루어져 있어서 USB나 이메일로 전달해서 쓸 수 있다. 단, 상대방 컴퓨터에도 Python과 필요한 라이브러리가 설치되어 있어야 한다. Claude Code에게 “다른 컴퓨터에서도 바로 실행할 수 있게 설치 안내 파일도 만들어줘”라고 하면 README.txt까지 작성해준다.
오늘 5분 실습
지금 바로 해볼 수 있는 실습이다. 터미널을 열고 Claude Code를 실행한 뒤 다음을 그대로 입력해보자:
오늘 날짜와 시간을 출력하고, 내가 이 명령을 실행한 횟수를 count.txt 파일에 기록해주는 파이썬 스크립트를 만들어줘. 파일이 없으면 새로 만들고, 있으면 숫자를 1 올려줘.5분 안에 작동하는 스크립트가 완성된다. 이것이 바이브 코딩의 시작이다. 복잡한 문법을 외울 필요 없이, 원하는 것을 말로 설명하면 된다.
다음 단계로 넘어가고 싶다면 이렇게 이어서 요청해보자:
방금 만든 스크립트를 실행할 때마다 실행 날짜, 시간, 횟수를 log.csv 파일에도 기록해줘. 나중에 엑셀로 볼 수 있게.Claude Code가 기존 스크립트를 수정해서 CSV 로깅 기능까지 추가해준다. 이렇게 대화를 이어가면서 기능을 추가하는 방식이 바이브 코딩의 실제 작업 흐름이다.
미래이음연구소 바이브 코딩 교육
이신우 소장이 이끄는 미래이음연구소에서 Claude Code, AntiGravity 등 최신 바이브 코딩 도구 실전 강의를 진행합니다.
강의 문의: 010-3343-4000 | lab.duonedu.net
마무리
Claude Code는 비전공자가 처음 접할 때 가장 진입 장벽이 낮은 AI 코딩 도구 중 하나다. 설치부터 첫 프로젝트 완성까지 30분이면 충분하다. 오늘 소개한 파일 정리 자동화와 CSV 처리는 실제 업무에서 즉시 활용 가능한 예제들이다.
바이브 코딩은 단순히 코드를 빠르게 짜는 방법이 아니다. 아이디어를 현실로 만드는 과정에서 기술적 장벽을 제거하는 새로운 패러다임이다. 누구나 개발자처럼 생각하고 실행할 수 있는 시대가 열리고 있다. 중요한 것은 완벽한 코드가 아니라, 일단 시작하는 것이다.
더 많은 바이브 코딩 실습 콘텐츠와 교육 프로그램은 두온교육(main.duonedu.net)과 미래이음연구소(lab.duonedu.net)에서 확인할 수 있다.
