브라우저 저장소와 API 키: 서버 없는 페이지에서 AI를 부르는 법

2026-10-14에 “웹 버전에 Claude나 ChatGPT를 쓰는 대화창을 달 수 있나”, “키를 브라우저 스토리지에 저장할 수 있지 않을까”라는 물음에 답한 것을 정리한다. → R-WEB-07

한 줄 요약

서버가 없는 페이지에서는 사용자가 자기 API 키를 넣고, 페이지가 그 키로 AI 회사의 서버를 직접 부른다. 키는 브라우저 저장소에 둘 수 있다. 다만 그 저장소는 같은 페이지에서 도는 모든 스크립트가 읽을 수 있다.

백엔드로 비유하면

백엔드에서는 API 키를 서버의 환경 변수나 비밀 저장소에 둔다. 사용자는 그 키를 볼 수 없다. 서버가 사용자를 대신해 AI를 부르기 때문이다.

정적 페이지에는 그 “서버”가 없다. 페이지의 코드는 모두 사용자의 브라우저로 내려가고, 누구나 “소스 보기”로 읽을 수 있다. 그래서 메인테이너의 키를 페이지에 넣을 수 없다. 넣는 순간 공개된다. 길은 셋이다.

길누구의 키서버치르는 값
사용자가 자기 키를 넣는다 (고른 것)사용자없음키가 있는 사람만 쓴다
중계 서버를 둔다메인테이너있음사용료와 운영, 남용 막기
대화창을 달지 않는다 (Claude skill)사용자의 Claude없음편집기 밖에서 묻고 결과를 가져온다

브라우저 저장소란

브라우저가 사이트마다 따로 내주는 작은 저장 공간이다. 백엔드로 치면 클라이언트마다 하나씩 있는 키-값 저장소이고, 서버는 그 안을 볼 수 없다.

종류언제까지 남나쓰임
localStorage사용자가 지울 때까지설정, 넣어 둔 키
sessionStorage그 탭을 닫을 때까지잠깐 쓰는 값
IndexedDB사용자가 지울 때까지큰 것(작성 중인 문서의 임시 보관 → R-WEB-03)

나누는 단위는 **출처(origin)**다. 주소의 앞부분(https:// + 도메인 + 포트)이 같으면 같은 저장소를 본다. 다른 사이트는 읽지 못한다.

무엇이 위험한가

출처가 같으면 읽을 수 있다는 것은, 그 페이지에 실려 도는 스크립트라면 누가 쓴 것이든 읽을 수 있다는 뜻이다.

  • 남의 스크립트. 광고, 통계, 외부에서 불러오는 라이브러리. 페이지에 <script>로 실으면 우리 코드와 같은 권한으로 돈다. 웹 버전에는 광고가 예정되어 있다(R-WEB-08). 광고와 키가 한 페이지에 있어도 되는지는 정하지 않았다 → 6. 미결정 사항
  • 끼어든 스크립트(XSS). 페이지가 남이 쓴 글을 그대로 화면에 넣으면 그 안의 스크립트가 돈다. AriadneNSD는 남이 준 파일과 공유 URL을 연다. 블록의 글자를 화면에 넣을 때 글자로만 다루어야 한다.
  • 같은 컴퓨터를 쓰는 다른 사람. localStorage의 값은 암호화되지 않고, 개발자 도구에서 그대로 보인다.

줄이는 법: 키를 sessionStorage에 두어 탭을 닫으면 잊게 하기, 광고를 다른 출처의 iframe 안에 가두기, 키를 쓰는 화면에는 남의 스크립트를 싣지 않기, 사용자에게 “쓸 수 있는 금액에 한도를 건 키를 따로 만들어 넣으라”고 안내하기.

브라우저에서 AI 회사의 서버를 직접 부를 수 있나

브라우저는 페이지가 다른 출처의 서버를 부르는 것을 기본으로 막는다. 그 서버가 “다른 출처에서 불러도 된다”고 답해 주어야 통한다(CORS). 백엔드에서는 겪지 않는 제약이다. 서버끼리는 누구나 누구를 부를 수 있다.

AI 회사의 API가 브라우저에서 바로 부르는 것을 받아 주는지는 회사마다, 때마다 다르다. 받아 주지 않으면 “사용자가 자기 키를 넣는다”는 길은 그 회사에 대해 닫힌다.

2026-10-14에 메인테이너가 염두에 둔 세 회사를 확인했다. 브라우저가 본 요청 앞에 보내는 물음(preflight, OPTIONS)과 키 없는 요청을 curl로 흉내 내어, 답에 access-control-allow-origin이 오는지 보았다. 출처는 https://reddiana.github.io로 적었다.

회사주소미리 묻기키 없는 요청의 답알아 둘 것
Claude (Anthropic)api.anthropic.com/v1/messages200, 허용401 + 허용 머리요청에 anthropic-dangerous-direct-browser-access: true를 넣어야 한다. 빼면 미리 묻기가 400이고 허용 머리가 오지 않는다
ChatGPT (OpenAI)api.openai.com/v1/chat/completions, /v1/responses200, 허용401 + 허용 머리따로 넣을 머리가 없다
Grok (xAI)api.x.ai/v1/chat/completions200, 허용400 + 허용 머리요청의 모양이 OpenAI와 같다

셋 다 받아 준다. 다만 이것은 문이 열려 있는지만 본 것이다. 진짜 키로 진짜 브라우저에서 답이 오는지, 답을 조금씩 흘려 받는 것(스트리밍)이 되는지는 해 보지 않았다. Claude의 머리 이름에 “dangerous”가 든 것은 위의 “무엇이 위험한가” 때문이다. 키가 사용자의 브라우저에 있다는 것을 알고 쓰라는 뜻이다.

문서를 둘 곳: localStorage와 IndexedDB (2026-11-03)

2026-11-03에 “브라우저 storage에 저장하는 기능”(R-WEB-09)을 정하며, 본보기인 SequenceDiagram.org는 메뉴 이름이 localStorage인데 AriadneNSD는 왜 IndexedDB에 두는지 설명한 것이다.

localStorageIndexedDB
크기출처마다 5 MB 안팎(브라우저마다 다름)디스크의 일부까지(대개 수백 MB 넘게)
담는 것문자열만(키 → 문자열)객체를 그대로, 색인으로 찾기
읽고 쓰기동기: 쓰는 동안 화면이 멈춤비동기: 화면을 막지 않음
백엔드로 치면설정 파일 하나클라이언트마다 있는 작은 데이터베이스
  • 문서 여러 개를 두면 5 MB는 금방 찬다. 문서마다 썸네일을 함께 두면 더 그렇다. 그래서 문서는 IndexedDB에, 작은 설정만 localStorage에 둔다. AriadneNSD는 로컬 백업 · 최근 파일을 이미 IndexedDB에 두고 있어 같은 곳을 쓴다 → 2. 로컬 백업과 자동 저장
  • 둘 다 브라우저가 지울 수 있다. 디스크가 모자라면 오래 안 쓴 사이트의 저장소부터 비우고, 사용자가 “사이트 데이터 삭제”를 누르면 둘이 함께 지워진다. navigator.storage.persist()로 “지우지 말아 달라”고 청할 수 있지만 브라우저가 거절할 수도 있다. 그래서 함께 지워진다는 경고와 파일로 백업하는 길을 둔다 → BS4
  • 같은 출처의 탭 둘은 같은 저장소를 본다. 한 문서를 두 탭에서 고치면 나중에 쓴 쪽이 이긴다

AriadneNSD에서 어디에 쓰나

  • 웹 버전의 AI 대화창(#P3) → R-WEB-07
  • AI가 다이어그램을 “그린다”는 것은 그림을 그리는 것이 아니라 모델을 글로 써 주는 것이다. 편집기는 그 모델을 읽어 그린다. “반복되는 부분을 Method로 빼 주세요”는 지금 모델을 보내고 고친 모델을 받는 일이다. 어떤 형식으로 주고받을지는 정하지 않았다 → backlog

더 읽을거리

  • MDN, “Web Storage API”
  • MDN, “Cross-Origin Resource Sharing (CORS)”
  • OWASP, “HTML5 Security Cheat Sheet”의 Local Storage 절