API가 뭔지도 몰랐는데, 하루 만에 딸 유학지 날씨 알림 위젯 만들었다
아레테_Arete
2026.05.26
# [Claude Code] API가 뭔지도 몰랐는데, 하루 만에 딸 유학지 날씨 알림 위젯 만들었다
## 📝 한줄 요약
API 개념조차 없던 비개발자가 Claude Code와 함께 4시간 만에 Notion용 한국어 날씨 위젯을 완성했다.
**바쁘시면 이것만 읽어도 돼요:**
- Claude Code로 Notion 삽입용 날씨 위젯 제작 — 국내 미세먼지는 에어코리아, 해외는 WHO 기준으로 자동 적용
- API가 뭔지 몰라도 "이게 뭐예요?"라고 물어보면 설명하면서 만들어줌
- 50개 이상 국내 도시 + 해외 도시 매핑 테이블을 한 번에 생성해주는 걸 보고 충격받음
- 프라하 유학 중인 딸 날씨를 전화 없이 클릭 한 번으로 확인 가능해짐
- 핵심 팁: 완성된 결과물을 설명하려 하지 말고, 내가 불편한 것을 그대로 말하면 됨
- 앞으로 즐겨찾기 도시를 직접 편집할 수 있게 발전시킬 계획
## 🎯 이런 분들께 도움돼요
- Notion이나 Obsidian 대시보드를 꾸미고 싶지만 코딩은 전혀 모르는 분
- AI 코딩 도구가 궁금한데 "나 같은 비개발자도 쓸 수 있을까?" 망설이는 분
- 해외에 가족이나 지인이 있어 그곳 날씨가 자주 궁금한 분
## 😫 문제 상황 (Before)
Notion을 일상 대시보드로 쓰고 있었다. 할 일, 메모, 일정 — 거의 모든 것이 Notion에 있는데, 날씨만큼은 따로 앱을 켜야 했다. 작은 불편함이지만 매일 반복되다 보니 슬슬 해결하고 싶어졌다.
마음에 드는 날씨 위젯을 찾아봤는데 문제가 두 가지였다. 하나는 무료로 쓸 만한 게 별로 없다는 것, 다른 하나는 대부분 영어라는 것이다. '맑음', '흐림', '가벼운 비'가 아니라 'Clear sky', 'Overcast', 'Light rain' — 읽힐 때마다 한 박자 쉬게 된다. 미세먼지 정보를 제대로 보여주는 것도 찾기 어려웠다.
그래서 직접 만들기로 했다. 단, 코딩은 한 줄도 할 줄 모른다.
## 🛠️ 사용한 도구
- **도구**: Claude Code (VS Code 확장)
- **모델**: Claude Sonnet
---
## 🔧 작업 과정
### 일단 원하는 것부터 말했다 — 기본 위젯 완성
처음에는 막막했다. 뭘 어떻게 요청해야 할지도 몰랐다. 그냥 내가 원하는 걸 그대로 말하기로 했다.
```
Notion/Obsidian에 삽입할 수 있는 날씨 위젯 만들어줘.
도시 검색, 즐겨찾기 5개 버튼, 현재 날씨 + 5일 예보 보여주면 돼.
다크모드도 지원해야 해.
```
잠시 후 하나의 HTML 파일이 생성됐다. 외부 프로그램 설치 없이 파일 하나만 Notion에 올리면 되는 방식이었다. 체감온도, 습도, 풍속까지 나오고, 즐겨찾기 버튼에 서울·부산·제주·도쿄·런던을 넣어줬다. 클릭 한 번으로 도시가 바뀌는 걸 처음 봤을 때 혼자 박수를 쳤다.
---
### "API가 뭐예요?" — 모르면 그냥 물어보면 된다
날씨는 됐는데, 미세먼지도 보고 싶었다. 그런데 Claude Code가 "미세먼지 데이터를 가져오려면 API 키가 필요해요"라고 했다. API가 뭔지 몰랐다.
```
미세먼지(PM10, PM2.5) 정보도 위젯에 추가해줘.
등급도 색깔로 보여주면 좋겠어.
그런데 API가 뭔지 모르는데, 어떻게 하는 거야?
```
Claude Code는 API가 뭔지부터 설명해줬다. '날씨 데이터를 제공하는 서비스에서 데이터를 가져오는 연결 통로' 같은 것이라고. 그리고 무료로 발급받는 방법까지 안내해줬다. 개념을 이해하면서 동시에 기능이 만들어졌다. 미세먼지 등급도 '좋음'은 초록, '나쁨'은 주황, '매우나쁨'은 빨간색으로 표시됐고, 다크모드에서도 색이 잘 보이도록 알아서 조정해줬다.
---
### 충격받은 순간 — 도시 50개를 한 번에
미세먼지 데이터를 쓰다 보니 문제가 생겼다. 해외 날씨 서비스의 미세먼지 데이터가 한국 기준과 달랐다. 한국 환경부는 '좋음/보통/나쁨/매우나쁨' 4단계를 쓰는데, 해외 서비스는 WHO 기준 5단계를 쓴다. 한국 도시를 검색했을 때는 한국 기준을, 해외 도시는 해외 기준을 자동으로 써야 했다.
```
해외 도시는 OpenWeatherMap 미세먼지 데이터 쓰면 되는데,
한국 도시는 에어코리아 공공 API로 바꾸고 싶어.
국내 도시 입력하면 에어코리아 데이터 쓰고, 해외면 OWM 쓰는 방식으로 해줘.
```
이 요청 하나에 Claude Code가 한 게 이거다:
- 국내 도시 50여 개의 위도·경도·시도명·에어코리아 측정소명을 담은 매핑 테이블 생성
- 해외 도시(동아시아·동남아·유럽·북미·오세아니아) 30여 개 추가
- 도시 이름을 입력하면 한국 도시인지 자동 판별하는 로직 설계
- 한국 도시는 에어코리아 API로 연결, 실패하면 자동으로 해외 서비스로 전환하는 폴백 처리
내가 요청한 건 "한국/해외 분기해줘" 한 줄이었는데, 이 모든 구조를 알아서 설계해줬다. "아, 이런 식으로 쓰는 거구나" 했던 순간이었다.
---
### 한글화 완성 — 딸 유학지 날씨까지
마지막으로 날씨 설명을 전부 한글로 바꿨다.
```
날씨 설명이 영어로 나오는데 전부 한글로 바꿔줘.
'light rain' → '가벼운 비', 'heavy snow' → '폭설' 이런 식으로.
```
맑음·구름·비·눈·안개·황사·토네이도까지 50여 개 날씨 설명이 전부 한글로 바뀌었다. 그리고 도시 이름도 한글로 검색하면 한글로 표시되게 됐다.
위젯이 완성되고 즐겨찾기 버튼 하나를 '프라하'로 바꿨다. 딸아이가 체코 프라하에서 유학 중인데, 날씨가 어떤지 궁금할 때마다 전화를 했었다. 이제는 Notion을 열 때마다 프라하 날씨가 바로 보인다. 전화하지 않아도 오늘 딸이 얼마나 춥게 지내는지 알 수 있다.
---
## ✅ 결과 (After)
### Before vs After
| 항목 | Before | After |
|------|--------|-------|
| 날씨 확인 | 별도 앱 실행 | Notion 열면 바로 확인 |
| 언어 | 영어 위젯 | 완전 한국어 |
| 미세먼지 기준 | 없음 | 국내 에어코리아 기준 / 해외 WHO 기준 자동 적용 |
| 딸 유학지 날씨 | 전화로 확인 | 클릭 한 번 |
| 개발 시간 | — | 약 4시간 |
### 결과물
- 단일 HTML 파일 (Notion/Obsidian 어디에나 삽입 가능)
- 지원 도시: 국내 50+ 도시 + 해외 30+ 도시
- 다크모드 자동 전환
## 💬 이 과정에서 배운 AI 활용 팁
### 효과적이었던 것
1. **모르면 그냥 물어보기** — "API가 뭐예요?"처럼 기초적인 질문도 아무 부담 없이 하면 된다. 설명해주면서 동시에 만들어준다
2. **내가 원하는 것을 구체적으로** — "날씨 위젯"이 아니라 "도시 검색, 즐겨찾기 5개, 5일 예보, 다크모드"처럼 원하는 기능을 나열하면 훨씬 결과가 잘 나온다
3. **단계별로 추가하기** — 기본 위젯 → 미세먼지 → 에어코리아 → 한글화 순으로 하나씩 요청했더니 각 단계에서 잘 동작하는 걸 확인하면서 진행할 수 있었다
### 이렇게 하면 안 돼요
1. 처음부터 모든 기능을 한꺼번에 요청하지 않기 — 단계별로 나누는 게 훨씬 안정적이다
2. 결과물을 어떻게 만들지 설명하려 하지 않기 — 코딩을 모르니까 기술적 방법이 아니라 "어떤 불편함을 해결하고 싶다"는 목적을 말하는 게 맞다
## 🌍 다른 업무에 적용한다면?
이번에 배운 방식 — 원하는 것을 말하고, 모르는 건 물어보고, 단계별로 기능을 추가하는 방식 — 은 다른 자동화 작업에도 그대로 쓸 수 있다.
- 업무 보고서를 자동으로 정리해주는 도구
- 자주 쓰는 문서 양식을 자동으로 채워주는 도구
- 특정 웹사이트 정보를 모아서 보여주는 대시보드
기술을 배우는 게 아니라 내가 원하는 것을 말하는 법을 배우는 거다.
## 🚀 앞으로의 계획
지금은 즐겨찾기 5개 도시가 코드에 고정돼 있다. 위젯 안에서 직접 도시를 추가하고 바꿀 수 있도록 만들고 싶다. 가족이 있는 곳, 여행 예정지, 관심 있는 도시를 내 마음대로 구성하는 위젯으로 발전시키는 게 다음 목표다.
## 📋 재사용 가능한 프롬프트
### 프롬프트 1: 처음 위젯 요청할 때
> [삽입할 도구 이름]에 넣을 수 있는 [원하는 기능] 위젯 만들어줘.
> [기능1], [기능2], [기능3] 보여줬으면 해.
> [추가 조건]도 지원해야 해.
### 프롬프트 2: 모르는 개념이 나왔을 때
> [모르는 용어]가 뭔지 모르는데, 어떻게 하는 거야?
> 처음부터 설명해줘.
### 프롬프트 3: 기능을 단계별로 추가할 때
> 지금까지 만든 위젯에 [새 기능]을 추가해줘.
> [조건1]이면 [방식A], [조건2]이면 [방식B]로 처리해줘.



오! 위젯 만들기 재밋겠는데요? ㅎㅎ
Api도 몰랐는데 과감하게 실행하신점이 대단하세요!
맞아요 일단 모르면 물어보면서 하면 된답니다!
사실 이게 ai를 공부하는 방식이예요.
너무 잘하시고 계세요^^