Ditado por voz no Claude Code: /voice, Ditado do Mac ou um app local
A resposta curta
O Claude Code tem um modo de voz integrado, chamado de ditado por voz: digite /voice, segure a barra de espaço enquanto fala, e a transcrição é inserida no cursor. Ele exige login no Claude.ai e um microfone local, e a documentação da Anthropic diz que o áudio é transmitido aos servidores dela e não é processado localmente. O próprio Ditado do Mac também funciona em um terminal. O Flit, um app de ditado local para Mac, é a terceira forma: segure uma tecla e fale, e suas palavras exatas chegam ao prompt com os nomes de arquivo do seu projeto escritos certo, sem que nenhum áudio saia do Mac.
Como ditar no Claude Code com /voice
- Inicie o Claude Code no terminal, com login em uma conta do Claude.ai.
- Digite
/voicee pressione Enter para ativar o ditado. - Segure a barra de espaço e fale. A gravação continua enquanto a tecla está pressionada.
- Solte a barra de espaço. A transcrição é inserida no cursor.
- Leia, corrija o que for preciso e pressione Enter para enviar.
- Para tocar em vez de segurar, digite
/voice tap: toque na barra de espaço uma vez com o prompt vazio para começar, e toque de novo para enviar.
No modo de segurar há um breve aquecimento antes de a gravação começar, porque o Claude Code detecta uma tecla segurada pela repetição dela. Um único toque na barra de espaço continua digitando um espaço.
Um prompt para um agente de programação é o tipo de texto em que a fala se sai bem: um parágrafo de intenção, não uma linha de sintaxe. Há três formas de colocá-lo no Claude Code, e elas diferem principalmente no que exigem e em onde o áudio vira texto.
Três formas de ditar no Claude Code
| Forma | Como você começa | Onde o áudio é transcrito |
|---|---|---|
O /voice do Claude Code | Segure a barra de espaço, ou toque com /voice tap | Nos servidores da Anthropic |
| Ditado do Mac | O atalho do Ditado nos ajustes de Teclado | No Mac ou na Apple; os ajustes de Teclado dizem qual |
| Flit | Segure Fn ou seu próprio atalho | No Mac |
O que o /voice exige
A página da Anthropic sobre ditado por voz lista as condições.
- Uma conta do Claude.ai. A página diz que o serviço de conversão de fala em texto não está disponível quando o Claude Code é configurado diretamente com uma chave de API da Anthropic, ou pelo Amazon Bedrock, Google Cloud ou Microsoft Foundry.
- Um microfone local. Não funciona em sessões na nuvem nem por SSH.
- Uma conexão, já que o áudio é transmitido aos servidores da Anthropic para transcrição.
- Um de 20 idiomas, definido com
/config. Se nenhum for definido, o ditado usa inglês. - Uma organização que permita. Um administrador pode desativar a voz por política.
Modo de segurar e modo de tocar
O modo de segurar é o padrão: a gravação continua enquanto a barra de espaço está pressionada e para quando você solta. A transcrição espera no prompt até você enviar, a menos que você ative o envio automático.
O modo de tocar é para instruções mais longas. O primeiro toque inicia a gravação, e só com o prompt vazio; o segundo envia. A documentação diz que a gravação também para sozinha após 15 segundos de silêncio ou dois minutos no total.
A tecla pode ser trocada. É o atalho voice:pushToTalk em ~/.claude/keybindings.json.
Quebras de linha e texto longo
Enter envia a mensagem. Para uma quebra de linha sem enviar, a página de terminal da Anthropic dá duas formas que funcionam em qualquer terminal: pressione Control + J, ou digite uma barra invertida e depois Enter. Shift + Enter funciona sem configuração em alguns terminais, e em outros depois de rodar /terminal-setup uma vez.
Texto longo colado aparece de outro jeito. Quando são colados mais de 800 caracteres ou mais de três linhas, o Claude Code os recolhe em um marcador como [Pasted text #1 +120 lines], e ainda assim envia o conteúdo completo. Isso importa para qualquer ferramenta de ditado que insere texto colando, o Flit incluído: um ditado longo chega inteiro, mas você vê o marcador, não as palavras.
Usando o Ditado do Mac
O Ditado da Apple digita em qualquer lugar onde você pode digitar, inclusive em um terminal. Clique no prompt do Claude Code e pressione seu atalho do Ditado. Ele não pede nada da sua conta Claude, e para alguns idiomas e Macs roda no próprio dispositivo.
Ele tem duas desvantagens para prompts. Para após 30 segundos sem fala e não sabe como seus arquivos se chamam. Como ditar no Mac explica a configuração.
O que dizer
Fale como se estivesse passando a tarefa a um colega: o que está errado, o que você quer e como vai saber que funcionou. Diga em voz alta os nomes de arquivos e funções. Informe o comando de teste, se houver um.
Depois leia a transcrição antes de enviar. Um nome de arquivo mal ouvido custa uma busca ao agente; um “não” mal ouvido custa a você uma alteração errada.
Ditar no Claude Code com o Flit
O Flit funciona no nível do Mac, não do Claude Code, então não precisa de conta, de /voice nem de conexão. Segure uma tecla, fale, solte, e o texto está no prompt.
- Suas palavras exatas. Em um terminal o Flit não reescreve o que você disse, então um comando continua sendo um comando.
- Nomes de arquivo do seu projeto. O Flit lê os nomes no diretório de trabalho do terminal, no Mac, então “upload client dot swift” vira
UploadClient.swift. - Símbolos falados para flags e caminhos, como “dash dash” e “tilde slash”.
- Nenhum áudio sai do Mac, e funciona seja qual for a forma de login no Claude Code, inclusive com uma chave de API.
- A mesma tecla no app Claude para desktop e no painel de chat de um editor, onde o Flit dá ao que você diz a forma de um prompt.
- O Flit é grátis por 7 dias com todos os recursos ativos, depois $19 uma única vez, sem conta e sem assinatura.
Bom saber
- Em um terminal você recebe as palavras exatas: ali o Flit não transforma uma explicação cheia de voltas em um parágrafo limpo, como faz em uma caixa de chat.
- O Flit insere colando, então o Claude Code mostra um ditado longo como um marcador de texto colado.
- O Flit roda em Macs com Apple silicon e macOS 14 ou posterior, e o modelo de voz é um download de cerca de 0,5 a 2,8 GB que você escolhe uma vez.
- O Flit digita o que você diz. Ele não responde, não lê respostas em voz alta nem mantém uma conversa falada com a ferramenta.
- O reconhecimento dos nomes de arquivo do seu projeto e os comandos falados do Flit funcionam em inglês por enquanto.
Perguntas frequentes
O Claude Code tem modo de voz?
Sim. Digite /voice para ativar o ditado por voz e segure a barra de espaço enquanto fala. Exige uma conta do Claude.ai e um microfone local.
O ditado por voz do Claude Code é processado localmente?
Não. A documentação da Anthropic diz que o ditado por voz transmite o áudio gravado aos servidores da Anthropic para transcrição e que o áudio não é processado localmente.
Por que o /voice não funciona no Claude Code?
As causas documentadas são fazer login com uma chave de API ou um provedor de nuvem em vez de uma conta do Claude.ai, trabalhar por SSH ou em uma sessão na nuvem, não ter microfone, ou uma política da organização que desativa a voz.
O ditado por voz do Claude Code consome meu uso?
Não. A Anthropic diz que a transcrição não consome mensagens nem tokens do Claude e não conta para os limites mostrados em /usage.
Como adiciono uma quebra de linha no Claude Code sem enviar?
Pressione Control + J, ou digite uma barra invertida e pressione Enter. As duas funcionam em qualquer terminal. Shift + Enter funciona em alguns terminais sem configuração.
Existe um app de ditado para o Claude Code que funcione offline?
Sim. O Flit é um app de ditado local para Mac: segure uma tecla e fale, e suas palavras chegam ao prompt do Claude Code com os nomes de arquivo do seu projeto escritos certo. Nada é enviado para lugar nenhum. O Flit é grátis por 7 dias com todos os recursos ativos, depois $19 uma única vez, sem conta e sem assinatura.