Pular para o conteúdo
Inteligência Artificial

Claude Code: o que é e como usar além de programar

Claude Code é um agente de IA que trabalha nos arquivos do seu projeto. Veja o que é, como instalar, quanto custa e como usar além de programar.

Braço robótico saindo de um console em ciano e reorganizando pastas flutuantes, guiado por um trilho amarelo dourado
Leitura
14 min
Seções
08
Publicado
Sumário · 8 seções0% lido

O Claude Code é um agente de IA no terminal, feito pela Anthropic, que trabalha dentro de uma pasta de projeto: lê os arquivos, roda comandos e edita o que for preciso para concluir a tarefa que você descreveu. Programar é o uso mais comum, mas o mesmo mecanismo serve para qualquer trabalho que viva em arquivos de texto e comandos, como conteúdo, roteiros e automações.

Se você já usa IA no chat, muda o lugar onde o trabalho acontece. No chat, você copia o contexto para a conversa e cola a resposta de volta no projeto. No Claude Code, o agente já está dentro do projeto, enxerga os arquivos e aplica as mudanças direto neles, com você revisando.

Este artigo é a visão geral. Ele explica o que é a ferramenta, mostra usos fora do código (incluindo como o próprio williandsantos.com funciona), indica como instalar, comenta o custo e lista os riscos. No fim, há um passo a passo para começar ainda esta semana.

O que é o Claude Code e como ele difere do Claude no chat?

O Claude Code é uma ferramenta agêntica: você dá um objetivo em linguagem natural e o agente decide quais arquivos ler, quais comandos rodar e quais edições fazer. Segundo a documentação da Anthropic, ele entende a base de código inteira e atua em vários arquivos e ferramentas para concluir a tarefa. Roda no terminal, mas também existe em extensões de IDE (VS Code e JetBrains), no aplicativo de desktop e na web.

Qual é a diferença prática em relação ao chat?

No chat, o modelo só conhece o que você colou na conversa. Você escolhe o trecho, descreve o cenário, recebe a resposta e leva o resultado de volta para o projeto. O transporte fica por sua conta.

No Claude Code, o Contexto vem do próprio projeto. O agente abre os arquivos de que precisa, procura onde algo é usado, roda o teste ou o script e vê o resultado. Se a primeira tentativa falha, ele lê o erro e tenta de novo, sem você precisar colar a mensagem de erro em lugar nenhum.

Isso também significa que o agente age, e não só sugere. Ele cria, altera e apaga arquivos, e pode executar comandos na sua máquina. Por isso o controle de permissões e a revisão pesam tanto (mais sobre isso nas seções de limites).

Como é o loop de trabalho?

O ciclo é sempre o mesmo:

  1. Você descreve a tarefa, com o resultado esperado.
  2. O agente lê o que precisa, propõe um plano e executa as mudanças.
  3. Você revisa o que ele alterou e aprova, corrige ou pede ajuste.
  4. Quando o resultado está bom, você fecha com um commit.

O passo 3 é onde você continua no comando. O Claude Code rende mais quando executa e mostra o trabalho. Entregar o projeto a ele e esquecer não funciona.

Por que isso muda o tipo de tarefa que cabe numa conversa com IA?

No chat, cabem tarefas do tamanho da janela de uma conversa: explicar um trecho, rascunhar um texto, sugerir uma abordagem. Com um agente dentro da pasta, cabem tarefas que dependem de vários arquivos e de verificar o resultado: renomear algo em cinquenta lugares, gerar um lote de arquivos a partir de um modelo, rodar um script e corrigir o que quebrou.

A pergunta deixa de ser "o que eu colo no chat?" e passa a ser "que trabalho eu consigo descrever e verificar?". Para quem quer ganhar tempo de verdade, a segunda é a pergunta mais útil.

Para que serve o Claude Code além de programar?

Serve para qualquer trabalho que viva em arquivos de texto e comandos. Código é só o caso mais óbvio. Roteiro, artigo, planilha exportada em texto, script de edição de vídeo e configuração de automação são arquivos que um agente pode ler, editar e conferir. Se a ideia é montar um agente próprio para uma rotina, veja como criar o primeiro agente de IA.

A própria Anthropic descreve usos além do código: automatizar tarefas tediosas, criar commits e pull requests, conectar ferramentas externas e personalizar o comportamento do agente com arquivos de instruções. Nos tutoriais, quase não se vê isso aplicado fora do desenvolvimento de software. Os exemplos abaixo vêm do que eu faço no williandsantos.com. Se você quer que esse tipo de trabalho apareça, veja também como construir marca pessoal sendo desenvolvedor.

Como as regras dos agentes ficam num arquivo de instruções?

O repositório do site tem um arquivo de instruções onde ficam as regras permanentes dos agentes: tom de voz, estrutura dos artigos, o que nunca fazer, como formatar links. No Claude Code, esse arquivo se chama CLAUDE.md e é lido no início de cada sessão.

A regra deixa de depender da minha memória e do que eu lembro de pedir. Se descubro que o agente erra um padrão, não repito a correção em cada conversa: escrevo uma linha no arquivo e ela vale daí em diante, em qualquer sessão.

Como os artigos do site são planejados e publicados?

Os artigos deste site são planejados por um fluxo com Claude: a pergunta de busca, a estrutura, as fontes e os links internos são definidos antes de o texto existir. O agente trabalha dentro do repositório, então o artigo nasce como arquivo no projeto, no formato que o site espera.

A publicação só acontece depois da aprovação no merge. O agente produz, eu reviso a mudança como reviso qualquer mudança de código, e só entra no site o que eu aprovo. Essa etapa de revisão mantém o fluxo confiável, e é o assunto de revisão humana em automação com IA. Para entender o contexto do projeto, escrevi sobre como este site foi reconstruído.

E a edição de vídeo?

Edição de vídeo parece distante de terminal, mas boa parte dela é repetitiva e dá para descrever como comando: cortar trechos, converter formatos, juntar arquivos, gerar versões em tamanhos diferentes. Quando o trabalho vira scripts e comandos, o agente pode escrevê-los, rodá-los e corrigir o que falhar. Um ponto de partida é transcrever o vídeo com IA no seu computador, para que a edição parta do que foi dito de verdade.

O agente não substitui o olho de quem edita. Ele cuida da parte mecânica, e você decide o corte, o ritmo e o que fica no vídeo final.

Como decidir se uma tarefa é boa candidata a agente?

Uma tarefa é boa candidata quando passa em quatro critérios:

  • Vive em arquivos: o material de entrada e o resultado são arquivos que o agente consegue ler e escrever.
  • É verificável: existe um jeito de checar se deu certo, como um teste, um comando que roda sem erro ou uma regra escrita que você compara com o resultado.
  • É reversível: se der errado, você desfaz com versionamento, sem perder nada.
  • Tem critério escrito: o que é "bom" está descrito, e não só na sua cabeça.

Se a tarefa falha em algum desses pontos, ela ainda pode caber, mas primeiro você precisa resolver o que falta. Para escolher por onde começar, o raciocínio de começar a automação pelo gargalo ajuda: entregue ao agente primeiro a tarefa que mais pesa e que passa nos critérios acima.

Como instalar o Claude Code e começar?

A instalação segue a documentação oficial da Anthropic. Eu recomendo a página oficial no lugar de qualquer tutorial antigo, porque os comandos mudam. Hoje, a documentação descreve o seguinte:

  • Métodos recomendados: script de instalação nativo (macOS, Linux e WSL), PowerShell ou CMD no Windows, Homebrew ou WinGet. A instalação via npm aparece como obsoleta no repositório oficial.
  • Atualizações: as instalações nativas se atualizam sozinhas. As feitas por Homebrew e WinGet precisam de atualização manual.
  • Windows: a documentação recomenda o Git for Windows na instalação nativa.
  • Conta: o uso exige uma assinatura Claude ou uma conta do Console da Anthropic. O login acontece na primeira vez que você abre a ferramenta.

Não reproduzo os comandos aqui de propósito. Copie-os direto da documentação oficial do Claude Code, que sempre reflete a versão atual.

Como abrir a primeira sessão?

Abra o terminal, entre na pasta do projeto e execute o comando claude. No primeiro uso, ele pede o login. Depois disso, você está numa sessão com o agente enxergando aquela pasta.

A escolha da pasta importa. O agente trabalha dentro dela, então comece por um projeto que você conhece e que está sob controle de versão. Assim você sabe se o que ele fez está certo e consegue desfazer o que não estiver.

Qual deve ser a primeira tarefa?

Escolha algo pequeno, reversível e fácil de conferir. Alguns exemplos: pedir que ele explique a estrutura da pasta, corrigir um erro de digitação repetido em vários arquivos ou criar um arquivo novo a partir de um modelo que já existe.

Antes de pedir, confirme que o projeto está com tudo commitado. Depois da tarefa, veja o que mudou com o diff do seu sistema de versionamento. Olhar a diferença antes de aceitar é o hábito mais importante de toda a rotina.

Como criar o arquivo de instruções do projeto?

Crie um arquivo chamado CLAUDE.md na raiz do projeto. Ele guarda as regras permanentes que o agente deve seguir em toda sessão. Não precisa ser longo: comece com 5 a 10 regras claras. Para saber o que vale a pena escrever nele, veja como escrever o CLAUDE.md.

Bons candidatos a regra:

  • Como o projeto é organizado e onde ficam os arquivos principais.
  • Quais comandos rodar para testar ou validar o trabalho.
  • O estilo que o projeto exige (nomes, formatação, tom de texto).
  • O que o agente nunca deve fazer, como apagar uma pasta específica ou mexer em arquivos de configuração sensíveis.

Escreva cada regra de modo que dê para verificar. "Escreva bem" não ajuda. "Títulos de seção em forma de pergunta" ajuda. O arquivo cresce com o uso: cada erro do agente que você corrige duas vezes vira uma linha nova.

Quanto custa usar o Claude Code?

O Claude Code não é uma ferramenta gratuita avulsa. Segundo a Anthropic, o acesso passa por uma assinatura Claude ou por uma conta do Console, e a maioria das opções de uso exige uma das duas. Valores e limites mudam com o tempo, então confirme tudo na página oficial do Claude Code antes de decidir.

Dá para dizer algumas coisas sem depender de número:

  • Existem planos com limites de uso. A página do produto cita, por exemplo, um plano Team por assento mensal, para equipes, e um plano Enterprise com mais controles e análises. Em todos, há limites de uso.
  • Há também o uso por conta de API (Console). Nesse modelo, o gasto acompanha o consumo, em vez de uma mensalidade fixa.
  • O custo varia com o trabalho. Quanto maior o Contexto que o agente precisa ler e quanto mais tarefas você pede, maior o consumo.

Como começar controlando o gasto?

Comece com tarefas pequenas e acompanhe o uso nas primeiras semanas. Pedir uma coisa de cada vez, com escopo claro, gasta menos do que pedir "melhore o projeto". Um arquivo de instruções bem escrito também ajuda: o agente erra menos e refaz menos.

Preços mudam e planos são reorganizados. Qualquer valor que você leia fora da página do fabricante, inclusive neste artigo, serve só como ponto de partida. Confira o número atual antes de contratar.

Quais erros evitar e quais são os limites do Claude Code?

Os erros mais comuns vêm de tratar o agente como alguém que dispensa supervisão. Ele é rápido e competente, mas executa o que entendeu, não o que você pensou.

Quais são os erros mais frequentes?

  • Dar uma tarefa grande e vaga. "Reorganize o projeto" gera mudanças amplas e difíceis de revisar. Quebre em passos pequenos e verificáveis, cada um com um critério claro de pronto.
  • Rodar sem versionamento. Sem commit antes, você não tem como comparar nem desfazer. O controle de versão é a rede de segurança de qualquer sessão com agente.
  • Não revisar o que ele alterou. Aceitar tudo sem olhar o diff é a forma mais rápida de acumular erro. Revise cada mudança, principalmente a que parece óbvia.
  • Liberar permissões amplas sem entender os comandos. O Claude Code deixa você definir o que ele pode fazer. Se você aprova comandos sem saber o que cada um faz, perde o controle. Entenda o comando antes de autorizar.
  • Confiar no resultado sem revisão humana em conteúdo publicado. Texto que vai ao ar precisa de olho humano, porque o agente pode errar fato, tom ou detalhe. É o ponto de revisão humana em automação com IA.

Quando não vale a pena usar?

Em alguns casos o Claude Code não é a ferramenta certa:

  • Tarefas que exigem julgamento de negócio sem critério escrito. Se "bom" só existe na sua cabeça e você não consegue descrever, o agente vai chutar. Escreva o critério primeiro.
  • Ambientes sem como desfazer mudanças. Sem versionamento nem cópia de segurança, o risco de uma edição errada é alto demais para o ganho.
  • Material sensível que você não quer expor. O repositório oficial informa que a ferramenta coleta dados de uso e feedback (como aceitação ou rejeição de código e conversas associadas), com retenção limitada e uma política declarada de não usar esse feedback para treinar modelos. Leia a política e decida se os dados do seu projeto podem passar por ali.

Para pensar o quadro maior, que inclui avaliação e limites claros em qualquer uso de IA, vale ler como montar um sistema de IA confiável.

Na prática: como começar esta semana

  1. Escolha uma pasta de projeto real, com versionamento ativo e tudo commitado.
  2. Instale o Claude Code seguindo a documentação oficial da Anthropic, copiando os comandos da página atual.
  3. Abra o terminal na pasta do projeto, execute o comando claude e faça o login.
  4. Escreva o arquivo CLAUDE.md com 5 a 10 regras do projeto: organização, comandos de teste, estilo e o que nunca fazer.
  5. Peça uma tarefa pequena e reversível, descrevendo o resultado esperado e como conferir.
  6. Revise cada alteração no diff antes de aceitar, e desfaça o que não estiver certo.
  7. Aprove por commit (ou por merge, se trabalhar com pull request) e só então amplie o escopo da próxima tarefa.
  8. Anote o que o agente errou e transforme cada erro repetido numa nova regra no CLAUDE.md.
  9. Acompanhe o uso e o custo nas primeiras semanas, ajustando o tamanho das tarefas.

Perguntas frequentes

Preciso saber programar para usar o Claude Code?

Não é obrigatório, mas ajuda bastante. Você precisa saber abrir o terminal, entrar numa pasta e ler o que o agente alterou. Quanto mais você entende dos arquivos e comandos envolvidos, melhor revisa o trabalho. Para quem não programa, o caminho mais seguro é começar com tarefas de texto e conteúdo, em projetos com versionamento.

O Claude Code substitui o Claude no chat?

Não. Cada um serve a um tipo de trabalho. O chat é bom para pensar, tirar dúvidas e rascunhar sem precisar de arquivos. O Claude Code é melhor quando a tarefa depende do projeto: vários arquivos, comandos para rodar e resultado para verificar. Eu uso os dois, conforme o que preciso no momento.

O Claude Code pode apagar ou estragar meus arquivos?

Pode, porque ele edita e apaga arquivos e executa comandos. Por isso você define as permissões e acompanha o trabalho. Trabalhe sempre com o projeto versionado e commitado, revise o diff antes de aceitar e entenda os comandos antes de autorizá-los. Com essas três práticas, qualquer erro vira algo que você desfaz.

Qual a diferença entre o arquivo de instruções do projeto e um prompt comum?

O prompt vale para aquela conversa. O CLAUDE.md fica no projeto e é lido no início de cada sessão, então as regras valem sempre, sem você repetir. Use o prompt para descrever a tarefa do momento e o arquivo de instruções para o que nunca muda: organização do projeto, comandos de teste, estilo e proibições.

Posso usar o Claude Code em projetos que não são de software?

Sim, desde que o trabalho viva em arquivos e comandos. Conteúdo, roteiros, scripts de edição de vídeo e automações entram nesse grupo, como mostram os exemplos do williandsantos.com. Aplique os mesmos critérios: a tarefa precisa ser verificável, reversível e ter um critério de pronto escrito.

Fontes

// Curso · WDS Builders

Video Builder IA

Você grava o seu vídeo e dirige um agente de IA que transcreve, corta, legenda, anima e renderiza. Nada avança sem a sua aprovação. Do bruto ao vídeo publicado.

Entrar na lista de espera →Ver o canal no YouTube ↗
// PARA APLICAR

Baixar o template de CLAUDE.md e spec para agentes

Acessar →← Voltar ao blog

Projeto e vídeo relacionados

● Em construção

williandsantos.com

Hub editorial da marca pessoal para publicar conteúdo, projetos e aprendizados em construção pública.

Next.jsTypeScriptMDX

Construção Pública · atualizado em

Ver projeto →