카카오톡 검역감염병 안내 챗봇, 처음부터 따라 만들기

• 위에서부터 순서대로 하세요. 단계 하나를 끝내면 맨 아래 "다 했어요"에 체크합니다. 창을 닫았다가 다시 열어도 체크는 남아 있습니다.
• 회색 상자 오른쪽의 복사 버튼을 누르면 내용이 복사됩니다. 붙여 넣을 곳에서 Ctrl + V.
• 이런 모양은 화면에 보이는 버튼·메뉴 이름입니다. 화면은 자주 바뀌니 비슷한 이름을 찾으세요.
• 선박 전자증서 데모를 이미 따라 만들었다면 1~6단계(가입·설치·토큰)는 이미 끝났습니다. 7단계부터 하세요. 같은 Supabase 프로젝트와 Cloudflare 계정을 그대로 씁니다.

1. https://claude.ai 접속 → Continue with Google 또는 이메일 입력 후 Continue with email.

2. 이름·약관 동의, 휴대폰 인증이 나오면 진행합니다.

3. 왼쪽 아래 내 이름 → Upgrade plan(또는 Settings → Billing) → Pro 선택 → 카드 결제. 월 약 20달러(부가세 별도).

1. https://claude.com/download → Windows용 내려받기(대부분 일반 x64).

2. Claude Setup ….exe 더블클릭 → "변경 허용"에 예.

3. 앱에서 Log in → 1단계 계정으로 로그인. 사이드바 위쪽에 Chat, Code 탭이 보이면 성공.

1. Git: https://git-scm.com/downloads/win → Click here to download → 실행 → 아무것도 바꾸지 말고 Next 반복 → Install → Finish.

2. Node.js: https://nodejs.org/ko/download → LTS Windows 설치 프로그램(.msi) → Next 반복 → Install. "Tools for Native Modules"는 체크하지 않습니다.

1. 파일 탐색기(Windows + E) → 문서 → 빈 곳 오른쪽 클릭 → 새로 만들기 → 폴더 → 이름 qc-demo.

선박 데모를 만들었다면 건너뛰세요. 같은 프로젝트(demo-hub)와 토큰을 씁니다.

1. https://supabase.com/dashboard/sign-up → 이메일·비밀번호 → Sign Up → 메일의 확인 링크 클릭.

2. 조직(Organization): 이름 아무거나, Personal, Free → Create organization.

3. New project → 이름 demo-hub, Database Password는 Generate a password, Region Northeast Asia (Seoul) → Create new project.

4. 주소창 supabase.com/dashboard/project/abcdefghijklmnopqrst의 굵은 20자가 프로젝트 ref입니다.

5. https://supabase.com/dashboard/account/tokens → Generate new token → 이름 claude-demo → Generate token. sbp_로 시작하는 토큰이 한 번만 보이니 메모장에 "supabase 토큰"과 함께 붙여 두세요(저장하지 말고 창만 열어 둠).

선박 데모를 만들었다면 건너뛰세요.

1. https://dash.cloudflare.com/sign-up → 가입 → 메일의 Verify email. 도메인 연결 안내는 Skip.

2. https://dash.cloudflare.com/profile/api-tokens → Create Token → Edit Cloudflare Workers의 Use template → Account Resources는 내 계정, Zone Resources는 All zones → Continue to summary → Create Token → 메모장에 "cloudflare 토큰"과 함께 붙여 두기.

3. 대시보드 첫 화면의 계정 이름 옆 ⋯ → Copy account ID(32자) → 메모장에 "cloudflare 계정 ID"와 함께.

1. https://center-pf.kakao.com (카카오톡 채널 관리자센터)에 내 카카오 계정으로 로그인.

2. 새 채널 만들기 → 약관 동의·본인 인증.

3. 채널 이름: (시연) 검역감염병 신고지원 챗봇
   검색용 아이디: 아무거나 (예: qcbot-내별명)
   소개글: 질병관리청 공식 채널이 아닌 기능 시연용 채널입니다.
   프로필 사진은 넣지 않습니다(실제 기관 로고 금지).

1. 만든 채널에 들어가서 확인합니다.
   · 검색 허용: 끔 (채널 공개/노출 설정)
   · 채팅 메뉴에서 1:1 채팅: 켬 (꺼져 있으면 채팅방에 입력창이 안 생깁니다)
   · 채팅방 메뉴: 끔 (켜져 있으면 챗봇을 연결할 수 없습니다)
   · 채팅방 인사말 설정이 있으면 꺼 두세요 (챗봇 안내와 겹칩니다)

2. 채널 홈 주소(http://pf.kakao.com/_xxxxx)를 메모장에 적어 둡니다. 채널 관리자센터 첫 화면에 있습니다.

1. https://chatbot.kakao.com (챗봇 관리자센터)에 같은 카카오 계정으로 로그인.

2. 오른쪽 위 봇 만들기 → 카카오톡 챗봇 → 봇 이름 검역감염병 신고지원 시연(20자 이내) → 확인.

3. 지금은 여기까지입니다. 스킬 연결과 배포는 Claude가 서버를 만든 뒤 주소를 알려 주면 합니다(10단계 표).

1. Claude 앱 → Code 탭.

2. 입력창 아래 줄 맨 왼쪽(환경) → Local 그룹 맨 위. Cloud는 고르지 마세요.

3. 폴더 버튼 → Open folder… → 문서 → qc-demo.

4. 권한 모드 → Accept edits (또는 보이면 Auto).

1. 아래 작업지시서 전체 복사 → Claude Code 입력창에 Ctrl + V → Enter.

중간에 Claude가 부탁할 일

미리보기 확인했어. 프로덕션 배포 승인할게.

작업지시서 기준으로 지금까지 어디까지 했는지 확인하고, 다음 단계부터 이어서 진행해 줘.

계속해 줘.

1. 폰 카카오톡: 채널 채팅방에 두바이 다녀왔고 3일 전 귀국했는데 열이 나고 설사를 해요 → "이렇게 이해했어요"가 나오면 네 → 안내 등급과 감염병 카드가 나오면 성공. 카드를 옆으로 넘기고 자세히 보기도 눌러 봅니다.

2. 하나씩 대화: 코피가 나요 → 네 콩고요 10일 전에 왔어요 → 네 → 🚨 119 안내와 "즉시 상담 권장".

3. 말로 고치기: 확인 단계에서 설사는 없어요, 아니 나라는 우간다예요, 결과 뒤에 기침도 있어요.

4. 다시 들어온 사람처럼: 안녕하세요 → 사용법 안내가 나오면 성공.

5. PC 웹: 사이트 주소를 열면 로그인 화면만 보여야 합니다. 열람 계정으로 로그인 → 체험하기·감염병 정보. 관리자 계정으로 로그인 → 관리자 → 대시보드, 변경 제안(예시 2건) 하나를 승인하고 적용 → 버전 이력에서 이 버전으로 되돌리기.

6. 관리자 → 대시보드 → 데모 초기화 두 번 눌러 확정 → 처음 상태로.

• 시연 전: 관리자 화면에서 데모 초기화.
• 웹 계정: 지인·동료에게는 열람 계정만 알려 주세요. 관리자 계정은 본인만.
• 7일 규칙: Supabase 무료 프로젝트는 7일 동안 안 쓰면 잠깁니다. 대시보드에서 Restore project. 시연 전날 한 번 접속해 두세요.
• 웰컴 메시지는 그 사람이 채널과 처음 대화할 때만 나옵니다. 다시 들어온 사람은 아무 말이나 보내면 됩니다(카카오 정상 동작).

매주 감염병 동향 반영하기 (선택)

Claude Code에서 qc-demo 폴더를 열고 아래 문장을 보내면, Claude가 공개 자료를 조사해 "규칙 바꾸기 제안"을 관리자 화면에 올립니다. 반영은 관리자 화면에서 승인해야만 됩니다.

이번 주 국내외 검역감염병 동향을 WHO 발생 소식과 질병관리청 공개 발표에서 조사해서, 지금 활성 룰셋과 다른 점을 변경 제안으로 등록해 줘. 항목마다 출처 링크를 붙이고, 출처가 없는 건 빼. 지난주 챗봇이 못 알아들은 표현이 있으면 별칭 추가 제안도 함께 해 줘.

1. Claude Code에서 qc-demo 폴더를 열고:

   이 챗봇 데모를 폐기하려고 해. Cloudflare Pages 사이트, Edge Function과 시크릿, 서버 깨우기 예약 작업, 데모 계정, quarantine_chatbot 스키마를 순서대로 지워 줘. 지우기 전에 목록을 먼저 보여 주고 내 확인을 받아.

   복사

2. 챗봇 관리자센터에서 봇의 채널 연결 해제 → 봇 삭제, 채널 관리자센터에서 채널 삭제.

3. Supabase·Cloudflare 토큰 삭제, Claude 구독 해지(필요하면).