Text of code.visualstudio.com › docs › configure › accessibility › voice as Styx crawled it on Nov 18, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Voice support

AI agents: See llms.txt for documentation discovery and navigation. Documentation articles are also available as Markdown by appending .md to the article URL. Join VS Code at Microsoft Ignite or catch the sessions online. A year of VS Code, wrapped. Explore the highlights. Voice support View as Markdown Ask in VS Code Ask in VS Code Insiders Visual Studio Code supports spoken agent conversations with Voice Mode and built-in dictation that converts your speech to text in chat, the Agents window, editors, and terminals.

Use Voice Mode Voice Mode is a feature that lets you have a hands-free, spoken conversation with an agent while it works on your code. Unlike dictation, which only converts speech to text, Voice Mode also reads the agent's responses aloud and listens for follow-up requests. To start a voice conversation, enable agents.voice.enabled Open in VS Code Open in VS Code Insiders , open the chat view or the Agents window, and select the Voice Mode button in the chat input.

You can also focus the chat input and press ⇧⌘Space (Windows, Linux Ctrl+Shift+Space ) . On first use, allow microphone access and follow the introduction to select a microphone and preview the available voices. Voice Mode sends your request to the chat or agent session where you start it and uses that session's selected model and attached files. To continue the conversation in another session, open the destination session and explicitly start Voice Mode there.

Spoken requests to switch sessions are submitted as ordinary chat requests and don't change the active session automatically. When agents.voice.handsFree Open in VS Code Open in VS Code Insiders is enabled, Voice Mode starts listening again after the agent finishes speaking. While the agent is speaking, start speaking or press ⇧⌘Space (Windows, Linux Ctrl+Shift+Space ) to interrupt the response and continue the conversation.

Note Voice Mode is rolling out gradually and might not be available to every eligible account immediately. Hosted Voice Mode requires an eligible individual GitHub Copilot plan and is not available with Copilot Business or Copilot Enterprise. The OpenAI bring your own key (BYOK) option can be used without hosted Voice Mode entitlement when client BYOK is permitted. Organizations can turn off Copilot preview features or restrict client BYOK by policy.

Use your own OpenAI key Voice Mode can use an OpenAI Live model with your own API key. This Experimental option uses your OpenAI account and incurs OpenAI usage charges. Your account and organization policies must permit client BYOK. Add an OpenAI model from the built-in provider and enter your OpenAI API key. Set agents.voice.useBYOKVoiceModel Open in VS Code Open in VS Code Insiders to an OpenAI Live model ID that your key can access, such as gpt-live-1 .

Model access depends on your OpenAI account and key. Start Voice Mode from the chat or agent session that you want to use. Leave agents.voice.useBYOKVoiceModel Open in VS Code Open in VS Code Insiders empty to use hosted Voice Mode. If you configure a BYOK model and the key, model, or policy check fails, Voice Mode reports the error and doesn't silently switch to the hosted service. The OpenAI Live model handles the spoken conversation.

The model selected in the chat or agent session remains the coding model that processes your requests. On the first successful OpenAI Live connection in each profile, a notice identifies OpenAI as the voice provider. The notice doesn't repeat when you reconnect or restart. To check the active provider later, hover over the Voice Mode button. Ask about your sessions (Experimental) With an OpenAI Live model configured, Voice Mode can answer read-only questions about your tracked agent sessions without submitting a coding request.

For example, ask 'Where were we?', 'What just happened?', or 'Which tracked session needs input?'. The agents.voice.sessionAwareness Open in VS Code Open in VS Code Insiders setting is on by default and applies only to OpenAI BYOK Voice Mode. When enabled, the voice model receives a limited briefing of tracked session titles, states, and response summaries, plus the active chat's recent conversation, pending prompts, selected coding model, and attachment names.

The briefing doesn't include attachment contents or other sessions' conversation histories. Changes to this setting take effect when Voice Mode reconnects. To stop sharing the briefing, turn off the setting, then disconnect and reconnect Voice Mode. Session awareness doesn't switch the session that receives your coding requests or approvals. To work in another session, start Voice Mode there. Respond to approvals and questions When Voice Mode uses English, say 'approve' or 'reject' to respond to the current tool confirmation.

With OpenAI BYOK Voice Mode, you can also approve or reject in the current voice language. Localized replies work in all 25 supported speech-recognition languages, including languages selected through Automatic . English approval and rejection phrases remain available in every language. Use complete, unambiguous replies. Qualified replies such as 'approve, but only this time' don't authorize an action. If a reply isn't recognized, use the controls in the chat input.

With hosted Voice Mode, use the chat controls for non-English approvals. For a question form, say an exact displayed option label or its number, such as 1 . You can also give a spoken free-text answer when the question permits it. Localized option labels work when the agent supplies them in that language. Changing the voice language doesn't translate the question or its choices. Use the form controls for unsupported spoken responses.

Configure Voice Mode While Voice Mode is connected, use the controls in the chat input to mute or unmute your microphone without ending the voice session. You can also focus the chat input and press ⇧⌘M (Windows, Linux Ctrl+Shift+M ) , or run Voice Mode: Toggle Mute Microphone from the Command Palette. The blue animation stays visible while Voice Mode is connected, including while speaking, processing, idle, or muted.

It indicates a connection, not whether your microphone is unmuted. You can also configure Voice Mode in the following ways: Enable agents.voice.showTranscript Open in VS Code Open in VS Code Insiders to show the conversation transcript in the chat input. Use the Voice Mode controls to show or hide the transcript and mute or unmute your microphone without ending the voice session. Run Chat: Dictate: Select Microphone from the Command Palette to choose the input device used by both dictation and Voice Mode.

Use agents.voice.voice Open in VS Code Open in VS Code Insiders to select the voice that reads responses aloud. Use agents.voice.language Open in VS Code Open in VS Code Insiders to select English, German, Spanish, French, Italian, Portuguese, Japanese, Korean, or Chinese. Automatic uses the configured display language for speech recognition and dictation when supported, or the system or browser locale otherwise. Spoken responses fall back to English when the detected language doesn't support native voice output.

Language changes take effect immediately, including while connected. Use agents.voice.speakResponses Open in VS Code Open in VS Code Insiders to control whether the agent reads responses aloud. Turning off spoken responses keeps the microphone and voice input active. Enable agents.voice.showTranscript Open in VS Code Open in VS Code Insiders to read responses as text. Run Voice Mode: Show Introduction from the Command Palette to reopen the introduction, where you can select a microphone and preview the available voices.

Open the context menu for the Voice Mode button to access its settings, instructions, introduction, microphone selection, and transcript controls. For all available options, see the Voice Mode and dictation settings . Use built-in dictation On desktop, dictation uses an on-device speech recognition model by default, so y

The rest of this page is on the live site.