> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# vox.ai 시작하기

> AI 음성 에이전트를 빌드하고 배포하고 모니터링하는 방법을 알아보세요.

AI 음성 에이전트는 대화로 업무를 처리합니다. 간단한 FAQ 응대부터 복잡한 상담 시나리오까지 가능합니다. vox.ai에서 에이전트를 설계하고 전화망에 배포한 뒤 운영 상태를 실시간으로 확인할 수 있습니다.

## 1분 만에 시작하기

사용 중인 AI 앱에 vox.ai를 연결하면 대화만으로 에이전트를 만들고 통화까지 실행할 수 있습니다. 아래에서 앱을 고르고 안내대로 진행하세요.

{/* 설치 명령어는 vox-public/vox-skills의 README와 동기 */}

<Tabs>
  <Tab title="Claude Code">
    아래 prompt를 복사해 Claude Code 채팅창에 그대로 붙여넣으세요. Claude Code 가 install 스크립트 한 줄로 plugin 등록·설치를 끝낸 뒤 첫 음성 에이전트 온보딩까지 안내합니다.

    ```plaintext theme={null}
    vox.ai 를 이 Claude Code 세션에 설치하고 첫 음성 에이전트 만들기 온보딩까지 진행해줘.

    1. 셸에서 한 줄을 실행 (Bash 도구로 너가 직접):
         bash <(curl -fsSL https://raw.githubusercontent.com/vox-public/vox-skills/main/install.sh) claude

    2. 내가 /reload-plugins 를 입력하도록 안내. "이 명령을 입력하세요: /reload-plugins"

    3. plugin 이 로드되면 /vox-ai:vox-onboarding 을 입력하라고 안내해서 첫 음성 에이전트 만들기 온보딩으로 진입.

    온보딩 시작 직전에 "vox.ai 를 이 프로젝트의 .claude/settings.json 에도 추가해서 팀원들과 공유할까요?" 라고 한 번 물어봐줘.
    ```

    <Accordion title="셸 명령으로 직접 설치">
      ```bash theme={null}
      bash <(curl -fsSL https://raw.githubusercontent.com/vox-public/vox-skills/main/install.sh) claude
      ```

      또는 install.sh 없이 두 줄로:

      ```bash theme={null}
      claude plugin marketplace add vox-public/vox-skills
      claude plugin install vox-ai@vox-ai
      ```

      Claude Code 채팅에서 `/reload-plugins` 입력 후 `/vox-ai:vox-onboarding` 으로 진입. 자세한 단계와 OAuth troubleshooting 은 [Claude Code 가이드](/docs/ai/claude-code) 참고.
    </Accordion>
  </Tab>

  <Tab title="Codex CLI">
    아래 prompt를 복사해 Codex CLI 채팅창에 그대로 붙여넣으세요. Codex 가 install 스크립트 한 줄로 마켓플레이스 등록을 끝내고 첫 음성 에이전트 온보딩까지 안내합니다.

    ```plaintext theme={null}
    vox.ai 를 이 Codex 세션에 설치하고 첫 음성 에이전트 만들기 온보딩까지 진행해줘.

    1. 셸에서 한 줄을 실행 (Bash 도구로 너가 직접):
         bash <(curl -fsSL https://raw.githubusercontent.com/vox-public/vox-skills/main/install.sh) codex

    2. 내가 /plugin 을 입력해서 plugin 목록에서 vox-ai 를 설치할 수 있도록 안내.

    3. 설치 후 "codex-cli 를 완전히 종료한 뒤 다시 시작하세요" 라고 안내. 재시작 전까지 plugin 의 skill 과 MCP 가 현재 세션에 로드되지 않음.

    4. 재시작 후 $vox-ai:vox-onboarding 을 입력하라고 안내해서 첫 음성 에이전트 만들기 온보딩으로 진입.
    ```

    <Accordion title="셸 명령으로 직접 설치">
      ```bash theme={null}
      bash <(curl -fsSL https://raw.githubusercontent.com/vox-public/vox-skills/main/install.sh) codex
      ```

      또는 install.sh 없이 한 줄로:

      ```bash theme={null}
      codex plugin marketplace add vox-public/vox-skills
      ```

      그 뒤 Codex CLI 안에서 `/plugin` 으로 vox-ai 설치 → codex-cli 재시작 → `$vox-ai:vox-onboarding`. 자세한 단계와 OAuth troubleshooting 은 [Codex CLI 가이드](/docs/ai/codex-cli) 참고.
    </Accordion>
  </Tab>

  <Tab title="Codex App">
    Codex 데스크톱 앱은 GUI 로 설치합니다. 아래 단계를 따라하세요.

    <Steps>
      <Step title="Plugins 메뉴 열기">
        Codex App 좌측 사이드바에서 **Plugins** 를 엽니다.
      </Step>

      <Step title="마켓플레이스 추가">
        검색창 옆 버튼을 누르고 **+ Add more** 선택. source 에 `vox-public/vox-skills` 를 입력한 뒤 **Add marketplace** 클릭.
      </Step>

      <Step title="vox.ai Plugins 열기">
        검색창 옆 **vox.ai Plugins** 버튼을 클릭합니다.
      </Step>

      <Step title="vox.ai 설치 및 로그인">
        `vox.ai` 를 설치합니다. 첫 도구 호출 시 브라우저에서 vox.ai 로그인 창이 열리면 인증을 완료하세요.
      </Step>

      <Step title="온보딩 시작">
        `$vox-ai:vox-onboarding` 을 입력해서 첫 음성 에이전트 만들기 온보딩을 시작하세요.
      </Step>
    </Steps>

    자세한 안내는 [Codex App 가이드](/docs/ai/codex-app)를 참고하세요.
  </Tab>

  <Tab title="Claude Cowork">
    Claude 데스크톱 앱(Cowork)은 GUI 로 설치합니다. 아래 단계를 따라하세요.

    <Steps>
      <Step title="Claude Desktop 실행">
        Claude Desktop 앱을 실행하고 Cowork에 접속하세요.
      </Step>

      <Step title="사용자 지정 메뉴 열기">
        좌측 사이드바에서 **사용자 지정** 메뉴를 클릭하세요.
      </Step>

      <Step title="개인 플러그인 추가">
        **개인 플러그인** 섹션의 **+** 버튼을 누르고 **플러그인 생성 → 마켓플레이스 추가** 를 선택하세요.
      </Step>

      <Step title="vox-skills 등록">
        입력란에 [`vox-public/vox-skills`](https://github.com/vox-public/vox-skills) 를 입력합니다.
      </Step>

      <Step title="Vox ai Plugin 설치">
        마켓플레이스 목록에서 `Vox ai` Plugin 을 설치합니다.
      </Step>

      <Step title="vox 커넥터 설치 및 연결">
        좌측 사이드바의 **Plugin** 메뉴에서 **Vox ai** 를 선택한 뒤 `vox` 커넥터를 설치하고 **연결** 버튼으로 vox.ai 로그인을 완료합니다.
      </Step>

      <Step title="vox-docs 커넥터 설치">
        같은 화면에서 `vox-docs` 커넥터도 설치합니다 (별도 연결은 필요하지 않습니다).
      </Step>

      <Step title="온보딩 시작">
        `/vox-ai:vox-onboarding` 을 입력하거나 "vox-onboarding 스킬을 실행해줘" 라고 입력해서 첫 음성 에이전트 만들기 온보딩을 시작하세요.
      </Step>
    </Steps>

    자세한 안내는 [Claude Cowork 가이드](/docs/ai/claude-cowork)를 참고하세요.
  </Tab>
</Tabs>

<Card title="대시보드로 직접 시작" icon="window" href="/docs/start/quickstart#대시보드에서-시작" horizontal>
  AI 앱 없이 vox.ai 대시보드에서 바로 빌드하고 싶다면 빠른 시작 가이드를 참고하세요.
</Card>

## 플랫폼 둘러보기

<CardGroup cols={3}>
  <Card title="빌드" icon="hammer" href="/docs/build/single-prompt/overview">
    프롬프트 에이전트, 플로우 에이전트로 음성 AI를 설계하세요.
  </Card>

  <Card title="배포" icon="rocket" href="/docs/operate/deploy/overview">
    전화번호, SIP을 연결하고 캠페인을 실행하세요.
  </Card>

  <Card title="모니터링" icon="chart-mixed" href="/docs/operate/monitor/overview">
    통화 기록, 분석, 알림으로 성능을 추적하세요.
  </Card>
</CardGroup>

## 플랫폼 기능

에이전트를 설계하고 배포하고 최적화하는 데 필요한 기능을 제공합니다.

### 설계 및 빌드

| 목표            | 가이드                                                 | 설명                             |
| ------------- | --------------------------------------------------- | ------------------------------ |
| 프롬프트 에이전트 만들기 | [프롬프트 에이전트](/docs/build/single-prompt/overview)     | 단일 프롬프트로 에이전트를 빠르게 만드세요        |
| 플로우 에이전트 만들기  | [플로우 에이전트](/docs/build/flow/overview)               | 노드 기반 워크플로우로 복잡한 대화를 설계하세요     |
| 시스템 프롬프트 작성   | [프롬프트 작성](/docs/build/single-prompt/prompt-writing) | 에이전트의 역할, 성격, 규칙을 정의하세요        |
| 도구 연결         | [도구](/docs/build/tools/overview)                    | API로 외부 기능을 추가하세요              |
| 지식 베이스 추가     | [지식 베이스](/docs/build/knowledge/overview)            | 문서와 URL을 업로드해 RAG 기반 응답을 제공하세요 |
| 대화 개인화        | [동적 변수](/docs/build/variables/dynamic-variables)    | `{{변수}}`로 대화별 커스터마이즈           |
| 버전 관리         | [에이전트 버전 관리](/docs/build/versioning)                | 에이전트를 버전별로 관리하고 프로덕션에 배포하세요    |

### 연결 및 배포

| 목표         | 가이드                                              | 설명                                            |
| ---------- | ------------------------------------------------ | --------------------------------------------- |
| SDK 통합     | [SDK](/docs/sdk/javascript)                      | JavaScript, React, Flutter, Python으로 앱에 내장하세요 |
| 전화번호 연결    | [전화번호](/docs/operate/deploy/phone-numbers)       | 인바운드 전화번호를 에이전트에 연결하세요                        |
| 단건 아웃바운드   | [아웃바운드 단건](/docs/operate/deploy/outbound-single) | API로 단건 통화를 실행하세요                             |
| 대량 아웃바운드   | [아웃바운드 대량](/docs/operate/deploy/outbound-batch)  | CSV/Excel로 대량 캠페인을 실행하세요                      |
| SIP 트렁크 연결 | [SIP 연동](/docs/operate/deploy/sip-telephony)     | 기존 PBX에 SIP으로 연결하세요                           |

### 모니터링 및 최적화

| 목표       | 가이드                                           | 설명                        |
| -------- | --------------------------------------------- | ------------------------- |
| 통화 기록 확인 | [통화 기록](/docs/operate/monitor/history)        | 녹음, 스크립트, 메타데이터를 확인하세요    |
| 분석 대시보드  | [분석](/docs/operate/monitor/analytics)         | 통화량, 성공률, 비용을 한눈에 파악하세요   |
| 알림 설정    | [알림](/docs/operate/monitor/alerts)            | 이상 감지 시 알림을 받으세요          |
| 통화 후 분석  | [통화 후 분석](/docs/operate/monitor/post-call)    | LLM으로 대화 품질과 목표 달성을 분석하세요 |
| 웹훅 연동    | [웹훅](/docs/operate/monitor/webhooks/overview) | 통화 이벤트를 외부 시스템으로 전달하세요    |
| 데이터 내보내기 | [내보내기](/docs/operate/monitor/exports)         | 통화 데이터를 CSV로 내보내세요        |

### 보안

| 목표        | 가이드                                      | 설명                      |
| --------- | ---------------------------------------- | ----------------------- |
| 워크스페이스 관리 | [워크스페이스](/docs/workspace/overview)       | 멤버, 역할, 인증, 설정을 관리하세요   |
| AI 고지 의무  | [AI 고지 의무](/docs/security/ai-disclosure) | AI 기본법에 따른 고지 의무를 확인하세요 |

## 아키텍처

vox.ai는 4가지 핵심 컴포넌트를 조율합니다:

1. **STT** — 음성을 텍스트로 바꾸는 음성 인식 모델
2. **LLM** — 대화 로직을 처리하는 언어 모델
3. **TTS** — 텍스트를 음성으로 읽어주는 음성 합성 모델
4. **턴테이킹** — 끼어들기, 침묵, 대화 타이밍을 잡아주는 모델

<Card title="빠른 시작" icon="rocket" href="/docs/start/quickstart">
  5분 안에 첫 에이전트를 만들어 보세요.
</Card>

***

<Accordion title="연관 검색어">
  시작하기, 개요, overview, getting started, 음성 에이전트, voice agent, AI 전화, 플랫폼 소개, 아키텍처
</Accordion>