설치하기

쓰는 AI 앱(Claude · ChatGPT)에 axhub를 설치해요. 설치 페이지에서 한 번이면 끝나요.

axhub 설치는 설치 페이지 한 곳에서 해요. 쓰는 AI 앱을 고르면, 그 앱이 axhub CLI · 플러그인 · 로그인을 차례로 갖춰요.
따로 받을 프로그램은 없어요. 내가 할 일은 브라우저에서 로그인 승인을 한 번 누르는 것뿐이에요.

준비물

  • AxHub 계정 — AxHub를 쓰는 회사의 구성원이어야 해요. 계정이 없다면 회사 관리자에게 초대를 요청하세요.
  • AI 앱 하나 — 가진 계정에 맞춰 골라요.
가진 계정고를 것쓰는 앱
Claude Pro 이상ClaudeClaude 데스크톱 앱 또는 Claude Code
ChatGPT (무료 포함)ChatGPTCodex 앱 또는 Codex CLI
둘 다 없어요아직 없어요ChatGPT 무료 계정을 만들어 시작해요
Cursor · VS Code · 터미널에서 써요Cursor, 터미널 등요청 문장을 복사해 붙여 넣어요

Claude 무료 플랜에는 Claude Code가 없어서 설치할 수 없어요. 이때는 ChatGPT로 바꿔요.

설치하기

1

설치 페이지 열기

axhub.ai/download를 열고 연결 시작을 눌러요. 쓰는 AI 계정을 고르면 다음 단계가 나와요.

2

AI 앱에서 요청 보내기

Claude에서 열기(또는 ChatGPT에서 열기)를 누르면 AI 앱이 설치 요청이 채워진 채 열려요. 그대로 전송하세요.

앱이 열리지 않거나 Cursor · 터미널을 쓴다면 요청 복사를 눌러 붙여 넣어요. 요청 문장은 이렇게 생겼어요.

axhub(https://axhub.ai) 을 이 컴퓨터에 설치해 줘. axhub 설치 페이지에서 내가 직접 시작한 설치야.
1. 터미널에서 axhub 공식 설치 명령으로 CLI 를 설치해 줘. 설치 스크립트를 받아 실행하고 지우는 세 줄이야:
curl -fsSL https://cli.axhub.ai/install.sh -o ~/axhub-install.sh
sh ~/axhub-install.sh
rm ~/axhub-install.sh
2. 그다음(플러그인 추가·로그인)은 공식 설치 안내 https://axhub.ai/setup.md 의 '2. 무엇이 빠졌는지 확인'부터 이어서 해 줘.

설치 명령이 요청 문장 안에 들어 있는 건 일부러예요. 요즘 AI 앱은 웹 문서에 적힌 지시만으로는 설치 스크립트를 실행하지 않아요. 내가 보낸 문장에 명령이 있어야 안심하고 실행해요.

3

실행 허락과 로그인 승인

AI 앱이 명령을 실행해도 되는지 물으면 허용을 눌러요. 내 사용자 폴더 안에만 설치해요.

로그인 단계가 되면 브라우저에 axhub 승인 화면이 열려요. 지금 직접 시작한 설치가 맞는지 확인하고 승인을 누르면 돼요. 화면이 안 열리면 AI 앱이 채팅에 보여 준 주소를 눌러요.

4

AI 앱 다시 켜기

AI 앱에 «준비 완료»가 뜨면 앱을 한 번 껐다 켜요(터미널이면 나갔다가 다시 실행). 껐다 켜야 axhub 플러그인이 앱 안에서 켜져요.

이제 빠른 시작대로 "axhub에 앱 만들고 싶어"라고 말하면 돼요.

무엇이 설치되나

항목설명
axhub CLI~/.axhub (Windows는 %USERPROFILE%\.axhub)에 설치돼요
axhub 플러그인Claude Code는 axhub@axhub, Codex는 axhub-codex@axhub예요. ChatGPT 데스크톱 앱의 Codex도 같은 설정을 읽어요
로그인내 axhub 계정으로 CLI가 로그인돼요
Git · Node.js앱을 만들 때 필요해서, 없을 때만 사용자 폴더에 설치해요

GitHub 연결은 설치 단계에서 하지 않아요. GitHub에 코드를 두는 회사라면 앱을 만들 때 그 자리에서 연결해요.

설치가 끝난 뒤 상태를 점검하거나 CLI를 업데이트하려면 AI 앱에 **"셋업해줘"**라고 말해요. 플러그인의 setup 기능이 CLI · 버전 · 로그인 · Git · Node.js를 확인하고 빠진 것만 채워요.

대화로 앱 · 배포 · 데이터를 조회하는 MCP 연결은 따로 더하는 기능이에요. AI 도구 연결하기를 보세요.

명령어로 직접 설치하기

AI에게 맡기지 않고 직접 설치하고 싶을 때만 봐요. 결과는 설치 페이지와 같아요.

1. CLI 설치와 로그인

curl -fsSL https://cli.axhub.ai/install.sh | bash
axhub auth login

macOS · Linux에서 axhub를 찾지 못한다고 나오면 새 터미널을 열거나 ~/.axhub/bin/axhub auth login으로 실행해요. axhub auth login은 브라우저 승인 화면을 열어요. 승인하면 어느 회사 소속으로 접속했는지 알려 줘요.

2. 플러그인 추가

Claude Code 안에서 두 줄을 차례로 입력해요. Claude 데스크톱 앱이라면 Code 탭에서 입력해요.

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

npm의 axhub · axhub-cli 패키지는 이름만 맡아 둔 빈 패키지예요. 설치는 위 공식 명령으로만 해요.

문제 해결

막힌 단계를 찾아 보세요.

앱이 없어요

설치 페이지에서 앱 받기를 누르면 내려받는 곳이 열려요. 설치한 뒤 설치 페이지로 돌아와 설치했어요를 눌러요.

회사 컴퓨터라 설치가 막히면 IT 담당자에게 Claude 데스크톱 앱이나 Codex 앱 설치를 요청해요.

«열기»를 눌러도 앱이 안 열려요

증상해결
아무 일도 없어요앱이 설치돼 있는지 확인하고, 앱을 한 번 켜 둔 뒤 다시 열기를 눌러요
브라우저가 «앱을 열까요?» 하고 물어요열기를 눌러요. 다음부터 안 묻게 체크해도 돼요
앱은 열렸는데 입력창이 비어 있어요앱 로그인 화면을 거치면 요청이 지워져요. 로그인한 뒤 다시 열기를 누르거나, 요청을 복사해 붙여 넣어요
그래도 안 열려요앱이 안 열려요를 누르면 앱 설치 단계로 돌아가요

앱에서 전송했는데 멈춰요

증상해결
명령을 실행해도 되냐고 물어요허용을 눌러요. 내 사용자 폴더 안에만 설치해요
보안 문제로 설치를 거절해요설치 페이지에서 요청을 새로 복사해 붙여 넣어요. 설치 명령이 들어 있지 않은 예전 요청 문장이면 거절될 수 있어요
중간에 멈췄어요앱에 «이어서 해줘»라고 보내요
같은 곳에서 또 멈춰요앱에 뜬 오류 문구를 그대로 복사해 문의할 때 함께 보내요
관리자 비밀번호를 물어요보통은 필요 없어요. 계속 물으면 IT 담당자에게 도움을 요청해요
내려받기가 막혀요 (회사망)IT 담당자에게 axhub.ai, api.axhub.ai, cli.axhub.ai, github.com 접속을 열어 달라고 요청해요

승인 화면이 이상해요

증상해결
승인 화면이 안 떠요앱이 보여 준 주소를 브라우저에 직접 열어요
로그인하라고 나와요회사에서 쓰는 axhub 계정으로 로그인한 뒤 승인해요
다른 계정으로 승인됐어요앱에 «axhub 로그아웃하고 다시 로그인해줘»라고 보낸 뒤 맞는 계정으로 승인해요

«준비 완료»가 떴는데 화면이 그대로예요

설치 페이지의 «준비 완료»가 떴어요를 눌러요. 마지막으로 AI 앱을 껐다 켜면 끝나요. 껐다 켜야 axhub가 앱 안에서 켜져요.

그래도 안 되면

설치 페이지 아래 문의하기를 눌러요. 로그인하지 않아도 돼요. 막힌 단계와 앱에 뜬 오류 문구를 함께 보내 주면 빨리 도와 드릴 수 있어요.