AXHub 웹에서 시작
템플릿을 고르고 완료를 누르면 저장소 생성부터 배포까지 한 번에 끝나요.
AxHub 앱 만들기 페이지는 템플릿을 고르고 완료 한 번이면 — GitHub 저장소 생성 → 템플릿 코드 넣기 → 연결 → 배포까지 알아서 해줘요. 직접 코드를 쓰거나 저장소를 만들 필요가 없어요. 앱이 뜨고 나면 그 저장소를 Claude Code로 열어 키우면 돼요.
공개 범위는 여기서 정하지 않아요. 새 앱은 처음엔 나만 보이는 상태(private) 로 시작하고, 회사에 공개하는 건 나중에 공개·접근 관리에서 해요.
준비물
- AxHub 계정 — 소속 회사의
tenant_admin에게 초대 요청 - GitHub 계정 — axhub GitHub App을 설치할 수 있는 계정(또는 org)
기본 정보 입력
앱 메뉴 → 앱 만들기. 맨 위 기본 정보에서 세 칸을 채워요.
앱 이름부터 입력하면, 그 이름을 바탕으로 서브 도메인과 슬러그가 자동으로 채워져요. 마음에 안 들면 각 칸을 직접 고치면 돼요.
| 항목 | 무엇인가요 | 규칙 |
|---|---|---|
| 앱 이름 | 동료가 알아볼 표시 이름 | 1~100자, 한글도 OK |
| 서브 도메인 | 앱 접속 주소예요 — {서브도메인}.{회사}.axhub.ai 형태로 만들어져요 | 영문 소문자·숫자·하이픈, 2~32자 |
| 슬러그 | 회사 안에서 앱을 식별하는 키 — URL·관리 화면에서 쓰여요 | 영문 소문자·숫자·하이픈, 2~64자 |
앱 이름을 한글로 적으면 서브 도메인·슬러그가 자동으로 채워지지 않아요. 그 두 칸은 영문으로 직접 입력하세요. (예: 이름 내 할일 → 서브 도메인·슬러그 my-todo)
템플릿 고르기
시작 템플릿을 하나 골라요. 고른 템플릿의 코드가 새 저장소에 그대로 들어가서, 빈 화면이 아니라 이미 동작하는 앱으로 시작해요.
| 템플릿 | 어떤 앱에 좋아요 | Pod 사양 |
|---|---|---|
| Vite + React SPA | 정적 React 앱 — 가장 빠른 시작. 클라이언트 사이드만, 외부 API 호출은 가능해요 | S |
| Next.js App Router | React 풀스택 SSR — 서버 컴포넌트·서버 액션을 써요 | M |
| Astro | 콘텐츠 사이트·블로그 — 정적 우선, 필요한 곳만 동적(island) | M |
고민되면 — 화면+서버가 함께 필요한 웹앱은 Next.js App Router, 가벼운 단일 화면 위주면 Vite + React SPA로 시작하면 무난해요.
Pod 사양이란? — 각 템플릿 카드에 표시되는 Pod 사양은 앱이 받는 CPU·메모리 크기예요. 화면의 Pod 사양이란? 버튼을 누르면 아래 표가 나와요. 템플릿마다 권장값이 정해져 있고(기본 M), 앱을 만든 뒤 설정에서 바꿀 수 있어요.
| 사양 | 용도 | CPU | 메모리 |
|---|---|---|---|
| S · Small | 가벼운 작업용 | 250m ~ 1000m | 384Mi ~ 768Mi |
| M · Medium (기본) | 표준 | 500m ~ 2000m | 768Mi ~ 1536Mi |
| L · Large | 트래픽이 많은 앱 | 1000m ~ 3000m | 1536Mi ~ 2560Mi |
| XL · XLarge | 고부하 전용 | 2000m ~ 4000m | 3Gi ~ 5Gi |
숫자가 낯설어도 괜찮아요. 1000m은 CPU 1개, Mi·Gi는 메모리 단위예요. 대부분 기본값 M으로 충분하고, 앱이 느려지면 나중에 키우면 돼요.
Git 저장소 연결
GitHub App 설치 (처음 한 번)
저장소 이름 정하기
같은 이름의 저장소가 이미 있으면 실패해요(repo_exists). 다른 이름으로 다시 시도하세요.
완료 — 한 번에 배포까지
완료를 누르면 진행 화면이 뜨고, 아래 순서로 자동 진행돼요.
앱 생성 → 저장소 생성 → 템플릿 코드 넣기 → 연결 → 배포끝나면 개발중 탭으로 이동하고, 앱 URL이 생겨요. 열어서 템플릿이 떠 있는지 확인하세요.
앱 개발하기
이제 만들어진 저장소를 Claude Code로 열어 기능을 더하면 돼요. 이 저장소는 이미 AxHub용으로 세팅(포트·구조)돼 있어요.
이 AxHub 앱에 [기능]을 추가해줘.
- 비밀값은 코드에 넣지 말고 환경변수(process.env)로 읽어줘
- 로그인 사용자 정보는 서버에서 X-AxHub-User-ID, X-AxHub-App-Role 헤더로 읽어줘수정한 코드를 GitHub에 push하면 배포가 다시 시작돼요. 비밀값·헤더·SDK·재배포 자세한 건 앱 개발하기에서 다뤄요.