가이드

Codex, Cursor, VS Code에서 텍스트 음성 변환

코딩 에이전트는 몇 분씩 작업하기도 하는데, 음성 알림이 있으면 화면을 지켜보지 않아도 끝난 것을 알 수 있습니다. 답변을 읽어 주는 편집기도 있습니다.

이 가이드는 VS Code, Codex CLI, Cursor를 SuperClonica 엔진으로 만든 무료 오프라인 목소리와 함께 다룹니다.

목소리를 한 번 만들기

무료 엔진을 설치하고(python -m pip install superclonica-cpu) 약 190개 목소리 중 하나로 짧은 클립을 만드세요: superclonica --text "Done!" --voice F2 --lang en --output done.wav. 홈 폴더의 sounds에 넣습니다. 아래 예시는 macOS의 afplay로 재생합니다. Linux에서는 paplay, Windows에서는 WAV 파일을 재생하는 작은 스크립트를 쓰세요.

VS Code: 채팅 답변 읽어 주기

VS Code Speech 확장을 설치하면 채팅의 각 답변에 스피커 아이콘이 생기고, 누르면 읽어 주며 Esc로 멈춥니다. accessibility.voice.autoSynthesize 설정(기본값 꺼짐)을 켜면 음성으로 질문했을 때 답변을 자동으로 읽어 줍니다. 최신 버전에는 에이전트 답변을 읽고 후속 요청을 듣는 실험적 Voice Mode(agents.voice.enabled)도 있습니다.

Codex CLI: 턴이 끝나면 소리 내기

Codex는 턴이 끝나면 ~/.codex/config.toml의 notify에 적은 프로그램을 실행합니다. 프로젝트 자체 설정에서는 무시됩니다. Codex가 JSON 인자 하나를 덧붙이므로 셸을 통해 플레이어를 호출하세요: notify = ["sh", "-c", "afplay $HOME/sounds/done.wav", "codex"]. JSON에는 last-assistant-message가 들어 있어, 작은 스크립트로 답변 자체를 엔진으로 음성화해 재생할 수도 있습니다.

Cursor: stop 훅

Cursor는 ~/.cursor/hooks.json(프로젝트는 .cursor/hooks.json)에서 훅을 읽습니다. stop 이벤트는 에이전트가 끝나면 발생하며 표준 입력으로 completed, aborted, error 중 하나의 상태를 줍니다: {"version": 1, "hooks": {"stop": [{"command": "afplay ~/sounds/done.wav"}]}}. 스크립트로 상태를 확인해 오류일 때 다른 클립을 재생할 수도 있습니다.

MCP로 요청할 때 음성 만들기

요청할 때 캐릭터나 내레이터 목소리로 텍스트를 읽게 하려면 무료 API 키로 SuperClonica MCP 서버(https://superclonica.com/mcp)를 연결하세요. VS Code, Cursor, Claude Code에서 동작하며 오디오 파일 링크를 돌려줍니다.