Comentários no código: quanto eles custam quando você cola na IA

Publicado em 22 de junho de 2026 · ⚡ 5 min de leitura

Comentário é bom. Documentar o "porquê" de uma decisão salva o próximo dev — que muitas vezes é você mesmo daqui a três meses. Mas quando você cola aquele arquivo comentado para a IA debugar, cada comentário vira token faturado. E a IA não precisa de nenhum deles para achar o bug. Vamos medir esse custo.

O que "conta" quando você cola código

Além da lógica que importa, vai junto uma pilha de coisa que só ocupa espaço:

• Comentários de linha (// isso faz X) e de bloco (/* ... */);
• Blocos inteiros de código comentado ("deixa aí, vai que precisa");
• // TODO e // FIXME de meses atrás;
• Linhas em branco duplas e triplas entre funções;
• Tabs e espaços sobrando no fim das linhas.

A medição

Pegamos um arquivo típico de rota de API em Node.js — o tipo de coisa que a gente cola pra debugar todo dia. Antes: 284 caracteres com dois comentários de linha, um bloco /* */ e três linhas em branco extras. Depois de remover só o que não é lógica: 212 caracteres.

Antes:   284 caracteres  (~71 tokens)
Depois:  212 caracteres  (~53 tokens)
Economia: 25%  — sem tocar em uma linha de lógica

Vinte e cinco por cento em um arquivo relativamente limpo. Em código legado de verdade — cheio de comentário histórico, função antiga comentada, changelog no topo do arquivo — a proporção passa fácil de 40%.

Não é só dinheiro: é qualidade da resposta

Aqui está o detalhe contraintuitivo. Comentários não só custam tokens — eles pioram a resposta. Um comentário desatualizado que diz "retorna o usuário" numa função que hoje retorna um token JWT vai enganar o modelo. Código morto comentado faz a IA raciocinar sobre caminhos que nem existem mais. Menos ruído no contexto = diagnóstico mais preciso.

"E se o comentário for importante pro bug?"

Boa pergunta. Se um comentário explica uma decisão que é parte do problema ("aqui a gente força UTC por causa do bug X"), aí ele é contexto legítimo — coloque essa informação na descrição do problema, com suas palavras, em vez de deixar espalhada no meio do código. É mais claro para o modelo e você controla o que entra.

URLs são a exceção que confunde regex ingênua

Um detalhe técnico que pega muita ferramenta caseira: https://api.exemplo.com tem // no meio. Um removedor de comentários mal feito apaga metade da sua URL achando que é comentário. Qualquer higienização séria precisa preservar http:// e https:// — é o tipo de detalhe que separa uma ferramenta que funciona de uma que quebra seu código silenciosamente.