빠른 시작

Claude Code 플러그인으로 첫 앱을 만들어 배포하는 가장 빠른 길

가장 빠른 길은 Claude Code 플러그인이에요. 플러그인을 깔고 자연어로 말하면, 설치·로그인부터 앱 만들기·배포까지 알아서 진행해요. 터미널에서 직접 하고 싶다면 아래 터미널 방법도 있어요.

준비물

AxHub를 도입한 회사의 멤버 계정
GitHub 계정
Claude Code (플러그인을 설치할 곳)

플러그인 설치

Claude Code 프롬프트에 두 줄을 차례로 입력해요.

/plugin marketplace add jocoding-ax-partners/axhub
/plugin install axhub@axhub

셋업하기

설치가 끝나면 이렇게 말해요.

셋업해줘

플러그인이 CLI 설치 → 로그인 → 환경 점검을 순서대로 안내해요. 필요한 게 빠져 있으면(예: 실행 환경) 동의를 받고 깔아줘요. 처음 한 번만 하면 돼요.

앱 만들기

만들고 싶은 걸 그냥 말하면 돼요.

Next.js 앱 만들어줘

플러그인이 템플릿을 고르고, GitHub 저장소를 만들고, 첫 배포까지 한 번에 진행해요. Next.js·Vite·Astro 같은 템플릿을 쓸 수 있어요.

배포처럼 실제로 무언가를 바꾸는 작업은, 진행 전에 한 번 더 확인을 받아요. 그대로 두거나 멈출 수 있어요.

배포하고 확인하기

코드를 고친 뒤에도 말로 배포하고 결과를 확인해요.

이 앱 배포해줘
앱 열어줘
왜 실패했어?

마지막 한마디면 실패한 배포의 로그를 가져와 원인을 짚어줘요.

터미널에서 직접 하기

플러그인 없이 터미널에서 바로 쓰고 싶다면, 같은 과정을 명령어로 할 수 있어요.

# 1. 설치 & 로그인
curl -fsSL https://cli.axhub.ai/install.sh | bash   # Windows: irm https://cli.axhub.ai/install.ps1 | iex
axhub auth login

# 2. 앱 만들기 (템플릿 → 저장소 → 첫 배포까지 한 번에)
axhub apps bootstrap --name hello --template nextjs \
  --github-owner <github-아이디> --repo-name hello --execute --watch

# 3. 확인
axhub open hello

수동으로 단계를 나눠서 하거나(앱 먼저 만들고 나중에 연결), 취소·롤백·환경변수 같은 세부는 앱 만들어 띄우기 가이드와 CLI 레퍼런스를 보세요.

배포가 안 되면

상태와 로그부터 — 플러그인이면 "왜 실패했어?", CLI면 axhub deploy status <id> --app <앱>과 axhub deploy logs <id> --app <앱>.
자세한 증상별 해결은 배포가 안 될 때 가이드를 보세요.