Vibe coding em português funciona? Como descrever o que você quer para a IA no seu idioma

Fala aí, beleza? Dá pra descrever um sistema inteiro em português, apertar enter, e receber código que roda

E não é gambiarra de tradutor no meio do caminho: é o fluxo que ficou conhecido como vibe coding

O termo foi criado por Andrej Karpathy num post no X publicado em 2 de fevereiro de 2025, com este texto: "There’s a new kind of coding I call ‘vibe coding’, where you fully give in to the vibes, embrace exponentials, and forget that the code even exists. It’s possible because the LLMs (e.g. Cursor Composer w Sonnet) are getting too good. Also I just talk to Composer with SuperWhisper so it’s not even coding, I just speak."

O próprio Karpathy comentou depois que aquilo foi "a shower of thoughts throwaway tweet that I just fired off without thinking", e que vibe coding hoje é citado na Wikipedia dele

Tweet improvisado que virou marco, olha só…

E não parou aí: vibe coding foi eleita a Palavra do Ano de 2025 pelo Collins Dictionary, com a definição de uso de inteligência artificial acionada por linguagem natural para escrever código de computador

Repara na definição: linguagem natural

Não diz inglês

E é exatamente isso que este post vai responder na prática: escrever o pedido em português funciona, e a alavanca que está na TUA mão é a formulação do pedido

Sendo honesto desde já: existe estudo acadêmico que mediu diferença de qualidade do código conforme o idioma do prompt, e eu mostro isso mais pra frente sem varrer pra debaixo do tapete

Só que, nesse mesmo estudo, traduzir o pedido pro inglês não foi o que fechou a lacuna, então detalhar requisito é onde teu esforço rende de verdade

Formação Recomendada

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

• 474 aulas
• 20 projetos
• 39h 27min

Conhecer formação

O que você precisa antes de escrever o primeiro prompt em português

A lista honesta é curta, beleza?

• um assistente de código instalado (Claude Code, Cursor, Copilot, o que tu já usa)
• um projeto real aberto, nem que seja uma pasta vazia com git init dentro

Só isso

Não precisa de plugin de tradução, não precisa de "prompt mágico em inglês", não precisa de PC da Nasa

O que faz diferença de verdade é o que você tem à mão na hora de escrever o pedido:

• os arquivos que você vai citar pelo nome
• as restrições do projeto (stack, versão, padrão de código, o que não pode mudar)
• um exemplo do padrão que você quer que a IA siga

Isso não é opinião minha, é o que a documentação oficial de melhores práticas do Claude Code fala: quanto mais precisas as instruções, menos correções depois

A orientação de lá é literalmente referenciar arquivos específicos, mencionar restrições e apontar padrões de exemplo, porque o Claude infere intenção mas não lê a sua mente

Se você conhece aquela sensação de abrir chamado mal escrito pro time e receber a coisa errada de volta, é a mesma dinâmica aqui =)

E os ajustes de idioma? Cada um mora num produto diferente:

Tome cuidado com esta parte, porque é onde a internet mistura tudo

• no Claude.ai (o aplicativo web) dá pra escolher o idioma preferido: ícone do perfil no canto inferior esquerdo, seção Idioma
• no GitHub Copilot Chat dentro do VS Code existe a configuração github.copilot.chat.localeOverride

São produtos diferentes, caminhos diferentes

Menu do Claude.ai não é instrução de Claude Code, e configuração do VS Code não vale pro chat do site

A boa notícia pra quem escreve em português: a documentação do Claude Code já tem versão traduzida em code.claude.com/docs/pt, e a documentação da plataforma tem versão pt-BR em platform.claude.com/docs/pt-BR, incluindo a página de suporte multilíngue

Como escrever um pedido de desenvolvimento em português que a IA entende

Bora ver na prática?

Cada passo abaixo vem com o pedido ruim, o pedido bom e o erro comum que quase todo mundo comete ali

1. Diga o resultado esperado, não a vibe

O pedido ruim é aquele que descreve sentimento:

    melhora essa tela, tá feia e confusa

O pedido bom descreve comportamento final observável:

    Na tela de listagem de pedidos, quero que:
    - pedidos com status "pendente" apareçam primeiro
    - cada linha mostre data, cliente e valor total formatado em BRL
    - a lista mostre 20 itens por página, com botão de próxima página
    Quando não houver pedido, mostrar uma mensagem no lugar da tabela vazia

Repara que o segundo está 100% em português, e mesmo assim é preciso

O erro comum deste passo: achar que "melhora" e "deixa mais bonito" são requisitos. Não são, são adjetivo. A IA vai chutar o gosto dela e você vai reclamar do chute

2. Aponte os arquivos específicos em vez de dizer "no projeto"

"Arruma o login no projeto" faz a IA sair varrendo o mundo e adivinhando

    Em src/auth/session.ts e src/app/login/page.tsx, ajuste o fluxo de
    login para invalidar a sessão anterior quando o mesmo usuário
    entrar de novo

Isso é a recomendação oficial aplicada: referenciar arquivos específicos

O erro comum deste passo: citar o arquivo com o nome traduzido de cabeça ("o arquivo de sessão") em vez do caminho real. Nome de arquivo é identificador, copia e cola do jeito que está no disco

3. Escreva as restrições, o que NÃO pode mudar

Essa é a parte que o inglês não conserta e o português vago não entrega

    Restrições:
    - não altere o schema do banco
    - não instale biblioteca nova, use o que já está no package.json
    - mantenha a assinatura pública de getSession() igual
    - não toque em nada fora da pasta src/auth

Restrição é o freio de mão do pedido

O erro comum deste passo: assumir que "é óbvio que não era pra mexer nisso". Não é óbvio pra ninguém, muito menos pra quem só leu o texto do seu prompt

4. Aponte um padrão de exemplo que já existe no código

Em vez de descrever o seu estilo em três parágrafos, mostra um arquivo que já está do jeito que tu quer:

    Siga o mesmo padrão de src/features/orders/repository.ts:
    mesma organização de funções, mesmo tratamento de erro,
    mesmo estilo de nomeação

É o velho truque da analogia: ligar o novo a algo que já existe

O erro comum deste passo: apontar um arquivo antigo que ninguém gosta mais. A IA vai imitar direitinho a bagunça que você indicou haha

5. Peça o plano antes do código

No Claude Code, Shift+Tab cicla os modos de permissão: do normal pro auto-accept e depois pro plan mode, indicado por "plan mode on"

No plan mode o Claude lê arquivos e responde sem alterar nada

E Ctrl+G abre o plano no editor de texto pra você editar antes de liberar

Isso é ULTRA útil quando o pedido é grande: você corrige o rumo no texto, que é barato, em vez de corrigir 14 arquivos depois

O erro comum deste passo: pular o plano em tarefa grande e só descobrir o mal-entendido quando o diff já está gigante

6. Registre o contexto que se repete em vez de redigitar toda vez

Se você escreve "responda em português, usamos pnpm, não crie testes na pasta X" em todo prompt, esse contexto merece morar num arquivo

O Claude Code lê arquivos CLAUDE.md em locais definidos:

– ~/.claude/CLAUDE.md, vale pra todas as suas sessões – ./CLAUDE.md na raiz do projeto, versionável no git e compartilhado com o time – ./CLAUDE.local.md, pras suas notas pessoais daquele projeto

E dá pra começar sem escrever do zero, rodando dentro do projeto:

    /init

O /init examina o codebase (arquivos de pacote, documentação, configuração, estrutura) e gera um CLAUDE.md inicial com comandos de build, instruções de teste, diretórios-chave e convenções detectadas

Escopo importante: no Cursor o equivalente versionado são as project rules, que vivem em .cursor/rules como arquivos .mdc, indo junto do projeto no git

O erro comum deste passo: gerar o arquivo e nunca mais olhar pra ele. O /init te dá o rascunho, a revisão à mão é sua

Erros comuns de quem descreve o projeto em português (e como corrigir)

A IA responde em inglês mesmo com a pergunta em português:

Causa provável: configuração de idioma do produto, ou ausência de qualquer instrução sobre idioma

Solução: fixe o idioma onde o produto oferece isso. No Claude.ai, no ícone do perfil, seção Idioma. No Copilot Chat do VS Code, na configuração github.copilot.chat.localeOverride

Como prevenir: se o seu assistente não tem esse ajuste, escreva a preferência no arquivo de contexto persistente do passo 6, tipo "todas as respostas e comentários de código em português do Brasil"

O código vem certo, mas fora do padrão do projeto:

Causa: prompt sem referência de arquivo e sem exemplo. A IA escreveu do jeito genérico dela, que é o jeito médio da internet

Solução: cite o arquivo que vai ser alterado e o arquivo que serve de modelo, os passos 2 e 4 juntos

Como prevenir: convenção de código é contexto que se repete, então ela pertence ao CLAUDE.md versionado, não ao seu prompt do dia

A IA reescreve o que você não pediu:

Causa: nenhuma restrição declarada. Sem freio, o assistente "aproveita" pra arrumar o que ele acha ruim no caminho

Solução: escreva o que não pode ser tocado e rode o plan mode antes de liberar edição

Como prevenir: deixe as áreas sensíveis do projeto registradas no arquivo de contexto, junto com o motivo. Já me ferrei mais de uma vez achando que "não precisava avisar"

O pedido em português vira ambiguidade porque mistura tradução com nome real do código:

Causa: você escreveu "a função de usuário" e no código existe UserService, usuarioRepo e getUser(). Qual dos três? 😛

Solução: mantenha em inglês o que É identificador do projeto (nome de função, arquivo, variável, rota) e descreva a intenção em português:

Quero que getUser() em src/services/UserService.ts pare de retornar
o campo password_hash na resposta da rota /api/users/:id

Como prevenir: registre no contexto persistente o glossário do projeto, ligando o termo do negócio em português ao nome real no código

Quando o português basta e quando vale escrever em inglês

Não tem regra única aqui, tem cenário

O português rende MUITO quando o gargalo é explicar regra de negócio, fluxo do usuário e critério de aceite

Motivo simples: precisão vem do idioma que você domina. Descrever em inglês capenga uma regra fiscal brasileira é trocar um problema por dois

Já em trecho onde o vocabulário é do próprio código, ou uma mensagem de erro literal, o inglês entra sozinho e nem precisa forçar

E tem pesquisa medindo essa história de idioma no prompt, não é achismo de post de LinkedIn

O HumanEval-XL conecta 23 idiomas naturais a 12 linguagens de programação, com 22.080 prompts e média de 8,33 casos de teste

Depois veio o mHumanEval, que amplia isso pra mais de 200 idiomas naturais nos prompts

E tem um estudo de 2024 que avaliou CodeLLaMa e CodeGemma e encontrou disparidades significativas na qualidade do código gerado a partir de prompts em idiomas diferentes do inglês

Ou seja, o idioma do prompt teve efeito medido ali. Não dá pra sair dizendo que é neutro

O detalhe mais interessante desse estudo: abordagens simples como traduzir o prompt, aumento de dados e fine-tuning se mostraram insuficientes pra fechar a lacuna

Ou seja, nem "escreve tudo em inglês" é a bala de prata que o pessoal vende

Vale o aviso honesto: esse estudo testou aqueles modelos, naquela época, e não os modelos de codificação que a gente usa hoje. Então não dá pra afirmar que a diferença continua igual

A própria Anthropic publica avaliação de desempenho multilíngue do Claude com metodologia declarada: scores zero-shot chain-of-thought por idioma, expressos em percentual relativo ao inglês (100%), sobre o MMLU em inglês traduzido por tradutores humanos profissionais pra 14 idiomas adicionais

Conclusão do bloco: como traduzir o pedido sozinho não fechou a lacuna nem lá na pesquisa, seu esforço rende muito mais detalhando requisito do que passando o texto pro inglês

O que muda na prática: de dois anos para cerca de uma semana

Agora um pedaço da minha própria história, porque eu vivi os dois lados disso

Eu programo há mais de 10 anos e construí vários sistemas linha a linha, do jeito antigo

A plataforma que eu montei sozinho, programando do zero, levou 2 anos

Hoje, com IA, um projeto rodando sai em cerca de uma semana, às vezes

E olha, eu passei os últimos meses testando ferramentas de vibe coding gratuitas e pagas, de empresa grande, pequena e desconhecida, criando e lançando projeto real pra comparar o que funcionava de verdade

Coloquei no ar um projeto completo, com autenticação, integração de pagamento e integração com IA, sem escrever uma única linha de código, só coordenando a IA

O fluxo é esse mesmo que você já leu aqui em cima: descrever em linguagem natural o que eu quero, deixar a IA construir, testar o resultado e ir dando novas orientações pra melhorar ou corrigir

E olha o ponto: esse salto NÃO veio de eu ter passado a escrever prompt em inglês

Veio de descrever com clareza o que eu queria e deixar a execução com a IA

Mas tem o outro lado, e eu falo isso sem romantizar: pedir do jeito errado gera problema

Sem saber o que roda por baixo do capô, o resultado tende a vir com falha de segurança, exposição de dados e problema de desempenho

O que me permitiu direcionar a IA pra sistemas mais robustos foi justamente a base técnica que eu já tinha. Aprender esse fluxo com quem não tem base costuma terminar em sistema que não escala

Saber programar não é pré requisito pra começar, mas quem já sabe acelera demais

E quando o projeto sai do localhost, aí entra outro capítulo: hospedar o projeto numa VPS com domínio de verdade

No vídeo acima eu conto essa trajetória com mais calma: o que eu construía antes linha a linha, como é o fluxo hoje descrevendo o projeto pra IA, e por que eu insisto que vibe coding não é montar bloco visual nem comprar template pronto, e sim construir o teu projeto do zero descrevendo o que tu quer

Próximo passo: escreva o próximo pedido em português, com contexto

Veredito honesto, sem enrolação: escrever em português funciona

O idioma não é irrelevante, tem estudo medindo diferença nisso, e eu não vou fingir o contrário

Só que trocar o idioma sozinho não foi o que fechou a lacuna lá na pesquisa, e a formulação é justamente a parte que está na tua mão hoje

Pedido vago erra em qualquer idioma, e pedido com arquivo citado, restrição declarada e exemplo apontado acerta muito mais, inclusive em português

Seu próximo passo é pequeno e cabe em 15 minutos:

1. rode /init no projeto pra gerar o CLAUDE.md inicial
2. revise o arquivo à mão, colocando as convenções do teu time e o que não pode ser tocado
3. escreva o próximo pedido citando arquivo, restrição e um exemplo do padrão
4. antes de liberar edição em tarefa grande, dá um Shift+Tab até aparecer "plan mode on" e leia o plano

E se você quer continuar a leitura numa fonte confiável, a documentação oficial em português tem as páginas Visão geral e Melhores práticas traduzidas, sem precisar de tradutor no meio

Esse mesmo raciocínio de descrever a regra em português também vale fora do código, tipo nas automações com n8n sem programar, onde o que decide o resultado é a clareza do que você pediu

Bora escrever o próximo prompt com contexto? 😀

Até o próximo post!