IA e Automações · 18 de novembro de 2026 · 6 min
Claude Code para iniciantes: o que é, para que serve e como eu uso no trabalho
O Claude Code é um agente de IA da Anthropic que trabalha dentro das pastas do seu computador. O que faz, se precisa programar e como eu uso na agência.
- O problema
- Você ouviu falar do Claude Code, achou que era ferramenta de programador e não sabe se ele serve para o seu trabalho.
- Para aplicar
- Crie uma pasta com os arquivos de uma tarefa que você repete toda semana, escreva um CLAUDE.md de cinco linhas e peça a tarefa uma vez, aprovando cada passo.
O Claude Code é um agente de IA, feito pela Anthropic, que trabalha dentro das pastas do seu computador. Você pede em português, ele lê os arquivos, escreve, edita e roda comandos, sempre dentro dos limites de permissão que você definiu. A diferença para o chat do Claude está aí: no chat você recebe um texto para copiar; no Claude Code o trabalho acontece no arquivo.
Eu uso o Claude Code todo dia na Kaleidos, e boa parte do que ele faz aqui não tem nada de programação. Ele escreve e revisa peça de conteúdo com a voz de cada marca, organiza a pasta de regras da agência, anota no diário o que foi feito e confere se um site que dizia estar no ar está mesmo. Este texto é para quem achou que era ferramenta de desenvolvedor e quer saber se serve para o seu trabalho.
O que é o Claude Code, na prática?
É um programa que roda no terminal, no app de desktop e dentro de editores como o VS Code. Você abre ele numa pasta, e aquela pasta vira o mundo dele.
Lá dentro ele consegue:
- ler qualquer arquivo da pasta, de planilha exportada a contrato em texto;
- criar e editar arquivos;
- rodar comandos, como buscar uma frase em mil arquivos, converter imagem ou subir um site;
- chamar sistemas externos pelo MCP, como a ferramenta de gestão da agência ou o Gmail.
Antes de agir em algo sensível, ele pede permissão. Dá para deixar mais solto ou mais travado, e essa escolha é a primeira decisão que importa.
Preciso saber programar para usar o Claude Code?
Para começar, não. Ajuda saber o que é uma pasta, um arquivo de texto e um comando de terminal, no nível de "eu sei abrir e colar". O resto se aprende vendo o que ele faz e lendo o que ele mostra antes de agir.
O que ajuda mais que programação é saber descrever trabalho. Quem já escreveu um bom briefing para freelancer tem metade do caminho andado, porque pedir para o Claude Code é briefar um colega que lê muito rápido e não conhece o seu contexto.
Qual a diferença entre o Claude Code e o chat do Claude?
Três diferenças mudam o uso:
- Ele mexe no arquivo. No chat, você copia e cola o resultado. No Claude Code, o resultado já está no lugar.
- Ele lê o contexto sozinho. Em vez de colar o manual da marca toda vez, você deixa o manual numa pasta e ele lê quando precisa.
- Ele lembra entre sessões pelo que está escrito. Um arquivo chamado CLAUDE.md na raiz da pasta é lido no começo de toda conversa, e é ali que moram as regras da casa. Escrevi sobre ele em CLAUDE.md: o que é e o que eu coloco no meu.
Como eu organizei o meu
A pasta onde eu trabalho se chama GOS e tem três divisões que o próprio Claude respeita, porque estão escritas na regra:
vault/: tudo que é texto. Regras, memória, manual de cada cliente, diário.code/: tudo que tem código, como este site, o KAI (o sistema de gestão da agência) e o Ghostmark.media/: vídeo e imagem pesada.
A regra de uma linha que mais me poupou dor de cabeça: nunca apagar, sempre mover. O Claude Code não apaga arquivo na minha máquina. Quando algo precisa sair, vai para uma pasta de arquivo com a data no nome, e errar passa a custar um minuto de volta.
A segunda regra: toda tarefa pedida, começada e terminada vira uma linha no diário do dia, com o nome do projeto. É o que me deixa saber, numa sexta à noite, o que os agentes fizeram durante a semana sem abrir conversa por conversa.
Para que eu uso, além de código
- Conteúdo. Cada marca atendida tem uma skill de voz e uma régua por canal. Peço "carrossel do cliente X sobre Y" e ele carrega as regras certas antes de escrever. Nada vai para o ar sem eu ler.
- Gestão. Pelo MCP, ele cria cards no KAI, onde a agência planeja os posts. Card criado por agente nasce na coluna de ideias e para ali.
- Conferência. Peço para ele abrir o site em produção e confirmar título, link e versão. Aprendi do jeito caro que "subiu" e "está no ar" são frases diferentes.
- Organização. Ele resume o dia no diário, arquiva o que ficou velho e aponta a regra que contradiz outra.
Por onde começar?
- Escolha uma pasta só. Não abra o Claude Code no computador inteiro. Uma pasta de projeto, com os arquivos que importam para uma tarefa.
- Escreva um CLAUDE.md curto. Cinco linhas: o que é a pasta, o que nunca pode acontecer, onde fica cada tipo de arquivo.
- Peça uma tarefa repetida e chata. Renomear cem arquivos, transformar uma transcrição em post, comparar duas versões de um contrato. Tarefa chata mostra o valor rápido.
- Leia o que ele mostra antes de aprovar. No começo, aprove passo a passo. Depois que você conhece o padrão, solta.
Que cuidados tomar?
O erro que eu mais vejo é confiar no relato. O agente diz "pronto, publiquei" e a pessoa acredita. Na minha casa, deploy só conta como feito quando alguém abriu a página de verdade e viu a mudança, e "não publicar nem agendar nada sem o meu OK" está escrito como regra dura, não como pedido educado. Juntei os erros que mais se repetiram em Erros de IA em produção.
O segundo cuidado é com segredo. Senha e chave de API não ficam em arquivo que o agente lê no dia a dia, e a regra manda nunca mostrar valor de segredo na tela.
O que fazer amanhã
Crie uma pasta com os arquivos de uma tarefa que você repete toda semana, escreva um CLAUDE.md de cinco linhas e peça para o Claude Code fazer essa tarefa uma vez, aprovando cada passo. No fim, abra o arquivo que ele mudou e compare com o que você teria feito. Essa comparação te diz se vale continuar.