{"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":"编程智能体常常一干就是几分钟，用语音提示告诉你它完成了，就不必一直盯着屏幕。有些编辑器还能朗读回答。本页使用的 SuperClonica 引擎不支持中文，可朗读英语、日语等 31 种语言。\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 参数，因此请通过 shell 调用播放器：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 有文本转语音吗？","answer":"Cursor 没有内置的回答朗读功能。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 文字转语音：从回答到音频文件"},{"slug":"fortnite-text-to-speech","path":"/guides/fortnite-text-to-speech","h1":"堡垒之夜文字转语音：如何开启和关闭"},{"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、Chromebook 和 Xbox 的读屏（讲述人）"},{"slug":"minecraft-narrator","path":"/guides/minecraft-narrator","h1":"《我的世界》旁白：关闭、设置，或给地图配上真实声音"},{"slug":"local-llm-text-to-speech","path":"/guides/local-llm-text-to-speech","h1":"本地大模型与聊天机器人的文字转语音"},{"slug":"bulk-text-to-speech","path":"/guides/bulk-text-to-speech","h1":"从表格批量文字转语音"}],"related":[{"slug":"text-to-speech","path":"/text-to-speech","h1":"在自己电脑上运行的语音合成"},{"slug":"supertonic","path":"/compare/supertonic","h1":"Supertonic 与 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：即时克隆还是训练好的音色文件"}]}