AI도 5번 틀렸다 - 그래도 KIS 관심종목 대시보드를 완성한 이유
아레테_Arete
2026.06.07
# [Claude Code] AI도 5번 틀렸다 — 그래도 KIS 관심종목 대시보드를 완성한 이유
## 📝 한줄 요약
코딩 없이 AI와 단 하루 만에 나만의 주식 관심종목 대시보드를 만들었다. AI가 같은 오류를 5번 반복했지만, 그 과정이 오히려 "AI를 어떻게 써야 하는가"를 가르쳐줬다.
**바쁘시면 이것만 읽어도 돼요:**
- Claude Code로 KIS 관심종목 모니터링 대시보드 제작, 휴대폰 홈 화면 앱으로 설치 가능
- AI가 배포 오류를 5번 반복 → AI는 100% 믿고 맡기는 도구가 아님을 깨달음
- 브라우저 보안 제약(CORS)은 서버리스 함수로 우회 — AI가 구조 설계부터 해결
- HTS/MTS 여러 앱 → 브라우저 탭 하나로 관심종목 전체 한눈에 확인
- 휴대폰 홈 화면에 아이콘까지 만들어 앱처럼 설치
- 핵심 교훈: AI가 막히면 접근 방식 자체를 바꿔달라고 요청하라
---
## 🎯 이런 분들께 도움돼요
- 주식 관심종목을 여러 앱 오가며 확인하는 게 번거로운 개인 투자자
- 코딩은 몰라도 나만의 편한 도구를 직접 만들어보고 싶은 분
- AI 코딩 도구를 써봤지만 오류가 나면 포기했던 분
---
## 😫 문제 상황 (Before)
주식 관심종목을 확인하려면 매번 HTS나 MTS 앱을 열어야 했다. 종목이 여러 개면 하나씩 검색하거나 여러 화면을 왔다갔다해야 했고, PC에서 보다가 휴대폰으로 이동하면 또 앱을 새로 열어야 했다.
"관심종목 전체를 한 화면에서 바로 볼 수 있는 나만의 페이지가 있으면 얼마나 편할까."
그 생각을 오래 했지만 코딩을 몰라서 시작조차 못 하고 있었다. AI 코딩 도구가 생겼다는 건 알았는데, 과연 이런 것도 만들어줄 수 있을지 반신반의한 채로 시도해봤다.
---
## 🛠️ 사용한 도구
- **도구**: Claude Code (Anthropic)
- **모델**: Claude Sonnet 4.6
- **배포 플랫폼**: Vercel (무료)
- **연동 API**: 한국투자증권(KIS) OpenAPI
---
## 🔧 작업 과정
### 첫 번째 벽 — "브라우저에서 직접 부르면 안 된다고?"
제일 먼저 맞닥뜨린 문제는 CORS였다. 한국투자증권 API를 직접 브라우저에서 부르려고 하면 보안 정책에 막혀 아예 연결이 안 된다. 처음엔 무슨 말인지도 몰랐다.
```
브라우저에서 KIS API를 직접 호출하면 CORS 오류가 나.
PC·모바일 어디서든 접근 가능하게 만들어줘.
```
AI는 "브라우저와 KIS 서버 사이에 중간 다리(프록시)를 하나 두면 됩니다"라고 설명했다. Vercel이라는 무료 배포 플랫폼에 서버 역할을 하는 함수를 하나 만들어서, 브라우저가 그 함수를 거쳐 KIS 데이터를 받아오는 구조를 설계해줬다.
코딩 지식 없이는 생각도 못 했을 해결책이었다. AI가 파일 구조부터 설정까지 전부 만들어줬다.
---
### 5번의 오류 — AI를 100% 믿으면 안 된다는 것
배포를 눌렀다. 그런데 안 됐다.
```
배포했는데 안 되네. 확인해줘.
```
AI가 원인을 찾아 수정해줬다. 다시 배포했다. 또 안 됐다. 또 수정, 또 배포. 이 과정이 **다섯 번** 반복됐다.
| 시도 | 문제 | 해결 |
|------|------|------|
| 1차 | 경로 설정 오류로 연결 안 됨 | 라우팅 방식 전면 변경 |
| 2차 | 없는 모듈 사용해서 실행 오류 | 기본 내장 모듈로 교체 |
| 3차 | 모의투자 서버 보안 인증 오류 | 인증 우회 옵션 적용 |
| 4차 | 기존 서재 앱 빌드가 망가짐 | 설정 파일 충돌 수정 |
| 5차 | 대시보드 HTML 파일 자체가 안 보임 | 파일 위치 변경 |
솔직히 피로했다. 같은 패턴의 시행착오가 반복되는 느낌이었다. 이때 깨달은 것이 있다.
> **AI는 방향을 잡아주는 도구이지, 한 번에 완벽히 해결해주는 마법이 아니다.**
오류가 반복될 때는 AI에게 "왜 또 안 되는 거야"라고 재촉하기보다, "지금 접근 방법 자체를 바꿔볼 수 있어?"라고 물어보는 게 훨씬 효과적이었다.
다섯 번 만에 정상 작동했을 때는 진짜 뿌듯했다.
---
### UI를 내 취향으로 — 한마디면 충분했다
기본으로 만들어진 화면은 어두운 배경이었다. 보기 불편해서 바꾸고 싶었다.
```
KIS 대시보드는 잘 작동해. 다만 UI가 좀 밝은 배경이면 좋겠어.
```
화면 전체가 흰 배경 기반의 깔끔한 디자인으로 바뀌었다. 종목 카드, 버튼, 그래프 색상까지 전부 한 번에.
그런데 종목명이 이름 대신 코드 번호(005930)로만 표시되는 문제가 있었다.
```
종목명이 왜 없지? 코드(005930)만 뜨는데.
```
AI가 원인을 찾아서 수정해줬다. KIS API에서 종목명 데이터를 가져오는 방식에 문제가 있었고, 내가 직접 추가해둔 종목명을 우선적으로 보여주도록 바꿨다.
---
### 글자 크기도 내 마음대로
시가, 고가, 저가, 거래량 숫자가 너무 작아서 한눈에 안 들어왔다.
```
시가, 고가, 저가, 거래량의 글자크기를 지금의 2배로 키워줘.
```
키웠더니 이번엔 너무 컸다.
```
2배가 아니라 1.5배로 하고, 2열이 아니라 1열로 배열해줘.
```
이런 식으로 "좀 더", "아니 이건 줄여줘"를 반복하면서 내가 원하는 레이아웃을 찾아갔다. 마치 디자이너에게 실시간으로 피드백 주듯이.
---
### 앱처럼 쓸 수 있게 — 아이콘까지 직접 제작
여기서 한 가지 해프닝이 있었다.
```
증권 정보에 어울리는 아이콘 만들어줘.
```
AI가 화면 안 작은 아이콘들(시가/고가/저가 옆에 붙는 기호)을 추가해줬다. 내가 원한 건 **휴대폰 홈 화면에 설치할 앱 아이콘**이었는데, AI가 다르게 이해한 것이다.
```
아니... 증권정보 대시보드 PWA의 아이콘을 내용에 어울리는 아이콘으로
만들어달라는 뜻이고, 시가/고가/저가/거래량의 글자크기를
지금의 30% 정도 더 줄여줘, 종목명과 이것들 간의 간격도 40% 정도 줄여줘.
```
정확히 설명하니 이번엔 제대로 알아들었다. 파란 배경에 빨강/초록 캔들스틱이 그려진 SVG 아이콘을 만들고, 휴대폰에 맞는 크기로 5종류 PNG 파일까지 자동 생성해줬다. 앱 등록 설정 파일(manifest)까지 완성해서 이제 휴대폰 홈 화면에 추가하면 진짜 앱처럼 실행된다.
---
## ✅ 결과 (After)
### Before vs After
| 항목 | Before | After |
|------|--------|-------|
| 관심종목 확인 | HTS/MTS 앱 여러 개 → 종목별로 하나씩 | 브라우저 탭 하나 → 전체 한눈에 |
| 기기 전환 | PC에서 보다 폰으로 이동하면 앱 다시 열기 | PC/모바일 동일 URL, 홈 화면 앱으로 설치 |
| 개발 비용 | 직접 만들기 불가 | Claude Code + Vercel 무료 |
### 결과물
- 관심종목 현재가·등락률·스파크라인 차트 한눈에 확인
- 실전투자/모의투자 전환 가능
- 휴대폰 홈 화면에 캔들스틱 아이콘으로 앱 설치
---
## 💬 이 과정에서 배운 AI 활용 팁
### 효과적이었던 것
1. **구조 설계는 AI에게 맡기기** — CORS 우회처럼 내가 몰랐던 기술적 구조를 AI가 알아서 설계해줬다. "어떻게 해야 하나요?"가 아니라 "~이 되게 만들어줘"라고 목표만 말하면 된다.
2. **화면 디자인은 대화하듯 조정** — "좀 더 크게", "이건 줄여줘"처럼 일상어로 말해도 척척 바꿔준다. 명확한 기술 용어 몰라도 된다.
3. **오류 반복 시 접근 방식을 바꾸도록 요청** — "왜 또 안 돼?"보다 "지금 방법 말고 다른 방법으로 해결해줄 수 있어?"가 훨씬 효과적이었다.
### 이렇게 하면 안 돼요
1. **AI를 100% 믿고 맡기기** — 결과물을 반드시 직접 확인해야 한다. AI가 내 의도를 잘못 이해한 채로 진행하는 경우가 있다. (아이콘 해프닝처럼)
2. **오류가 나도 같은 방식으로 재시도 요청** — 같은 접근법을 반복하면 같은 오류가 나온다. 막히면 방향 전환을 요청하자.
3. **한 번에 너무 많이 바꾸기** — 여러 수정을 한꺼번에 요청하면 어디서 문제가 생겼는지 파악하기 어렵다. 하나씩 바꾸고 확인하는 게 낫다.
---
## 🌍 다른 업무에 적용한다면?
이번에 쓴 구조(브라우저 접근 제한 → 서버리스 함수 중계)는 주식 API에만 국한되지 않는다. 외부 API를 쓰는 거의 모든 상황에 같은 방식으로 적용 가능하다.
- **환율/날씨 모니터링 대시보드**: 원하는 정보를 한 화면에 모아보기
- **사내 데이터 조회 페이지**: 반복 확인하는 내부 시스템 데이터를 웹으로 꺼내기
- **개인 포트폴리오 트래커**: 여러 계좌의 수익률을 하나로 합산해서 보기
---
## 🚀 앞으로의 계획
- 종목별 목표가/손절가 설정 기능 추가
- 장 시작/마감 알림 푸시 알림 연동
- 여러 포트폴리오를 탭으로 분리해서 관리
---
## 📋 재사용 가능한 프롬프트
### 프롬프트 1: 외부 API 연동 대시보드 만들기
> [서비스명] API를 사용해서 [보고 싶은 정보]를 한눈에 볼 수 있는 대시보드를 만들어줘.
> PC와 모바일 어디서든 접근 가능하고, Vercel 무료 플랫폼에 배포해줘.
> CORS 문제가 있으면 프록시 방식으로 해결해줘.
### 프롬프트 2: 오류 반복 시 방향 전환 요청
> 지금 방법으로 계속 같은 오류가 나고 있어.
> 완전히 다른 접근 방식으로 다시 설계해줄 수 있어?
> 지금까지 시도한 방법은 [방법 요약]이었어.
### 프롬프트 3: UI 세부 조정
> [항목]의 크기를 지금의 [배율]로 [크게/작게] 해줘.
> [항목A]와 [항목B] 사이의 간격도 [비율]만큼 [늘려/줄여]줘.
> 전체 레이아웃은 [1열/2열]로 배열해줘.



잘하셨습니다! 어플까지 만들다니! 멋지싶니다!^^