VoiceMode: falar com o Claude Code por voz quando escrever é inconveniente

Para quem

Já usas o Claude Code e queres continuar a conversa com fala natural quando as mãos estão ocupadas e escrever é inconveniente. O texto oficial diz que a voz não serve para substituir a escrita, mas para manter a conversa utilizável quando escrever é impossível. Para quem aceita entrada e saída de voz reais, não só um eco de texto.

Os excertos de plataforma cobrem Linux, macOS, Windows (nativo ou WSL) e NixOS, Python 3.10-3.14. As notas atuais não listam um modelo de microfone obrigatório, requisitos de altifalante nem se um serviço de voz na nuvem é forçado. Se não puderes instalar um plugin no Claude Code, ou não puderes permitir ferramentas relacionadas com voz, este guia não te ajuda.

Primeira tentativa em 3 minutos

Pré-requisitos: o Claude Code está disponível, o Python está em 3.10-3.14 e o ambiente atual pode falar e ouvir. O caminho oficial recomendado é adicionar primeiro o mercado e depois instalar o plugin. Não comeces por um comando MCP de desvio:

claude plugin marketplace add mbailey/voicemode
claude plugin install voicemode@voicemode

Depois de instalar, reinicia ou volta a abrir o Claude Code uma vez e confirma que o plugin aparece. Na primeira tentativa usa só mcp__voicemode__converse, o que o excerto nomeia. Não é uma consulta só de leitura: entra numa conversa por voz, pode usar dispositivos de áudio locais e entrega o que disseres ao agente. Antes de começares, confirma que podes falar, ouvir e que não te importas que o modelo processe esta conversa; depois faz a chamada.

Sinal de sucesso observável: a conversa continua em forma de voz, não o sucesso do próprio comando de instalação do plugin. As notas atuais não dão uma frase de teste fixa nem uma palavra-chave de registo. Se o cliente mostrar uma confirmação de permissão, vê que vai libertar mcp__voicemode__converse antes de concordares. Não chames mcp__voicemode__service na primeira tentativa — o excerto só o põe na lista de permissões e não diz o que faz.

O material também tem claude mcp add --scope user voicemode -- uvx --refresh --from voice-mode voicemode-mcp-launcher, outro caminho de instalação. A primeira tentativa deve seguir só o mercado de plugins acima; não configures duas entradas ao mesmo tempo.

Casos de uso

Caso 1: quando escrever por perto não serve, usa mcp__voicemode__converse para transformar uma tarefa Claude Code em curso em idas e voltas de voz. As notas atuais só prometem «conversa de voz natural» e não listam língua, interrupção, redução de ruído nem parâmetros para transformar a voz num rascunho editável. O sucesso mede-se por perceberes a resposta e poderes continuar a ronda seguinte, não por uma linha de registo de texto.

Caso 2: quando a capacidade de voz tem de ser permitida de forma explícita, a lista de permissões inclui mcp__voicemode__converse e mcp__voicemode__service. O excerto não explica o papel de service, se altera serviços locais nem como recuar em caso de falha. Este caso pára portanto em «libertar converse segundo a lista; service fica por explicar». Não inventes passos para reiniciar um serviço ou instalar um daemon de sistema.

Limites de uso

A página oficial é

https://github.com/mbailey/voicemode

Não leias isto como «sem rede, sem leituras locais, sem fronteira de privacidade»: uma conversa por voz recolhe por defeito o que dizes. O Python tem de estar em 3.10-3.14. A lista de plataformas pára em Linux, macOS, Windows (nativo ou WSL) e NixOS. O excerto não tem passos de desinstalação, de desligar o microfone ou de revogar uma conversa. A ferramenta service não tem uso além do nome de permissão. Existe um comando de arranque uvx de desvio, mas não deve competir com o mercado de plugins como segundo caminho principal. Quotas, faturação e chaves de nuvem obrigatórias não estão escritas.