회사 플러그인 빠른 시작

axhub plugin list --tenant <회사 UUID>

한 줄에 플러그인 하나씩 설치 이름 · 제공 중인 버전 · 설치 가능 여부 · 앱 주소가 나와요.

weather-tools	1.2.3	installable	weather-tools

installable인 플러그인만 설치할 수 있어요. 처음에는 회사에서 만든 것 중 하는 일이 분명하고 만든 사람을 아는 플러그인을 골라요. 플러그인은 내 컴퓨터에서 hook · 명령 · MCP 서버를 실행할 수 있어서, 게시 심사를 통과했다는 사실만으로 안전하다고 단정하지 않아요.

axhub plugin install --tenant <회사 UUID> --app weather-tools --version 1.2.3 --host claude

Codex에 설치하려면 --host codex를 써요. --execute가 없으면 네트워크 요청 없이 무엇을 할지만 보여 줘요.

Plugin install preview
  App: weather-tools
  Version: 1.2.3
  Host: claude (user scope)
  No network request, extraction, or host command was performed.
  Next: axhub --tenant <회사 UUID> plugin install --app weather-tools --version 1.2.3 --host claude --execute --yes

미리보기의 Next 명령을 그대로 실행해요.

axhub plugin install --tenant <회사 UUID> --app weather-tools --version 1.2.3 --host claude --execute --yes

CLI가 그 버전의 ZIP을 받아 SHA-256을 확인하고, Claude Code · Codex의 플러그인 명령으로 설치해요. 실행 권한이 있던 파일은 실행 권한을 지킨 채 설치돼요.

Installed weather-tools 1.2.3 for claude through marketplace axhub-app-<앱 ID>. Restart the host to load it.

열려 있던 Claude Code · Codex를 닫고 새 세션을 시작해야 플러그인이 올라와요. 먼저 터미널에서 설치됐는지 봐요.

claude plugin list

Codex는 codex plugin list예요. 목록에 weather-tools@axhub-app-<앱 ID>가 보이면 돼요. 새 세션에서 Claude Code는 /weather-tools:<기능 이름>, Codex는 $weather-tools:<기능 이름>으로 플러그인 기능을 불러요. hook이 있는 플러그인은 세션 시작처럼 정해진 순간에 저절로 실행돼요.

루트에 .claude-plugin/plugin.json이 있는 플러그인 폴더를 준비해요. name이 설치 이름, version(SemVer)이 올릴 버전이에요. 한 번 올린 버전은 바꿀 수 없어서, 고칠 때마다 버전 번호를 올려요. .claude-plugin/plugin.json 없이 루트에 SKILL.md만 있는 스킬 폴더도 부속 파일과 함께 올라가요.

CLI가 패키지에 담는 규칙은 이래요.

• .git · .venv · __pycache__ · .DS_Store · __MACOSX는 늘 빠지고, node_modules는 --keep-dir node_modules를 줄 때만 담겨요.
• .gitignore는 적용하지 않아요. 빌드한 dist/도 그대로 올라가니, 뺄 경로는 --exclude <glob>으로 정해요.
• 실행 권한이 있는 파일은 실행 권한을 지켜 올라가요. Windows에서는 git 저장소 안에서 게시하거나 --executable <경로>로 실행 파일을 지정해요.
• .env · *.key · id_rsa* · 개인 키가 든 *.pem 같은 비밀 파일이 있으면 미리보기에서 멈춰요(plugin_secret_files).

게시는 OAuth 로그인 대신 plugins:read · plugins:write 권한의 PAT로 해요. 로그인한 상태에서 한 번 발급해 두면 돼요.

axhub auth pat issue --scopes plugins:read,plugins:write --tenant-id <회사 UUID> --use

--use는 토큰 값을 화면에 보여 주지 않고 이 CLI에 저장만 해요. Saved PAT in keychain.이 나오면 끝이에요. 토큰 값을 출력하는 --show-token은 쓰지 마세요.

axhub plugin publish ./weather-tools --tenant <회사 UUID> --submit

--execute가 없으면 네트워크 요청 없이 담길 파일 · 실행 파일 · 제외한 경로 · 위험 요소(hooks · MCP 서버 · bin · 스크립트)를 보여 줘요.

Plugin publish preview (offline)
  Name: weather-tools
  Version: 1.2.3
  Kind: plugin_zip
  Files: 4
    - .claude-plugin/plugin.json
    - hooks/session-start.sh (실행 파일)
    - …
  Risk inventory:
    - …
  Artifact SHA-256: …
  Artifact size: … bytes
  No network request or authentication was performed.
  --submit: 업로드가 끝나면 이 버전의 게시 심사를 바로 신청해요.
  Next: review the preview, then add --attest-distribution-rights --execute.

목록을 확인했으면 배포 권리를 확인하는 --attest-distribution-rights와 --execute를 붙여요. --submit이 있으면 업로드 처리가 끝난 뒤 그 버전의 게시 심사까지 한 번에 신청해요.

axhub plugin publish ./weather-tools --tenant <회사 UUID> --attest-distribution-rights --execute --submit

플러그인 버전 업로드가 끝났어요
  App ID: <앱 ID>
  App slug: weather-tools
  Version ID: <버전 ID>
  Version: 1.2.3
게시 심사를 신청했어요 (신청 ID: <신청 ID>, 자동 검수: awaiting)
결과 알림은 없어요 — `axhub plugin manage status` 로 확인하세요
다음: axhub --tenant <회사 UUID> plugin manage status --app <앱 ID> --version 1.2.3

업로드는 됐는데 신청만 실패하면 publish를 다시 실행하지 말고 안내된 axhub plugin submit 명령만 다시 실행해요. 이미 올린 버전을 나중에 신청할 때도 같은 명령을 써요.

axhub --tenant <회사 UUID> plugin submit --app <앱 ID> --version 1.2.3 --execute

같은 버전을 다시 신청해도 새 신청이 생기지 않고 성공(already_submitted: true)으로 끝나요.

axhub --tenant <회사 UUID> plugin manage status --app <앱 ID> --version 1.2.3 --watch

첫 줄에 지금 상태 하나, 그 아래에 다음에 할 명령과 단계별 상태(업로드 처리 · 자동 검수 · 게시 심사 · 게시 · 제공)가 나와요. --watch는 서버를 기다리는 상태가 끝날 때까지 지켜봐요(기본 5분).

[관리자 심사 대기] 워크스페이스 관리자가 승인하면 제공돼요. 결과 알림은 없으니 이 화면이나 `axhub plugin manage status` 로 확인하세요.
다음: axhub --tenant <회사 UUID> plugin manage status --app <앱 ID> --version 1.2.3
상태:
  업로드 처리: 완료
  …
위험 요약: hooks 1 · MCP 0 · bin 0 · 동적 컨텍스트 0 · 스크립트 0

자동 검수를 통과하면 워크스페이스 관리자가 콘솔의 앱 심사에서 승인해요(앱 심사하기). 승인돼 반영되면 상태가 [제공 중]으로 바뀌고, 그때부터 회사 구성원이 위 순서대로 설치할 수 있어요. 결과 알림은 없으니 이 명령으로 확인해요.