指南

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

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

本指南介绍 VS Code、Codex CLI 和 Cursor，并用 SuperClonica 引擎生成免费的离线声音。

免费获取 API 密钥 浏览声音 安装 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，并返回音频文件链接。