Como fazer

Como explicar um erro de código com IA

Evite o ciclo de copiar e colar. Capture o erro, pergunte o que aconteceu e preserve o contexto.

Shuran Zhou, Founder · 2026-07-30 ·8 min ·Atualizado em 2026-07-30

TL;DR

Este guia mostra como explicar erros de código com IA usando a Loqua. Capture o erro onde ele aparece, faça uma pergunta natural e mantenha junto o código visível, o stack trace e o contexto. A análise por IA não substitui o julgamento do desenvolvedor; ela encurta o caminho entre ver o problema e saber o que verificar.

Configuração em 90 segundos

Baixe a Loqua e mova para /Applications.
Conceda a permissão de Acessibilidade para trabalhar com os apps ativos.
Confira os atalhos: Fn para ditado, Fn + Espaço para perguntar à IA, Fn + ↑ para tradução e Shift esquerdo + A + Command (⌘) para Q&A de screenshot.
Abra o IDE, terminal ou navegador onde está o erro.
Capture, pergunte e continue trabalhando.

Todos os atalhos podem ser personalizados.

Pergunte sobre o erro sem quebrar o fluxo

Depois de alterar arquivos no Cursor, o aplicativo para. O IDE mostra stack trace, código destacado e a localização da falha. O ciclo tradicional é copiar → abrir chat de IA → colar → explicar mudanças → esperar.

Mas a mensagem é só parte do contexto. Arquivo, linha destacada, código ao redor e estado atual costumam conter a informação útil.

Você captura

O erro, o código destacado, o arquivo e o contexto no IDE.

Você pergunta

“O que está causando este erro e o que devo verificar primeiro?”

Loqua mostra

A resposta da API pode devolver um valor inesperado antes do processamento. Verifique primeiro a estrutura: o componente espera um array, mas pode receber undefined.

Você vê, pergunta e continua depurando. A Loqua combina compreensão da captura, voz e contexto de trabalho, em vez de tratar a imagem isoladamente.

Cenários comuns de depuração

Explicar erros do IDE

Pergunte: “Qual é a causa raiz mais provável e qual linha devo inspecionar primeiro?”

Entender mensagens desconhecidas

Pergunte: “Explique em linguagem simples e diga qual condição disparou isto.”

Explorar uma correção

Pergunte: “Qual é a menor correção segura e que teste a confirma?” Revise sempre mudanças maiores.

Continuar por voz

Continue com “Também falha quando a resposta está vazia?” ou “Como proteger sem mudar a API pública?”

Quando funciona melhor

Use quando a informação já está visível: erros do IDE, saída do terminal, console do navegador, logs de CI/CD, documentação e diagramas técnicos.

Use ditado direto quando o problema for um comportamento invisível, como “o botão só falha após o segundo login”. Nem todo problema precisa de screenshot; a vantagem está em reconhecer quando a tela contém o contexto que falta.