빠른 시작

이 안내를 따라가면 몇 분 안에 첫 잡이 Mac mini M4 러너에서 돌고 로그가 터미널로 옵니다, 준비물은 XenoCI 계정, 프로젝트 폴더, 그리고 그 안에서 빌드를 시작하는 스크립트 하나 (예: ci.sh)입니다

전제 조건

• 콘솔 계정과 크레딧, 가입하면 조직과 기본 워크스페이스가 함께 만들어집니다
• macOS, Linux 또는 Windows 터미널, Apple Silicon Mac이면 설치 스크립트가 바로 되고 Intel Mac은 npx -y -p github:xeno-ci/xenocast xenocast로 씁니다
• 러너에서 실행할 스크립트, 러너의 Xcode 버전은 27.0, 26.6 가운데 고릅니다

첫 잡 실행하기

1. 1

   API 키 만들기

   API 키 받기를 따라 콘솔의 API 키에서 실행과 조회 권한의 키를 만들고 복사해 둡니다, 키는 xci_live_로 시작하고 한 번만 보입니다

2. 2

   설치하고 키 넣기

   터미널에서 CLI(xenocast)를 설치하고 xenocast login을 실행해 방금 복사한 키를 붙여 넣습니다, 입력한 키는 화면에 보이지 않고 이 컴퓨터에만 저장됩니다

   curl -fsSL https://github.com/Xeno-CI/xenocast/releases/latest/download/install.sh | sh
   xenocast login

   irm https://github.com/Xeno-CI/xenocast/releases/latest/download/install.ps1 | iex
   xenocast login

   • 키는 macOS 키체인, Windows 자격 증명 관리자, Linux secret-service에 저장되고 그것이 없으면 이 기기에 묶인 암호화 파일에 저장됩니다, 출력에는 키의 마지막 4자만 나옵니다
   • 실행 파일은 ~/.local/bin/xenocast에 놓입니다, 이 경로가 PATH에 있는지 확인하세요
   • 셸 설정 파일이나 CI에 두려면 환경 변수 XENOCI_API_KEY를 씁니다, 환경 변수가 저장된 키보다 우선합니다, 환경 변수가 있으면 설치 스크립트가 그 키로 바로 다음 단계까지 진행합니다

   export XENOCI_API_KEY="xci_live_..."

3. 3

   도구 등록

   키를 확인하고 이 컴퓨터에 설치된 AI 에이전트(Claude Code, Codex, Cursor, OpenCode, OmO)에 MCP 서버 xenocast mcp를 등록합니다

   xenocast setup

   마지막 줄이 XenoCast 준비 완료로 시작하면 끝입니다, 그 줄에 키의 조직, 워크스페이스, 잔액, MCP를 등록한 에이전트가 나옵니다

   • 에이전트 설정 파일에는 실행 명령만 들어가고 키는 들어가지 않습니다, MCP 서버가 저장된 키를 읽습니다, 이미 등록돼 있으면 건너뛰고, 고치기 전 파일은 .bak-xenocast- 이름으로 백업합니다
   • 키를 확인하지 못하면 등록하지 않습니다
4. 4

   AI 에이전트에게 맡기기

   설치와 도구 등록, 첫 빌드를 에이전트에게 시켜도 됩니다, 키를 내 터미널에 넣어 둔 뒤 에이전트 대화창에 이 한 줄만 붙여 넣습니다, 키는 들어 있지 않습니다

   XenoCI 설정 안내를 읽고 따라 해 줘: https://xenoci.com/agent-setup

   에이전트 설정 안내에는 설치, 키 확인, 도구 등록, 첫 빌드, 결과 확인 절차가 있고, 키가 없으면 에이전트가 사람에게 xenocast login을 요청하도록 적혀 있습니다, MCP 도구는 에이전트를 새 세션으로 시작하면 보입니다

5. 5

   첫 빌드

   프로젝트 폴더에서 실행합니다, 현재 폴더가 tar.gz로 올라가고, 러너의 Xcode 27.0에서 ./ci.sh가 실행되며, 로그가 끝날 때까지 터미널로 흐릅니다, 명령의 종료 코드는 스크립트의 종료 코드와 같습니다

   xenocast build --script ./ci.sh --xcode 27.0

   끝나면 마지막 줄에 실행 시간과 금액, 남은 잔액이 나옵니다 (예: 실행 2분 5초, 금액 US$0.08), 요금은 실행한 초만큼, 최소 1분이고 금액은 센트로 반올림합니다

   --script에는 파일 경로 대신 한 줄 명령을 넣어도 됩니다, 공개 git 저장소를 빌드하려면 --repo owner/name --ref main을, 결과물을 받으려면 --artifacts "build/*.ipa"를 붙입니다, 제한 시간은 --timeout (분, 1부터 360까지)으로 정합니다

6. 6

   결과 확인

   잡 id (job_...)로 상태와 로그, 결과물을 다시 봅니다

   xenocast status job_...
   xenocast logs job_... --failure
   xenocast artifacts job_... --out ./out

   같은 내용은 콘솔의 잡 화면에서도 봅니다, 모든 명령에 --json을 붙이면 기계가 읽는 JSON 한 개만 출력합니다

다른 방법으로 같은 잡 보내기

name: iOS build
on: [push, workflow_dispatch]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: Xeno-CI/build@v1
        with:
          api-key: ${{ secrets.XENOCI_API_KEY }}
          script: ./ci.sh
          xcode: '27.0'
          artifacts: build/*.ipa

curl https://xenoci.com/api/runner/v1/jobs \
  -H "Authorization: Bearer $XENOCI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "script": "./ci.sh",
    "source": { "git_url": "https://github.com/org/app.git", "ref": "main" },
    "xcode": "27.0",
    "timeout_minutes": 30
  }'

claude mcp add --transport stdio --scope user xenoci -- "$(which xenocast)" mcp
codex mcp add xenoci -- "$(which xenocast)" mcp

{ "mcpServers": { "xenoci": { "command": "xenocast", "args": ["mcp"] } } }

다음 단계