서비스를 고객사 계정으로 옮길 때
회사에서 할 일

1. 한눈에 보기

서비스 1개 기준 월 약 $21이에요(백업 포함, 부가세 별도). API 사용료는 쓴 만큼 따로예요.

원칙 하나 — 계정은 전부 고객사 명의

서버 · 저장소 · API 계정과 결제 카드가 처음부터 고객사 자산이어야 해요. 그래야 나중에 헤이제임스 접근을 끊어도 서비스가 그대로 돌아요. 헤이제임스 명의로 만들면 청구가 헤이제임스로 오고, 키를 회수하는 순간 서비스가 멈춰요. 그래서 가입과 카드 등록은 회사가, 그 안에 서버를 만드는 일은 헤이제임스가 해요.

준비물

• 회사 이메일 계정 — 개인 지메일은 쓰지 마세요. 서비스마다 가입하니 대표 메일 하나로 통일해요
• 해외 결제 가능한 카드 — 달러 결제 · 온라인 결제 허용 상태 (법인카드 또는 대표 카드)
• 대표 또는 담당자 휴대폰 — 2단계 인증용
• 사업자등록번호 — DigitalOcean 세금 정보(부가세 면제)에 넣어요
• 도메인 관리 계정 접근(가비아 · 후이즈 · Cloudflare 등) — DNS 를 새 서버로 바꿀 때 필요해요
• 프로젝트를 만든 헤이제임스 계정 — 대시보드의 계정 연결 화면은 그 계정으로만 열려요

2. DigitalOcean — 가입 · 카드 · 계정 연결

서버(싱가포르 리전 2 GiB) · 일일 백업 · 파일 저장소 · 이미지 저장소가 전부 이 계정 안에 만들어져요. 회사가 할 일은 가입 · 카드 등록 · 연결 세 가지예요. 서버를 만드는 화면은 열 필요가 없어요.

1. 1

   회사 이메일로 가입

   고객사

   cloud.digitalocean.com/registrations/new 에서 이메일 + 비밀번호로 가입하고 인증 메일을 확인해요. Settings → Security 에서 2단계 인증을 켜요. Google 계정 로그인도 되지만, 인수인계에는 회사 이메일 계정이 안전해요.

2. 2

   결제 카드 등록

   고객사

   왼쪽 메뉴 Billing → Payment methods → Add payment method. VISA · Mastercard 를 권해요. 카드가 등록돼야 서버를 만들 수 있어요. 한국 카드가 거절되면 다른 카드나 PayPal 로 우회해요. 등록 직후 소액 임시 승인이 찍혔다 사라질 수 있어요.

3. 3

   세금 정보(사업자등록번호) 등록

   고객사

   Settings → Billing → Tax ID 에 사업자등록번호를 넣으면 사업자 거래로 잡혀 청구서에 부가세가 붙지 않아요. 인보이스는 달러 PDF 로 매달 나오고 세금계산서는 아니에요 — 경비 처리는 세무사와 확인하세요.

4. 4

   (권장) 회사명으로 팀 만들기

   고객사

   오른쪽 위 계정 메뉴 → Create a Team → 회사명. 서버 요금이 이 팀으로 청구되고, 나중에 담당자를 팀원으로 초대할 수 있어요. 개인 계정 그대로 써도 동작은 같아요.

5. 5

   프로젝트 대시보드에서 계정 연결

   고객사

   헤이제임스 프로젝트 대시보드 → 계정 연결 → 「DigitalOcean 계정 연결하기」. DigitalOcean 인증 화면이 뜨면 방금 만든 팀을 고르고 허용해요. 화면에 팀 이름이 뜨면 끝이에요. 서버 · 백업 · 파일 저장소 · 이미지 저장소는 헤이제임스가 이 계정 안에 만들어요. 비밀번호나 카드 정보는 헤이제임스에 넘어오지 않아요.

3. GitHub — 코드가 회사 조직으로

서비스 코드는 회사 GitHub 조직의 비공개 저장소로 옮겨져요. 이후 수정 · 배포는 그 저장소를 기준으로 해요. 헤이제임스와의 계약이 끝나도 코드는 회사에 남아요.

1. 1

   회사 조직(Organization) 만들기

   고객사

   github.com/organizations/plan 에서 Free 플랜으로 조직을 만들어요(무료, 비공개 저장소 무제한). 이미 회사 조직이 있으면 그걸 써요. 개인 계정에 받아도 동작하지만, 담당자가 바뀌어도 코드가 회사에 남으려면 조직이 나아요.

2. 2

   프로젝트 대시보드에서 앱 설치

   고객사

   계정 연결 → 「GitHub 조직에 앱 설치하기」 → 설치 화면에서 방금 만든 조직을 고르고 All repositories 를 선택해요. 헤이제임스가 이 조직에 새 저장소를 만들어 코드를 옮기고, 자동 빌드 설정까지 넣어요. 조직 관리자가 따로 있으면 승인 요청이 가요. 승인 뒤 연결을 한 번 더 누르면 돼요.

4. API 키 — 고객사 명의로 발급해 대시보드에 입력

서비스가 쓰는 외부 API(AI · 메일 · 알림톡 · 결제 · 로그인) 키를 회사 명의로 발급해 계정 연결 화면의 입력칸에 붙여넣어요. 필요한 서비스는 프로젝트마다 달라요. 대시보드에는 그 프로젝트에 필요한 것만 나와요. 저장한 뒤에는 앞 여섯 자만 보이고, 다시 넣으면 바뀌어요.

4-1. 모든 서비스에 공통

• 회사 이메일로 가입하고, 결제는 회사 카드를 등록해요.
• 키는 발급하는 순간 한 번만 보여요. 화면을 닫기 전에 대시보드에 붙여넣거나 비밀번호 관리자에 저장하세요.
• 선불 충전형 서비스(앤트로픽 · OpenAI · fal · 솔라피)는 잔액이 0 이 되면 기능이 멈춰요. 자동 충전이나 잔액 알림을 켜 두세요.
• 카톡 · 이메일로 키를 평문으로 보내지 마세요 — 대시보드 입력칸이 그 자리를 대신해요.

4-2. 서비스별 발급 위치와 결제

5. 이전 진행 순서

1. 1단계 · 고객사

   계정을 만들고 대시보드에서 연결해요

   2 · 3 · 4장을 마치면 대시보드의 이전 상태가 「준비 완료」로 바뀌어요. 남은 항목이 있으면 무엇이 빠졌는지 화면에 표시돼요.

2. 2단계 · 헤이제임스

   고객사 계정 안에 새 서버를 만들고 먼저 배포해요

   드로플릿(일일 백업 포함) · 파일 저장소 · 이미지 저장소를 만들고, 회사 GitHub 저장소에 코드를 올린 뒤 자동 빌드로 배포해요. 여기까지는 기존 서비스가 그대로 돌아 사용자에게 영향이 없어요. 진행 내용은 대시보드 「이전 진행 상태」에 단계별로 기록돼요.

3. 3단계 · 헤이제임스 · 고객사

   데이터를 옮기고 도메인을 새 서버로 돌려요

   트래픽이 적은 시간에 30분 안팎 점검 시간을 두고 데이터를 복사해요. 그다음 담당자가 도메인 관리 화면에서 A 레코드를 새 서버 주소로 바꿔요(주소와 방법은 그때 안내해요). 바뀌면 헤이제임스가 새 서버에서 전부 확인해요.

4. 4단계 · 헤이제임스

   인수인계 묶음을 받아요

   계정 목록 · 접근 정보 · 배포 방법 · 복구 방법을 문서로 드려요. 이후 헤이제임스 접근은 대시보드 「연결 해제」로 언제든 끊을 수 있어요. 배포는 회사 GitHub 저장소에서 계속 돼요.

6. 직접 배포하고 싶다면 — 클로드 코드로

이전이 끝나면 배포는 코드를 회사 GitHub 저장소에 올리는 것으로 끝나요. 올리면 GitHub 가 알아서 빌드하고 서버에 반영해요(약 5분, 서비스 중단 없음). 서버 열쇠 · 비밀키는 헤이제임스가 인수인계 때 GitHub 의 비밀 금고(Actions Secrets)에 넣어 둬요. 그래서 담당자 컴퓨터에는 비밀이 없어요. 명령어도 칠 필요 없어요 — 클로드 코드(Claude Code)에게 말로 시키면 돼요.

1. 1

   클로드 코드 설치

   고객사

   docs.claude.com/claude-code 안내대로 설치하고 로그인해요. 회사 GitHub 조직에 담당자 계정이 들어가 있어야 해요(조직 관리자가 초대).

2. 2

   저장소 내려받기

   고객사

   클로드 코드에게 「회사 GitHub 의 <서비스 이름> 저장소를 내려받아 줘」 라고 해요. 저장소 안에 헤이제임스가 남긴 설명 파일(CLAUDE.md)이 있어서 서버 주소나 배포 절차를 따로 알려줄 필요가 없어요.

3. 3

   고치고 「배포해 줘」

   고객사

   고칠 내용을 말로 시키고, 끝나면 「배포해 줘」 라고 해요. 클로드 코드가 커밋해 GitHub 에 올리고, 빌드와 배포가 끝날 때까지 지켜본 뒤 결과를 알려줘요. 진행 상황은 GitHub 저장소의 Actions 탭에서도 볼 수 있어요.

4. 4

   인수인계 때 헤이제임스가 해 두는 것

   헤이제임스

   저장소의 Actions Secrets 에 서버 접속 키 · 앱 비밀키 · DigitalOcean 토큰을 넣고 첫 배포까지 확인해요. 이후 헤이제임스 접근을 끊어도 배포는 그대로 돼요. 로컬 컴퓨터에서 앱을 실행하며 개발하려는 담당자에게만 앱 비밀키(master.key)를 1회용 비밀 링크로 따로 드려요.

7. 자주 묻는 것

궁금한 게 있으면 프로젝트 대시보드의 수정 요청이나 담당 채널로 언제든 물어보세요. 계정 준비가 끝나면 대시보드에 「준비 완료」가 뜨고, 헤이제임스가 이전 일정을 잡아요.