빠른 시작

Claude Code 플러그인으로 10분 안에 첫 앱을 만들어 배포까지 끝내요.

이 문서를 따라 하면 10분 안에 첫 앱을 만들어 배포까지 끝나요.
명령어를 외울 필요 없이, Claude Code에 axhub 플러그인을 설치하고 말로 시키면 돼요.

준비물

세 가지가 있어야 해요.

Claude Code는 터미널에서 쓰는 AI 도구예요. axhub 플러그인은 이 안에 설치해요.

먼저 터미널을 열고 claude를 입력해 Claude Code를 켜요. 그러면 말을 입력받는 칸(프롬프트)이 나와요.

claude

이제 Claude Code 안에서 아래 두 줄을 차례로 입력해요.

/plugin marketplace add jocoding-ax-partners/axhub

/plugin install axhub@axhub

/로 시작하는 줄은 터미널 명령이 아니라 Claude Code에게 보내는 명령이에요. Claude Code를 켜지 않은 채 그냥 터미널에 입력하면 동작하지 않아요.

앱을 만들기 전에 필요한 것들을 한 번에 갖추는 단계예요. 설치가 끝나면 이렇게 말해요.

온보딩해줘

플러그인이 axhub 명령어 도구(CLI) 설치 → 로그인 → 환경 점검 → GitHub 연결 → AI 도구 연결을 순서대로 안내해요. 필요한 게 빠져 있으면 먼저 동의를 받고 깔아줘요. 처음 한 번만 하면 돼요.

중간에 내가 직접 승인해야 하는 화면이 나와요. Claude Code가 그때그때 안내하지만, 미리 알아 두면 덜 당황해요. 이미 되어 있는 단계는 건너뛰어요.

승인	무엇을 하면 되나
① AxHub 로그인	인증 주소와 코드가 뜨고 브라우저가 열려요. 화면의 코드가 같은지 확인하고 승인을 누르면 "디바이스 연결 완료"가 떠요. Claude Code로 돌아오면 자동으로 이어져요.
② GitHub 기기 인증	`github.com/login/device`를 열어 표시된 코드를 입력하고 승인해요. 끝나면 Claude Code에 "승인했어"라고 알려 주세요.
③ GitHub App 설치	안내된 주소를 열고 Install & Authorize를 눌러요. AxHub가 저장소를 만들고 코드를 읽을 수 있게 하는 권한이에요. 끝나면 "설치했어"라고 알려 주세요.
④ axhub 도구 연결	Claude Code에 `/mcp`를 입력하고, 목록에서 axhub를 골라 Authenticate를 눌러요. 브라우저에서 승인하면 끝이에요.

두 가지 길이 있어요. 내 상황에 맞는 하나만 하면 돼요.

처음부터 새로 만들 때예요.

axhub에 앱 만들고 싶어

플러그인이 템플릿 고르기 → GitHub 저장소 만들기 → 첫 배포까지 한 번에 진행해요. Next.js · Vite · Astro 중에서 고르면 되고, "Next.js 앱 만들어줘"처럼 처음부터 정해서 말해도 돼요.

AxHub와 상관없이 내 컴퓨터에서 개발하던 프로젝트가 있을 때예요. 템플릿 대신 그 폴더를 그대로 올려요. 폴더 안에서 이렇게 말해요.

이 폴더 axhub에 올려줘

다른 데서 Claude Code를 켰다면 경로를 알려 줘도 돼요.

작업 폴더는 ~/projects/myapp 이야. axhub에 올려줘

Express · FastAPI · Django · Rails · Go처럼 어떤 스택이든 올릴 수 있어요. 플러그인이 코드를 보고 배포 설정 파일(axhub.yaml)까지 만들어 준 다음, 앱 연결과 첫 배포를 이어서 해요.

올리는 건 스택을 가리지 않지만, 그 뒤 말로 기능을 추가하는 건 스택에 따라 달라요. 플러그인이 다루지 못하는 스택이면 "이 앱 스택은 아직 자동 코딩을 지원 안 해요"라고 알려 주고 멈춰요 — 배포는 그대로 되고, 코드는 직접 쓰면 돼요.

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

끝나면 앱 주소(URL)를 알려 줘요. 코드를 고친 뒤에도 같은 방식으로 말하면 돼요.

이 앱 배포해줘
앱 열어줘

배포가 안 됐다면 이렇게 물어보세요. 실패한 배포의 기록(로그)을 가져와 원인을 짚어줘요. 그래도 막히면 문제 해결을 보세요.

왜 실패했어?

AxHub에 올려 둔 앱은 다음에도 말로 이어서 손보면 돼요. 처음부터 다시 만들 필요 없어요.

앱 폴더에서 Claude Code를 켜고 하고 싶은 걸 말하면 돼요. 플러그인이 폴더의 axhub.yaml을 보고 어느 앱인지 알아내요 — development 기능이 맡아요.

할 일 검색 기능 추가하고 싶어

고친 내용은 "배포해줘" 한마디로 다시 올라가요 — 이건 deploy 기능이에요.

폴더가 없는 컴퓨터에서 이어 하려면 GitHub 저장소를 먼저 클론해 오세요. 플러그인은 지금 폴더에 묶인 앱만 손대요 — 다른 앱을 가리키면 그 앱 폴더로 가라고 알려 주고 멈춰요.

말로 시키면 플러그인이 알맞은 기능(스킬) 을 골라서 실행해요. 이름을 외울 필요는 없지만, 알아 두면 무엇이 도는지 보이고 /axhub:<이름>으로 직접 부를 수도 있어요.

이 말	도는 기능
"온보딩해줘"	`onboarding`
"axhub에 앱 만들고 싶어"	`bootstrap`
"이 폴더 axhub에 올려줘"	`import`
"이 앱 배포해줘"	`deploy`
"왜 실패했어?"	`diagnosis` — 원인만 보고, 재배포나 롤백은 하지 않아요
"할 일 검색 기능 추가하고 싶어"	`development`