# Codex、Cursor 和 VS Code 的文本转语音

更新于 2026-11-01

编程智能体常常一干就是几分钟，用语音提示告诉你它完成了，就不必一直盯着屏幕。有些编辑器还能朗读回答。本页使用的 SuperClonica 引擎不支持中文，可朗读英语、日语等 31 种语言。

本指南介绍 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 参数，因此请通过 shell 调用播放器：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，并返回音频文件链接。

## 更多指南

- [Claude 文本转语音：语音模式与 Claude Code 的语音](https://superclonica.com/zh/guides/claude-text-to-speech)
- [文字转语音 MCP 服务器：让你的 AI 智能体开口说话](https://superclonica.com/zh/guides/tts-mcp-server)
- [文本转语音 MCP 服务器：让你的 AI 助手开口说话](https://superclonica.com/zh/guides/text-to-speech-mcp-server)
- [Copilot 朗读：收听 Microsoft Copilot 的回答](https://superclonica.com/zh/guides/copilot-read-aloud)
- [为 Ollama 加上文字转语音：让本地模型完全离线地开口说话](https://superclonica.com/zh/guides/ollama-text-to-speech)
- [ChatGPT 文字转语音：从回答到音频文件](https://superclonica.com/zh/guides/chatgpt-text-to-speech)
- [堡垒之夜文字转语音：如何开启和关闭](https://superclonica.com/zh/guides/fortnite-text-to-speech)
- [如何关闭来电时朗读来电者姓名](https://superclonica.com/zh/guides/turn-off-caller-name-announcement)
- [如何关闭 Mac、Chromebook 和 Xbox 的读屏（讲述人）](https://superclonica.com/zh/guides/turn-off-narrator-mac-chromebook-xbox)
- [《我的世界》旁白：关闭、设置，或给地图配上真实声音](https://superclonica.com/zh/guides/minecraft-narrator)
- [本地大模型与聊天机器人的文字转语音](https://superclonica.com/zh/guides/local-llm-text-to-speech)
- [从表格批量文字转语音](https://superclonica.com/zh/guides/bulk-text-to-speech)

## 语音合成与对比

- [在自己电脑上运行的语音合成](https://superclonica.com/zh/text-to-speech)
- [Supertonic 与 SuperClonica：同一模型，更快更干净](https://superclonica.com/zh/compare/supertonic)
- [Fish Audio、Fish Speech 与 SuperClonica 对比](https://superclonica.com/zh/compare/fish-audio)
- [OmniVoice 与 SuperClonica：语言更多，还是速度更快](https://superclonica.com/zh/compare/omnivoice)
- [本地语音合成：Qwen3-TTS 还是 SuperClonica](https://superclonica.com/zh/compare/qwen3-tts)
- [VoxCPM 2 与 SuperClonica：录音棚音质还是 CPU 速度](https://superclonica.com/zh/compare/voxcpm)
- [F5-TTS 与 SuperClonica：零样本克隆还是 CPU 上的快速合成](https://superclonica.com/zh/compare/f5-tts)
- [可离线使用的 ElevenLabs 替代方案](https://superclonica.com/zh/compare/elevenlabs)
- [Kokoro TTS 与 SuperClonica：两个小模型的本地语音合成](https://superclonica.com/zh/compare/kokoro)
- [Piper TTS 与 SuperClonica：小设备还是定制音色](https://superclonica.com/zh/compare/piper)
- [Coqui XTTS-v2 与 SuperClonica：Coqui TTS 的替代方案](https://superclonica.com/zh/compare/xtts)
- [Chatterbox TTS 与 SuperClonica：即时克隆还是训练好的音色文件](https://superclonica.com/zh/compare/chatterbox)

## 常见问题

### Cursor 有文本转语音吗？

Cursor 没有内置的回答朗读功能。stop 钩子可以播放声音或朗读结果，MCP 服务器可按需朗读文本。

### Codex CLI 能朗读回答吗？

它本身不能，但 notify 会把最后的回答传给你的程序，由离线引擎朗读。

### 如何让 VS Code 朗读聊天？

安装 VS Code Speech 扩展后点击回答旁的扬声器图标，或开启 accessibility.voice.autoSynthesize，在语音提问时听到回答。

### 免费吗？

免费：引擎免费且离线，MCP 服务器用免费密钥每天可用 3 分钟。

- [免费获取 API 密钥](https://superclonica.com/zh/speech-api)
- [浏览声音](https://superclonica.com/zh/explore)
- [安装 SuperClonica 引擎](https://superclonica.com/zh/superclonica)

## 参考来源

- [OpenAI: Codex advanced configuration (notify)](https://developers.openai.com/codex/config-advanced)
- [Cursor: Hooks](https://cursor.com/docs/hooks)
- [VS Code: Voice support](https://code.visualstudio.com/docs/configure/accessibility/voice)
- [VS Code: AI settings reference](https://code.visualstudio.com/docs/agents/reference/ai-settings)
- [SuperClonica](https://superclonica.com/zh/)
- [文字转语音 AI 声音目录](https://superclonica.com/zh/explore)
- [语音合成 API：免费密钥，每月 5 美元起](https://superclonica.com/zh/speech-api)
- [Supertonic 3 定制音色委托](https://superclonica.com/zh/requests)
- [工作原理：音色、本地语音、训练](https://superclonica.com/zh/guide)
- [安装更快的 Supertonic 3 引擎](https://superclonica.com/zh/superclonica)
- [关于我们：语音合成爱好者团队](https://superclonica.com/zh/about)
- [联系方式、支持与音色投诉](https://superclonica.com/zh/contacts)
- [隐私政策](https://superclonica.com/zh/privacy)
- [使用条款](https://superclonica.com/zh/terms)
- [语音合成](https://superclonica.com/zh/text-to-speech)