Claude Code para leigos: o que é, para que serve e o que ele não faz por você

Se você ouviu falar do Claude Code e não sabe se é “coisa de programador”, este texto é para você. Vou explicar o que ele é, o que você precisa para começar e, principalmente, o que ele não faz por você.

Eu não sou programador. Trabalho numa área que não é tecnologia e aprendi a usar esse tipo de ferramenta fazendo e errando. Aviso desde já: este texto é independente e não tem vínculo com a Anthropic, a empresa que criou o Claude Code.

O que é o Claude Code

É uma ferramenta em que a IA Claude trabalha dentro da pasta do seu projeto. Ela lê os arquivos que estão lá, cria arquivos novos, altera os existentes e roda comandos. Quanto ela pergunta antes de agir depende do modo escolhido: no modo Manual, cada mudança espera a sua aprovação.

A diferença para um chat comum é essa. No chat, a IA devolve um texto e você leva esse texto até o lugar onde ele deveria ficar: copia, cola, testa, volta com o erro. No Claude Code, ela mesma faz o trabalho dentro da pasta e mostra o resultado. Você aprova, confere e manda corrigir.

Chamo essa IA que trabalha na pasta de agente. Cada conversa de trabalho com ela é uma sessão.

Para que serve, em termos práticos

Serve para construir e manter sistemas pequenos a partir de uma descrição em português. Exemplos do dia a dia de escritório:

• um painel para anotar pedidos, em vez de caderno e mensagens soltas;
• uma tela de cadastro com lista e filtro;
• uma exportação para planilha;
• ajustes num sistema que você já tem, como trocar um texto, mudar o formato da data ou acrescentar um campo.

No livro, o exemplo que atravessa tudo é a Gráfica Aurora, uma gráfica pequena que perde prazos porque anota pedidos em caderno. A Lúcia, do administrativo, que não programa, descreve o que precisa e o agente monta a tela. Ela olha, aprova ou pede ajuste.

O que você precisa para começar

A lista é curta:

• um computador com Windows 10 ou macOS 13 em diante, 4 GB de memória e internet;
• uma conta no Claude com assinatura paga, porque a conta gratuita não inclui o Claude Code;
• uma pasta vazia no computador, só para o projeto.

Sobre valores, não vou citar nenhum, porque mudam. Para preço e planos, a página oficial é claude.com/pricing, e a página do produto é claude.com/claude-code.

O Claude Code existe como aplicativo de computador (Windows e Mac), versão web (claude.ai/code), terminal e extensão para editores de código. Terminal e extensões servem a quem já programa. A versão web exige um repositório no GitHub, um passo a mais para quem não programa. O caminho mais simples é o aplicativo de computador.

No aplicativo, o começo é assim: aba Code, ambiente Local, Open folder para abrir a pasta do projeto e, no seletor de modo abaixo da caixa de texto, Manual. Nomes de tela mudam; a página oficial de início rápido mostra o caminho atual.

Um cuidado com a pasta: use uma só para o projeto, nunca a pasta inteira de Documentos, e não coloque ali senhas nem dados reais de terceiros.

Permissões: a assinatura é sua

No modo Manual, cada mudança aparece na tela para você aprovar ou recusar. Nos outros modos, o agente aplica sem perguntar, por isso comece no Manual e leia antes de aceitar. Pergunte-se: isso faz sentido para o que eu pedi? Se a Lúcia pediu uma tela de cadastro e o agente quer apagar uma pasta, ela deve parar e perguntar o motivo.

Se você não entender, escreva:

Antes de eu autorizar, explique em linguagem simples o que você pretende fazer agora, por que é necessário e o que pode dar errado.

Recusar não estraga nada. Autorizar sem entender pode estragar.

Um manual que ele lê toda vez

O Claude Code lê um arquivo chamado CLAUDE.md no início de cada sessão. É onde ficam as instruções permanentes: quem é você, como quer as respostas, o que nunca deve ser feito sem perguntar. Isso importa porque cada conversa começa sem o histórico das anteriores. Existe uma memória automática, mas as regras que você quer ver seguidas ficam num arquivo que você escreve e controla.

Ele tem também um modo de planejamento, em que apresenta o plano e espera a sua aprovação antes de mexer em qualquer coisa. No aplicativo, é a opção Plan, no mesmo seletor de modo. Para quem está começando, é um bom freio.

O que ele não faz por você

Esta é a parte mais importante do texto.

Ele não decide o que você quer. Se o pedido é vago, ele preenche as lacunas com suposições, e nem sempre acerta. Quanto mais claro você descrever o que vê e o que espera, melhor o resultado.

Ele não garante que está certo. Pode dizer “pronto” quando só terminou de escrever. Confira abrindo o sistema e usando de verdade.

Ele não guarda os seus pedidos por você. Conversas longas são resumidas para caber na memória de trabalho, e detalhes se perdem. O que importa precisa estar num arquivo seu, não só no chat.

Ele não assume a responsabilidade. Quem publica responde pelo que publicou. Se o sistema mostrar um dado errado a um cliente, a conversa será com você.

Ele não substitui um profissional em casos sérios. Sistema com pagamento ou com dado sensível de outras pessoas pede revisão de quem entende do assunto.

Primeiro contato sem risco

Um bom primeiro teste não cria nada. Abra o aplicativo na pasta vazia, com o modo em Manual, e copie:

Esta é a pasta de um projeto novo. Olhe o que existe nela e me explique, em linguagem simples, o que você encontrou. Não crie nem altere nenhum arquivo ainda. Depois, proponha o primeiro passo mais sensato para começar um painel para anotar pedidos de uma gráfica, e me pergunte o que você precisa saber antes.

A resposta deve se parecer com a de um profissional novo na equipe: olha o ambiente, explica o que viu e pergunta antes de agir. Se ele sair criando arquivos, interrompa e diga que você pediu apenas para olhar e propor. Essa conduta é a que você vai querer sempre.

Como pensar na ferramenta

A mudança de postura é o centro de tudo. Você não vai aprender a programar. Vai aprender a gerenciar: pedir com clareza, exigir perguntas antes da execução, manter uma lista do que falta, conferir de verdade e proteger o que já funciona. Nenhuma dessas habilidades exige saber código, e você provavelmente já usa todas no seu trabalho.

Quer ir além do primeiro passo?

O guia “Equipe de IA sem programar” organiza esse caminho em capítulos curtos, com pedidos prontos e um projeto de exemplo do começo ao fim. É independente e não oficial, e o convite é só isso: se quiser conhecer, o botão está abaixo.