ChanghyukBan코딩 1도 몰라도 OK,
AI로 주식 분석 프로그램 만들기
비개발자를 위한 바이브코딩 완전정복 가이드
💡 이 글을 읽고 나면 만들 수 있는 것
종목 코드(예: 005930 삼성전자)를 입력하면 자동으로 재무제표와 주가 차트를 보여주고, AI가 "이 회사 요즘 어때?"를 분석해주는 나만의 주식 분석 프로그램
0단계. 바이브코딩이 뭔가요?
바이브코딩(Vibe Coding)은 OpenAI 공동창업자 안드레이 카파시(Andrej Karpathy)가 만든 용어입니다. 한 줄로 정리하면 이렇습니다.
"코드를 직접 타이핑하지 않고, AI에게 '이런 거 만들어줘'라고 자연어로 말하면 AI가 코드를 짜주는 방식"
즉, 나는 사장님이고 AI는 개발자입니다. 사장님은 "이런 기능 넣어주세요"라고 말하고, AI가 코드를 작성합니다. 비개발자가 진짜 프로그램을 만들 수 있게 된 패러다임입니다.
중요한 건 마인드셋입니다.
- ❌ "내가 코딩을 배워야 한다"
- ✅ "내가 무엇을 만들고 싶은지 명확히 설명하고, AI 결과물을 검증한다"
1단계. 꼭 알아야 할 9가지 용어
외울 필요 없습니다. "아 이게 그거구나" 정도의 감만 잡으시면 됩니다.
① API
외부 서비스에서 데이터를 가져오는 "창구". 식당 메뉴판처럼, "삼성전자 재무제표 주세요" 하면 데이터를 돌려줍니다.
② API Key
API를 사용하기 위한 "출입증". 대부분 무료지만 발급받아야 합니다.
③ JSON
API가 데이터를 돌려줄 때 쓰는 형식. {"매출액": "300조", "영업이익": "50조"} 같은 모양.
④ 프론트엔드 / 백엔드
프론트엔드 = 사용자가 보는 화면(차트·버튼). 백엔드 = 뒤에서 데이터 가져오고 계산하는 부분.
⑤ 라이브러리 / 패키지
남이 미리 만들어둔 기능 묶음. 차트 그리는 라이브러리, 데이터 다루는 라이브러리 등을 가져다 씁니다.
⑥ 터미널 (Terminal)
검은 화면에 명령어를 입력하는 곳. "이 프로그램 실행해줘"를 글자로 입력합니다.
⑦ Git / GitHub
코드 저장소. 게임의 "세이브" 기능처럼 작업 중간중간 저장하고 되돌릴 수 있습니다.
⑧ .env 파일 (환경변수)
API Key 같은 비밀 정보를 코드와 분리해서 보관하는 파일. 코드에 직접 적으면 유출 위험.
⑨ localhost
내 컴퓨터 안에서만 도는 임시 인터넷 주소. localhost:3000 처럼 사용합니다.
2단계. 필요한 툴 4가지 설치
단 4개만 설치하면 모든 준비가 끝납니다.
② Claude (또는 Claude Code)
바이브코딩의 엔진. Claude.ai 웹은 대화형, Claude Code는 터미널에서 Claude가 직접 파일을 읽고 수정합니다. 비개발자에게는 Claude Code가 훨씬 강력합니다.
3단계. 무엇을 만들지 명확히 정하기
⚠️ 비개발자가 가장 많이 실패하는 지점
"그냥 만들어줘" 한 마디로 AI에게 던지는 것. 무엇을 만들지 먼저 종이에 적어야 합니다.
우리가 만들 프로그램의 명세를 구체적으로 정합니다.
📋 프로그램 명세서
- 입력: 종목 코드 (예: 005930)
- 데이터: DART API → 최근 3년 재무제표 / yfinance → 3년 주가
- 화면: 좌측 재무제표 막대그래프, 우측 주가 라인차트
- AI 분석: 차트 아래 "AI 분석 코멘트" 박스 자동 생성
- 기술 스택: FastAPI(백엔드) + React+Vite(프론트엔드) + Claude API
4단계. API Key 3개 발급받기
데이터를 가져올 "출입증"을 미리 받아둡니다.
| 서비스 | 용도 | 비용 |
|---|---|---|
| DART OpenAPI opendart.fss.or.kr |
재무제표 | 무료 |
| yfinance 파이썬 라이브러리 |
주가 데이터 | 무료(키 불필요) |
| Claude API console.anthropic.com |
AI 분석 | 사용량 과금 |
발급받은 키들은 모두 .env 파일에 저장합니다. 코드에 직접 적으면 안 됩니다.
5단계. Claude에게 프로젝트 골격 만들게 하기
바이브코딩의 진짜 시작입니다. VS Code 터미널을 열고 Claude Code를 실행한 뒤, 아래처럼 말합니다.
Claude가 알아서 폴더 구조, 필요한 파일, 패키지 설치 명령어까지 다 만들어줍니다. 여러분이 할 일은 Claude가 보여주는 명령어를 복사해서 터미널에 붙여넣고 엔터를 치는 것뿐입니다.
6단계. 백엔드: 재무제표 가져오기
Claude에게 작게 작게 시킵니다. 한 번에 다 시키면 오류 발생 시 어디가 문제인지 모릅니다.
6-1. 재무제표 API 만들기
"DART API에서 종목코드를 받아 최근 3년 사업보고서 재무제표를 가져오는 FastAPI 엔드포인트 /api/financials/{stock_code}를 만들어줘."
6-2. 응답 정리
"응답은 연도별 매출액·영업이익·당기순이익·영업이익률을 JSON으로 정리해줘."
6-3. 주가 API 추가
"yfinance로 주가 3년치를 가져오는 /api/price/{stock_code} 엔드포인트도 추가해줘."
✅ 비개발자 검증 포인트
백엔드를 실행하고 브라우저에서 http://localhost:8000/docs에 접속하면 FastAPI가 자동으로 만들어준 테스트 화면이 뜹니다. 005930 입력 후 실행 → 데이터가 잘 나오면 성공.
7단계. 프론트엔드: 차트 화면 만들기
백엔드가 잘 작동하면 이제 사용자가 보는 화면을 만듭니다.
7-1. 데이터 가져오기
"백엔드 두 API를 호출해서 데이터를 가져오는 React 컴포넌트를 만들어줘. 종목코드 입력란과 조회 버튼이 있고, 결과는 Recharts로 그려줘."
7-2. 차트 디자인
"재무제표는 막대그래프, 주가는 라인그래프로 그리고, 둘을 좌우로 나란히 배치해줘."
7-3. 스타일
"전체 디자인을 깔끔한 모던 스타일로 만들어줘. 메인 컬러는 주황색(#c2410c) 계열."
8단계. AI 분석 코멘트 붙이기
단순 차트 앱과 차별화되는 핵심 단계입니다.
8-1. AI 분석 API 추가
"/api/analyze/{stock_code} 엔드포인트를 만들어줘. 재무제표와 주가 데이터를 Claude API에 보내서 '이 종목의 재무 상태와 주가 흐름을 3줄로 분석해줘'라고 요청한 결과를 반환해줘."
8-2. 프론트엔드 표시
"차트 아래에 'AI 분석' 박스를 만들어 결과를 표시해줘."
💡 프롬프트가 결과 퀄리티를 결정합니다. "3줄로 분석"보다 "1) 매출 성장세 2) 수익성 변화 3) 주가 흐름 코멘트, 각각 한 문장씩"처럼 구체적으로 시킬수록 좋은 답이 나옵니다.
9단계. 검증 — 가장 중요한 단계
⚠️ 바이브코딩의 함정
AI가 짠 코드가 작동하는 것처럼 보여도 틀린 경우가 많습니다. 카파시 본인도 "바이브코딩은 일회성 주말 프로젝트에 적합"이라고 했습니다. 검증은 무조건 사람이 해야 합니다.
비개발자도 할 수 있는 검증 체크리스트:
- 삼성전자 매출이 약 300조 근처로 나오는가? (말도 안 되는 숫자면 단위 오류)
- 영업이익률 = (영업이익 ÷ 매출) × 100, 직접 계산해서 일치하는가?
- 작년 주가가 네이버 금융과 비슷한가?
- 오류 메시지가 뜨면 → 그대로 복사해서 Claude에게 "이 에러 고쳐줘"
10단계. 배포 (선택)
친구나 가족도 사용할 수 있게 인터넷에 올리는 단계입니다. 안 해도 됩니다.
- Vercel — 프론트엔드 무료 배포. GitHub 연동하면 자동 배포.
- Railway — 백엔드 배포. FastAPI 그대로 올라갑니다.
마무리: 성공의 두 가지 조건
비개발자 바이브코딩이 성공하는 사람과 실패하는 사람의 차이는 딱 두 가지입니다.
① 무엇을 만들지 명확히 정의했는가 (3단계가 그래서 중요)
② AI 결과물을 검증할 도메인 지식이 있는가 (9단계가 그래서 중요)
주식과 재무제표를 이미 아는 분이라면 검증은 자연스럽게 됩니다. 명세서 한 장 작성하고 시작하면 1~2주 안에 MVP가 나옵니다.
코딩을 못해도 괜찮습니다. 지금 시대의 진짜 무기는 "명확하게 설명하는 능력"과 "결과를 검증하는 안목"이니까요.
📌 이번 주말 미션
2단계의 4가지 툴 설치 + 4단계의 DART API Key 발급까지만 끝내세요. 다음 주에는 본격 코드를 짭니다.
ATOZAI · 실전 구축기