LaunchRepo권장 환경: LaunchRepo를 가장 잘 활용하려면 Claude나 Codex 데스크톱 앱 대신 터미널에서 Claude Code CLI 또는 Codex CLI를 사용할 것을 강력히 권장합니다. 이는 저희가 권장하는 워크플로일 뿐이며, 권한이 달라지거나 작업이 중단 없이 실행된다는 보장은 아닙니다.
툴킷 자체의 시작 페이지는 한 화면에 다 들어갑니다. 클론하고, 프롬프트 하나를 붙여 넣고, 링크를 열면 끝입니다. 이 가이드는 같은 세 단계를 따라가면서 각 단계 뒤에서 무슨 일이 일어나는지 조금 더 자세히 설명합니다. 그래야 에이전트가 무엇을 하고 있는지, 끝난 뒤 무엇을 확인해야 하는지 알 수 있습니다. 전체 그림부터 보고 싶다면 작동 방식 페이지에서 이 단계들이 제품 → 에이전트 → 디렉터리 → 트래커로 이어지는 전체 흐름의 어디쯤에 있는지 확인하세요.
시작하기 전에 필요한 것
초기 설정에는 다음이 필요합니다.
- 저장소를 클론할 Git.
- Windows, macOS, Linux에서 쓸 수 있는 Python 3.10 이상. 워크스페이스 스크립트, 트래커, 로컬 대시보드는 모두 표준 라이브러리만 쓰는 Python이라
pip install할 것도, 빌드 단계도 없습니다. - 파일을 읽고 명령을 실행할 수 있는 코딩 에이전트: Claude Code, Codex, Cursor 또는 비슷한 도구. 이 사이트에는 도구별 설정 페이지가 따로 있습니다. 예를 들어 Claude Code, Codex, Cursor 페이지를 참고하세요. 브라우저 제어는 나중 일이라 처음 세 단계에는 필요 없습니다.
저장소는 결제할 때 입력한 계정 앞으로 GitHub 초대 형태로 전달됩니다. 아래 내용은 모두 그 초대를 수락했다는 전제로 설명합니다.
1단계: 클론하고 열기
Windows에서는 아래 명령의 python3 대신 py -3를 사용하세요(Python 3.10 이상을 실행하는 명령이 python이라면 그것을 써도 됩니다). 워크스페이스는 OneDrive 같은 동기화 폴더가 아닌 비공개 로컬 폴더에 두세요.
git clone <your LaunchRepo invite URL> LaunchRepo
cd LaunchRepo평소 프로젝트를 여는 방식대로 이 폴더를 에이전트에서 여세요. 아직 아무것도 실행되지 않습니다. 방금 받은 체크아웃은 플레이북, 템플릿, 스크립트, 문서가 담긴 전달용 저장소입니다. 제품, 자격 증명, 제출 기록은 여기에 두지 않습니다. 2단계가 있는 이유가 바로 이것입니다.
2단계: 시작 프롬프트 붙여 넣기
다음 문장을 한 글자도 바꾸지 말고 에이전트에 붙여 넣으세요.
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.
AGENTS.md는 모든 AI 코딩 에이전트가 가장 먼저 읽는 파일로, 정확한 시작 절차와 에이전트가 반드시 수행해야 할 확인 항목이 들어 있습니다. 이 절차에 따라 에이전트는 다음을 수행합니다.
scripts/init-workspace.py로 체크아웃 옆에 비공개 워크스페이스(기본값은 같은 위치의 형제 폴더)를 만듭니다. 제품 데이터가 공유 전달용 저장소에 들어가지 않게 하기 위해서입니다.- 그 워크스페이스 안에서 로컬 대시보드를 시작합니다.
127.0.0.1링크로 답합니다.
에이전트가 링크로 답했다면 2단계는 성공입니다. 링크 대신 무엇을 할 것인지 설명만 한다면 실제로 절차를 실행해 달라고 요청하세요. 툴킷의 원칙상 확인은 지침이 있을 때가 아니라 실제로 관찰됐을 때 비로소 완료됩니다.
3단계: 링크 열기
첫 세션의 나머지는 대시보드 탭에서 진행됩니다. 여기서 첫 제품을 추가하고, 온보딩 프롬프트를 다시 에이전트에게 넘기고, 어떤 등록이 게시됐는지, 검토 대기 중인지, 예약됐는지, 내 조치를 기다리는지 확인하고, 이후 실행에 쓸 프롬프트를 복사합니다. 대시보드는 127.0.0.1에만 바인딩되며 디렉터리에 접속하는 일은 없습니다. 각 화면은 로컬 대시보드 가이드에서 다룹니다.
작업이 끝나면 에이전트의 터미널에서 Ctrl+C를 누르거나 에이전트에게 서버를 중지해 달라고 하세요. 워크스페이스와 거기에 기록된 모든 내용은 디스크에 그대로 남습니다.
직접 설정하기
설정 자체에는 에이전트가 필요 없습니다. 프롬프트가 실행하는 세 명령은 다음과 같습니다.
python3 scripts/init-workspace.py --destination ../my-launch-workspace
cd ../my-launch-workspace
python3 scripts/dashboard.py워크스페이스를 만들기 전에 먼저 둘러보고 싶나요? python3 scripts/dashboard.py --demo를 실행하면 가상의 제품이 들어 있는 일회용 샘플 워크스페이스가 열립니다. 내 데이터는 건드리지 않고 개요, 제품 페이지, 카탈로그를 클릭해 볼 수 있습니다.
다음 단계
본격적인 첫 세션(제품 브리프, 브라우저 연결, 권한, 저장된 실행 목표)은 에이전트가 이끌며, 첫 세션 온보딩 가이드에서 설명합니다. 에이전트가 폼을 채우려면 먼저 에이전트를 내 Chrome에 연결해야 합니다. 이야기 형식으로 먼저 읽고 싶다면 Claude Code 워크스루가 출시 하나를 처음부터 끝까지 따라갑니다. 온보딩을 마친 뒤에는 런치 실행, 처음부터 끝까지에서 이후의 모든 실행이 권한 확인부터 남은 플랫폼 재개까지 어떻게 진행되는지 볼 수 있습니다.