> ## 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 CLI와 코딩 에이전트로 대화만으로 에이전트를 빌드·배포·개선하세요.

AI로 vox.ai를 다루는 경로는 [vox CLI](/docs/ai/cli)입니다. CLI를 설치하고 프로젝트를 만들면 Claude Code, Codex 같은 코딩 에이전트가 에이전트 정의를 코드처럼 다룹니다. 대시보드를 열지 않고도 대화만으로 **빌드·배포·모니터링·평가·개선**하는 전체 루프를 수행할 수 있습니다.

## 시작하기

{/* CLI 퍼널 — 설치 → 로그인·init → 코딩 에이전트에게 요청 */}

<Steps>
  <Step title="vox CLI 설치">
    <CodeGroup>
      ```bash npm theme={null}
      npm install -g @vox-ai/cli
      ```

      ```bash Homebrew theme={null}
      brew install vox-public/tap/vox
      ```
    </CodeGroup>
  </Step>

  <Step title="로그인하고 프로젝트 만들기">
    ```bash theme={null}
    vox auth login
    vox init --agent main --type flow
    ```

    `vox init`은 Claude Code와 Codex가 자동으로 인식하는 스킬 파일을 프로젝트에 만듭니다. 별도 설정이 필요 없습니다.
  </Step>

  <Step title="코딩 에이전트에게 요청">
    같은 프로젝트에서 Claude Code나 Codex를 열고, 만들고 싶은 에이전트를 설명하세요.

    ```plaintext theme={null}
    치과 예약 확인 에이전트 만들어줘.
    환자 이름과 예약 시간을 확인하고, 변경이 필요하면 담당자에게 연결해줘.
    만들고 나서 vox chat으로 예약 변경 시나리오까지 테스트해줘.
    ```

    코딩 에이전트가 CLI로 에이전트를 만들고, 검증하고, 테스트까지 진행합니다.
  </Step>
</Steps>

<Note>
  명령어와 전체 워크플로우는 [CLI 문서](/docs/ai/cli)를, 클라이언트별 연결 방법은 [Claude Code·Codex에서 CLI 설치](/docs/ai/clients)를 참고하세요.
</Note>

## 할 수 있는 것

CLI 연동 후 코딩 에이전트에게 자연어로 아래 작업을 요청할 수 있습니다.

* **빌드** — 프롬프트, 음성, 지식 베이스, 도구를 설정해 에이전트를 만들고 수정
* **테스트** — `vox chat`으로 전화 없이 멀티턴 시나리오 검증
* **배포** — 전화번호 연결, 단일 아웃바운드 콜, 대량 발신 캠페인, 인바운드 수신 설정
* **모니터링** — 통화 기록과 녹취 조회, 실패 원인 파악
* **개선** — 통화 결과를 바탕으로 프롬프트와 플로우를 반복 수정

에이전트 정의가 JSON 파일로 레포에 남으므로, 모든 변경을 git으로 리뷰하고 롤백할 수 있습니다.

## 더 알아보기

<CardGroup cols={2}>
  <Card title="CLI 문서" icon="terminal" href="/docs/ai/cli">
    설치부터 전체 명령어, 코딩 에이전트 워크플로우까지 확인하세요.
  </Card>

  <Card title="Claude Code·Codex에서 CLI 설치" icon="sparkles" href="/docs/ai/clients">
    Claude Code, Codex, 그 밖의 코딩 에이전트에 연결하는 방법입니다.
  </Card>
</CardGroup>

***

<Accordion title="연관 검색어">
  AI 앱 연동, CLI, vox CLI, Claude Code, Codex, 코딩 에이전트, agent as code, 에이전트 생성, 온보딩, 음성 에이전트
</Accordion>
