{"kind":"guides","slug":"coding-agent-text-to-speech","path":"/guides/coding-agent-text-to-speech","title":"Codex, Cursor, VS Code 텍스트 음성 변환 | SuperClonica","description":"코딩 에이전트용 음성: VS Code 채팅 읽어 주기, Codex나 Cursor 작업 완료 음성 알림, 오프라인으로 답변을 음성으로 만드는 방법.","h1":"Codex, Cursor, VS Code에서 텍스트 음성 변환","intro":"코딩 에이전트는 몇 분씩 작업하기도 하는데, 음성 알림이 있으면 화면을 지켜보지 않아도 끝난 것을 알 수 있습니다. 답변을 읽어 주는 편집기도 있습니다.\n\n이 가이드는 VS Code, Codex CLI, Cursor를 SuperClonica 엔진으로 만든 무료 오프라인 목소리와 함께 다룹니다.","sections":[{"heading":"목소리를 한 번 만들기","paragraphs":["무료 엔진을 설치하고(python -m pip install superclonica-cpu) 약 190개 목소리 중 하나로 짧은 클립을 만드세요: superclonica --text \"Done!\" --voice F2 --lang en --output done.wav. 홈 폴더의 sounds에 넣습니다. 아래 예시는 macOS의 afplay로 재생합니다. Linux에서는 paplay, Windows에서는 WAV 파일을 재생하는 작은 스크립트를 쓰세요."]},{"heading":"VS Code: 채팅 답변 읽어 주기","paragraphs":["VS Code Speech 확장을 설치하면 채팅의 각 답변에 스피커 아이콘이 생기고, 누르면 읽어 주며 Esc로 멈춥니다. accessibility.voice.autoSynthesize 설정(기본값 꺼짐)을 켜면 음성으로 질문했을 때 답변을 자동으로 읽어 줍니다. 최신 버전에는 에이전트 답변을 읽고 후속 요청을 듣는 실험적 Voice Mode(agents.voice.enabled)도 있습니다."]},{"heading":"Codex CLI: 턴이 끝나면 소리 내기","paragraphs":["Codex는 턴이 끝나면 ~/.codex/config.toml의 notify에 적은 프로그램을 실행합니다. 프로젝트 자체 설정에서는 무시됩니다. Codex가 JSON 인자 하나를 덧붙이므로 셸을 통해 플레이어를 호출하세요: notify = [\"sh\", \"-c\", \"afplay $HOME/sounds/done.wav\", \"codex\"]. JSON에는 last-assistant-message가 들어 있어, 작은 스크립트로 답변 자체를 엔진으로 음성화해 재생할 수도 있습니다."]},{"heading":"Cursor: stop 훅","paragraphs":["Cursor는 ~/.cursor/hooks.json(프로젝트는 .cursor/hooks.json)에서 훅을 읽습니다. stop 이벤트는 에이전트가 끝나면 발생하며 표준 입력으로 completed, aborted, error 중 하나의 상태를 줍니다: {\"version\": 1, \"hooks\": {\"stop\": [{\"command\": \"afplay ~/sounds/done.wav\"}]}}. 스크립트로 상태를 확인해 오류일 때 다른 클립을 재생할 수도 있습니다."]},{"heading":"MCP로 요청할 때 음성 만들기","paragraphs":["요청할 때 캐릭터나 내레이터 목소리로 텍스트를 읽게 하려면 무료 API 키로 SuperClonica MCP 서버(https://superclonica.com/mcp)를 연결하세요. VS Code, Cursor, Claude Code에서 동작하며 오디오 파일 링크를 돌려줍니다."]}],"faq":[{"question":"Cursor에 TTS가 있나요?","answer":"답변을 읽어 주는 기본 기능은 없습니다. stop 훅으로 소리를 내거나 결과를 읽게 할 수 있고, MCP 서버로 요청 시 텍스트를 음성으로 만들 수 있습니다."},{"question":"Codex CLI가 답변을 읽어 줄 수 있나요?","answer":"단독으로는 안 되지만 notify가 마지막 답변을 내 프로그램에 넘겨 주므로 오프라인 엔진으로 읽게 할 수 있습니다."},{"question":"VS Code에서 채팅을 읽게 하려면?","answer":"VS Code Speech 확장을 설치하고 답변의 스피커 아이콘을 누르거나, accessibility.voice.autoSynthesize를 켜서 음성 질문의 답변을 들으세요."},{"question":"무료인가요?","answer":"네. 엔진은 무료이고 오프라인이며, MCP 서버는 무료 키로 하루 3분을 제공합니다."}],"cta":{"catalog":"목소리 보기","install":"SuperClonica 엔진 설치","api":"무료 API 키 받기"},"sources":[{"label":"OpenAI: Codex advanced configuration (notify)","url":"https://developers.openai.com/codex/config-advanced"},{"label":"Cursor: Hooks","url":"https://cursor.com/docs/hooks"},{"label":"VS Code: Voice support","url":"https://code.visualstudio.com/docs/configure/accessibility/voice"},{"label":"VS Code: AI settings reference","url":"https://code.visualstudio.com/docs/agents/reference/ai-settings"}],"published":"2026-11-01","updated":"2026-11-01","pages":[{"slug":"claude-text-to-speech","path":"/guides/claude-text-to-speech","h1":"Claude 텍스트 음성 변환: 음성 모드와 Claude Code용 음성"},{"slug":"tts-mcp-server","path":"/guides/tts-mcp-server","h1":"텍스트 음성 변환 MCP 서버: AI 에이전트가 소리 내어 말하게"},{"slug":"text-to-speech-mcp-server","path":"/guides/text-to-speech-mcp-server","h1":"텍스트 음성 변환 MCP 서버: AI 어시스턴트에 목소리를"},{"slug":"copilot-read-aloud","path":"/guides/copilot-read-aloud","h1":"Copilot 소리 내어 읽기: Microsoft Copilot 답변 듣기"},{"slug":"ollama-text-to-speech","path":"/guides/ollama-text-to-speech","h1":"Ollama 텍스트 음성 변환: 로컬 모델이 완전히 오프라인으로 말하게"},{"slug":"chatgpt-text-to-speech","path":"/guides/chatgpt-text-to-speech","h1":"ChatGPT TTS: 답변을 오디오 파일로"},{"slug":"fortnite-text-to-speech","path":"/guides/fortnite-text-to-speech","h1":"포트나이트 TTS: 켜고 끄는 방법"},{"slug":"turn-off-caller-name-announcement","path":"/guides/turn-off-caller-name-announcement","h1":"전화 올 때 발신자를 읽어 주는 기능 끄는 법"},{"slug":"turn-off-narrator-mac-chromebook-xbox","path":"/guides/turn-off-narrator-mac-chromebook-xbox","h1":"Mac·크롬북·Xbox의 내레이터(화면 낭독기) 끄는 법"},{"slug":"minecraft-narrator","path":"/guides/minecraft-narrator","h1":"마인크래프트 내레이터: 끄기, 설정하기, 맵에 진짜 목소리 넣기"},{"slug":"local-llm-text-to-speech","path":"/guides/local-llm-text-to-speech","h1":"로컬 LLM과 챗봇을 위한 텍스트 음성 변환"},{"slug":"bulk-text-to-speech","path":"/guides/bulk-text-to-speech","h1":"스프레드시트로 대량 텍스트 음성 변환"}],"related":[{"slug":"text-to-speech","path":"/text-to-speech","h1":"내 컴퓨터에서 돌아가는 음성 합성(TTS)"},{"slug":"supertonic","path":"/compare/supertonic","h1":"Supertonic vs SuperClonica: 같은 모델, 더 빠르고 깨끗하게"},{"slug":"fish-audio","path":"/compare/fish-audio","h1":"Fish Audio·Fish Speech와 SuperClonica 비교"},{"slug":"omnivoice","path":"/compare/omnivoice","h1":"OmniVoice와 SuperClonica: 언어 수인가, 속도인가"},{"slug":"qwen3-tts","path":"/compare/qwen3-tts","h1":"로컬 음성 합성, Qwen3-TTS와 SuperClonica 중 무엇을 쓸까"},{"slug":"voxcpm","path":"/compare/voxcpm","h1":"VoxCPM 2와 SuperClonica: 스튜디오 음질인가, CPU 속도인가"},{"slug":"f5-tts","path":"/compare/f5-tts","h1":"F5-TTS와 SuperClonica: 제로샷 복제인가, CPU에서 빠른 음성인가"},{"slug":"elevenlabs","path":"/compare/elevenlabs","h1":"오프라인으로 쓰는 ElevenLabs 대안"},{"slug":"kokoro","path":"/compare/kokoro","h1":"Kokoro TTS와 SuperClonica: 로컬 음성 합성을 위한 작은 모델 두 가지"},{"slug":"piper","path":"/compare/piper","h1":"Piper TTS와 SuperClonica: 소형 기기인가, 맞춤 목소리인가"},{"slug":"xtts","path":"/compare/xtts","h1":"Coqui XTTS-v2와 SuperClonica: Coqui TTS 대안"},{"slug":"chatterbox","path":"/compare/chatterbox","h1":"Chatterbox TTS와 SuperClonica: 즉시 복제인가, 학습된 목소리 파일인가"}]}