Voz do Claude Code não funciona: soluções por sintoma, e a versão em que cada bug foi corrigido

Quase toda falha do /voice cai em um de cinco baldes: você entrou de um jeito que não inclui o recurso, seu terminal nunca recebeu permissão de microfone, você está em algum lugar sem microfone local, falta uma peça no backend de áudio do seu Linux ou WSL, ou você está rodando uma versão com um bug que um lançamento posterior já corrigiu.

Pela redação do VoiceBoardAtualizado em 28 de agosto de 2026

Comece pelo último, porque é o mais barato de descartar. O ditado por voz chegou no começo de março de 2026 e desde então foi mexido em 32 lançamentos, com 56 entradas separadas no changelog público. Se a sua instalação tem mais de duas semanas, atualize antes de depurar qualquer coisa:

claude update
claude doctor

Tudo abaixo foi conferido na fonte em 27 de agosto de 2026: a documentação de ditado por voz da Anthropic, o changelog público mapeado lançamento a lançamento, as datas de publicação do registro npm e relatos datados no rastreador de issues da Anthropic. A versão mais recente naquele momento era a 2.1.247, publicada em 26 de agosto de 2026.

Uma coisa para esclarecer logo, porque manda gente pelo caminho errado. A Anthropic tem dois recursos diferentes com "voz" no nome. O modo de voz é a conversa falada de mão dupla nos apps do Claude, e a página de ajuda dele diz que não é compatível com o Claude Code. Já o /voice no Claude Code é só ditado: você fala, o texto cai no prompt, o Claude responde em texto. A maioria dos vídeos de "consertar a voz do Claude" nos resultados de busca fala do primeiro e não vai ajudar em nada.

Ache o seu sintoma

1. /voice não aparece ou se recusa a ligar

O /voice não está disponível para toda conta, e o Claude Code esconde os comandos que a sua configuração não pode usar em vez de mostrá-los apagados (changelog 2.1.84, 25 de março de 2026). Então "o comando não existe" e "o comando não é para você" têm exatamente a mesma cara.

O ditado por voz exige uma conta Claude.ai. Ele não existe quando o Claude Code está apontado direto para uma chave de API da Anthropic, para o Amazon Bedrock, para a Agent Platform do Google Cloud ou para o Microsoft Foundry. Isso não é bug e não há chave para virar. Se você recebe Voice mode requires a Claude.ai account, rode /login e entre com a conta Claude.ai, não com a credencial de API.

Se você vê Voice mode is disabled by your organization's policy, algum administrador desligou o recurso para a organização inteira. Antes de junho de 2026 esse caso mostrava uma mensagem genérica de "não disponível", e é por isso que respostas antigas de fórum mandam reinstalar; o texto específico chegou na 2.1.191, em 24 de junho de 2026.

Versão mínima. A primeira entrada de changelog que menciona voz é a 2.1.69, publicada em 4 de março de 2026. Nada mais antigo tem o recurso.

Se você está lendo uma thread velha dizendo que /voice devolve Unknown skill: voice: isso era a liberação gradual, não a sua máquina. Ao longo de março de 2026 o comando ficou atrás de uma trava de recurso, então gente na versão certa e no plano certo continuava recebendo o erro, e o aviso de abertura mandava alegremente rodar um comando que não respondia (#33580, 12 de março de 2026; #33914, 13 de março de 2026). Não é coisa que se resolva editando configuração, e não é coisa que você ainda deva estar encontrando hoje.

2. Permissão de microfone, inclusive quando o terminal não está na lista

O /voice faz uma checagem de microfone na primeira vez que você o ativa. No macOS, é nesse momento que o seu terminal deveria pedir permissão.

macOS: Ajustes do Sistema, depois Privacidade e Segurança, depois Microfone, aí ligue o seu app de terminal e rode /voice de novo.

Windows: Configurações, depois Privacidade e segurança, depois Microfone, aí ligue o acesso ao microfone para aplicativos da área de trabalho e rode /voice de novo.

Quando o seu terminal não aparece na lista do macOS, não há interruptor para ligar, e este é o conserto que a Anthropic documenta: zerar o estado da permissão para que a próxima execução dispare um pedido novo.

tccutil reset Microphone com.apple.Terminal      # Terminal do sistema
tccutil reset Microphone com.googlecode.iterm2   # iTerm2
osascript -e 'id of app "Ghostty"'               # qualquer outro terminal: descobrir o bundle id

Depois encerre o terminal com Cmd+Q, e não apenas feche a janela, porque o macOS não volta a pedir permissão a um processo que já está rodando. Reabra e rode /voice.

Um aviso que vale repetir da documentação: rodar tccutil reset Microphone sem um bundle id tira o acesso ao microfone de todos os apps da máquina, Zoom e Slack incluídos. Não faça isso durante uma reunião.

A armadilha sobre a qual ninguém escreve. Se você roda o Claude Code dentro de um app invólucro de terminal ou de um multiplexador, em vez de um terminal comum, esse invólucro pode nunca ter declarado o direito de usar o microfone, e nesse caso ele não aparece na lista de privacidade e não dá para adicionar. Dois exemplos estão registrados: um relato contra o terminal Solo (soloterm/solo#114, 30 de março de 2026) observa que o macOS não oferece botão de adicionar para apps sem assinatura ou sem o direito declarado, e um contra o Superset (superset-sh/superset#5026, 1º de junho de 2026) relata que nenhum dos modos funciona. O contorno é o mesmo nos dois: rode o Claude Code no Terminal.app, no iTerm2 ou em outro terminal assinado e veja se a voz volta. Se voltar, o problema nunca foi o Claude Code.

3. Segurar a barra de espaço não faz nada

O modo de segurar detecta a tecla pressionada observando eventos rápidos de repetição vindos do terminal. Esse mecanismo tem dois modos de falhar, e você distingue um do outro olhando a linha de digitação enquanto segura.

Os espaços vão se acumulando. A voz está desligada. Rode /voice hold.

Aparecem um ou dois espaços e depois nada. A voz está ligada, mas a repetição de tecla não chega ao Claude Code. Alguns terminais não enviam eventos de repetição, e a repetição pode estar desligada no nível do sistema. Não brigue com isso, troque de modo:

/voice tap

O modo de toque alterna: toque uma vez para começar, fale, toque de novo para parar. Não tem aquecimento e não depende de repetição de tecla. Repare que o primeiro toque só inicia a gravação com o prompt vazio, então, se você já digitou alguma coisa, tocar a barra apenas digita um espaço.

Perder as primeiras palavras é o mesmo mecanismo visto do outro lado. O modo de segurar tem um aquecimento curto, o rodapé mostra keep holding… antes de listening…, e a reclamação é pública desde a semana de lançamento: um desenvolvedor no Hacker News mediu uns 500 ms e disse que as palavras iniciais eram cortadas (13 de março de 2026). Duas saídas. Use o modo de toque, ou reatribua a função a uma combinação com tecla modificadora, que começa a gravar já no primeiro toque, sem aquecimento nenhum:

{
  "bindings": [
    { "context": "Chat", "bindings": { "meta+k": "voice:pushToTalk" } }
  ]
}

Isso vai em ~/.claude/keybindings.json. Evite atribuir uma letra solta no modo de segurar, porque a letra é digitada no seu prompt durante o aquecimento. O Caps Lock não pode ser atribuído de jeito nenhum: os terminais não o entregam, e desde a 2.1.122 você pelo menos recebe um erro dizendo isso, em vez de silêncio.

Na extensão do VS Code, a barra de espaço pode simplesmente não ser o gatilho. A caixa de conversa é uma webview, e há um relato aberto de que a barra não faz nada ali enquanto clicar no ícone do microfone funciona normalmente (#85309, 9 de agosto de 2026). No mesmo relato: digitar /voice como mensagem dentro da extensão responde /voice isn't available in this environment. Clique no ícone.

4. Ele grava e não volta nada

Três mensagens diferentes, três causas diferentes. Leia o texto exato antes de mudar qualquer coisa.

No audio detected from microphone. A gravação começou e capturou silêncio. Verifique se o dispositivo certo é o padrão do sistema e se o nível dele não está perto de zero: Configurações, Sistema, Som, Entrada no Windows; Ajustes do Sistema, Som, Entrada no macOS. Uma causa comum no macOS é a entrada padrão ter mudado depois que você iniciou a sessão, o que está na seção 7.

Voice connection failed. A gravação nunca chegou ao serviço de transcrição. Verifique a rede. Repare que essa mensagem já foi enganosa: antes da 2.1.200, publicada em 3 de julho de 2026, um microfone mudo era reportado como falha de conexão, mandando gente depurar uma rede que estava perfeita.

Voice stream error: WebSocket upgrade rejected with HTTP <status>. Um servidor recusou a conexão, então não é queda de serviço. Um status na faixa dos 400 costuma significar login vencido, ou um proxy ou serviço de proteção contra bots respondendo no lugar do serviço de transcrição. Rode /login e olhe qualquer VPN ou proxy corporativo no caminho.

No speech detected. O áudio chegou, nenhuma palavra foi reconhecida. Fale mais perto, corte o ruído de fundo e verifique se o idioma do ditado bate com o que você está falando.

Esse último tem uma história teimosa. Um relato aberto em 25 de março de 2026, com reprodução completa, microfone funcionando, permissões concedidas, dispositivo padrão correto, tanto no Terminal.app quanto num terminal da JetBrains, continua aberto e recebeu várias confirmações no macOS em poucos dias. Se você passou por tudo desta página e ainda recebe No speech detected com o medidor de nível se mexendo, você provavelmente está nesse relato, e não num erro de configuração. Acrescente ali a sua versão e a sua plataforma, em vez de reinstalar pela quarta vez.

Falhas repetidas pausam o ditado. Três falhas de captura em 10 segundos e o Claude Code para de tentar até completar 10 segundos desde a primeira: Voice input is failing repeatedly and has been paused. Isso é sintoma, não doença. Resolva a causa por baixo e acione a voz de novo.

5. Linux, WSL, contêineres e máquinas sem tela

A gravação usa um módulo nativo. Quando ele não carrega, o Claude Code recorre ao arecord do ALSA utils ou ao rec do SoX, e se nenhum dos dois existe, o /voice imprime o comando de instalação do seu gerenciador de pacotes.

Voice mode requires SoX for audio recording. Instale, por exemplo com sudo apt-get install sox.

Voice mode requires a microphone, but SoX could not open an audio capture device. O SoX está instalado e o host não tem dispositivo de captura: um servidor sem tela, ou um contêiner sem áudio repassado. Instalar mais nada resolve. Antes da 2.1.195 (26 de junho de 2026) esse caso pedia erradamente para instalar um SoX que já estava lá, e é por isso que tanta thread de Linux termina em confusão.

WSL: Voice mode could not find a working audio recorder in WSL. O WSLg encaminha áudio pelo PulseAudio, e o sox puro puxa o backend do ALSA, que não tem nenhum /dev/snd de onde gravar.

sudo apt install sox libsox-fmt-pulse

Você também precisa do WSLg em si, que vem com o WSL2 instalado pela Microsoft Store. No WSL1 não há caminho que faça isso funcionar; rode o Claude Code no Windows nativo.

Transcrições que voltam vazias depois de alguns ditados no Linux podem ser processos de gravação se acumulando. Um relato aberto descreve capturas que falharam e foram repetidas deixando processos rec vivos, que mantêm conexões de cliente do PulseAudio abertas até a pilha de áudio degradar e a transcrição não devolver nada (#83905, 4 de agosto de 2026, num devcontainer Debian sobre WSLg). Vale olhar:

ps -eo pid,ppid,etime,cmd | grep '[r]ec -q'

Se houver uma pilha deles parada ali minutos depois de você ter parado de falar, mate os processos e reinicie a sessão.

6. A transcrição sai no idioma errado

O ditado usa o mesmo ajuste language que controla o idioma das respostas do Claude, e se esse ajuste está vazio, o padrão é inglês. Fale português num decodificador de inglês e você não recebe erro nenhum, recebe uma bobagem plausível.

{ "language": "pt" }

Defina isso no /config ou no seu arquivo de configuração, pelo código BCP 47 ou pelo nome do idioma. Vinte idiomas têm suporte: alemão, coreano, dinamarquês, espanhol, francês, grego, híndi, holandês, indonésio, inglês, italiano, japonês, norueguês, polonês, português, russo, sueco, tcheco, turco e ucraniano. Qualquer outro cai para o inglês com um aviso quando você ativa a voz. Uma pegadinha específica para nós: a lista traz um único código de português, o "pt". Não existe "pt-BR" ali, e escrever "pt-BR" conta como idioma fora da lista, ou seja, ditado em inglês com um aviso que é fácil não ver.

Na extensão do VS Code, um language vazio recorre ao accessibility.voice.speechLanguage do próprio VS Code antes de cair no inglês.

Duas coisas que isso não resolve. O envio automático no modo de toque conta palavras, e para japonês, chinês e tailandês isso só passou a funcionar na 2.1.195. E misturar idiomas numa frase só tem um relato aberto por trás: termos técnicos em inglês dentro de outro idioma são traduzidos ou descartados, porque o decodificador é fixado em um idioma por vez (#83881, 4 de agosto de 2026). Quem dita sobre programação em português esbarra nisso todo dia, já que metade dos termos da profissão é em inglês.

7. Ontem funcionava

Três causas, na ordem que vale checar.

Você atualizou. Compare o seu sintoma com a tabela abaixo. Cada data é a data de publicação daquela versão no npm.

Seu Mac suspendeu. Há um relato aberto de que a voz morre em definitivo depois de um ciclo de suspender e acordar, que desligar e religar o /voice não ajuda, e que a única cura é reiniciar o Claude Code por inteiro; quem relatou rastreou o problema até o descritor de áudio nativo ficar em cache pelo tempo de vida do processo e nunca ser reaberto depois que o macOS desmonta a camada de áudio (#89635, 25 de agosto de 2026, na 2.1.245). Até isso ser corrigido, trate "fechei a tampa" como "reiniciar a CLI".

Seus dispositivos de áudio mudaram. Mesmo formato de problema, gatilho diferente. Outro relato aberto diz que o dispositivo de entrada é resolvido uma vez e nunca mais reobtido, então trocar o padrão do sistema no meio da sessão continua gravando do dispositivo antigo, e conectar ou desconectar AirPods pode travar a captura por completo até você reiniciar (#88890, 22 de agosto de 2026, na 2.1.239). Se você vive de fone Bluetooth, é nesse que você está esbarrando.

8. Onde nunca vai funcionar, mude o que mudar

Poupe a sua noite. O ditado por voz transmite áudio para os servidores da Anthropic, e o microfone precisa estar na máquina que roda o processo, então ele não existe em:

• Sessões SSH e Claude Code na web. O microfone está no seu laptop, o processo não.
• VS Code Remote, o que inclui Remote SSH, Dev Containers e Codespaces, pelo mesmo motivo.
• Qualquer configuração autenticada com chave de API, Bedrock, Agent Platform do Google Cloud ou Microsoft Foundry. Se a sua empresa colocou o Claude Code atrás de um desses por conformidade, o /voice não é uma discussão que você vá vencer.
• WSL1.
• Sessões em segundo plano e de despacho de agentes, pelo menos no macOS. Um relato com logs do CoreAudio mostra o ditado falhando 100% das vezes a partir da linha de despacho claude agents, com No audio detected from microphone, porque o processo que abre o microfone é reparentado para o launchd e o macOS não consegue resolver um processo responsável a quem conceder a permissão (#86217, 12 de agosto de 2026).

Para todos esses casos a resposta é a mesma: dite para o terminal a partir do sistema operacional, com uma ferramenta que digita na janela que estiver em foco. É a seção "quando o conserto não resolve", logo abaixo.

9. Seu app de ditado parou de digitar no Claude Code

Essa é outra falha com a mesma sensação, e pega gente que nunca usou o /voice. O Claude Code lê o teclado em modo bruto, e as ferramentas de ditado inserem texto simulando teclas ou uma colagem. Essas duas coisas já se chocaram mais de uma vez.

O caso grande foi uma regressão na 2.1.83 (25 de março de 2026): a colagem simulada parou de cair no prompt enquanto a colagem manual continuava funcionando, confirmada tanto no Windows quanto no macOS por mais de uma dúzia de pessoas numa mesma thread, com várias ferramentas de ditado afetadas (#38620). Quem relatou viu aquilo voltar a funcionar por volta das versões 2.1.116 a 2.1.119, no fim de abril, alguns só depois de reinstalar e reiniciar a máquina. No Linux houve um caso paralelo em que os espaços vindos de teclados virtuais eram engolidos, e o texto ditado chegava como HelloWorldTest (#43429, 4 de abril de 2026).

O que tentar hoje, em ordem:

1. Atualize o Claude Code e depois reinicie a máquina. Duas pessoas naquela thread só recuperaram o ditado depois de reinstalar tudo e reiniciar, não pela atualização sozinha.
2. Use um método de inserção baseado em colagem, e não em digitação simulada. Se a sua ferramenta oferece a escolha, aceite. O VoiceInk, por exemplo, documenta trocar o Paste Method de Default para AppleScript e aumentar o Restore Delay quando o texto não cai no app.
3. Tente outro atalho de colar. Os terminais discordam sobre isso, e as páginas de ajuda do Wispr Flow dizem que ele recorre a Shift+Insert nos terminais de IDE do Windows quando o Ctrl+V não é confiável.
4. Envie ditados longos de uma vez e leia antes de apertar Enter. O Wispr Flow divide ditados longos em pedaços justamente para que um prompt inteiro chegue limpo no Claude Code e no Codex, e documenta que esse fatiamento é só no Mac, e que você deve deixar um ditado terminar de colar antes de começar o próximo. Há também um relato aberto descrevendo um ditado de uns 4.000 caracteres chegando à interface do terminal com os pedaços remontados fora de ordem, cortados no meio de palavras, e enviados sem nenhum aviso (#82339, 29 de julho de 2026). Monólogos longos dentro de um terminal merecem revisão de qualquer jeito.
5. Espere que a colagem se recolha. Qualquer coisa além de algumas linhas aparece como [Pasted text #1 +N lines] em vez das suas palavras, o que parece falha e não é. Aperte Ctrl+G para abrir o prompt no seu editor, se quiser ler antes de enviar.

Quando o conserto não resolve

Em algum ponto a resposta honesta deixa de ser um ajuste. O /voice é um bom recurso gratuito e está soldado a uma janela: funciona no prompt do Claude Code e em lugar nenhum mais, exige login Claude.ai, some exatamente nas implantações que as empresas grandes usam, e depende de o seu terminal repassar eventos de repetição de tecla. Enquanto isso, um terminal em modo bruto é um alvo hostil para qualquer coisa que tente digitar texto nele de fora. As duas metades disso estão nesta página.

A saída para as duas é uma camada de ditado que vive no sistema operacional: você segura um atalho, fala, e o texto pronto cai no que estiver em foco, seja o Claude Code, uma mensagem de commit, uma aba do navegador ou o Slack. Ela não se importa com o app em que você está, então não há nada para configurar por ferramenta nem nada para lembrar.

O Wispr Flow é o que indicamos primeiro para quem programa, e o motivo é estreito: é a única ferramenta que encontramos cuja própria documentação descreve o tratamento deste caso exato, dividindo ditados longos em pedaços para que um prompt de vários milhares de palavras chegue inteiro ao Claude Code em vez de truncado. No dia a dia ele faz bem a parte sem glamour: muletas removidas, pontuação no lugar, a frase que você recomeçou saindo como a frase que você quis dizer, tanto no terminal quanto no painel de conversa. O plano gratuito dá 2.000 palavras por semana no desktop, e o Pro custa $15 por mês ou $12 por mês na cobrança anual. As letras miúdas, porque elas desqualificam parte dos leitores de saída: é um serviço em nuvem, o suporte a Windows é só x64, então laptops ARM ficam de fora, máquinas virtuais e área de trabalho remota não têm suporte, e não existe versão para Linux. Preços verificados em 27 de agosto de 2026.

Se o áudio não pode sair da sua máquina, ou se você simplesmente quer pagar uma vez. O VoiceInk roda modelos locais em Macs com Apple Silicon, é open source e custa $29, $49 ou $69 uma única vez, conforme o número de Macs, com atualizações vitalícias. É o caminho pago mais curto no Mac para um ditado que nunca manda áudio a lugar nenhum, e $29 uma vez contra $144 por ano de assinatura se paga em umas dez semanas. Aprofundamos no nosso levantamento de Mac.

No Linux, onde o Wispr Flow não vai, o Voicy entrega pacotes .deb, .rpm e AppImage, e escreve dentro de terminais e editores. O reconhecimento passa pela infraestrutura da Groq, então o áudio sai mesmo da sua máquina; a política do fornecedor é apagar depois do processamento e não treinar, o que é uma política, e não a mesma coisa que processamento local. São 30 minutos gratuitos, depois $8,49 por mês ou $260 pela licença vitalícia.

E as opções gratuitas merecem resposta direta, não nota de rodapé. O Handy é gratuito, licenciado sob MIT, roda em Windows, macOS e Linux, e transcreve inteiramente na sua máquina; para quem programa e não se incomoda em escolher o tamanho do modelo, é a escolha de custo zero mais forte desta página, e um desenvolvedor no Hacker News contou tê-lo usado com prazer por um bom tempo antes de o Claude Code ter voz. O Superwhisper ganhou um plano gratuito permanente em 26 de agosto de 2026 que cobre ditado em qualquer app com uso ilimitado dos modelos Whisper. E se o seu dia é dentro do VS Code e não de um terminal, o ditado embutido de lá reconhece a fala no seu aparelho, não custa nada e vem do mesmo fornecedor do editor.

Se você chegou aqui para consertar um recurso quebrado e agora está se perguntando o que instalar no lugar, nosso guia mais amplo compara as opções embutidas em Claude Code, Cursor, VS Code e no terminal, incluindo o que fica na sua máquina.

Escrito a partir da documentação de ditado por voz da Anthropic, do changelog do Claude Code mapeado lançamento a lançamento (56 entradas sobre voz em 32 versões), das datas de publicação no npm de cada versão citada aqui e de relatos datados no rastreador público de issues da Anthropic. Não reproduzimos esses bugs nas nossas máquinas e não afirmamos ter reproduzido; cada um está atribuído ao relato ou à entrada de changelog de onde veio. Relatos num rastreador público descrevem o que os usuários observaram, o que não é a mesma coisa que um defeito confirmado. Esta página envelhece rápido, então revisamos a cada trimestre.