Dá para usar o Claude Code sem saber programar? O que funciona e onde você trava

Fala aí, beleza? O vibe coding vendeu uma ideia bem sedutora: você descreve o que quer, aperta enter e o software aparece

E não é mentira, funciona muito mais do que deveria 😀

Só que tem um detalhe que quase ninguém conta no vídeo de 60 segundos: o Claude Code escreve o código, roda comando, corrige o próprio erro, e mesmo assim ele para o tempo todo pra te perguntar uma coisa

Essa pergunta é onde mora o problema de quem não lê código, porque responder "sim" sem entender o que está sendo aprovado é justamente o buraco

Então bora separar as duas coisas neste post: o que o agente resolve sozinho, e onde você trava

O que você precisa antes de começar (e quanto custa):

Primeira barreira, e é real: não existe Claude Code no plano gratuito

A documentação é direta nisso, o Claude Code exige assinatura Pro, Max, Team ou Enterprise

A porta de entrada mais barata é o Pro, que custa US$ 20 por mês nos Estados Unidos e já inclui o Claude Code junto de outros recursos do Claude na mesma assinatura

Se você for pesado no uso, existe o Max em duas faixas, o Max 5x e o Max 20x, que dão 5x ou 20x o uso do Pro por sessão de 5 horas

"Sessão de 5 horas?" pois é, o uso é medido em janela de sessão, e a Anthropic também pode aplicar limites semanais e mensais por modelo ou recurso

Quem estoura o limite incluído nos planos Max consegue continuar usando pagando o consumo às taxas padrão da API

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

Caminho 1: sem terminal, pelo app de desktop

Se a palavra "terminal" já te dá um arrepio, esse é o seu caminho

Existe um app de desktop do Claude Code que roda sem terminal, com interface gráfica, disponível pra macOS, Windows e Linux (esse último em beta)

O download fica em claude.com/download

E ele não é uma versão capada de vitrine: tem revisão visual de diff, editor de arquivos, preview do app e sessões em paralelo

Caminho 2: pelo terminal, via npm

Se você já tem o Node por aí, é um comando global:

npm install -g @anthropic-ai/claude-code

Também existe instalação por curl no macOS e Linux, e por PowerShell no Windows

Tome cuidado com um detalhe aqui: a documentação alerta pra NÃO usar sudo nesse npm install, porque isso gera problema de permissão de arquivo depois

É o clássico erro que só aparece três dias na frente, quando você já esqueceu o que fez

O que o Claude Code resolve sozinho para quem não programa:

Agora a parte boa, porque tem MUITA coisa aqui que não depende de você saber ler uma função

1. A primeira mudança assistida

O guia oficial de primeiro dia tem como meta você instalar, entrar e fazer a primeira mudança assistida em cerca de 15 minutos

Ou seja, o fluxo já é desenhado pra quem está chegando, não pra quem já domina

2. O CLAUDE.md, o passo de maior valor

O CLAUDE.md é um arquivo markdown na raiz do projeto que o Claude Code lê automaticamente no começo de toda sessão naquele diretório

É o contexto persistente: o que é o projeto, como builda, como testa, quais os padrões

Você gera ele com o comando /init, que analisa o codebase pra detectar build, testes e padrões, e refina com /memory

A própria Anthropic chama gerar o CLAUDE.md de "the single highest-value setup step you can take"

Pra quem não programa isso vale ouro: é você delegando pro agente a tarefa de entender o projeto que você também não entende 🙂

3. O plan mode, ver antes de deixar tocar

O plan mode lê arquivos, explora o projeto e escreve um plano, mas não edita o código-fonte

O plano vem em português, em texto, e isso você consegue avaliar mesmo sem ler o diff

Se o plano estiver falando de mexer em coisa que você nem pediu, é sinal de que o pedido saiu torto, e vale melhorar o prompt antes de liberar a edição (aqui no blog tem um post só sobre técnicas de prompt no Claude Code que ajuda nessa parte)

4. Revisão visual de diff e preview do app

No app de desktop você vê a mudança visualmente e consegue dar um preview do app

"Mas eu não leio diff" beleza, mas você lê o app funcionando ou quebrado

É um sinal grosseiro, e sinal grosseiro é melhor que nenhum sinal

5. Revisão automatizada de segurança

O Claude Code tem uma revisão automatizada que identifica classes conhecidas de vulnerabilidade: SQL injection, XSS, falhas de autenticação e autorização, tratamento inseguro de dados e vulnerabilidades em dependências

Essa é a rede de proteção que o vibe coder solo normalmente não teria, porque ele nem sabe que essas categorias existem

O agente decide x você decide: a divisão real de trabalho

O ponto central é o sistema de permissões: cada ação sensível pausa e pede aprovação, e o Claude Code só tem as permissões que você concede

Ou seja, ele é o dev, e você é quem assina embaixo

Repare que a coluna do meio é generosa e a coluna da direita é curta, mas pesada

A frase da documentação de segurança é essa, sem meia palavra: "You’re responsible for reviewing proposed code and commands for safety before approval"

Onde você trava sem saber ler código (e como se proteger):

Agora as travas concretas, com sintoma, causa e o que fazer

Trava 1: aprovar comando sem entender o que ele faz

Sintoma: aparece um pedido de permissão, você não faz ideia do que é aquilo, e aprova porque quer ver o resultado

Causa: o sistema de permissões é uma pergunta, e pergunta só protege quem consegue responder

O que fazer: trabalhe em plan mode antes de liberar edição

Você entra nele com Shift+Tab, que cicla entre default, acceptEdits e plan, ou prefixando o prompt com /plan

Assim você lê a INTENÇÃO em texto, decide ali, e só depois solta a mão dele no código

Trava 2: quebrar o projeto e não saber voltar

Sintoma: funcionava, você pediu "só mais um ajustezinho", agora não abre mais

Causa: sem base técnica, você não consegue reverter na unha

O que fazer: o checkpointing cria um checkpoint a cada prompt enviado

Você abre o menu com /rewind (os aliases são /checkpoint e /undo), ou apertando Esc duas vezes com o campo de prompt vazio

Dali dá pra restaurar código e conversa, só a conversa, só o código, ou retomar daquele ponto

E eles ficam salvos com a conversa, sobrevivem a fechar o terminal

Trava 3: confiar demais no checkpoint

Essa é a pegadinha que machuca, se liga

Sintoma: você deu rewind, mas alguma coisa continuou torta

Causa: o checkpoint não captura tudo

Alterações feitas por comandos Bash (aquele echo > file.txt ou um sed -i da vida) ficam de fora, e arquivos com symlink ou hard link também não são revertidos

O que fazer: trate o rewind como rede de segurança parcial, não como backup

Ter o projeto versionado é o que fecha esse buraco de verdade, e o próprio agente cuida dessa parte pra você se você pedir, tem um passo a passo de usar o Claude Code com Git aqui no blog

Trava 4: prompt injection

Sintoma: o agente faz algo que você não pediu, depois de ler um arquivo ou um conteúdo da web

Causa: prompt injection, que é texto malicioso tentando sobrescrever as instruções do assistente

A documentação reconhece isso como risco, com salvaguardas PARCIAIS: o próprio sistema de permissões, análise do pedido completo, sanitização de entrada e resumo dos resultados de busca web em vez de jogar o conteúdo bruto no contexto

O que fazer: parcial é a palavra-chave aqui

Quanto mais você aprova no automático, menos a salvaguarda principal (a permissão) está fazendo o trabalho dela

O que muda quando você usa de verdade:

No vídeo abaixo eu monto o Channels no Claude Code pra mandar tarefa de código pelo Telegram, e ali aparece bem clarinho o que este post está falando

Eu até desenhei um infográfico do fluxo antes de começar, porque na minha avaliação o processo não é tão simples quanto parece: a mensagem sai do Telegram, passa por um MCP Server que liga o app à sessão do Claude Code, o código roda na minha máquina e o retorno volta pelo chat

E olha o detalhe mais importante de todos pra quem não lê código: eu precisei abrir a sessão com a flag que pula as permissões

Motivo: o pedido de permissão no terminal travaria a execução remota, já que ninguém está lá pra clicar

Eu mesmo digo no vídeo que não é a opção mais indicada, era o único jeito de funcionar

Ou seja, o preço da conveniência foi desligar exatamente o guardrail que segura o agente

O resto do caminho também não foi "next, next e finish": conferi o Claude Code atualizado, verifiquei o Bun instalado (e o terminal do VS Code não devolveu a saída do comando de versão, só o terminal fora do editor, alguma interferência do editor), criei o bot no BotFather, peguei o token (que ocultei na gravação, é segredo), instalei o plugin e fiz o pareamento com um código que o próprio bot devolveu no chat

Na primeira tentativa eu mandei a mensagem no Telegram e não aconteceu nada

O Claude Code me avisou que o servidor do Telegram precisava estar rodando e pediu pra reiniciar a sessão com o channel, aí sim a mensagem chegou

Depois rodei o comando de allowlist de política pra que só a minha conta pudesse mandar mensagem pra aquela sessão, e isso eu trato como medida de segurança mesmo

O teste em si foi um prompt pedindo um projeto Node com Express servindo uma API REST de tarefas, com rotas GET e POST e populada com exemplos, e deu pra acompanhar o Claude Code recebendo e respondendo (teve até um problema de atualização da interface, precisei recarregar pra ver o retorno)

As limitações que encontrei: o Telegram não guarda histórico ali e mensagem enviada com a sessão offline se perde no limbo, sem reenvio

O que fica da experiência é isso: acompanhar o agente trabalhando é fácil, qualquer um faz

Decidir o que liberar pra ele é o que continua exigindo cabeça

No vídeo você vê o fluxo inteiro rodando ao vivo, incluindo a parte que deu errado na primeira tentativa 😀

Veredito: até onde vai o vibe coding sem base técnica

O termo vibe coding nasceu num post do Andrej Karpathy no X, em 2 de fevereiro de 2025: "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"

Esquecer que o código existe é ótimo… até o momento em que o código passa a existir pra outra pessoa

Vale muito a pena se: é projeto pessoal, protótipo, script pra resolver a sua vida, ou você quer aprender mexendo

Nesses casos quebrar é barato, e quebrar ensina

Pisa no freio se: o código vai pra produção, mexe com dado de terceiro ou tem dinheiro envolvido

Não é que o agente escreve mal, é que a documentação oficial já te avisou de quem é a revisão

Ninguém revisa por você, e o botão de aprovar não pergunta se você entendeu

Conclusão

Usar o Claude Code sem saber programar funciona, e funciona bem melhor do que parecia há pouco tempo

O agente escreve, edita, roda comando, propõe plano, guarda checkpoint e ainda aponta classe conhecida de vulnerabilidade

O que continua com você é curto e não terceirizável: aprovar ação sensível e julgar se a mudança está certa

Próximo passo bem concreto pra hoje: escolha o caminho (app de desktop se você não quer terminal, ou o npm install -g @anthropic-ai/claude-code se você quer), rode /init pra gerar o CLAUDE.md e comece em plan mode

E faça isso num projeto que você pode quebrar sem prejuízo nenhum, é assim que se aprende sem chorar depois

até o próximo post! 🙂