RU: Локальная озвучка ответов Claude Code из строки меню macOS.
EN: Local text-to-speech for Claude Code replies from the macOS menu bar.
Claude Voice читает вслух финальный абзац ответа Claude Code приятным локальным голосом. Приложение работает полностью офлайн: без облачной модели, без сетевых запросов и без сбора данных.
- Озвучивает только финальный ответ, чтобы не читать промежуточный шум.
- Поддерживает русский и английский с автоопределением языка абзаца.
- Останавливает голос при нажатии клавиши в терминале с Claude Code.
- Нормализует русские числа и добавляет ударения через словарь на 3.2 млн словоформ.
- Использует sherpa-onnx и голоса Piper; синтез обычно быстрее реального времени.
- Позволяет выбрать RU/EN голос, число CPU-потоков, автозапуск и язык интерфейса прямо в меню.
- Скачайте
ClaudeVoice-x.y.z.dmgна странице Releases. - Откройте DMG и запустите
Install.command. - Если macOS блокирует запуск, кликните по
Install.commandправой кнопкой и выберите Открыть. - После запуска разрешите Input Monitoring / Отслеживание ввода и установите хук Claude Code из меню.
- Откройте новую сессию Claude Code. Хуки читаются при старте новой сессии.
Требования: Apple Silicon, macOS 14+.
| Пункт | Назначение |
|---|---|
| Озвучка включена | Главный переключатель озвучки |
| Голос (русский) / Voice (Russian) | Выбор русского голоса |
| Голос (английский) / Voice (English) | Выбор английского голоса |
| CPU-потоки | Ограничение числа потоков синтеза |
| Язык интерфейса | Переключение меню между RU и EN |
| Проверить голос | Быстрый тест выбранного языка интерфейса |
| Установить хук | Интеграция с Claude Code |
| Запускать при входе | Автозапуск приложения |
flowchart LR
A[Claude Code завершил ответ] --> B[Stop hook]
B --> C[POST на 127.0.0.1]
C --> D[Последний абзац transcript]
D --> E{Язык}
E -- RU --> F[Числа и ударения]
E -- EN --> G[Текст как есть]
F --> H[sherpa-onnx + Piper]
G --> H
H --> I[Воспроизведение]
K[Клавиша в терминале Claude Code] -. stop .-> I
Хук добавляется в ~/.claude/settings.json с резервной копией. Команда хука помечена src=claude-voice-tts, использует локальный curl с таймаутом и не блокирует Claude Code.
bash packaging/fetch_assets.sh
bash packaging/build_app.sh 0.1.0
bash packaging/make_dmg.sh 0.1.0Быстрая проверка без GUI:
swift build -c release
DYLD_LIBRARY_PATH="$PWD/vendor/lib" CLAUDEVOICE_RESOURCES="$PWD/Resources" \
./.build/release/ClaudeVoice --selftest- Сборка не подписана Developer ID, поэтому Gatekeeper требует ручного подтверждения при первом запуске.
- После обновления macOS может снова запросить разрешение Input Monitoring.
- Поддерживается только Apple Silicon.
- Лицензия русского голоса
ru_RU-irinaуказана какUnknown; используйте с учётом этого ограничения.
- Добавить Developer ID подпись и notarization в release pipeline.
- Вынести локализацию из словаря
Lв.strings, если меню станет заметно больше. - Добавить unit-тесты для
TranscriptReader,LanguageDetector,HookInstallerи русской нормализации. - Сделать отдельные тесты голосов RU/EN в меню вместо одного пункта
Проверить голос.
Claude Voice speaks the final paragraph of each Claude Code answer with a local voice. It runs fully offline: no cloud TTS, no network calls, and no data collection.
- Speaks only the final answer to avoid intermediate noise.
- Supports Russian and English with automatic paragraph language detection.
- Stops playback when you press a key in the terminal running Claude Code.
- Normalizes Russian numbers and applies stress marks using a 3.2M-word-form dictionary.
- Uses sherpa-onnx and Piper voices; synthesis is usually faster than real time.
- Lets you choose RU/EN voices, CPU thread count, launch at login, and interface language from the menu bar.
- Download
ClaudeVoice-x.y.z.dmgfrom Releases. - Open the DMG and run
Install.command. - If macOS blocks it, right-click
Install.commandand choose Open. - After launch, allow Input Monitoring and install the Claude Code hook from the menu.
- Open a new Claude Code session. Hooks are loaded when a new session starts.
Requirements: Apple Silicon, macOS 14+.
| Item | Purpose |
|---|---|
| Speech enabled | Master speech toggle |
| Voice (Russian) / Голос (русский) | Russian voice selection |
| Voice (English) / Голос (английский) | English voice selection |
| CPU threads | Synthesis thread limit |
| Interface language | Switch the menu between EN and RU |
| Test voice | Quick test for the selected interface language |
| Install Claude Code hook | Claude Code integration |
| Launch at login | Start the app on login |
flowchart LR
A[Claude Code finishes an answer] --> B[Stop hook]
B --> C[POST to 127.0.0.1]
C --> D[Last transcript paragraph]
D --> E{Language}
E -- RU --> F[Numbers and stress marks]
E -- EN --> G[Text as-is]
F --> H[sherpa-onnx + Piper]
G --> H
H --> I[Playback]
K[Key press in Claude Code terminal] -. stop .-> I
The hook is added to ~/.claude/settings.json with a backup. It is marked with src=claude-voice-tts, uses a local curl call with a timeout, and does not block Claude Code.
bash packaging/fetch_assets.sh
bash packaging/build_app.sh 0.1.0
bash packaging/make_dmg.sh 0.1.0Quick non-GUI check:
swift build -c release
DYLD_LIBRARY_PATH="$PWD/vendor/lib" CLAUDEVOICE_RESOURCES="$PWD/Resources" \
./.build/release/ClaudeVoice --selftest- The app is not signed with a Developer ID, so Gatekeeper requires a manual confirmation on first launch.
- macOS may ask for Input Monitoring permission again after updates.
- Apple Silicon only.
- The Russian voice
ru_RU-irinais marked with anUnknownlicense; use it with that limitation in mind.
- Add Developer ID signing and notarization to the release pipeline.
- Move localization from the compact
Ldictionary to.stringsif the menu grows. - Add unit tests for
TranscriptReader,LanguageDetector,HookInstaller, and Russian normalization. - Add separate RU/EN voice test menu items instead of a single
Test voicecommand.
| Component | License |
|---|---|
| App code | MIT |
| sherpa-onnx / ONNX Runtime | Apache-2.0 / MIT |
en_US-libritts_r voice |
CC BY 4.0 |
ru_RU-irina voice |
Unknown |
| espeak-ng | GPL-3.0 |
| RUAccent dictionaries | Apache-2.0 |