← Voltar ao attunz

Ajuda do attunz

Dite prompts de programação e textos técnicos no Mac

Use o attunz nos apps do Mac, incluindo Cursor, VS Code, Claude Code, Codex e o terminal, para ditar prompts de programação, documentação e notas técnicas. Comece pelo texto que você quer escrever e revise antes de usar.

Dê uma estrutura clara ao seu prompt

  1. Posicione o cursor no campo em que você quer inserir o texto e inicie o ditado do attunz.
  2. Diga o objetivo, os nomes dos componentes ou das APIs relevantes e as restrições. Para documentação, diga a quem ela se destina e o que deve explicar.
  3. Revise o texto, corrija os detalhes importantes e envie para a ferramenta que você está usando.

Experimente um prompt de programação ou um pedido de documentação

Prompt hipotético de programação: “Em UserSettings, adicione um estado vazio quando a API não retornar nenhum projeto. Mantenha os estados de carregamento e de erro existentes. Explique a alteração proposta e sugira testes antes de editar o código.”

Pedido hipotético de documentação: “Documente como retryAfterMs é usado após uma resposta HTTP 429. Inclua a unidade e um exemplo.”

Esses exemplos ilustram textos que você poderia ditar. Confira se UserSettings, retryAfterMs e HTTP 429 correspondem à sua tarefa real antes de enviar o pedido.

Entenda que contexto o attunz usa

Durante o ditado, o attunz pode usar automaticamente, conforme necessário, o nome do app, o texto da janela via AX, o texto selecionado, o texto já no campo e a posição disponível do cursor. O texto da janela vem da Acessibilidade do macOS (AX), não de capturas de tela. As informações disponíveis dependem do app e das permissões; ajudam o aprimoramento por IA a entender a entrada e refinar o texto ASR e sua formatação.

A coleta da área de transferência para contexto dos modelos é desativada por padrão. O contexto automático das janelas não varre código-fonte de projetos. Importar documentos é uma ação separada escolhida por você; o histórico local autorizado Claude/Codex é outra entrada. É possível desativar a coleta automática de contexto.

Confira os detalhes que mudam o significado

Revise identificadores, letras maiúsculas e minúsculas, caminhos de arquivos, números, unidades e pontuação. Confira com atenção especial restrições como “não altere a API pública”. Se você ditar um comando no terminal, revise antes de executar.

Para nomes recorrentes e termos especializados, leia o guia de memória. Para configurar modelos locais e entender a diferença entre processamento local e na nuvem, leia o guia de ditado offline. A coleta de contexto e o local de processamento são questões distintas.

Configure o aprimoramento por IA e visualize o prompt

Ative “Aprimorado por IA” nos ajustes e escolha um modelo. Após o ditado, a IA segue suas instruções para corrigir erros de reconhecimento, tirar vícios de linguagem e repetições e ajustar o tom e a formatação. Textos curtos podem sair direto, conforme os ajustes.

Em Aprimorado por IA → Prompt, defina o tom e a formatação e confira o resultado na área de teste. Você pode inserir variáveis de contexto, como o app atual. As preferências pessoais também podem ser editadas no perfil de estilo da memória.

A área de teste do prompt usa o modelo de aprimoramento selecionado. Com um modelo na nuvem, executar o teste envia o texto ao provedor. Use um exemplo sem dados sensíveis e revise a saída; a prévia não garante o mesmo resultado em todos os apps.

Todos os recursos são grátis para sempre com modelos locais ou BYOK (sua chave API). O Attunz não cobra por essas opções. Modelos terceiros são pagos diretamente ao provedor. O serviço hospedado Attunz usa recargas manuais de créditos para ASR e aprimoramento IA de nuvem opcionais, sem renovação automática atualmente. Está disponível. Preços

Escolha um fluxo de entrada por voz

Uma conversa de voz ao vivo é uma troca contínua com um agente. O ditado gera texto editável de prompt para revisar antes de enviar. Ferramentas nativas podem oferecer um ou ambos; diferencie app e CLI. Um fluxo de ditado entre apps do Mac pode ajudar ao alternar entre campos de prompt, editores e notas.

Confira os requisitos de voz do Claude Code

O ditado nativo do Claude Code é ajustado ao vocabulário de programação e usa nomes de projeto e branch como pistas. Exige autenticação Claude.ai e envia áudio à Anthropic para transcrição. Não aceita autenticação direta por API Key nem por provedores terceiros; a documentação também exclui sessões SSH/nuvem e VS Code Remote. Confira a documentação atual da interface usada.

Requisitos de voz do Claude Code

O Codex já tem ditado nativo. A atualização do app Codex de 5 de maio de 2026 adicionou limpeza de texto e um dicionário de nomes, caminhos e símbolos de código. Separadamente, o CLI 0.156.0 de 22 de setembro de 2026 ativou conversas de voz por padrão. Ditado no app e conversas no CLI são interfaces e fluxos diferentes.

Histórico do app Codex · Codex CLI 0.156.0

Escolha conforme suas necessidades entre apps

  • Uma ferramenta: confira primeiro a voz nativa. Claude Code e Codex têm opções nativas, e Agents Window do Cursor também oferece entrada por voz. Opções gratuitas, locais ou BYOK não são exclusivas do Attunz.
  • Vários apps do Mac: escolha um fluxo de ditado adequado para alternar entre editor, campo de prompt e notas técnicas. A inserção de texto ainda depende do app de destino e das permissões.
  • Processamento local: siga o guia offline para configurar reconhecimento de fala, aprimoramento e modelos de memória locais. Confira quais serviços recebem seu texto quando você o envia.

Janela Agents do Cursor · Guia offline

Com contas de trabalho, use apenas apps e serviços de processamento permitidos pela organização. Confira o texto antes de enviar um prompt ou executar um comando.

Perguntas frequentes

Posso usar o attunz no Cursor, no VS Code, no Claude Code, no Codex e em um terminal?

Sim. O attunz permite ditar nos apps do Mac, incluindo essas ferramentas. Posicione o cursor onde você quer escrever, dite e revise o texto antes de enviar.

O attunz lê os arquivos do meu projeto ou a área de transferência?

A coleta da área de transferência para contexto dos modelos é desativada por padrão. O contexto automático das janelas não varre código-fonte de projetos. Importar documentos é uma ação separada escolhida por você; o histórico local autorizado Claude/Codex é outra entrada. É possível desativar a coleta automática de contexto. Durante o ditado, o attunz pode usar automaticamente, conforme necessário, o nome do app, o texto da janela via AX, o texto selecionado, o texto já no campo e a posição disponível do cursor. O texto da janela vem da Acessibilidade do macOS (AX), não de capturas de tela. As informações disponíveis dependem do app e das permissões; ajudam o aprimoramento por IA a entender a entrada e refinar o texto ASR e sua formatação.

Posso desativar a coleta automática de contexto?

Sim. O contexto é obtido automaticamente, e você pode desativar essa função. Para conhecer as opções de processamento local e na nuvem, consulte o guia específico de ditado offline.

O ditado local faz o Claude Code ou outro serviço de programação funcionar offline?

Não. Com os modelos locais necessários selecionados, o ditado pode transformar fala em texto no seu Mac. O app ou serviço que recebe esse texto tem seus próprios requisitos de rede e políticas de dados. Confira isso separadamente antes de enviar um prompt.

Qual a diferença entre ditado editável e conversa de voz ao vivo?

O ditado fornece texto para revisar, editar e então enviar como prompt de programação. Uma conversa de voz é uma troca oral contínua com um agente. Use controles nativos adequados, ou ditado no Mac para vários apps e processamento local opcional. Transcrição local não torna o serviço destinatário offline nem confirma compatibilidade com sessões remotas.

Vindo de outro app de ditado? Compare o attunz como alternativa ao Wispr Flow ou como alternativa ao Superwhisper.