[나의 앱 개발기] 코딩 몰라도 만들었다: 아버지를 위한 AI 맞춤법 앱과 API 키 보안 삽질기
아버지가 카카오톡 메시지를 보낼 때마다 맞춤법이 조금씩 신경 쓰이셨던 모양이다. 직접 말씀을 꺼내신 건 아닌데, 어느 날 "맞춤법 검사하는 거 쉽게 쓸 수 있는 게 없냐"고 물어보셨다. 포털 맞춤법 검사기를 알려드렸는데 사용법이 복잡하다고 하셔서, 그냥 내가 만들어드리기로 했다.
간단할 거라고 생각했다. 텍스트 입력하면 AI가 교정해주는 앱. 하루면 되겠지 싶었는데, 실제로는 API 키 보안 하나 때문에 GitHub Pages, Cloudflare Workers, 그리고 최종적으로 Vercel까지 빙 돌아오는 여정이 됐다. 그 삽질의 전 과정을 솔직하게 공개한다.
1. 처음 기획은 이랬다
아버지가 쓰실 앱이라 복잡하면 안 됐다. 요구사항은 딱 세 가지였다.
글 입력 또는 음성으로 말하기
맞춤법·띄어쓰기·용례 자동 교정
왜 틀렸는지 쉬운 설명까지!
여기에 국립국어원 한글 맞춤법 규정을 기준으로 교정해주면 더 신뢰도가 올라갈 것 같았다. 단순 맞춤법 교정 도구가 아니라 왜 틀렸는지 이유까지 설명해주는 앱을 목표로 잡았다. 그게 기존 무료 맞춤법 검사기와의 차이점이기도 했다.
추가로 오늘의 맞춤법 팁, 즐겨찾기 저장, 국어사전 검색 기능도 넣기로 했다. 일단 Claude한테 기획을 던졌다.
2. 첫 번째 시도 — HTML 단일 파일
처음엔 가장 단순한 방법으로 갔다. HTML 파일 하나에 Claude API 호출 코드를 넣고, 파일을 아버지한테 보내드리는 방식. Claude가 만들어준 코드를 붙여넣고 실행해봤더니 PC에서는 됐다.
내 환경에서는 로컬 파일로 열었을 때 음성 입력과 API 호출이 정상 작동하지 않았다. 원인은 마이크 권한·브라우저 지원·요청 출처와 CORS 등을 나누어 확인해야 한다. 마이크 접근 관련 문서에서도 안전한 컨텍스트와 사용자 권한을 구분하며, file://에서 모든 기능이 항상 차단된다고 일반화할 수는 없다. 배포용 앱은 HTTPS에서 권한 거부와 API 오류를 각각 시험하는 편이 좋다.
해결책은 웹 호스팅. GitHub Pages를 쓰기로 했다. 무료고 HTTPS도 기본 적용되니까.
3. 두 번째 시도 — GitHub Pages, 그리고 API 키 문제
GitHub에 레포지토리를 만들고 HTML 파일을 올렸다. 그런데 업로드하자마자 GitHub에서 경고가 떴다.
"Secret scanning found a Anthropic API Key secret."
GitHub 자체적으로 API 키를 감지해서 경고를 보내온 거다. 일단 무시하고 진행했는데, 잠시 후 실제로 Anthropic 쪽에서 그 키를 자동 비활성화해버렸다. Public 레포에 올라간 API 키는 GitHub의 비밀 정보 검사에 곧바로 걸리고, 키가 비활성화될 수 있다. 몰랐던 사실이다.
새 키를 발급받아 다시 넣으면 또 차단. 이 사이클을 세 번 반복하고 나서야 방향을 바꿔야겠다고 판단했다.
4. 세 번째 시도 — Cloudflare Workers
API 키를 파일에 넣지 않고 중간 서버를 두는 방식으로 전환했다. Cloudflare Workers가 그 역할을 한다. HTML은 키를 모르고, Workers가 키를 들고 Anthropic에 요청을 대신 보내주는 구조다.
| 방식 | 비밀 API 키 위치 | 키 노출 관점 | 별도 확인할 점 |
|---|---|---|---|
| HTML 직접 포함 | 브라우저로 전달되는 파일 | 사용자가 키를 볼 수 있음 | 노출한 키 폐기·재발급 |
| Cloudflare Workers | 서버 환경변수 | 브라우저에 보내지 않도록 구성 가능 | 인증·권한·요청 제한·CORS 설정 |
| Vercel API Route | 서버 환경변수 | 브라우저에 보내지 않도록 구성 가능 | 인증·권한·요청 제한·오류 로그 |
서버에 키를 두는 것은 키 노출을 줄이는 한 단계입니다. API 주소를 아는 누구나 무제한 호출할 수 있다면 비용 피해가 생길 수 있으므로, 이것만으로 앱 전체가 안전해졌다고 볼 수는 없습니다.
Cloudflare 계정을 만들고 Worker를 생성했다. 코드를 붙여넣고 배포했는데 Request not allowed 오류가 계속 났다. CORS 설정을 고치고, 키를 다시 입력하고, 코드 편집기가 코드를 잘라서 저장하는 문제까지 겹쳤다. 환경변수에 키를 넣었는데도 forbidden 오류가 사라지지 않았다.
원인을 찾다 보니 API 잔액이 부족해도 비슷한 오류가 날 수 있다는 얘기가 있어서 확인해 봤다. 그런데 잔액은 $68 넘게 남아있었다. 원인 불명의 forbidden이었다. 한 시간 넘게 씨름하다가 포기하고 다른 방법을 찾기로 했다.
5. 최종 선택 — Next.js + Vercel
이전에 딸아이 문제출제 앱을 만들 때 썼던 조합이다. 처음부터 이걸 썼으면 반나절 안에 끝났을 텐데, 돌아오는 길이 꽤 길었다.
Next.js의 API Route 기능이 핵심이다. app/api/check/route.js 파일 하나가 브라우저와 Anthropic 사이의 중간 서버 역할을 한다. 사용자는 이 파일을 볼 수 없고, API 키는 Vercel 환경변수에만 저장된다.
배포 과정은 이렇다.
GitHub에 Next.js 프로젝트 push
Vercel에서 레포지토리 Import
환경변수에 ANTHROPIC_API_KEY 입력
Deploy → 자동 배포 완료!
Vercel 배포 화면에 앱 미리보기가 뜨는 순간 진짜 다 됐다는 실감이 났다. 그동안 고생한 것에 비해 배포 자체는 10분도 안 걸렸다.
6. 완성된 앱, 이런 기능이 들어갔다
| 기능 | 설명 |
|---|---|
| 맞춤법 검사 | 국립국어원 규정 기준으로 교정 + 이유 설명 |
| 음성 입력 | 말하면 자동으로 텍스트 변환 후 검사 |
| 국어사전 | 단어 입력하면 뜻·품사·예문·유의어 제공 |
| 오늘의 팁 | 매번 다른 맞춤법 팁 6개 자동 생성 |
| 즐겨찾기 | 틀린 표현 저장해두고 반복 학습 |
| 글자 크기 조절 | 어르신 배려, 버튼으로 크기 조절 |
특히 맞춤법 교정 결과에서 단순히 틀렸다고만 하는 게 아니라, "국립국어원 규정 제○항에 따르면..." 식으로 근거를 들어 설명해주는 부분을 신경 썼다. 아버지가 납득하면서 쓰실 수 있도록.
7. 이번 개발에서 배운 것
1. API 키가 필요한 앱은 처음부터 Next.js + Vercel로.
HTML 파일에 키를 넣는 방식은 아예 시작하지 말자. 내 경우에는 공개 저장소에 올린 키가 차단됐지만, 모든 키가 수 분 안에 자동으로 차단되는 것은 아니다. 자동 탐지를 기다리지 말고 노출을 알게 된 즉시 키를 폐기·재발급해야 한다. 처음부터 서버 환경을 갖춘 구조로 가는 게 결국 빠르다.
2. 삽질도 공부다.
Cloudflare Workers에서 막혀서 시간을 날린 것 같지만, 덕분에 CORS가 뭔지, 환경변수가 어떻게 동작하는지 직접 몸으로 익혔다. Claude한테 물어보면서 개념을 하나씩 이해하는 과정이 결국 다음 프로젝트에 도움이 됐다.
3. 대상 사용자를 계속 생각할 것.
아버지가 쓰실 앱이라 글자 크기 조절, 큰 버튼, 쉬운 설명에 계속 집중했다. 기능을 추가할 때마다 "아버지가 이걸 쓸 수 있을까?"라고 자문했다. 덕분에 불필요한 기능은 빠지고 꼭 필요한 것만 남았다.
비슷한 앱을 만들 때 API 키 보안 체크리스트
이번에 돌아오면서 정리한 원칙이다. AI API를 쓰는 작은 앱을 만들 계획이라면 시작 전에 한 번 훑어보면 같은 삽질을 줄일 수 있다.
- 키는 브라우저 코드에 넣지 않는다. HTML이나 프런트엔드 자바스크립트에 들어간 키는 누구나 개발자 도구로 볼 수 있다. 서버 쪽(Next.js API Route, Workers 등)에서만 쓴다.
- 키는 환경변수로 관리한다. 내 컴퓨터에서는 .env.local 같은 파일에 두고, 이 파일이 .gitignore에 들어 있는지 확인한 뒤 push한다. 배포 서비스에는 설정 화면에서 따로 입력한다.
- 노출됐다면 바로 폐기하고 새로 발급한다. 레포에서 파일을 지워도 커밋 기록에는 남는다. 이미 올라간 키는 다시 쓰지 않는 게 원칙이다.
- 사용 한도를 걸어 둔다. API 콘솔에서 월 사용 한도나 알림을 설정해 두면, 혹시 키가 새더라도 큰 비용으로 번지는 걸 막을 수 있다.
- 오류 메시지를 그대로 AI에게 보여 준다. "안 돼요"보다 "Request not allowed 오류가 Workers 로그에 이렇게 찍힌다"처럼 원문을 붙여 넣어야 원인을 빨리 좁힌다.
AI 맞춤법 교정 결과를 볼 때 주의할 점
AI가 "국립국어원 규정 제○항"처럼 근거를 들어 설명해 주면 믿음이 가지만, 조항 번호나 예시를 틀리게 말할 때도 있다. 그래서 아버지께도 헷갈리는 표현은 국립국어원 표준국어대사전이나 우리말샘에서 한 번 더 찾아보시라고 말씀드렸다. 앱은 "먼저 걸러 주는 도우미"로 쓰고, 최종 판단은 사람이 하는 게 맞다.
자주 묻는 질문
Q. 왜 GitHub Pages만으로는 안 됐나?
GitHub Pages는 정적 파일만 올리는 곳이라 API 키를 숨길 서버가 없다. 키를 HTML에 넣으면 공개 레포에서 바로 노출되고, 그래서 중간 서버가 필요했다.
Q. Cloudflare Workers는 나쁜 선택이었나?
아니다. 키를 숨기는 구조 자체는 맞았다. 다만 내 경우 설정 과정에서 원인을 끝까지 찾지 못했고, 이미 써 본 Next.js + Vercel 조합이 더 익숙해서 그쪽으로 마무리했다.
Q. 어르신용 앱에서 가장 신경 쓴 부분은?
글자 크기 조절, 큰 버튼, 음성 입력, 쉬운 설명이다. 기능을 늘리기보다 "아버지가 혼자 쓸 수 있나"를 기준으로 덜어냈다.
마무리 정리
결론만 말하면, API 키 보안 문제 하나를 해결하는 데 가장 많은 시간이 걸렸다. 기능 구현보다 배포 환경 세팅이 더 어려웠다는 얘기다. 처음부터 Next.js + Vercel로 갔으면 하루면 충분했을 것을, 돌아서 오느라 배로 걸렸다.
그래도 완성하고 나니 아버지가 실제로 쓰신다. 카카오톡 보내기 전에 이 앱으로 한 번씩 확인하신다고 하셨다. 그걸로 충분하다.
코딩을 모른다고 만들 수 없는 게 아니다. 다만 어디서 막히는지 파악하고, 그 구간을 AI한테 물어가며 뚫어나가는 과정이 필요하다. 그 인내심만 있으면 생각보다 많은 걸 만들 수 있다.
본 글은 개인 개발 경험을 기록한 것이며, 특정 서비스나 플랫폼을 추천하는 글이 아닙니다.