API 레퍼런스
로그인
본문으로 건너뛰기

빠른 시작

키를 넣은 설치 한 줄로 xenocast CLI, 키 저장, AI 에이전트 MCP 등록을 끝내고 첫 macOS 잡을 실행하기까지

API 키를 넣은 설치 명령 하나로 xenocast 실행 파일이 생기고, 키가 저장되고, 설치된 AI 에이전트에 MCP 서버가 등록됩니다. 이 파일이 CLI이자 MCP 서버입니다

준비물

  • 콘솔 계정(Google 또는 이메일 로그인)과 충전된 크레딧
  • macOS 또는 Linux 터미널(Windows는 PowerShell)

1. API 키 발급

  1. 콘솔 API 키(/console/keys)에서 API 키 만들기를 누릅니다
  2. 이름, 워크스페이스, 권한(실행과 조회 또는 조회만), 만료(만료 없음, 30일, 90일, 1년)를 고릅니다
  3. 키는 이때 한 번만 보입니다. 바로 복사해 두세요

잡을 보내려면 권한이 실행과 조회(run)여야 합니다

2. 키를 넣어 한 줄로 설치

xci_live_...를 복사한 키로 바꿔 실행합니다

macOS와 Linux

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

Windows(PowerShell)

$env:XENOCI_API_KEY="xci_live_..."; irm https://github.com/Xeno-CI/xenocast/releases/latest/download/install.ps1 | iex

설치 스크립트는 이 OS와 CPU에 맞는 실행 파일 하나를 받아 SHA256SUMS로 검증한 뒤 ~/.local/bin/xenocast에 둡니다(XENOCI_INSTALL_DIR로 바꿀 수 있습니다). Node는 필요 없습니다. 그다음 xenocast setup을 실행해 아래를 차례로 합니다

  1. 키 확인: 키의 조직, 워크스페이스, 권한을 서버에서 확인합니다. 확인하지 못하면 아무것도 저장하거나 바꾸지 않습니다
  2. 키 저장: macOS 키체인, Windows 자격 증명 관리자, Linux secret-service, 셋 다 없으면 이 기기에 묶인 암호화 파일
  3. MCP 등록: 설치된 Claude Code, Codex, Cursor, OpenCode, OmO 설정에 MCP 서버 xenocast mcp를 넣습니다. 설정 파일에는 실행 명령만 들어가고 키는 들어가지 않습니다. 이미 등록돼 있으면 건너뜁니다
  4. MCP 서버 확인: 저장된 키만으로 서버가 whoami에 답하는지 봅니다

마지막 줄이 XenoCast 준비 완료로 시작하면 끝입니다. 출력에는 키의 마지막 4자만 나옵니다

키 없이 설치하면 터미널에서는 키를 가린 입력으로 묻고, 터미널이 아니면 설치만 하고 다음 할 일을 알려 줍니다. 이미 설치한 뒤라면 같은 일을 이 명령이 합니다(--agent claude처럼 대상을 고를 수 있습니다)

XENOCI_API_KEY=xci_live_... xenocast setup

3. 또는 AI 에이전트에게 붙여 넣기

설치를 에이전트에게 시켜도 됩니다. 에이전트 대화창에 붙여 넣으면 에이전트가 명령을 실행하고 준비됐다고 답합니다

XenoCI(macOS 빌드 러너)를 이 컴퓨터에 설정해 줘. 터미널에서 아래 명령을 그대로 실행해.
curl -fsSL https://github.com/Xeno-CI/xenocast/releases/latest/download/install.sh | XENOCI_API_KEY=xci_live_... sh
Windows PowerShell이면 이걸 실행해: $env:XENOCI_API_KEY="xci_live_..."; irm https://github.com/Xeno-CI/xenocast/releases/latest/download/install.ps1 | iex
출력 마지막 줄이 "XenoCast 준비 완료"로 시작하면 조직, 워크스페이스, 잔액을 한 줄로 알려 주고 "준비됐다"고 답해. 키는 파일이나 답변에 다시 적지 마.

명령에 넣은 키는 셸 기록이나 에이전트 대화 기록에 남습니다. 키가 새면 콘솔 API 키에서 폐기하고 다시 발급하세요. CI에서는 저장하지 않고 환경 변수 XENOCI_API_KEY만 둡니다, 환경 변수가 저장된 키보다 우선합니다

확인

xenocast whoami

4. 첫 잡

프로젝트 폴더에서

xenocast build --script 'xcodebuild -version'

--script에는 올릴 폴더 안의 스크립트 파일 경로(./ci.sh)나 명령 문자열을 줍니다. 현재 폴더가 tar.gz로 올라가고, 잡이 접수되면 로그가 바로 흐르며, 끝나면 한 줄 요약이 남습니다

업로드: 파일 12개 (0.3MB)
잡 접수: job_Ab12Cd34
...
잡 job_Ab12Cd34 succeeded (종료 코드 0), 실행 25초, 과금 1분, 금액 $0.0396, 남은 잔액 $19.9604

명령의 종료 코드는 스크립트의 종료 코드와 같습니다. Ctrl+C로 멈추면 잡도 취소됩니다

5. 코딩 에이전트에 연결

2단계의 설치가 설치된 에이전트에 이미 등록했습니다. 그 뒤에 설치한 에이전트는 xenocast setup을 다시 실행하거나 아래처럼 직접 등록합니다. 설정 파일에 키를 넣지 않아도 저장된 키나 환경 변수를 읽습니다

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

Cursor는 ~/.cursor/mcp.json에 넣습니다

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

새 세션에서 "xenoci whoami 도구를 불러 줘"라고 하면 키의 조직과 워크스페이스가 보입니다

6. GitHub Actions에 연결

저장소 시크릿 XENOCI_API_KEY에 키를 넣고 워크플로에 액션을 추가합니다

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

잔액이 모자라면

잔액이 1분 요금보다 적으면 잡은 시작하지 않고 종료 코드 3으로 끝납니다

잔액이 부족해 잡을 시작하지 않았습니다 (사용 가능 $0.0100, 1분 요금 $0.0396). 충전: https://xenoci.com/console/billing

충전은 콘솔에서 로그인한 사람이 합니다. CLI, MCP, 액션은 결제하지 않습니다

다음 단계