Programação por Voz com Claude Code: Fale Seus Prompts

Resumo: O Claude Code funciona no terminal e espera prompts detalhados em linguagem natural. Digitar esses prompts é lento. O ditado por voz permite que você dê ao Claude Code contexto mais rico em uma fração do tempo, resultando em saída melhor e menos iterações.

O Problema dos Prompts do Claude Code

O Claude Code é uma das ferramentas de codificação com IA mais poderosas disponíveis. Ele pode ler toda sua codebase, editar múltiplos arquivos, rodar testes e executar tarefas complexas em múltiplos passos. Mas há um porém: sua qualidade é diretamente proporcional à qualidade dos seus prompts.

E o Claude Code roda no terminal, onde digitar prompts longos e detalhados é particularmente doloroso. Não há editor de texto rico, não há forma fácil de voltar e editar o meio de um parágrafo, não há autocomplete para linguagem natural. Só você, um cursor piscando e a tentação de ser breve.

Então desenvolvedores escrevem prompts como:

> corrige o bug de auth

Quando o que deveriam escrever é:

> O middleware de autenticação em src/middleware/auth.ts está retornando 401
> para usuários com refresh tokens válidos quando o access token expirou.
> O problema está na função verifyToken por volta da linha 45 - ela verifica
> a expiração do access token mas não faz fallback para verificar o refresh
> token. Corrija isso adicionando validação do refresh token antes de retornar
> 401, e adicione um caso de teste para esse cenário em auth.test.ts.

O segundo prompt evita que o Claude Code adivinhe. Ele produz a correção certa de primeira. Mas quem quer digitar tudo isso num terminal?

A Solução: Voz + Claude Code

Aqui está o fluxo de trabalho: você mantém o Claude Code rodando no seu terminal como de costume. Quando precisa dar instruções, em vez de digitar, pressiona seu atalho de voz, fala naturalmente por 15-30 segundos, e seu prompt detalhado aparece no terminal pronto para enviar.

Configuração: Murmur + Claude Code

1. Instale o Murmur se ainda não instalou
2. Abra seu terminal (PowerShell, Windows Terminal, CMD ou qualquer emulador de terminal)
3. Inicie o Claude Code como faria normalmente
4. Quando o Claude Code estiver esperando entrada, pressione Ctrl+Space (atalho padrão do Murmur)
5. Fale seu prompt naturalmente
6. O Murmur transcreve e insere o texto na posição do seu cursor
7. Pressione Enter para enviar o prompt ao Claude Code

É isso. O Murmur usa transcrição com IA que lida corretamente com termos técnicos, caminhos de arquivo e nomes de comandos.

Exemplos Reais: Ditados vs Digitados

Aqui estão prompts reais do meu fluxo de trabalho diário, comparando o que eu teria digitado versus o que realmente falei usando voz.

Exemplo 1: Correção de Bug

O que eu teria digitado:

corrige o problema de redirect no login

O que eu falei (transcrito pelo Murmur):

A página de login redireciona para /dashboard após autenticação bem-sucedida
mas deveria redirecionar para a URL que o usuário originalmente tentou acessar.
A URL de retorno está armazenada no query parameter chamado 'next' na URL
da página de login. Atualize o handler de login em pages/login.tsx para ler
esse parâmetro e redirecionar para lá após a autenticação, com fallback para
/dashboard se nenhum parâmetro next existir. Também garanta validação da URL
next para prevenir ataques de open redirect.

Tempo para digitar a primeira versão: 5 segundos. Tempo para falar a segunda versão: 18 segundos. Tempo economizado em iterações porque o Claude Code acertou de primeira: vários minutos.

Exemplo 2: Nova Funcionalidade

O que eu teria digitado:

adiciona rate limiting na API

O que eu falei:

Adicione rate limiting na API Express. Use o pacote express-rate-limit.
Aplique um limite global de 100 requisições por minuto por endereço IP. Para
os endpoints de autenticação em routes/auth.ts, aplique um limite mais
restritivo de 10 requisições por minuto para prevenir ataques de força bruta.
Armazene os contadores de rate limit no Redis usando nosso cliente Redis
existente em lib/redis.ts. Retorne status 429 com uma mensagem de erro JSON
que inclua um campo retryAfter em segundos. Adicione o rate limiter como
middleware em app.ts antes dos handlers de rota.

Exemplo 3: Refatoração

O que eu teria digitado:

refatora o user service para usar o repository pattern

O que eu falei:

Refatore o UserService em services/user.ts para usar o repository pattern.
Crie uma interface UserRepository em repositories/types.ts com métodos para
findById, findByEmail, create, update e delete. Implemente em
repositories/prisma/user.ts usando nosso cliente Prisma existente. Atualize
o UserService para aceitar o repository através de injeção no construtor em
vez de importar o Prisma diretamente. Isso tornará o service testável sem
banco de dados. Atualize a configuração de injeção de dependência em
di/container.ts para conectar tudo. Não mude nenhum código dos controllers,
apenas a camada de service.

Dicas para Falar Prompts Técnicos com Clareza

Nomeie Arquivos e Caminhos Explicitamente

O Claude Code tem acesso à estrutura do seu projeto, mas caminhos específicos removem ambiguidade.

Diga: "Atualize o middleware de autenticação em src/middleware/auth.ts" em vez de "atualize o middleware de auth."

Diga: "O schema Prisma em prisma/schema.prisma" em vez de "o schema do banco de dados."

Descreva a Arquitetura

Ao pedir mudanças em múltiplos arquivos, descreva a arquitetura em português simples:

"Quero adicionar uma camada de cache. Crie uma interface CacheService, implemente com Redis, injete no UserService e ProductService, e adicione invalidação de cache nas operações de escrita."

Você nunca digitaria tudo isso. Mas falar leva dez segundos.

Use Restrições "Não Faça"

Declare explicitamente o que o Claude Code deve evitar. Isso é fácil ao falar, mas tedioso ao digitar:

"Refatore o tratamento de erros mas não mude o formato de resposta de erro porque o frontend depende da estrutura atual. Também não remova nenhum dos códigos de erro existentes, apenas adicione os novos."

Referencie Padrões na Sua Codebase

O Claude Code pode ler seu código, então referencie padrões existentes:

"Crie um novo endpoint de API para orders seguindo exatamente o mesmo padrão do endpoint de products em routes/products.ts. Mesma cadeia de middleware, mesmo tratamento de erros, mesmo formato de resposta. Apenas troque products por orders e use o OrderService."

Pense em Voz Alta

Diferente da digitação, a voz permite que você raciocine sobre um problema em tempo real:

"Ok, o problema é que essa conexão WebSocket cai após 30 segundos de inatividade. Acho que precisamos de um mecanismo de heartbeat. Deixa eu pensar... sim, adicione um sistema de ping/pong onde o servidor envia um ping a cada 15 segundos e o cliente responde com um pong. Se o servidor não receber um pong em 5 segundos, feche a conexão e deixe a lógica de auto-reconexão do cliente cuidar. A lógica de reconexão já está em lib/websocket.ts então só precisamos do ping no lado do servidor."

O Claude Code é excelente em extrair a intenção acionável desse tipo de raciocínio natural.

Por que a Voz Dá Mais Contexto a Agentes de IA

Há uma razão psicológica pela qual a voz produz prompts melhores: falar tem menos fricção do que digitar.

Quando você digita, cada palavra tem um custo. Você inconscientemente se edita, cortando detalhes que parecem "longos demais para digitar." O resultado são prompts concisos e ambíguos.

Quando você fala, as palavras fluem a mais de 150 palavras por minuto (contra 60-80 para a maioria dos digitadores). O custo por palavra cai dramaticamente. Você inclui contexto que teria cortado. Menciona casos extremos que teria pulado. Explica o "porquê" junto com o "o quê."

Isso importa enormemente para agentes de IA. O Claude Code pode lidar com um prompt de 500 palavras tão facilmente quanto um de 10 palavras. Mas o prompt de 500 palavras dá contexto suficiente para acertar a implementação de primeira, enquanto o de 10 palavras o força a adivinhar.

A equação é simples: A voz remove o custo do contexto. Mais contexto significa melhor saída da IA. Melhor saída significa menos iterações. Menos iterações significa desenvolvimento mais rápido.

Problemas Comuns de Digitação por Voz no Terminal

Prompts Longos e Quebra de Linha

Alguns terminais lidam com texto longo colado de forma diferente. Se você encontrar problemas com quebra de linha, tente usar um terminal que lide bem com paste multilinha (o Windows Terminal funciona muito bem).

Caracteres Especiais em Código

Se você precisa incluir código específico no seu prompt, geralmente é melhor digitar apenas esse trecho e falar o resto. Por exemplo, digite o padrão regex, depois fale a explicação do que ele deve fazer.

Ruído de Fundo no Terminal

Se você está em um ambiente barulhento, o cancelamento de ruído do Murmur (alimentado pelo processamento do ChatGPT) lida com a maioria do ruído ambiente. Mas um microfone direcional ou headset dá os melhores resultados.

Uma Sessão Típica de Voz + Claude Code

Veja como uma sessão real de 30 minutos se parece:

1. Fale: "Olhe para as falhas de teste no módulo de usuário. Os testes em tests/user.test.ts estão falhando no fluxo de criação de usuário. Você pode identificar o que mudou recentemente que os quebrou?"
2. O Claude Code investiga, identifica o problema
3. Fale: "Ok, corrija essas falhas de teste. O mock do serviço de email precisa ser atualizado para corresponder à nova interface EmailService que mudamos na semana passada. Também atualize quaisquer outros arquivos de teste que fazem mock do EmailService."
4. O Claude Code corrige os testes em múltiplos arquivos
5. Fale: "Rode a suite de testes completa e me diga se algo mais está falhando."
6. Todos os testes passam
7. Fale: "Ótimo. Agora crie um commit com uma mensagem descritiva resumindo as correções dos testes."

Quatro prompts por voz. Cinco minutos de fala no total. Uma sessão completa de depuração e correção que teria levado muito mais tempo com prompts digitados.

Conclusão

O Claude Code é mais poderoso quando você dá a ele prompts detalhados e ricos em contexto. O ditado por voz com o Murmur remove a fricção entre seus pensamentos e o terminal, permitindo que você fale da mesma forma que explicaria um problema a um colega sênior.

O resultado não é apenas entrada mais rápida. São prompts fundamentalmente melhores, que levam a código melhor, menos iterações e um fluxo de trabalho de codificação com IA mais eficaz.

Se você usa o Claude Code regularmente, tente adicionar voz ao seu fluxo de trabalho no terminal. Comece com uma sessão. Você vai sentir a diferença imediatamente.