Claude Code: o que é, como funciona e o que dá para fazer com ele

O nome Claude Code confunde. “Code” faz parecer ferramenta só de programador. Na prática, ele trabalha com qualquer arquivo de uma pasta: código, planilhas, textos, PDFs e páginas web.

Trabalho com internet há mais de 25 anos e uso o Claude Code todos os dias, num notebook comum com Windows 11 e 16 GB de memória. Uso a ferramenta em sistemas de clientes que estão no ar, como um CRM com IA para uma indústria do segmento de acústica e uma calculadora de aquecimento de piscina com dados do INMET.

O que é o Claude Code?

O Claude Code é uma ferramenta de IA da Anthropic, a empresa que cria o Claude. A documentação oficial o define como uma ferramenta de programação agêntica, que lê o seu projeto, edita arquivos, roda comandos e se conecta às suas ferramentas de trabalho.

Agêntica quer dizer que ele executa várias etapas seguidas, em vez de só responder. Você descreve o que quer, em português comum, e ele faz o caminho até o resultado.

Dois pedidos mostram o alcance:

• Para quem programa: “Escreva os testes do módulo de login, rode e corrija o que falhar.”
• Para quem não programa: “Junte as planilhas de vendas do semestre, some o total por mês e crie um gráfico.” Ele escreve um pequeno programa para a conta, roda e salva o resultado. Como a conta sai de código, cada número pode ser conferido.

No treinamento que dou, resumo assim: se uma tarefa passa por arquivos no computador, ela pode ser delegada.

Como o Claude Code funciona?

Ele trabalha em ciclo. A Anthropic descreve três fases que se misturam: reunir contexto, agir e conferir o resultado. Eu divido em quatro passos, porque fica mais fácil de acompanhar na tela:

1. Entende: lê o pedido e os arquivos que importam para a tarefa.
2. Planeja: divide o trabalho em etapas.
3. Executa: cria e edita arquivos, roda comandos e pesquisa na web.
4. Confere: testa o resultado e, se algo falhou, corrige e repete.

Uma pergunta sobre o projeto pode parar no primeiro passo. A correção de um erro passa pelo ciclo várias vezes, e cada volta usa o que ele descobriu na anterior.

Você continua no controle de três jeitos:

• Modos de permissão. No modo Plano, ele pesquisa e propõe um plano sem alterar os arquivos. No Manual, pede aprovação antes de editar arquivos e rodar comandos. No Aceitar edições, edita sem perguntar a cada vez. No Auto, um segundo modelo revisa as ações e bloqueia as arriscadas. O modo inicial varia, então olhe o seletor antes do primeiro pedido.
• Interrupção. A tecla Esc para o trabalho na hora, e uma correção digitada no meio do caminho muda o rumo no passo seguinte.
• Pontos de restauração. Antes de editar um arquivo, ele guarda o conteúdo anterior. Apertar Esc duas vezes devolve os arquivos a um estado anterior.

A regra que passo no treinamento: comece no modo Plano, leia a proposta e só então libere a execução, sempre com cópias dos arquivos importantes.

Onde dá para usar o Claude Code?

O mesmo motor aparece em várias portas, e o CLAUDE.md, as configurações e as conexões valem em todas:

• Terminal: a versão mais completa, para quem programa. Instala com um comando no macOS, no Linux ou no PowerShell do Windows.
• App desktop do Claude, aba Code: a porta de entrada de quem não programa. Tem versão para Windows e macOS, e para Linux em beta. Já traz o Claude Code e exige um plano pago.
• Editores: extensão para VS Code (que também funciona no Cursor) e plugin para os editores JetBrains, que pede o Claude Code instalado no terminal.
• Navegador, em claude.ai/code: roda na nuvem, sem instalar nada, a partir de um repositório. Também abre no app do Claude para celular.
• Slack: você menciona @Claude num canal com o pedido e recebe o trabalho de volta, a partir de um repositório do GitHub conectado.

No meu computador, o Claude Code roda na extensão do VS Code, com o app desktop do Claude aberto ao lado. Para quem não programa, o caminho mais curto é o app desktop: entrar com um plano pago, clicar na aba Code e escolher a pasta. O passo a passo da primeira hora está no guia Claude Code para quem não programa.

Qual a diferença entre o chat do Claude e o Claude Code?

Os dois usam os mesmos modelos. O chat responde numa janela de conversa: você lê a sugestão, copia e cola onde precisa. O Claude Code trabalha nos seus arquivos: ele mesmo cria e altera o que for preciso e pede a sua aprovação nas ações importantes.

Se a tarefa cabe numa resposta, como revisar um e-mail ou explicar um conceito, o chat resolve. Se ela envolve abrir vários arquivos, alterar e salvar, o Claude Code poupa o copia e cola. A comparação completa está em qual a diferença do Claude para o Claude Code.

Quais recursos do Claude Code vale conhecer?

Cada sessão começa do zero: o Claude Code não lembra da conversa anterior. Dois recursos levam o que importa de uma sessão para a outra. O CLAUDE.md é um arquivo de texto que você escreve com as regras do projeto, lido no começo de toda sessão. A memória automática são notas que o próprio Claude grava a partir das suas correções e preferências.

Os outros recursos ampliam o que ele faz. Uma imagem do dia a dia ajuda a lembrar de cada um:

Recurso	O que é	Exemplo
CLAUDE.md	O manual da casa: regras que valem em toda sessão	“Nunca cite preço de serviço nos artigos”
Memória automática	Anotações que ele faz sozinho entre sessões	Lembrar que você prefere datas no formato brasileiro
Skills	Receitas reutilizáveis, chamadas por um comando	Transformar um roteiro em carrossel para o Instagram
Subagentes	Colegas especialistas, cada um com o próprio contexto	Auditar dez páginas do site em paralelo
MCP	A tomada que liga o Claude a outras ferramentas	Ler o briefing que está no Google Drive
Hooks	O alarme que dispara sempre no mesmo momento	Conferir os links depois de cada edição
Plugins	A caixa que embala tudo isso para outra pessoa instalar	O kit de skills e regras da agência para a equipe

Dois exemplos da tabela são do meu dia a dia: o CLAUDE.md deste blog diz que nenhum artigo cita o preço dos meus serviços e que todo artigo traz pelo menos uma prova minha, e a skill de carrossel monta as imagens nas cores da marca.

A ordem de adoção que recomendo é a mesma que a Anthropic sugere. Comece pelo CLAUDE.md: quando ele erra a mesma convenção duas vezes, ela vai para o arquivo. Depois, crie skills para as tarefas que se repetem e conecte outras ferramentas pelo MCP quando precisar delas. Subagentes, hooks e plugins vêm com a prática.

Vale saber o limite do CLAUDE.md: o Claude trata o arquivo como contexto e tenta seguir, sem garantia. A própria Anthropic dá o exemplo: “nunca edite o arquivo .env” escrito no CLAUDE.md é um pedido, e um hook que bloqueia a edição é uma garantia. Regra que precisa valer sempre vira hook.

O que dá para fazer com o Claude Code?

Se você programa, ele assume as tarefas que costumam ficar para depois: testes para código sem cobertura, erros de lint, conflitos de merge, dependências desatualizadas e notas de versão. Também constrói funcionalidades a partir de uma descrição, rastreia bugs a partir da mensagem de erro, faz commits e abre pull requests. Tarefas recorrentes viram rotinas agendadas na nuvem, que rodam com o computador desligado.

Se você não programa, as tarefas mais comuns cabem em seis grupos:

• Renomear e separar centenas de arquivos por um padrão.
• Juntar planilhas, limpar os dados e gerar gráficos.
• Resumir PDFs e montar relatórios padrão.
• Criar uma página simples: landing page, página de evento ou portfólio.
• Rodar uma rotina, como um resumo diário ou um relatório toda segunda-feira.
• Pesquisar na web e reunir o resultado num arquivo.

Um critério ajuda a escolher a primeira tarefa: ela envolve arquivos, se repete e você consegue descrever o resultado esperado.

No meu trabalho, as duas listas se misturam. Além do blog, do site e da página de vendas, feitos em Astro e publicados no Cloudflare Pages, mantenho com o Claude Code os scripts que falam com as APIs do Google Ads e da Meta. Eles criam as campanhas pausadas e puxam os relatórios. Nenhuma campanha vai ao ar antes de eu revisar no painel.

Quanto custa o Claude Code e qual modelo usar?

O plano gratuito do Claude não inclui o Claude Code. Ele vem em todos os planos pagos: Pro, Max, Team e Enterprise. Outra porta é a conta de API da Anthropic, em que você paga pelo que usar. Os valores mudam e ficam em claude.com/pricing.

Nos planos, o limite de uso é um só: o que você gasta no Claude Code sai da mesma cota das conversas no chat. Ao chegar no limite, dá para esperar a renovação, mudar de plano ou ativar créditos de uso extra, cobrados pelo preço da API. A conta detalhada está em quanto custa o Claude Code, e as dúvidas sobre uso grátis, em o Claude Code é gratuito?

O Claude Code usa os modelos do Claude, e o comando /model troca de um para outro:

• Haiku: o mais rápido e econômico, para tarefas simples.
• Sonnet: para o trabalho do dia a dia.
• Opus: raciocínio mais forte. O Opus 5.5 é o padrão nos planos pagos.
• Fable: para as tarefas mais difíceis e longas.

Quanto mais capaz o modelo, mais ele consome do seu limite. Na dúvida, comece no padrão e só troque se sentir necessidade.

Quais são os limites e os cuidados?

Ele erra. O Claude Code confere o próprio trabalho, mas pode entender o pedido de outro jeito ou entregar algo que parece certo e não está. Tudo o que vai para cliente, paciente ou produção passa pelos seus olhos antes.

Desfazer tem limite. Os pontos de restauração cobrem as edições de arquivos. Ações que saem do seu computador, como publicar um site, alterar um banco de dados ou chamar uma API, não voltam com Esc. Para elas valem o modo de permissão e a sua aprovação.

Chaves e dados sensíveis. Senha e chave de acesso nunca entram num pedido. No meu repositório, todas as chaves (Google Ads, Meta e sites) ficam num único arquivo .env, que não vai para o GitHub e não aparece em gravação de tela. Dados de clientes seguem a LGPD e a política da empresa.

Conteúdo de terceiros. Uma página da web ou uma mensagem que ele lê pode trazer instruções escondidas. A documentação do Claude Code no Slack avisa que ele pode seguir orientações de outras mensagens e recomenda usá-lo só em conversas de confiança.

Erros de ambiente. Um dia, o Claude parou de responder no VS Code com uma mensagem sobre firewall e proxy, enquanto o app funcionava no mesmo computador. A causa eram duas configurações do Windows esquecidas de uma instalação antiga: a mensagem mostrava onde o problema aparecia, e a causa estava em outro lugar. Contei como resolvi em o erro ECONNREFUSED no Claude Code.

Onde aprender Claude Code?

A Anthropic oferece o Claude Code 101 de graça na Claude Academy: 12 aulas, cerca de uma hora e meia, em inglês. Os exercícios pedem uma conta Pro, Max ou Enterprise, ou uma chave de API, e o curso pressupõe familiaridade com editor de código e linha de comando.

Para quem não programa, dou o treinamento ao vivo Claude Code para Iniciantes, às terças-feiras, com o app desktop e um exercício prático na pasta de arquivos de cada aluno. Ele é a Fase 1 da Série Claude Code, que segue com dois treinamentos para quem quer ir além: decidir a stack do primeiro sistema e construí-lo. As opções estão comparadas no artigo sobre curso de Claude Code.

O próximo passo depende do seu caso:

• Não programa e quer começar: Claude Code para quem não programa.
• Programa e está entre o Claude Code e a ferramenta da OpenAI: Claude Code vs Codex.

Para a primeira semana, escolha a tarefa mais repetitiva que você tem e entregue ao Claude Code numa pasta de cópias, no modo Plano.