claude-voice-system is a voice alert app for Claude Code on Windows. It turns status messages, task changes, and other events into spoken audio so you can hear what is happening without watching the screen.
It uses edge-tts for voice output, phrase pools for text choices, and a priority queue to handle important messages first. It also learns from past events to pick better phrases over time.
Use this link to visit the page and download the app:
Open claude-voice-system on GitHub
After you open the page, look for the download files or the latest release. If the project provides an app file, download it to your PC. If it comes as a folder or zip file, save it in a place you can find, such as Downloads or Desktop.
- Windows 10 or Windows 11
- Internet access for voice generation
- Claude Code installed and working
- About 200 MB of free disk space
- Audio output such as speakers or headphones
- A standard user account with permission to run apps
The app listens for Claude Code events and turns them into spoken updates.
It can:
- speak task updates
- announce important notifications
- choose from a pool of phrases
- rank messages by priority
- adjust phrase use based on past output
- use Microsoft edge-tts for natural speech
This helps you keep track of Claude Code without constant screen checks.
- Open the GitHub link above.
- Find the latest download on the page.
- Download the file to your PC.
- If the file is zipped, right-click it and choose Extract All.
- Open the extracted folder.
- Look for the main app file or startup script.
- Double-click it to run the program.
If Windows shows a security prompt, choose the option that lets you run the file.
When you start the app for the first time, it may set up voice files and local settings.
Do this:
- Launch the app.
- Wait for the first setup to finish.
- Open Claude Code.
- Trigger a status update or task event.
- Check that your speakers or headphones are on.
- Listen for the spoken message.
If you do not hear anything, lower the app volume if needed and check your Windows sound output.
The app uses edge-tts to speak messages with clear Windows voices. This gives you natural-sounding audio for alerts and status updates.
Instead of repeating the same line each time, the app can rotate through a pool of phrases. This makes updates feel less repetitive.
The system tracks which phrases it uses and can shift toward phrases that fit the current event pattern better over time.
Important messages can move ahead of low-priority ones. This helps urgent updates get spoken first.
The app is designed for Windows users who want simple audio feedback while using Claude Code.
Use the app while Claude Code is open.
Typical flow:
- Start claude-voice-system.
- Open Claude Code.
- Run your normal tasks.
- Let the app speak changes, warnings, or progress updates.
- Keep working without switching windows as often.
You may see settings for:
- voice choice
- speech speed
- volume
- event types
- phrase group selection
- queue priority rules
If you want a calm voice, pick a standard Microsoft voice. If you want faster updates, raise speech speed a little and keep the text short.
If the download includes several files, you may see items like these:
- a main launcher file
- a config file
- a phrases folder
- a logs folder
- a voice or cache folder
- a readme file
Keep the files together in one folder so the app can find its settings and phrase data.
Try these steps:
- Check that your speaker or headset works in another app.
- Make sure Windows sound is not muted.
- Confirm Claude Code is sending events the app can read.
- Restart the app.
- Restart your PC.
- Open the app again and test with a new Claude Code action.
If the app starts but stays quiet, the issue is often sound output, event input, or a blocked background process.
When a newer version is posted:
- Open the GitHub page again.
- Download the latest file.
- Replace the old app files with the new ones.
- Keep your config file if you want to save your settings.
- Start the new version.
If you made custom phrase edits, copy them to a safe folder first.
claude-voice-system fits well if you want:
- spoken updates while coding
- fewer screen checks
- better attention on long Claude Code tasks
- clear alert handling
- a simple voice layer for daily use
If you have never used a GitHub project before, focus on these steps:
- Open the link.
- Find the download file or latest release.
- Download it.
- Extract it if needed.
- Run the main file.
- Keep the app open while using Claude Code.
The app should work like a normal Windows program once it is set up
claude-code, edge-tts, hooks, neural-voice, notifications, python, self-learning, tts, voice, windows