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.
• 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