Voz do Claude Code não funciona? Todos os erros e como corrigir.

1. O /voice exige que você entre com uma conta Claude.ai. Ele não está disponível com chave de API, Bedrock, Vertex ou Foundry.
2. Ele grava na máquina em que o Claude Code roda, então não funciona via SSH, no VS Code Remote nem em sessões na nuvem.
3. Depois de fechar a tampa, trocar de dispositivo ou atualizar, inicie uma nova sessão.

1. Unknown command: /voice ou Voice mode requires a Claude.ai account

   Você não entrou com uma conta Claude.ai, ou uma chave de API ou configuração de provedor tem prioridade. Rode /login, remova ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN ou apiKeyHelper e reinicie o Claude Code.

   Da documentação do Claude Code.

2. Voice mode is disabled by your organization’s policy

   Um administrador desativou a voz. Fale com ele ou use uma ferramenta de ditado fora do Claude Code.

   Da documentação do Claude Code.

3. Microphone access is denied

   Permita o seu terminal (ou o VS Code) em Ajustes do Sistema → Privacidade e Segurança → Microfone. Se ele não estiver na lista, redefina a permissão, feche-o com ⌘Q e abra de novo.

   # Terminal: com.apple.Terminal · iTerm2: com.googlecode.iterm2
   # Ghostty: com.mitchellh.ghostty · Warp: dev.warp.Warp-Stable · VS Code: com.microsoft.VSCode
   tccutil reset Microphone com.apple.Terminal
   
   # Not sure of the bundle ID? Ask macOS:
   osascript -e 'id of app "iTerm"'

   Da documentação do Claude Code.

4. No audio detected from microphone

   A gravação captou silêncio. Geralmente a sessão está presa a um dispositivo ou binário que mudou: inicie uma nova sessão. Todas as causas e soluções →

5. No speech detected

   O áudio chegou, mas nenhuma palavra foi reconhecida: chegue mais perto, reduza o ruído, defina seu idioma em /config. Mais →

6. Voice input is failing repeatedly and has been paused

   Três falhas em dez segundos: geralmente não há microfone (SSH, container) ou a permissão foi negada. Mais →

7. Voice connection failed ou Voice stream error: WebSocket upgrade rejected

   A gravação não chegou ao serviço de transcrição. Verifique sua rede; com um status 4xx, rode /login de novo e veja se há uma VPN ou proxy no caminho.

   Da documentação do Claude Code.

8. Voice mode requires SoX for audio recording ou could not find a working audio recorder in WSL

   Só no Linux e no WSL. Instale o SoX; no WSL, também o formato PulseAudio dele.

   sudo apt-get install sox                    # Linux
   sudo apt install sox libsox-fmt-pulse       # WSL with WSLg

   Da documentação do Claude Code.

9. Segurar Space só digita espaços

   Se os espaços se acumulam, a voz está desligada: rode /voice hold. Se aparecem só um ou dois, a repetição de teclas está desativada no seu sistema: use /voice tap. No modo de toque, o prompt precisa estar vazio para o primeiro toque começar a gravar.

   Da documentação do Claude Code.

Em outubro de 2026. Com base na documentação do Claude Code e nos issues do GitHub.

A voz do Claude Code funciona com chave de API, Bedrock ou Vertex?

Não. O ditado por voz exige login com uma conta Claude.ai. O Copy That funciona com qualquer login, porque só cola texto no Claude Code.

O ditado por voz do Claude Code é processado localmente?

Não. O áudio é enviado em streaming para a Anthropic para transcrição, e o nome do projeto e a branch do git são enviados como dicas. Isso não gasta tokens nem conta para os limites de uso. O Copy That transcreve no seu Mac com o Whisper.

Posso usar a voz do Claude Code no VS Code Remote ou via SSH?

Não, a voz grava na máquina em que o Claude Code roda. O Copy That cola no terminal que estiver na sua frente no Mac, inclusive um conectado via SSH.

Dá para evitar esses erros de vez?

Use um microfone que não seja o do Mac. O Copy That grava no seu iPhone ou Apple Watch, transcreve no seu Mac com o Whisper e cola no Claude Code, então dispositivos de entrada, tampa e permissões de microfone no Mac não importam.