AI용 분할본 · 지도 1단계(구조·준비) · 이 페이지 전에 읽을 페이지: PART 0 사용법·AI 시작 지침, PART 1 구조·정책 · 코드 파일은 여기 없다 — 코드 자리의 줄을 따른다(폴더에 책 파일이 하나도 없는 처음이면 부록 A-2 의 curl 한 줄부터)

핵심 규칙 — AI 는 어느 페이지에서든 이것을 지킨다

  1. 사용자가 결정 질문(PART 0 지침 1)에 답하고 승인하기 전에는 코드를 한 줄도 쓰지 않는다.
  2. HRUM API 키는 서버 환경변수 HRUM_API_KEY 에만 둔다. 미니앱 코드·.env·채팅·커밋·로그에 쓰지 않고, 키 값을 사용자에게 달라고 하지 않는다. 미니앱은 내 서버만 부른다.
  3. 책 코드 파일은 다시 쓰지 않는다 — node scripts/get-book-code.mjs 가 책 그대로 만든다(처음에는 부록 A-2 의 curl 한 줄). 분할본의 코드 자리는 「경로」 한 줄이다 — 받은 파일을 cat 으로 읽는다.
  4. 앱인토스 내용은 각 장 끝 출처의 공식 문서가 우선이다. 다르면 문서를 따르고 사용자에게 알린다.
  5. 확인은 명령 출력으로 증명한다. 콘솔 화면(앱인토스·HRUM)은 사용자가 누르고, AI 는 대신 가입·로그인하지 않는다. 진행은 PROGRESS.md 에 적는다.
  6. AI 는 지도(https://console.hrum.ai/tossEbook/ — 같은 지도가 tossEbook/ai.html 에도 있다)의 단계 순서대로 그 단계의 페이지만 읽는다. 전체본 tossEbook.html 은 사람용이다.

PART 2 — 계정과 준비물

2-1. 앱인토스 콘솔 — 가입·워크스페이스·앱 등록

① 가입 — 앱인토스 콘솔에 접속해 회원가입합니다. 토스 비즈니스 회원을 기반으로 하며, 만 19세 이상이고 본인 명의로 로그인된 토스 앱이 있어야 합니다.

② 워크스페이스 — 팀이 함께 앱을 관리하는 공간입니다. 사업자당 1개만 만들 수 있고 이름은 겹칠 수 없습니다. 이어서 제작자 이름을 넣습니다. 미니앱 상세 화면에 「누가 만들었는지」로 보이는 이름이고, 공백을 포함해 10자 이내, 한글·영문·숫자만 쓸 수 있고, 토스 브랜드를 도용하거나 헷갈리게 하는 이름(예: 「토스OO」)은 쓸 수 없습니다. 나중에 워크스페이스 「내 정보」에서 바꿀 수 있습니다.

③ 앱 등록 — 워크스페이스의 앱 메뉴에서 +등록하기를 누릅니다. 개발이 끝나지 않은 앱도 먼저 등록할 수 있습니다.

테스트용 앱과 실제 배포용 앱을 같은 워크스페이스에 따로 등록해 나눠 관리할 수도 있습니다. 다만 서비스 오픈 정책은 핵심 기능이 비슷한 앱을 여러 개 출시하는 것을 막습니다 — 출시는 하나만 합니다.

사업자 등록: 이 책의 예시(로그인·결제·광고 없음)에는 필수가 아닙니다. 나중에 토스 로그인·인앱 결제·토스페이 등을 붙이려면 워크스페이스 「내 정보」에서 사업자 등록이 필요하고, 사업자 등록증의 업종과 미니앱 서비스 업종이 같아야 합니다. 부가세 면세 사업자는 등록할 수 없습니다.

2-2. HRUM 콘솔 — 가입·API 키·요청 제한

  1. HRUM 콘솔 로그인 화면에서 회원가입 탭을 고르고 이메일과 비밀번호를 넣습니다. 받은 편지함의 이메일 인증 메일에서 인증 버튼을 누른 뒤 다시 로그인합니다
  2. 콘솔 → API 키에서 키 제목(예: 토스 미니앱 서버)을 적고 발급합니다. 새 키는 발급 직후 한 번만 보입니다. 바로 복사해 비밀번호 관리자 같은 안전한 곳에 둡니다. AI 채팅창·파일·메모에 붙여넣지 않습니다 — PART 5 에서 RIDM Apps 환경변수 칸에 여러분이 직접 넣습니다
  3. 같은 화면의 요청 제한에서 초당·일일 요청 수를 정해 둡니다. 키가 새거나 코드가 잘못 반복해도 잔액을 지키는 마지막 울타리입니다
  4. 호출 비용은 선불 크레딧에서 차감됩니다. 크레딧은 콘솔 → 빌링에서 충전하고, 상품별 금액은 요금표와 콘솔 → 사용량에서 봅니다. 금액은 늘 이 화면들의 값을 기준으로 합니다

2-3. 내 컴퓨터

출처

앱인토스 내용은 2026-10-28 에 앱인토스 개발자센터 문서를 직접 읽고 요약했고, 2026-10-30 에 문서와 다시 대조했습니다. 정책·화면은 바뀔 수 있으니 시작 전에 원문을 다시 확인하세요.

AI용 분할본 · 지도 1단계(구조·준비) · 이 페이지 전에 읽을 페이지: PART 0 사용법·AI 시작 지침, PART 1 구조·정책 · 코드 파일은 여기 없다 — 코드 자리의 줄을 따른다(폴더에 책 파일이 하나도 없는 처음이면 부록 A-2 의 curl 한 줄부터)