블로그

Claude Code로 디렉터리에 SaaS 출시하기: 따라 하기

Claude Code로 디렉터리 출시 실행 한 번을 처음부터 끝까지 따라가 봅니다. 그대로 붙여 넣는 시작 프롬프트, 온보딩, Chrome 연결, 실제 도구 출력, 그리고 트래커가 기록하는 11가지 상태를 모두 설명합니다.

글쓴이 게시일 11분 분량

이 글은 Claude Code로 진행하는 LaunchRepo 실행 한 번을 실제 순서 그대로 보여 줍니다. 붙여 넣는 프롬프트, 에이전트가 묻는 질문, 브라우저 연결, 계획된 실행, 그리고 트래커가 기록할 수 있는 모든 상태입니다. 기준은 2026년 9월 29일에 나온 툴킷 릴리스 1.9.0이며, 아래에 나오는 터미널 출력은 2026년 9월 30일에 툴킷 자체 스크립트를 실제로 실행한 결과입니다. LaunchRepo가 Claude Code와 맞는지부터 알고 싶다면 Claude Code 페이지가 한 화면으로 답해 줍니다. 런치 실행 가이드는 같은 실행을 어떤 에이전트에나 맞게 설명합니다.

요약하면 이렇습니다. Claude Code는 플레이북을 읽고, 폼을 채우고, 트래커에 기록하는 반복 작업을 맡습니다. 나는 사람만 가져올 수 있는 네 가지를 준비합니다. 제품 정보, 로그인된 Chrome, 문구에 대한 승인, 그리고 플랫폼이 사람에게만 맡기는 CAPTCHA와 2단계 인증입니다. 모든 등록은 여전히 디렉터리가 결정하고 무료 검토는 몇 주씩 걸리는 경우가 많습니다. 그래서 실행의 목표는 즉시 생기는 페이지가 아니라 정직하고 확인된 제출의 묶음입니다.

실행 한눈에 보기

단계 Claude Code가 하는 일 내가 하는 일 잘 됐다는 증거
1. 시작 프롬프트 비공개 워크스페이스를 만들고 대시보드를 시작 프롬프트 하나 붙여 넣기 127.0.0.1 링크가 열림
2. 온보딩 인터뷰를 하고 product.json과 copy.md를 채움 답하고, 고치고, 승인하기 내가 서명할 수 있는 브리프
3. Chrome Chrome DevTools MCP를 설정하고 눈에 보이는 테스트를 실행 원격 디버깅을 켜고 Chrome의 확인 창 승인하기 탭이 움직이는 것을 직접 봄
4. 권한 제품마다 한 번 범위를 기록 배지, 계정, 이메일에 대해 결정하기 authorizations.json
5. 실행 제출 10건을 계획하고 한 번에 한 플랫폼씩 처리 요청이 오면 넘겨받은 일 해결하기 대시보드의 확인된 개수
6. 트래커 결과마다 증거와 함께 기록 공개된 등록 페이지 확인하기 플랫폼마다 상태 하나
7. 이어서 하기 진행 상황과 다음 날짜를 저장 다음 세션까지 할 일 없음 다음 에이전트가 이어서 진행

0단계: 준비물

  • 저장소. 구매하면 비공개 GitHub 저장소 초대를 받습니다. 클론한 뒤 그 폴더를 Claude Code에서 엽니다.
  • Git과 Python 3.10 이상, Windows, macOS, Linux 모두 가능합니다. 트래커, 대시보드, 보조 스크립트는 Python 표준 라이브러리만 쓰므로 따로 설치할 것이 없습니다. Windows에서는 문서에 python3라고 적힌 곳마다 py -3을 씁니다.
  • Chrome, 최신 Node.js LTS, npm은 브라우저 연결에 필요합니다. 툴킷은 Chrome DevTools MCP로 연결하며, --autoConnect 모드에는 Chrome 144 이상이 필요합니다.
  • 제품 정보: 이름, URL, 대상 사용자, 실제 기능, 현재 가격, 출시 단계, 진짜 스크린샷과 로고입니다.

저장소는 데스크톱 앱보다 터미널에서 CLI로 Claude Code를 실행하길 권장합니다. 그것이 문서화된 작업 방식이고, 시작 프롬프트도 이를 한 번 알려 줍니다.

1단계: 시작 프롬프트

START.md에 있는 프롬프트를 적힌 그대로 붙여 넣습니다.

Recommend Claude Code CLI or Codex CLI in a terminal instead of the desktop apps for best results. If session metadata confirms desktop hosting, explicitly advise me to switch to the CLI and resume this same private workspace. Do not infer the host from a CLI engine version alone. Read AGENTS.md, then follow “Start the dashboard for the owner”. Create my private workspace if I do not have one yet, start the dashboard, and give me the link. Then lead ONBOARDING.md one phase at a time. Reuse recorded permissions instead of asking again unless their scope is missing or conflicting. Actually test my visible existing Chrome profile and intended identity as BROWSER-SETUP.md requires; use the OS fallback if needed. Use one platform/browser worker by default. Build the normal run only from suitable free-ready routes, keep research separate, and preserve any draft that needs one exact human CAPTCHA/2FA action. Never claim browser control bypasses or reduces those challenges.

프롬프트는 영어 그대로 둡니다. Claude Code는 지침을 읽은 뒤 내 언어로 답합니다. 에이전트는 체크아웃 폴더 옆에 비공개 워크스페이스를 만들기 때문에, 내 제품과 로그인 정보는 배포용 저장소에 절대 들어가지 않습니다. 그다음 로컬 대시보드를 시작하고 127.0.0.1 링크로 답합니다. 이후의 모든 일은 그 탭에서 해도 되고 채팅에서 해도 됩니다. 대시보드의 폼이 에이전트가 읽는 바로 그 파일에 기록하기 때문입니다.

결정하기 전에 먼저 둘러보고 싶나요? python3 scripts/dashboard.py --demo를 실행하면 가상의 제품이 들어 있는 일회용 워크스페이스가 열립니다.

2단계: 온보딩 인터뷰

ONBOARDING.md는 일곱 단계로 되어 있고, 에이전트는 한 번에 한 단계씩 진행합니다. 무엇을 묻기 전에 기존 파일부터 읽기 때문에 두 번째 세션이 첫 번째 세션을 반복하지 않습니다.

현재 위치. 에이전트는 첫 제품의 이름, URL, 그리고 코드나 메모가 있는 폴더를 묻고, 추가 질문 전에 그 자료를 살펴봅니다. 내 OS가 무엇인지, 실제로 호출할 수 있는 브라우저 도구가 무엇인지도 확인합니다. 지침은 이 부분에서 단호합니다. 터미널만으로는 브라우저를 제어할 수 없으며, 에이전트는 세션에 없는 도구를 있다고 주장해서는 안 됩니다.

비공개 보관소. Claude Code는 워크스페이스용 비공개 원격 저장소를 직접 만들도록 도와주고, 그곳에 저장한 로그인 정보는 이력을 포함해 그 저장소에 접근할 수 있는 모든 사람이 읽을 수 있다고 설명합니다. 선택은 내가 합니다. 로그인 정보를 워크스페이스에 둘지, 비밀 관리 도구에 대한 참조만 둘지, 아무것도 두지 않을지입니다. 또 비밀 정보와 이메일 주소를 지운 상태로 문제를 LaunchRepo 관리자에게 GitHub 이슈로 보고해도 되는지 한 번 묻습니다. 답이 없으면 거절로 간주합니다.

제품. 스크립트가 제품 폴더를 만들면, 에이전트는 내 답변으로 제품 컨텍스트 파일인 product.json을 채우고 카피 워크숍을 진행합니다. 워크숍은 필드 길이 제한별 변형을 담은 copy.md를 만듭니다. 모르는 내용은 비워 둡니다. 계획 중인 기능이 이미 있는 기능으로 바뀌는 일은 없습니다.

이 단계에서 출시일 하한선도 정합니다. 무료 등급 디렉터리 중 상당수는 제출을 몇 주 동안 검토 대기열에 두기 때문에, 에이전트는 그 전에는 아무것도 공개되면 안 되는 날짜가 있는지 묻습니다. 그러면 트래커는 그 날짜 이전의 scheduled 기록을 모두 거부합니다.

신원. identity.json에는 공개 이름, 로그인 이메일, 그리고 공개를 허락한 조직 정보가 들어갑니다. 이 중 무엇이든 등록 페이지에 실리기 전에 에이전트는 공개 소개 확인을 진행합니다. 나에 관한 짧은 예시 문장 세 개를 그대로 보여 주고 고칠 수 있게 하는 과정입니다.

3단계: Chrome과 메일함 연결

나머지 모든 것을 가능하게 하는 단계입니다. 에이전트에게는 내가 보고 감독할 수 있는 브라우저가 필요하고, BROWSER-SETUP.md는 정확히 한 가지 연결 방식만 지원합니다. Chrome 원격 디버깅 위에서 동작하는 Chrome DevTools MCP입니다. Chrome 연결 가이드가 두 가지 경로를 차례로 안내합니다.

경로 A: 지금 쓰는 Chrome. chrome://version에서 버전(144 이상)을 확인하고, 에이전트가 쓸 Chrome에서 chrome://inspect/#remote-debugging을 열어 원격 디버깅을 켭니다. 그다음 claude mcp add로 Claude Code에 서버를 등록합니다. 정확한 명령은 Chrome DevTools MCP 클라이언트 가이드에 있고, 저장소는 여기에 --autoConnect를 붙입니다. 서버를 이 프로젝트에서만 쓰고 싶다면 Claude Code 자체의 MCP 문서가 범위 설정을 설명합니다.

경로 B: 전용 프로필. 원격 디버깅 설정이 없거나 자동 연결이 실패하면, Chrome은 워크스페이스 안의 자체 프로필 폴더와 로컬 디버깅 포트로 시작하고 설정에는 대신 --browserUrl을 씁니다. 그 창에서 한 번만 로그인하면 됩니다. 포트는 localhost 밖으로 나가지 않으며 쿠키는 절대 복사되지 않습니다.

그다음이 눈에 보이는 테스트입니다. 내가 사용할 프로필에서 빈 탭을 열면, 에이전트가 그 탭을 https://example.com/로 이동시켜 “Example Domain”(예시 도메인) 제목을 읽고, 나는 바로 그 탭이 움직였는지 확인합니다. 이것은 Chrome DevTools Protocol을 통해 이 탭 하나를 제어할 수 있다는 증거일 뿐, 그 이상은 아닙니다. 실행 중인 MCP 프로세스나 완료된 OAuth 화면은 증거가 되지 않습니다. macOS에서는 이런 연결에 보통 손쉬운 사용, 자동화, 화면 기록 권한이 필요 없습니다. 첫 실제 로그인 뒤에는 에이전트가 계정 메뉴에서 올바른 신원인지 확인하고 메일함 접근도 확인합니다. 대부분의 가입은 인증 메일로 마무리되기 때문입니다. 코드를 직접 전달하는 방법도 지원되는 대안이며, 트래커는 이를 사람에게 넘긴 작업으로 기록합니다.

재연결 후에는 Chrome이 연결 확인 창을 다시 띄울 수 있습니다. 이것은 보안 장치이며, 에이전트는 이 창이 없어진다고 약속하거나 CAPTCHA를 우회해서는 안 된다고 지시받습니다.

4단계: 권한, 제품마다 한 번

무엇이든 제출하기 전에 에이전트는 WEBSITE-AND-EMAIL.md를 읽고 다시는 묻지 않을 몇 가지 질문을 합니다. 웹사이트 코드가 어디에 있는지, 어떻게 배포되는지, 어느 브랜치가 프로덕션인지, 그리고 필수 디렉터리 배지를 푸터에 추가하고 커밋해서 다시 배포해도 되는지입니다. 무료 가입, 무료 최종 제출, 그에 따른 인증 메일 처리를 허용하는지도 묻습니다. 답변, 날짜, 정확한 범위는 authorizations.json에 기록됩니다. 지출은 0으로 유지되며 모든 유료 업셀은 거절합니다.

배지를 거절해도 괜찮습니다. 배지를 요구하는 디렉터리만 제외될 뿐입니다. 제품마다 권한을 따로 부여하므로, 한 제품에 대한 허락이 다음 제품으로 넘어가는 일은 없습니다.

5단계: 실행을 계획하고 카운터 지켜보기

이제 doctor.py가 빠진 설정과 내가 거절한 권한을 구분하고, 에이전트가 실행 플래너를 엽니다. 기본값은 의도적으로 정해져 있습니다. 새 제출 10건, 브라우저 작업자 1개, 전체 활성 시간 150분, 플랫폼당 15분. 대기열에는 바로 쓸 수 있는 무료 경로만 들어갑니다. 최신이고, 근거가 있고, 작동하며, 조건 없이 무료인 경로입니다. 조건이 붙은 경로는 필요한 준비 사항과 함께 따로 표시됩니다. 적합한 경로가 목표보다 적으면 에이전트는 더 작지만 사실에 맞는 실행을 제안합니다. Claude Code가 /goal을 지원하는 곳에서는 생성된 목표를 거기에 쓰도록 제안하고, 그렇지 않으면 같은 문장을 일반 프롬프트로 쓰면 됩니다.

실행이 터미널에서 어떻게 보이는지 살펴봅시다. 2026년 9월 30일에 툴킷 스크립트로 새 워크스페이스와 빈 제품을 만들고 문서에 나온 명령을 실행했습니다. 아래 줄들은 그 실행에서 그대로 복사한 것이며, 관련 필드만 남기고 줄였습니다.

$ python3 scripts/run.py --project projects/my-product start --target 10 --total-minutes 150 --platform-minutes 15
  "target": 10,
  "parallel": 1,
  "remaining": 10,
$ python3 scripts/run.py --project projects/my-product claim pitchwall --worker worker-1 --window window-1
$ python3 scripts/record.py --project projects/my-product pitchwall live --worker worker-1 --note 'Thank-you page shown' --next-action 'Open the public listing'
Tracker rejected input: Public states require a reviewed URL and --confirmed-public
$ python3 scripts/record.py --project projects/my-product pitchwall submitted_pending_review --worker worker-1 --note 'Dashboard confirms Under Review' --next-action 'Recheck after the stated review window'
Recorded pitchwall: submitted_pending_review
$ python3 scripts/run.py --project projects/my-product status
  "completed_count": 1,
  "remaining": 9,

눈여겨볼 점이 두 가지 있습니다. 트래커는 감사 인사 페이지를 live로 기록하길 거부했습니다. 공개 상태에는 검토된 URL과 나의 명시적 확인이 필요하기 때문입니다. 그리고 정직한 기록, 즉 검토 중인 제출은 카운터를 남은 10건에서 9건으로 줄였습니다. 접수 확인도 목표에 포함되므로, 실행이 진전됐는지 알기 위해 몇 주씩 게시를 기다릴 필요가 없습니다.

진행 중에 넘겨받을 일이 생긴다고 예상하세요. CAPTCHA, 2단계 인증, 또는 불분명한 계정 상태가 나타나면 에이전트는 초안을 열어 둔 채 나에게 필요한 조치를 정확히 하나 적어 prepared_needs_human을 기록하고, 대시보드는 이를 “내 조치 필요” 아래에 보여 줍니다. 같은 창에서 해결하면 실행이 계속됩니다.

6단계: 트래커 상태의 의미

모든 결과는 record.py를 거쳐 submissions.json에 기록되고, 대시보드에도 같은 열한 가지 상태가 표시됩니다. 상태마다 최소한의 관찰 요건이 있어서 결과를 부풀릴 수 없습니다. 실행 카운터를 움직이는 상태는 그중 네 가지뿐입니다.

상태 최소 관찰 요건 실행 목표에 포함
draft 작업은 준비됐지만 최종 제출은 확인되지 않음 아니요
prepared_needs_human 나만 해결할 수 있는 구체적인 장애물 하나 아니요
submitted_pending_review 플랫폼이 접수를 확인했고 모더레이션 대기 중 예
queued 플랫폼이 대기열 순번을 확인함 예
scheduled 출시일 하한선 당일 또는 그 이후로 확정된 날짜 예
live 검토된 공개 URL과 나의 확인 예
already_listed 이미 있는 공개 등록 페이지, 게시됨과 같은 증거 필요 아니요
blocked 자격 요건, 계정 한도 또는 빠진 정보 아니요
deferred_paid 쓸 수 있는 경로가 유료뿐이며 아무것도 구매하지 않음 아니요
not_a_fit 대상 사용자나 등록 기준이 맞지 않음 아니요
unavailable 지금은 그 경로를 쓸 수 없음 아니요

나중에 상태가 몇 번 바뀌든 각 플랫폼은 실행당 한 번만 집계됩니다. 등록 상태 항목이 용어를 설명하고, 상태 추적 가이드는 두 번째 사이트 게시를 약속하는 파트너 체크박스 같은 예외 상황을 다룹니다.

7단계: 이어서 할 수 있는 워크스페이스 남기기

세션이 끝날 때 에이전트는 실제로 관찰한 확인 항목에만 온보딩 체크 표시를 하고, 민감하지 않은 증거와 남은 단계를 SESSION.md에, 다음 날짜를 FOLLOW-UP.md에 적은 뒤, 내 비공개 원격 저장소에 푸시하기 전에 git 개인정보 점검을 실행합니다. 다음 세션은 내가 하든 다른 에이전트가 하든 트래커부터 읽습니다. 넘겨받을 일, 확인할 때가 된 예약 출시, 그리고 검토 기간이 지난 검토 대기 항목 순서입니다. 두 번 제출하지 않고 기존 기록을 다시 확인합니다.

이것이 진짜 보상입니다. 두 번째 제품은 브라우저 설정, 신원, 권한 패턴, 그리고 2026년 9월 24일 기준 카탈로그 스냅숏의 활성 플레이북 299개를 그대로 재사용합니다. 새로 만드는 것은 product.json과 문구뿐입니다.

다음으로 볼 곳

작동 방식은 창업자 영상과 함께 단계를 보여 줍니다. 디렉터리 카탈로그에서는 결정하기 전에 공개된 현장 가이드 몇 개를 읽어 볼 수 있고, 업데이트 내역에는 툴킷의 모든 릴리스가 나와 있습니다. Claude Code에게 마케팅 문구도 맡기고 싶나요? Claude Code 마케팅 스킬을 비교해 보세요. 다른 에이전트는 에이전트 페이지에서 다룹니다. 저장소 자체는 가격 페이지에서 한 번 구매합니다.

자주 묻는 질문

Claude Code가 내 SaaS를 디렉터리에 스스로 제출할 수 있나요?

대부분은 그렇습니다. 저장소, 연결된 Chrome, 그리고 내 권한이 있으면 Claude Code가 각 플레이북을 읽고, 폼을 채우고, 결과를 기록합니다. 나는 문구를 승인하고, 공개된 등록 페이지를 확인하며, 실행이 나를 위해 멈추면 CAPTCHA나 2단계 인증을 해결합니다.

Claude Code CLI가 필요한가요, 아니면 데스크톱 앱으로도 되나요?

저장소는 가장 좋은 결과를 위해 터미널의 CLI를 권장하고, 시작 프롬프트도 그렇게 안내합니다. 데스크톱 앱이 막혀 있는 것은 아닙니다. 그대로 머물러도 에이전트는 허락된 작업을 계속하고, 저장된 진행 상황도 그대로 유지됩니다.

첫 실행에는 얼마나 걸리나요?

플래너는 플랫폼 10곳에 활성 시간 150분, 플랫폼당 15분을 배정합니다. 이는 도달하면 실행을 멈추는 조율용 한도일 뿐 속도에 대한 약속이 아니며, 넘겨받은 일에 쓰는 시간은 플랫폼에 따라 달라집니다.

디렉터리에 CAPTCHA가 나타나면 어떻게 되나요?

에이전트는 그 확인 단계에서 멈추고, 초안을 열어 둔 채 나에게 필요한 정확한 조치 하나와 함께 prepared_needs_human을 기록합니다. 같은 창에서 해결하면 실행은 거기서부터 이어집니다.

같은 과정이 Codex나 Cursor에서도 통하나요?

네. 저장소를 읽고 Chrome DevTools MCP를 쓸 수 있는 에이전트라면 파일, 트래커, 브라우저 설정이 모두 같습니다. 도구마다 다른 점은 에이전트 페이지에 정리되어 있습니다.

출처: LaunchRepo 툴킷(릴리스 1.9.0, 2026년 9월 29일)의 START.md, ONBOARDING.md, BROWSER-SETUP.md, WEBSITE-AND-EMAIL.md, RUNBOOK.md, CHANGELOG.md; 원문 그대로 인용한 시작 프롬프트; 2026년 9월 30일에 실행한 run.py와 record.py; 2026년 9월 30일에 확인한 Chrome DevTools MCP 설정 레퍼런스(--autoConnect에는 Chrome 144 이상 필요). 고객 전반에 걸친 소요 시간이나 결과 수치는 측정한 적이 없으므로 제시하지 않습니다.

  • claude-code
  • walkthrough
  • tracker
  • agents

에이전트에게 전체 목록을 건네세요

LaunchRepo는 AI 코딩 에이전트가 실행하는 저장소입니다. 디렉터리 플레이북 299개, 제품 템플릿, 트래커가 들어 있습니다. 현재 가격 €49.00에 한 번 결제하고, 만드는 모든 제품에 쓰세요.

가격 보기