클로드코드(Claude Code)로 주식 분석 웹 서비스 만들기 : #1. 계획 세우기

Claude Code 활용 프로젝트 #1

만년 마이너스 주식러의
AI 주식 분석기 도전기

비전공자 공정 엔지니어의 Claude Code 실전 연습

Claude Code 활용 연습을 위해 실생활에서 진짜 쓸 수 있는 무언가를 만들어보자고 결심했다.

고민 끝에 내린 첫 번째 과제는 바로 — 주식 분석 웹 서비스 만들기!

주식 투자 경력 10년의 만년 마이너스 손을, 과연 프로그램으로 황금손으로 탈바꿈할 수 있을까? 🤔

🏗️ 1단계 — 구조부터 잡고 가자

나는 비전공자 공정 엔지니어다. 코딩에 앞서 만들고자 하는 프로그램의 구성부터 짚고 넘어가기로 했다.

📌 주식 분석기 아키텍처 이미지

FRONTEND

Next.js + TailwindCSS

기존에 알던 JS+HTML 대신, 요즘 핫하다는 이걸로. 딱히 특별한 이유는 없다. 많이 쓰는 게 좋겠지 라는 기대감으로 선택.

BACKEND

Python + FastAPI

나중에 통계 분석이나 AI 모델을 붙여볼 수 있지 않을까? 라는 생각에 Python 선택!

API

키움증권 OpenAPI

보유 중인 주식 계좌 중 선택. 신청 즉시 승인되어 진입 장벽이 낮음.

DATABASE

PostgreSQL

무료로 사용 가능하다는 이유 하나로 선택. 이보다 더 현실적인 이유가 있을까.

🔑 2단계 — 키움증권 API 신청

구조를 잡고 나니 오히려 뭐부터 해야 할지 더 막막해졌다. 일단 키움증권 API 사용 신청부터 시작하기로 했다.

📎 키움증권 OpenAPI 홈페이지

https://openapi.kiwoom.com/main/home

우측 상단 'API 사용신청' 클릭 → 신청 즉시 승인 완료. 과정이 너무 단순해서 오히려 당황스러울 수도 있다.

💡

API 항목이 너무 많아서 겁먹지 말 것!

다운로드하면 내용이 엄청 많지만, 읽을 필요 없다. 내가 무엇을 구현하고 싶은지만 생각하면 된다. 어떤 API를 어떻게 쓸지는 Claude가 알아서 해준다.

🎯 3단계 — 뭘 만들 것인가

기능 목표를 먼저 정하는 것이 핵심이다. 구현 방법은 Claude에게 맡기면 되니까.

V 1.0 — 구현 목표

1

실시간 조회 순위

2

외국인 매매 상위 리스트

3

기관 매매 상위 리스트

★

1~3번 모두 해당하는 종목 Top 10 →
분봉 기준 매수 추천 리스트 자동 생성

추가 기능은 일단 나중에 — 지금은 Claude Code 연습이 목적이니까. 😄

다음 편 예고

PRD 작성 — 실제 개발을 위한 설계도 그리기

만년 마이너스 탈출 프로젝트는 계속된다 →

클로드코드(Claude Code)로 주식 분석 웹 서비스 만들기 : #2. PRD, 개발계획서 작성하기