Programar por voz — o passo a passo

O que você precisa

• Celular com ChatGPT e modo de voz
• Fone (crítico — microfone do celular no carro erra demais)
• Uma máquina que fica ligada em casa com o projeto
• Codex configurado
• Claude Code instalado na máquina

Preparar a máquina antes de sair

Cinco minutos que evitam duas horas de frustração.

Desligue a suspensão automática. Se a máquina hibernar no meio, o processo morre e você só descobre 40 minutos depois, parado no farol. Nas configurações de energia, tela pode apagar — a máquina não pode dormir.

Deixe tudo autenticado. Toda credencial, token e login resolvidos antes de sair. Você não vai conseguir digitar senha pelo áudio, e nem deveria.

Abra o projeto e deixe rodando. O ambiente de pé, dependências instaladas, o servidor local subindo se for o caso.

Teste o acesso remoto antes de precisar. Saia de casa, entre no 4G e confirme que alcança a máquina. Testar no wi-fi de casa não vale.

Como a cadeia funciona

Por que três e não um: se você falar direto com um agente de código, gasta metade do tempo corrigindo transcrição e a outra metade dando contexto. O ChatGPT no meio absorve a imprecisão da fala — ele aguenta você mudando de ideia no meio da frase, com ruído de carro. O Claude Code no fim carrega o contexto do repositório inteiro.

Cada um cobre o buraco do outro.

A peça que liga tudo está na configuração do Codex.

Não tem plumbing complicado, não tem servidor no meio, não tem gambiarra. O Codex já vem preparado pra isso — você só precisa conceder a permissão.

Quando você ativa o Codex, entre nas configurações dele e habilite o controle da sua máquina. É essa autorização que faz ele deixar de ser um assistente que sugere e passar a ser um agente que executa no seu computador.

A partir daí a cadeia fecha sozinha: você fala com o ChatGPT, o Codex já tem permissão de agir na máquina, e o trabalho acontece.

É por isso que eu clico algumas vezes durante o dia. Não é digitação — são as autorizações. O Codex pede confirmação, e é bom que peça.

O prompt de abertura da sessão

Cole isto no ChatGPT antes de começar a falar. É o que faz a diferença entre uma conversa produtiva e 40 minutos de mal-entendido.

Vamos trabalhar por voz. Estou dirigindo ou andando, sem tela.

Regras da nossa conversa:

1. Nunca me leia código em voz alta. Se precisar me mostrar código,
diga apenas o arquivo, a função e o que mudou em uma frase.

2. Me responda sempre em linguagem natural, curta. Um parágrafo, no
máximo dois. Se a resposta for longa demais pra ouvir, ela está errada.

3. Minha fala vai ter erro de transcrição. Se algo não fizer sentido,
interprete pelo contexto do projeto antes de me perguntar. Só pergunte
se realmente ficou ambíguo.

4. Antes de qualquer alteração destrutiva — apagar arquivo, migração
de banco, deploy, reescrever mais de um arquivo — pare e me pergunte.
Descreva o que vai fazer em uma frase e espere eu confirmar.

5. A cada tarefa concluída, faça commit com mensagem descritiva. Eu vou
revisar pelo git log depois, então a mensagem é o meu relatório.

6. Se eu pedir algo que exige precisão de caractere (regex, query
complexa, nome exato de variável), me avise que isso é melhor eu fazer
sentado, e siga para o próximo item.

Confirme que entendeu e me diga em que ponto o projeto está.

Como falar durante a sessão

Descreva comportamento, não implementação. "Quando o usuário clicar aqui, tem que acontecer isso" funciona muito melhor que tentar ditar código.

Conte a história inteira. Digitando você escreveria "arruma esse bug". Falando, conte o contexto todo — leva 20 segundos e a resposta melhora muito. Contexto que você não digitaria por preguiça, você fala sem perceber.

Peça o resumo antes de seguir. "Me conta em uma frase o que você fez" a cada tarefa. É o que evita chegar em casa e descobrir que ele foi para o lado errado 40 minutos atrás.

Pense em voz alta. Metade das vezes você descobre o problema no meio da própria explicação, antes da resposta chegar.

O que funciona e o que não funciona

Quando você chegar em casa

git log --pretty=format:'%h  %ad  %s' --date=format:'%d/%m %H:%M' --since="1 day ago"
git diff --stat "@{1 day ago}"

O git log é o relatório do dia. É por isso que a regra 5 do prompt pede commit descritivo a cada tarefa.

Os erros que eu cometi