Claude Read Aloud

Claude Read Aloud 是一个专为 Claude Code 设计的插件及配套 VS Code 扩展，将文本回复转化为高质量的语音输出。它解决了开发者长时间阅读代码和解释导致的视觉疲劳问题，通过“听”来吸收信息，让你能更专注于屏幕上的代码本身。

核心亮点

1. 多引擎支持，丰俭由人
   • 开箱即用（免费）：直接使用 macOS (say)、Windows (SAPI) 或 Linux 的系统语音。
   • 本地神经语音（推荐）：一键安装 Kokoro，提供 54 种高质量本地神经语音，无账户、无密钥、永久免费（约 340MB）。
   • 云端顶级音质：支持集成 Speechify、ElevenLabs 和 OpenAI TTS，只需配置 API Key 即可享受逼真的人声。
2. 无缝集成体验
   • 聊天内按钮：在 Claude Code 聊天框的麦克风旁出现扬声器图标，点击即读。
   • 右键朗读：高亮任意文本，右键选择“朗读”。
   • 快捷键支持：默认 Ctrl+Alt+S (macOS: ⌘⌥S) 启动/停止。
   • 状态栏控制：VS Code 左下角提供快速控制入口。
3. 智能分块与流式播放
   • 零延迟启动：长回复在 1-3 秒内开始播放。
   • 无间隙衔接：文本在句子边界处被智能切分，前一块播放时合成下一块，确保听觉连贯性。
   • 代码过滤：自动跳过冗长的代码块（朗读为“代码省略”），避免枯燥的 JSON 或代码朗读。
4. 隐私与安全
   • 所有配置和 API Key 均存储在本地环境变量或配置文件中，绝不上传。
   • 本地引擎（如 Kokoro）完全离线运行。

安装指南

第一步：安装 Claude Code 插件（引擎）

这是核心部分，负责语音合成和播放逻辑。

claude plugin marketplace add michaelpgifford/claude-read-aloud
claude plugin install read-aloud@claude-read-aloud

要求：系统 PATH 中需有 Python 3.9+。

第二步：安装 VS Code 扩展（界面增强，可选但推荐）

如果你使用 VS Code，安装此扩展以获得按钮、热键和设置面板。

code --install-extension MichaelGifford.claude-read-aloud-button

注意：Linux 用户建议首次运行时执行 /read-aloud:voice-setup 以安装高质量的 Kokoro 语音，否则默认 espeak 音质较差。

常用命令

配置与自定义

配置文件位于 ~/.config/claude-read-aloud/config.json (Linux/macOS) 或 %APPDATA%\claude-read-aloud\config.json (Windows)。

示例配置（使用 Speechify）：

{
  "provider": "speechify",
  "voice": "oliver",
  "speed": 1.0,
  "auto_read": false
}

API Key 请通过环境变量设置（如 export SPEECHIFY_API_KEY=...），不要写入配置文件。

使用本地命令引擎（如 Piper）：

{
  "provider": "command",
  "command": "piper -m /path/to/voice.onnx -f {out}"
}

为什么你需要它？

• 缓解屏幕疲劳：将信息接收通道从眼睛转移到耳朵，降低认知负荷。
• 提升无障碍体验：对低视力用户、阅读障碍者或单纯喜欢“听书”模式的开发者极其友好。
• 多任务处理：在等待编译或部署时，可以“听”完 Claude 的代码审查意见，而不必死死盯着屏幕。

⚠️ 注意事项

• 自动朗读默认关闭：因为长时间会话可能产生数小时语音，建议按需使用。
• VS Code 补丁机制：为了在 Claude Code 的 Webview 中插入按钮，扩展会轻微修改 Claude Code 扩展的两个文件。每次 Claude Code 更新后，扩展会自动重新应用补丁，可能需要你重新加载窗口。
• 字符限制：单次朗读上限为 12,000 字符（约 14 分钟），超出部分会被截断。