Ditado por voz

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

Requisitos

​

Ativar ditado por voz

/voice
Voice mode enabled (hold). Hold Space to record. Dictation language: en (/config to change).

{
  "voice": {
    "enabled": true,
    "mode": "tap"
  }
}

​

Hold to record

> refactor the auth middleware to ▮
  # hold Space, speak "use the new token validation helper"
> refactor the auth middleware to use the new token validation helper▮

​

Tap to record and send

​

Alterar o idioma do ditado

{
  "language": "japanese"
}

​

Revinculação da tecla de ditado

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

​

Troubleshooting

• Voice mode requires a Claude.ai account: você está autenticado com uma chave API ou um provedor de terceiros. Execute /login para entrar com uma conta Claude.ai.
• Microphone access is denied: conceda permissão de microfone ao seu terminal nas configurações do sistema. No macOS, vá para Configurações do Sistema → Privacidade e Segurança → Microfone e ative seu aplicativo de terminal, depois execute /voice novamente. No Windows, vá para Configurações → Privacidade e segurança → Microfone e ative o acesso ao microfone para aplicativos de desktop, depois execute /voice novamente. Se seu terminal não estiver listado nas configurações de Microfone do macOS, consulte Terminal not listed in macOS Microphone settings.
• No audio recording tool found no Linux: o módulo de áudio nativo não conseguiu carregar e nenhum fallback está instalado. Instale SoX com o comando mostrado na mensagem de erro, por exemplo sudo apt-get install sox.
• Voice mode could not find a working audio recorder in WSL: WSLg roteia áudio através do PulseAudio em vez de um dispositivo ALSA, portanto SoX precisa que seu backend PulseAudio esteja instalado explicitamente. Execute sudo apt install sox libsox-fmt-pulse. Instalar apenas sox puxa o backend ALSA, que não consegue gravar no WSL porque não há nenhum dispositivo /dev/snd.
• Voice input is failing repeatedly and has been paused: o ditado por voz atingiu várias falhas de inicialização seguidas e parou de tentar novas sessões até que uma tenha sucesso. Isso geralmente significa que o microfone ou a pilha de áudio neste host não consegue capturar áudio, por exemplo um servidor sem cabeça, um shell remoto sem passagem de áudio, ou uma permissão de microfone negada. Confirme um dispositivo de entrada funcionando, corrija a causa subjacente das entradas acima, depois dispare a voz novamente.
• Nada acontece ao manter Space pressionado no modo de manutenção: observe a entrada do prompt enquanto você mantém. Se espaços continuarem se acumulando, o ditado por voz provavelmente está desativado; execute /voice hold para ativá-lo. Se apenas um ou dois espaços aparecerem e depois nada, o ditado por voz está ativado mas a detecção de manutenção não está sendo acionada. A detecção de manutenção requer que seu terminal envie eventos de repetição de tecla, portanto não pode detectar uma tecla mantida se a repetição de tecla estiver desativada no nível do SO. Mude para o modo de toque com /voice tap para evitar o requisito de repetição de tecla.
• Tocar Space digita um espaço em vez de gravar no modo de toque: o primeiro toque só começa a gravar quando a entrada do prompt está vazia. Limpe a entrada primeiro, ou verifique se você está no modo de toque executando /voice tap.
• No audio detected from microphone: a gravação começou mas capturou silêncio. Confirme que o dispositivo de entrada correto está definido como padrão do sistema e que seu nível de entrada não está mudo ou próximo a zero. No Windows, abra Configurações → Sistema → Som → Entrada e selecione seu microfone. No macOS, abra Configurações do Sistema → Som → Entrada.
• No speech detected: o áudio chegou ao serviço de transcrição mas nenhuma palavra foi reconhecida. Fale mais perto do microfone, reduza o ruído de fundo e confirme que seu idioma de ditado corresponde ao idioma que você está falando.
• A transcrição está distorcida ou no idioma errado: o ditado usa o padrão em inglês. Se você estiver ditando em outro idioma, defina-o em /config primeiro. Consulte Change the dictation language.

​

Terminal not listed in macOS Microphone settings

​

Veja também

• Customize keyboard shortcuts: revinculação voice:pushToTalk e outras ações de teclado CLI
• Configure settings: referência completa para voice, language e outras chaves de configurações
• Interactive mode: atalhos de teclado, modos de entrada e controles de sessão
• Commands: referência para /voice, /config e todos os outros comandos