AXHub

빠른 시작

Claude Code · Codex에 플러그인을 설치하고 10분 안에 첫 앱을 만들어 배포까지 끝내요.

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

Newt를 쓰고 있다면 플러그인 · GitHub · 터미널 없이 Newt 채팅만으로 앱을 만들고 배포할 수 있어요. Newt에서 대화로 앱 만들기를 따라 하세요. 그 안의 Agent 개발 권한 확인하기 단계에서 대화하는 Agent가 앱을 만들고 고칠 수 있는지 먼저 확인해요.

준비물

이 방법에는 아래가 필요해요.

  • AxHub 계정 — AxHub를 쓰는 회사의 구성원이어야 해요. 계정이 없다면 회사 관리자에게 초대를 요청하세요.
  • Claude Code 또는 Codex — 여기에 axhub 플러그인을 설치하고, 말로 시켜요.
  • GitHub 계정 (선택) — 앱 코드를 GitHub에 둘 때만 필요해요. 계정만 있으면 저장소는 플러그인이 만들어 줘요. GitHub 없이 AxHub 안의 Git 저장소에 둘 수도 있어요 — 온보딩에서 코드 저장 위치를 물으면 Axhub self-hosted를 고르면 돼요.

첫 앱 만들기

1

AI 도구를 켜고 플러그인 설치

Claude Code와 Codex 어느 쪽이든 돼요. 쓰는 도구의 탭을 골라 따라 하세요 — 이후 단계는 어느 쪽이든 똑같아요.

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를 켜지 않은 채 그냥 터미널에 입력하면 동작하지 않아요.

2

온보딩하기

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

온보딩해줘

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

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

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

앱 만들기

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

3-1. 템플릿으로 새로 만들기 — bootstrap

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

axhub에 앱 만들고 싶어

플러그인이 템플릿 고르기 → 코드 저장소 만들기 → 첫 배포까지 한 번에 진행해요. 저장소는 고른 저장 위치(GitHub 또는 AxHub 안의 Git)에 생겨요. Next.js · Vite · Astro 중에서 고르면 되고, "Next.js 앱 만들어줘"처럼 처음부터 정해서 말해도 돼요.

3-2. 원래 만들던 앱 올리기 — import

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

이 폴더 axhub에 올려줘

다른 폴더에서 AI 도구를 켰다면 경로를 알려 줘도 돼요.

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

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

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

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

4

열어서 확인하기

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

이 앱 배포해줘
앱 열어줘

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

왜 실패했어?

이어서 작업하기

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

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

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

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

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

지금 무엇이 돌았나

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

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

전체 10개 기능과 각각의 안전장치는 플러그인 스킬에 있어요.

다음 문서

플러그인 말고 웹 콘솔이나 터미널 명령어로 만드는 방법, 그리고 각 단계에서 정하는 값(이름 · 주소 · 템플릿)의 자세한 설명은 다음 문서에 있어요.