Claude Code text to speech on Windows
Make Claude Code read aloud on Windows with a PowerShell hook and the built-in Windows voice, a screen reader, or Verbative Speak. Native Windows and WSL.
Claude Code has no text to speech, on Windows or anywhere else: its /voice command turns your speech into text, and its replies stay on screen. Windows has a voice built in, though, and Claude Code's hooks can use it. Here are three ways to hear Claude Code on Windows, from a hook you paste into your settings to a plugin that tells you when Claude needs you.
How Claude Code runs hooks on Windows
Hooks are commands Claude Code runs at fixed moments, such as when a reply finishes. On Windows it runs them in Git Bash when Git for Windows is installed, and in PowerShell when it isn't. A hook can also name its shell: with "shell": "powershell", it runs in PowerShell 7 if you have it, and in the Windows PowerShell that ships with Windows otherwise. (Anthropic: hooks)
That last option is the one to use for speech: PowerShell can read Claude's reply and talk to the Windows voice directly, with nothing extra to install.
Option 1: a Stop hook with the Windows voice
The Stop hook runs when Claude finishes a reply, and receives that reply as last_assistant_message; Anthropic's hooks documentation names read-aloud hooks as a use for it. Add this to %USERPROFILE%\.claude\settings.json to hear every reply in the Windows voice:
{
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"shell": "powershell",
"command": "$raw = (New-Object System.IO.StreamReader([Console]::OpenStandardInput(), [System.Text.Encoding]::UTF8)).ReadToEnd(); $t = ($raw | ConvertFrom-Json).last_assistant_message; [void](New-Object -ComObject SAPI.SpVoice).Speak($t)",
"async": true
}
]
}
]
}
}
The command reads what Claude Code sends the hook as UTF-8. That matters: PowerShell otherwise reads it in the console's old code page, and every accented letter, curly quote and dash in Claude's reply comes out garbled. ConvertFrom-Json then picks out the reply, so you don't need jq, which Windows doesn't include. SAPI.SpVoice is the speech engine that ships with Windows, and "async": true lets Claude carry on while it speaks.
To also hear when Claude waits for an approval, add a Notification hook with the same command, reading .message instead of .last_assistant_message. Claude Code sends that notification a few seconds after a permission prompt appears, with a message such as "Claude needs your permission to use Bash".
It's free and takes a minute. The catches: it reads every reply in full, code blocks and file paths included, in the Windows system voice, and two sessions talk over each other.
Option 2: a screen reader
Run Claude Code as claude --ax-screen-reader and it replaces its animated interface with plain lines that a screen reader such as NVDA can follow (Anthropic: accessibility). Windows' own screen reader, Narrator, starts and stops with Win+Ctrl+Enter.
A screen reader reads everything as it appears, code included. That's what you need if you can't see the screen; it's a lot of listening if you just want to know when Claude is done.
Option 3: Verbative Speak on Windows
Verbative Speak is a plugin for Claude Code that speaks only what helps when you're away from the screen:
- A short summary when a task finishes, written to be heard: no code, no file paths.
- What Claude needs when it waits: an approval to run a command or edit a file, an answer to its question, or a plan to review.
- Several sessions at once: each says which project it's speaking for, and the voices queue instead of talking over each other.
The voices are natural, eleven of them, and they run on your computer: no API key, and nothing is sent to a speech service. Claude Code runs plugin hooks with Git Bash on Windows, so install Git for Windows first. Then, in Claude Code:
/plugin marketplace add verbative/verbative-claude-plugins
/plugin install verbative-speak@verbative
The first session downloads the voice once, about half a gigabyte. It's free for 10 spoken summaries a day, and unlimited with Code Advanced.
Claude Code in WSL
In WSL, Claude Code runs its hooks in Linux. Two ways to get sound out:
- The Windows voice from Linux: WSL can run
powershell.exedirectly. Withjqinstalled in your Linux distribution,jq -r '.last_assistant_message' | powershell.exe -NoProfile -Command "[void](New-Object -ComObject SAPI.SpVoice).Speak((New-Object System.IO.StreamReader([Console]::OpenStandardInput(), [System.Text.Encoding]::UTF8)).ReadToEnd())"as a Stop hook speaks each reply through Windows. - A Linux voice: WSL 2 with WSLg passes Linux audio through to your Windows speakers (Microsoft: WSLg), so a Linux speech engine works too.
Verbative Speak runs in Claude Code on Windows itself, not inside WSL.
In VS Code or Cursor on Windows
If you run Claude Code in VS Code or Cursor, the Verbative extension speaks the same summaries and approvals, and lets you answer out loud: say "approve" or "deny", or dictate your next prompt on your own machine. Our guide to Claude Code voice and dictation on Windows covers that setup, the microphone permission and WSL.
Which one to use
| You want… | Use |
|---|---|
| Every reply read aloud, free, with nothing to install | A Stop hook with the Windows voice |
| Everything on screen read, because you can't see it | Screen reader mode with NVDA |
| A spoken summary and approval reminders, in natural voices | Verbative Speak |
| To talk back too, in VS Code or Cursor | The Verbative extension |
Frequently asked
Does Claude Code have text to speech on Windows?
No. Claude Code's /voice is dictation, from your speech to text, on every platform. To hear Claude Code on Windows, add a Stop hook that sends each reply to the Windows voice, or install Verbative Speak.
How do I make Claude Code read its replies aloud on Windows?
Add a Stop hook with "shell": "powershell" that reads last_assistant_message and passes it to the Windows speech engine, SAPI.SpVoice. Or install the Verbative Speak plugin, which speaks a short summary when a task finishes and tells you when Claude needs an approval.
Which shell runs Claude Code hooks on Windows?
Git Bash, when Git for Windows is installed, and PowerShell otherwise. A hook can choose with its "shell" field: "bash" or "powershell".
Do I need jq on Windows?
No. In a PowerShell hook, ConvertFrom-Json reads what Claude Code sends the hook. jq isn't part of Windows; you'd only need it for a hook written for Bash.
Does it work in WSL?
Yes, with a hook. From WSL you can pipe Claude's reply to powershell.exe and the Windows voice, or use a Linux speech engine through WSLg on WSL 2. Verbative Speak runs on native Windows, not inside WSL.
Can Claude Code tell me when it needs an approval on Windows?
Yes. A Notification hook can speak Claude Code's permission message a few seconds after the prompt appears. Verbative Speak says it for you, with what Claude wants to run or edit.