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

# PC 오디오 출력

> AI 에이전트가 로컬 PC 오디오로 TTS를 출력할 때 CLI를 사용하는 방법입니다.

에이전트가 로컬 컴퓨터를 제어하는 상황에서는 CLI로 짧은 텍스트를 음성으로 만들고 기본 오디오 출력 장치로 바로 재생할 수 있습니다. 작업 완료 알림, 손을 쓰지 않는 상태 안내, 빠른 음성 미리듣기에 유용합니다.

<Info>
  로컬 에이전트 피드백에는 `cast "message"`가 가장 단순한 실시간 느낌의 경로입니다. API 레벨의 chunked streaming이 필요하면 SDK로 타입캐스트 streaming endpoint를 사용하세요.
</Info>

## 바로 말하기

```bash theme={null}
cast "The export is complete."
```

CLI는 기본적으로 파일 저장 대신 생성된 오디오를 바로 재생합니다.

## 안정적인 재생을 위해 파일로 저장

긴 문장이나 반복 재생이 필요한 메시지는 먼저 파일로 저장합니다:

```bash theme={null}
cast "The build failed. Check the test report before pushing." --out agent-alert.wav
```

이후 시스템 오디오 도구로 재생합니다:

<Tabs>
  <Tab title="macOS">
    ```bash theme={null}
    afplay agent-alert.wav
    ```
  </Tab>

  <Tab title="Linux">
    ```bash theme={null}
    aplay agent-alert.wav
    ```
  </Tab>
</Tabs>

## 에이전트 프롬프트 예시

```text theme={null}
긴 작업이 끝나면 PC 오디오로 짧은 상태 안내를 말해줘.
CLI를 사용해줘.
말할 문장은 12단어 이하로 유지해줘.
재생에 실패하면 오디오 파일을 저장하고 경로를 알려줘.
```

## 좋은 오디오 메시지

| 상황        | 추천 문장                                    |
| --------- | ---------------------------------------- |
| 작업 완료     | `The task is complete.`                  |
| 사용자 입력 필요 | `I need your input to continue.`         |
| 테스트 실패    | `Tests failed. Please check the report.` |
| 배포 준비 완료  | `The preview is ready.`                  |

## 오디오 경로 선택

| 필요          | 추천 경로                                        |
| ----------- | -------------------------------------------- |
| 빠른 음성 상태 안내 | `cast "The preview is ready."`               |
| 같은 알림 반복 재생 | `--out agent-alert.wav`로 저장한 뒤 `afplay`로 재생  |
| 에이전트 전용 음성  | `cast config set voice-id tc_xxx`            |
| 프로젝트 전용 음성  | `cast voices clone` 후 `--voice-id uc_xxx` 사용 |
| 자세한 보고      | 한 문장만 말하고 세부 내용은 채팅이나 로그에 작성                 |

<Tip>
  PC 오디오 메시지는 짧게 유지하세요. 자세한 상태는 한 문장으로 말하고, 세부 내용은 채팅이나 로그에 남기는 편이 좋습니다.
</Tip>