설치하기
쓰는 AI 앱(Claude · ChatGPT)에 axhub를 설치해요. 설치 페이지에서 한 번이면 끝나요.
axhub 설치는 설치 페이지 한 곳에서 해요. 쓰는 AI 앱을 고르면, 그 앱이 axhub CLI · 플러그인 · 로그인을 차례로 갖춰요.
따로 받을 프로그램은 없어요. 내가 할 일은 브라우저에서 로그인 승인을 한 번 누르는 것뿐이에요.
준비물
- AxHub 계정 — AxHub를 쓰는 회사의 구성원이어야 해요. 계정이 없다면 회사 관리자에게 초대를 요청하세요.
- AI 앱 하나 — 가진 계정에 맞춰 골라요.
| 가진 계정 | 고를 것 | 쓰는 앱 |
|---|---|---|
| Claude Pro 이상 | Claude | Claude 데스크톱 앱 또는 Claude Code |
| ChatGPT (무료 포함) | ChatGPT | Codex 앱 또는 Codex CLI |
| 둘 다 없어요 | 아직 없어요 | ChatGPT 무료 계정을 만들어 시작해요 |
| Cursor · VS Code · 터미널에서 써요 | Cursor, 터미널 등 | 요청 문장을 복사해 붙여 넣어요 |
Claude 무료 플랜에는 Claude Code가 없어서 설치할 수 없어요. 이때는 ChatGPT로 바꿔요.
설치하기
설치 페이지 열기
axhub.ai/download를 열고 연결 시작을 눌러요. 쓰는 AI 계정을 고르면 다음 단계가 나와요.
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. 무엇이 빠졌는지 확인'부터 이어서 해 줘.axhub(https://axhub.ai) 을 이 컴퓨터에 설치해 줘. axhub 설치 페이지에서 내가 직접 시작한 설치야.
1. axhub 공식 설치 명령으로 CLI 를 설치해 줘. 설치 스크립트를 받아 실행하고 지우는 세 줄이야. PowerShell 이면:
irm https://cli.axhub.ai/install.ps1 -OutFile "$env:USERPROFILE\axhub-install.ps1"
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\axhub-install.ps1"
Remove-Item "$env:USERPROFILE\axhub-install.ps1"
Git Bash 면:
curl -fsSL https://cli.axhub.ai/install.ps1 -o ~/axhub-install.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File "$(cygpath -w ~/axhub-install.ps1)"
rm ~/axhub-install.ps1
2. 그다음(플러그인 추가·로그인)은 공식 설치 안내 https://axhub.ai/setup.md 의 '2. 무엇이 빠졌는지 확인'부터 이어서 해 줘.설치 명령이 요청 문장 안에 들어 있는 건 일부러예요. 요즘 AI 앱은 웹 문서에 적힌 지시만으로는 설치 스크립트를 실행하지 않아요. 내가 보낸 문장에 명령이 있어야 안심하고 실행해요.
실행 허락과 로그인 승인
AI 앱이 명령을 실행해도 되는지 물으면 허용을 눌러요. 내 사용자 폴더 안에만 설치해요.
로그인 단계가 되면 브라우저에 axhub 승인 화면이 열려요. 지금 직접 시작한 설치가 맞는지 확인하고 승인을 누르면 돼요. 화면이 안 열리면 AI 앱이 채팅에 보여 준 주소를 눌러요.
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 loginirm https://cli.axhub.ai/install.ps1 | iex
axhub auth loginmacOS · 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터미널에서 두 줄을 차례로 입력해요. ChatGPT 데스크톱 앱의 Codex도 같은 설정을 읽어요.
codex plugin marketplace add https://github.com/jocoding-ax-partners/axhub
codex plugin add axhub-codex@axhub첫 대화에서 플러그인 훅을 신뢰할지 물으면 신뢰를 선택해요. 선택에 따라 달라지는 점은 플러그인 스킬에 있어요.
npm의 axhub · axhub-cli 패키지는 이름만 맡아 둔 빈 패키지예요. 설치는 위 공식 명령으로만 해요.
문제 해결
막힌 단계를 찾아 보세요.
앱이 없어요
설치 페이지에서 앱 받기를 누르면 내려받는 곳이 열려요. 설치한 뒤 설치 페이지로 돌아와 설치했어요를 눌러요.
회사 컴퓨터라 설치가 막히면 IT 담당자에게 Claude 데스크톱 앱이나 Codex 앱 설치를 요청해요.
«열기»를 눌러도 앱이 안 열려요
| 증상 | 해결 |
|---|---|
| 아무 일도 없어요 | 앱이 설치돼 있는지 확인하고, 앱을 한 번 켜 둔 뒤 다시 열기를 눌러요 |
| 브라우저가 «앱을 열까요?» 하고 물어요 | 열기를 눌러요. 다음부터 안 묻게 체크해도 돼요 |
| 앱은 열렸는데 입력창이 비어 있어요 | 앱 로그인 화면을 거치면 요청이 지워져요. 로그인한 뒤 다시 열기를 누르거나, 요청을 복사해 붙여 넣어요 |
| 그래도 안 열려요 | 앱이 안 열려요를 누르면 앱 설치 단계로 돌아가요 |
앱에서 전송했는데 멈춰요
| 증상 | 해결 |
|---|---|
| 명령을 실행해도 되냐고 물어요 | 허용을 눌러요. 내 사용자 폴더 안에만 설치해요 |
| 보안 문제로 설치를 거절해요 | 설치 페이지에서 요청을 새로 복사해 붙여 넣어요. 설치 명령이 들어 있지 않은 예전 요청 문장이면 거절될 수 있어요 |
| 중간에 멈췄어요 | 앱에 «이어서 해줘»라고 보내요 |
| 같은 곳에서 또 멈춰요 | 앱에 뜬 오류 문구를 그대로 복사해 문의할 때 함께 보내요 |
| 관리자 비밀번호를 물어요 | 보통은 필요 없어요. 계속 물으면 IT 담당자에게 도움을 요청해요 |
| 내려받기가 막혀요 (회사망) | IT 담당자에게 axhub.ai, api.axhub.ai, cli.axhub.ai, github.com 접속을 열어 달라고 요청해요 |
승인 화면이 이상해요
| 증상 | 해결 |
|---|---|
| 승인 화면이 안 떠요 | 앱이 보여 준 주소를 브라우저에 직접 열어요 |
| 로그인하라고 나와요 | 회사에서 쓰는 axhub 계정으로 로그인한 뒤 승인해요 |
| 다른 계정으로 승인됐어요 | 앱에 «axhub 로그아웃하고 다시 로그인해줘»라고 보낸 뒤 맞는 계정으로 승인해요 |
«준비 완료»가 떴는데 화면이 그대로예요
설치 페이지의 «준비 완료»가 떴어요를 눌러요. 마지막으로 AI 앱을 껐다 켜면 끝나요. 껐다 켜야 axhub가 앱 안에서 켜져요.
그래도 안 되면
설치 페이지 아래 문의하기를 눌러요. 로그인하지 않아도 돼요. 막힌 단계와 앱에 뜬 오류 문구를 함께 보내 주면 빨리 도와 드릴 수 있어요.