JARVIS·CORE ← JARVIS로 돌아가기
JARVIS Core · 처음부터 끝까지 · Gemini 판

JARVIS 셋업 가이드

순서대로 따라 하면 내 JARVIS가 인터넷 주소로 열려요. 어려운 코드 작업은 Claude Code가 하고, 여러분은 계정을 만들고, 키를 복사하고, 버튼을 누르면 돼요.

걸리는 시간약 35분처음이라면 1시간 잡으세요
추가 비용0원Vercel·Gemini 무료 플랜. Claude 구독만 필요
결과내 주소 1개https://…vercel.app, 비밀번호로 잠김

지금 이 JARVIS의 현황

운영 중 · 2026-09-17 확인
운영 주소
www.horuto.net (내 도메인) · jarvis-vercel-eight.vercel.app — Vercel 프로젝트 jarvis-vercel, 서버 지역 미국 동부(iad1)
도메인
horuto.net — Cloudflare에서 구매, DNS에 @·www CNAME을 DNS 전용(회색 구름)으로 연결. 메일 발송(Resend) 레코드는 그대로 유지
두뇌 · 귀
대답과 음성 인식 모두 Google Gemini Flash. Groq는 쓰지 않아요.
모델 순서
3.8 Flash→3.7 Flash→3.6 Flash→3.5 Flash→2.5 Flash
무료 사용량이 차면 다음 모델로 넘어가요. Pro 모델은 절대 쓰지 않아요.
환경변수
GEMINI_API_KEY · JARVIS_PASSWORD — 둘 다 Vercel에 Secret으로 저장
확인된 것
비밀번호 없는 요청 차단, 한국어·영어 대화, 미세먼지·날씨 도구, 못 하는 일은 솔직하게 거절

시작 전에 준비할 것

  • 컴퓨터 — Windows 11 또는 Mac
  • Claude 유료 플랜(Pro 이상) — Claude Code는 무료 플랜에 포함되지 않아요
  • Chrome 브라우저 — 음성 인식이 가장 잘 돼요
  • Google 계정 — Gemini 키를 만들 때 필요해요
  • 빌드 가이드 파일 — JARVIS_BUILD_GUIDE.md, 4단계에서 준비해요
  • 메모장 — 키를 잠깐 붙여둘 곳
STEP 1

무료 계정 두 개 준비하기

약 5분

JARVIS가 올라갈 곳(Vercel)과 JARVIS의 두뇌·귀(Gemini), 두 서비스를 준비해요. 둘 다 카드 등록이 필요 없어요.

  1. Vercel — 사이트를 올리는 곳

    vercel.com/signup에서 요금제는 Hobby(개인용 무료)를 고르고, GitHub나 Google 계정으로 가입해요. 이미 가입돼 있으면 건너뛰세요.

  2. Google AI Studio — JARVIS의 두뇌와 귀

    aistudio.google.com에 Google 계정으로 로그인해요. 약관 동의 화면이 나오면 동의해요. 따로 가입 절차는 없어요.

참고

Vercel Hobby는 개인용 무료 요금제예요. 돈을 버는 용도로 쓰려면 유료 Pro 요금제가 필요해요.

STEP 2

Gemini API 키 발급받기

약 3분

API 키는 JARVIS가 Gemini를 쓸 수 있게 해주는 비밀 열쇠예요. 비밀번호처럼 다뤄야 해요.

  2. Create API key를 누르고, 프로젝트를 고르라고 하면 기본값이나 새 프로젝트를 골라요.

  3. 화면에 나타난 긴 키를 복사해서 메모장에 잠깐 붙여두세요.

결제는 끄기

AI Studio에서 결제(Billing)를 켜거나 유료로 올리지 않으면 요금이 나가지 않아요. 무료 사용량이 다 차면 잠시 멈출 뿐이에요. JARVIS는 Pro 모델을 절대 쓰지 않도록 만들어져 있어요.

주의

키를 카톡, 이메일, 스크린샷, 그리고 Claude Code 대화창에도 붙이지 마세요. IDE에서 .env의 키 줄을 선택한 채로 Claude에게 메시지를 보내도 그 줄이 대화에 같이 들어가요. 키를 넣는 곳은 6단계의 Vercel 설정 화면이에요.

개인정보

Gemini 무료 플랜은 말한 내용·녹음이 Google 제품 개선에 쓰이고 사람이 검토할 수 있어요. 민감한 개인정보는 JARVIS에게 말하지 마세요.

STEP 3

컴퓨터에 프로그램 두 개 설치하기

약 10분

  1. Node.js — 배포 도구용

    Claude Code가 JARVIS를 Vercel에 올릴 때 쓰는 Vercel CLI와 배포 전 검사 명령이 Node.js로 돌아가서 필요해요. 터미널에서 아래 명령을 쳐서 v22.12.0처럼 버전이 나오면 건너뛰세요.

    WIN시작 메뉴 → "터미널" 또는 "PowerShell" MAC⌘ Space → "터미널"
    터미널 · 설치 확인
    node -v

    없으면 nodejs.org에서 LTS 버전을 내려받아 설치해요(Windows는 .msi, Mac은 .pkg).

  2. Claude 데스크톱 앱

    claude.ai/download에서 내 컴퓨터용 앱을 설치하고 유료 플랜 계정으로 로그인해요. 앱 위쪽의 Code 탭이 Claude Code예요.

STEP 4

작업 폴더와 가이드 파일 준비하기

약 2분

  1. 작업 폴더를 만들어요.

    WIN예) C:\Project\jarvis MACFinder에서 ⌘ ⇧ H로 홈 폴더에 가서 jarvis 폴더 (다운로드·데스크탑·문서 폴더는 피하세요)

  2. 빌드 가이드 JARVIS_BUILD_GUIDE.md(Gemini 판, 텍스트 파일 원본 11개 포함 · 아이콘은 생성기로 만듦)를 작업 폴더 바로 아래에 넣어요. 정본은 저장소의 assets/md/jarvis-setup-guide/에 있어요.

빌드 가이드 위치역할직접 수정
assets/md/jarvis-setup-guide/JARVIS_BUILD_GUIDE.md정본(Gemini 판) — 고칠 때는 여기만✅
작업 폴더/JARVIS_BUILD_GUIDE.md4단계 작업본 — Claude Code가 읽는 복사본❌ 정본이 바뀌면 다시 복사
backups/2026-09-17/…groq-original.md옛 Groq 판 원본 보관❌

두 파일이 같은지는 PowerShell에서 확인해요. 두 줄의 Hash 값이 같으면 정상이에요.

PowerShell · 작업 폴더에서
Get-FileHash JARVIS_BUILD_GUIDE.md, assets\md\jarvis-setup-guide\JARVIS_BUILD_GUIDE.md
옛 페이지 주의

예전 셋업 페이지의 "전체 내용 복사" 버튼은 옛 Groq 판 가이드를 줘요. 쓰지 마세요.

STEP 5

Claude Code에게 만들고 배포해 달라고 하기

약 10분

  1. Claude 앱의 Code 탭에서 작업 폴더(예: C:\Project\jarvis)를 골라요.

  2. 아래 문장을 그대로 복사해서 보내요.

    Claude Code에 보낼 말
    이 폴더의 JARVIS_BUILD_GUIDE.md대로 JARVIS Core(Gemini 판)를 구현하고 Vercel에 배포해줘. 부록 파일은 추출 스크립트로 그대로 꺼내고, 검증을 모두 통과한 뒤에 배포해. Gemini Pro 모델은 절대 쓰지 마. Vercel CLI가 없으면 설치해 주고, 로그인이 필요하면 나한테 알려줘. API 키와 비밀번호는 내가 Vercel 화면에서 직접 넣을게.

  3. Vercel 로그인을 부탁받으면 아래 명령을 실행해요. 화면에 나오는 vercel.com/oauth/device?user_code=… 주소를 브라우저로 열고, 보이는 코드가 같은지 확인한 뒤 승인해요.

    터미널
    vercel login

  4. 작업 중에 "이 명령을 실행해도 될까요?" 같은 권한 요청이 뜨면, 내용을 읽고 허용해요.

잘 되고 있다는 신호

Claude Code가 파일 11개가 OK, 도구 8개가 OK라고 알려준 뒤 https://jarvis-vercel-….vercel.app 같은 주소를 줘요. 아직 키가 없어서 대화는 안 되는 게 정상이에요.

STEP 6

Vercel에 API 키와 비밀번호 넣기

약 5분

키는 Vercel 서버에만 저장돼요. 방문자의 브라우저로는 절대 전달되지 않아요.

  1. vercel.com/dashboard에서 jarvis-vercel 프로젝트를 눌러요.

  2. Settings → 왼쪽 메뉴 Environments → Production → Environment Variables로 가요. (2026-09 화면 기준 — 예전에는 Settings 왼쪽에 바로 있었어요.)

  3. 아래 두 개를 하나씩 추가해요. 적용 환경은 Production이면 돼요.

    Key
    Type
    Value
    GEMINI_API_KEY
    Secret
    2단계에서 복사한 Gemini 키 전체
    JARVIS_PASSWORD
    Secret
    직접 정한 8자 이상 비밀번호

  4. 다 넣었으면 메모장에 붙여둔 키를 지워요.

두 개 함께

JARVIS_PASSWORD를 빼먹으면 비밀번호 검사가 꺼져서 주소만 알면 누구나 내 무료 사용량을 쓸 수 있어요. 반드시 키와 함께 넣으세요.

Secret

Secret으로 저장하면 나중에 값을 다시 볼 수 없어요. 비밀번호는 따로 기억해 두세요. 예전 GROQ_API_KEY·GROQ_MODEL은 쓰이지 않으니 지워도 돼요.

화면 메뉴를 못 찾으면 jarvis-vercel 폴더에서 직접 연 터미널로 넣어도 돼요. 값은 물어볼 때 붙여넣어요.

PowerShell · 직접 실행
cd C:\Project\jarvis\jarvis-vercel
vercel env add GEMINI_API_KEY production
vercel env add JARVIS_PASSWORD production
STEP 7

다시 배포하기

약 2분

방금 넣은 값은 다시 배포해야 적용돼요. Vercel은 배포하는 순간의 환경변수를 담아 사이트를 만들기 때문이에요.

  1. 방법 A — Claude Code에게 부탁하기

    Claude Code에 보낼 말
    Vercel에 GEMINI_API_KEY와 JARVIS_PASSWORD를 넣었어. 다시 배포하고, 페이지가 열리는지와 비밀번호 없는 요청이 막히는지 확인해줘.

  2. 방법 B — Vercel 화면에서 하기

    Deployments 탭 → 맨 위 배포 줄 오른쪽 끝의 ⋯(마우스를 올리면 보여요) → Redeploy → 확인 창에서 다시 Redeploy. 맨 위에 새 줄이 생겨 Ready가 되면 끝이에요.

목록 화면

Deployments 위쪽의 Status · Error는 걸러 보기 메뉴의 선택지일 뿐, 오류가 났다는 뜻이 아니에요. 각 줄에 Ready가 보이면 정상이에요.

STEP 8

JARVIS 켜고 말 걸어보기

약 3분

  1. Chrome에서 5단계에 받은 주소를 열고, 6단계에서 정한 비밀번호를 넣어요.

  2. 가운데 코어나 아래 마이크 버튼을 누르고, 주소창에 뜨는 마이크 권한을 허용해요.

  3. 한국어나 영어로 말해 보세요. 같은 언어로 대답해요. 입력창에 치면 무료 사용량을 절반만 써요.

이렇게 말하면이렇게 되면 성공
"system check"오른쪽 창에 5개 항목이 모두 ✓ (Brain · Gemini, Speech input · browser (Google, KO/EN))
"what can you do?"기능 카드 8개가 뜨고, 실제로 할 수 있는 일만 말해요
"오늘 미세먼지 어때?"서울 초미세먼지·미세먼지를 한국어로 알려줘요
"100 dollars in won"오늘 환율로 계산한 카드
"next holiday"다가오는 공휴일 카드
"timer 1 minute"주황 타이머, 1분 뒤 삐 소리와 음성 알림
"제주 날씨 어때?"제주시 날씨 카드와 한국어 대답
"I want to watch TV."아직 못 한다고 솔직하게 말하고 할 수 있는 일을 제안
꾸미기

Voice 메뉴에서 영어 목소리를, Theme 메뉴에서 색(Stark 청록 / Mignon 마젠타)을 바꿀 수 있어요. Lang 메뉴는 기본이 Auto이고, 한국어나 English로 고정할 수도 있어요. 화면 오른쪽 위 톱니바퀴를 누르면 이 가이드가 열려요.

여기까지 됐다면 완성이에요

주소는 휴대폰 Chrome에서도 열려요. 비밀번호를 아는 사람만 쓸 수 있어요. 휴대폰에서 "홈 화면에 추가"를 하면 JARVIS 아이콘으로 앱처럼 열려요.

문제 해결

화면에 이런 게 보이면

보이는 것원인이렇게 하세요
Wrong passwordVercel에 넣은 비밀번호와 다름대소문자와 공백까지 확인. Vercel에서 바꿨다면 7단계로 다시 배포
Server not ready키나 비밀번호가 아직 적용되지 않음6단계 이름 철자(GEMINI_API_KEY) 확인 후 7단계로 다시 배포
노란 문구 Gemini 400 … API key not valid키가 틀렸거나, 잘렸거나, 지워짐AI Studio에서 새 키를 만들고 6→7단계 다시
노란 문구 Gemini 400 … FAILED_PRECONDITION서버 지역에서 Gemini 무료 플랜을 쓸 수 없음Vercel → Settings → Functions에서 지역을 미국·한국 등으로 → 다시 배포
노란 문구 Gemini 404 … model그 모델이 종료됨보통 다음 Flash 모델로 자동 전환. 계속되면 Claude Code에 문구를 보여주세요
Brain is busyFlash 모델 5개의 무료 사용량을 모두 씀잠시 뒤나 다음 날(한국 시간 오후 4~5시쯤 초기화). 요금은 나가지 않아요
Voice input failed (Speech limit …)음성 인식 무료 사용량을 다 씀잠시 뒤 다시 하거나 입력창에 쳐요
마이크를 눌러도 반응 없음마이크 권한이 막혔거나 Chrome이 아님Chrome 주소창 왼쪽 아이콘 → 마이크 허용 → 새로고침
"잘 못 들었어요"너무 짧거나 조용함마이크 가까이서 또박또박 다시
짧은 한국어를 영어로 알아들음짧은 말은 언어 감지가 헷갈려요Lang 메뉴를 한국어로 고정
vercel: command not foundVercel CLI가 설치되지 않음Claude Code에 "Vercel CLI 설치해줘"라고 부탁
안전하게 쓰기

키와 비밀번호 관리

  1. 키는 Vercel 설정 화면과 내 컴퓨터의 .env에만 둬요. 코드, 채팅, 공유 문서, 스크린샷에 남기지 않아요.

  2. 키가 새어 나간 것 같으면 AI Studio에서 그 키를 지우고, 새 키를 만들어 6→7단계를 다시 해요.

  3. 결제를 켜지 않고, Pro 모델을 쓰지 않아요. 그러면 요금이 나갈 일이 없어요.

  4. 노션·메일·캘린더를 연결하기 전에는 본인만 로그인하는 방식으로 바꿔야 해요. 지금은 비밀번호만 알면 누구나 들어올 수 있어요.