O Claude Code é o assistente de programação com IA da Anthropic que roda no terminal e trabalha direto dentro do seu projeto: ele lê os arquivos, edita o código, roda comandos, executa testes e faz commits — tudo conversando com você em linguagem natural. Em vez de copiar e colar trechos de código no chat do Claude, você aponta o Claude Code para a pasta do projeto e pede: “corrige esse bug”, “escreve o teste dessa função”, “refatora esse módulo”. Ele responde com um plano, mostra o diff e aplica só o que você aprovar.
Este guia é para quem nunca usou: o que é, como instalar, os primeiros comandos, quanto custa e os erros mais comuns de iniciante — em português, sem pressupor que você já sabe programar com IA.
Resposta rápida: o Claude Code resolve cada problema como
| Problema | Como o Claude Code resolve | Sem ele, você faria |
|---|---|---|
| “Não sei onde está o bug” | Ele navega pelo repositório, lê os arquivos relevantes e aponta a causa | Caçar arquivos manualmente e colar trechos no chat |
| “Preciso de um teste para essa função” | Ele escreve o teste e roda para verificar se passa | Escrever à mão e rodar sozinho |
| “Esse erro de build não faz sentido” | Ele lê o log, identifica a causa e propõe a correção | Pesquisar o erro no Google e montar o contexto à mão |
| “Refatorar dá medo de quebrar tudo” | Ele mostra o diff antes de aplicar e roda os testes depois | Refatorar à mão e torcer |
| “Documentar esse projeto está parado há meses” | Ele gera e atualiza a documentação a partir do código real | Adiar |
A diferença central: no chat você leva o código até a IA; no Claude Code a IA mora no seu projeto.
O que é o Claude Code, exatamente
O Claude Code é uma interface de linha de comando (CLI): um programa que você instala e executa dentro da pasta do seu projeto. Por baixo, ele usa os modelos Claude da Anthropic — os mesmos do claude.ai — mas com três capacidades que o chat não tem:
- Acesso ao repositório inteiro. Ele enxerga a árvore de arquivos, abre o que precisa e mantém o contexto do projeto entre as suas perguntas.
- Execução de ações. Ele edita arquivos, roda comandos (testes, build, git) e propõe commits. Cada ação sensível passa pela sua aprovação antes de rodar.
- Memória de projeto. Um arquivo
CLAUDE.mdna raiz guarda as convenções do seu time — estilo de código, comandos padrão, o que nunca tocar. O Claude Code lê esse arquivo no início de cada sessão. (É o mesmo princípio das Claude Skills: instruções versionadas que ensinam o assistente a trabalhar do seu jeito.)
Ele não é um editor: você continua usando o VS Code, o Neovim ou o que preferir. O Claude Code é o par que trabalha ao lado, no terminal.
Requisitos e como instalar
O que você precisa antes de começar:
- Um sistema suportado: macOS 13+, Windows 10 1809+ (ou Windows Server 2019+), Ubuntu 20.04+, Debian 10+ ou Alpine 3.19+; 4 GB de RAM ou mais e conexão com a internet (o modelo roda na nuvem da Anthropic).
- Uma conta Anthropic: assinatura do Claude (Pro ou Max) ou uma chave de API do Anthropic Console, com créditos pré-pagos.
A instalação recomendada é o instalador nativo, em um comando no terminal:
# macOS, Linux e WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
Quem prefere npm também pode instalar pelo Node.js (18 ou superior):
npm install -g @anthropic-ai/claude-code
(No npm, evite rodar com sudo — a própria documentação alerta que isso causa problemas de permissão.)
Depois de instalar, entre na pasta do projeto e inicie:
cd meu-projeto
claude
Na primeira execução, ele abre o navegador para você fazer login com a conta Anthropic. Pronto — você está numa sessão do Claude Code dentro do projeto.
Dica de primeiro passo: rode /init. Ele analisa o repositório e cria o CLAUDE.md com um resumo do projeto, os comandos de build/teste e as convenções que detectou. Esse arquivo economiza minutos de explicação em toda sessão futura.
Primeira sessão: como usar sem medo
O fluxo básico de uma tarefa no Claude Code:
- Peça em português, do jeito que falaria para um colega. Exemplo: “a página de checkout está quebrando no mobile, descobre o que aconteceu e corrige”.
- Leia o plano. Para tarefas grandes, ele costuma propor um plano antes de mexer. Você pode pedir explicitamente: “me mostra o plano antes de editar”.
- Aprove cada mudança. Por padrão, toda edição de arquivo e todo comando passam pela sua confirmação. Leia o diff — aprovar sem ler é o erro nº 1 de iniciante.
- Verifique com testes. Peça: “roda os testes e me mostra o resultado”. Ele executa e interpreta a saída.
- Feche o ciclo com commit. Se estiver bom: “faz o commit disso”. Ele escreve a mensagem e commita.
Comece com tarefas pequenas e verificáveis (um teste, um bug pontual, uma função isolada) e vá aumentando o escopo conforme você aprende a confiar — e a conferir.
Comandos e atalhos essenciais
Dentro da sessão, os comandos mais usados começam com barra:
| Comando | O que faz |
|---|---|
/help | Lista todos os comandos disponíveis |
/init | Cria o CLAUDE.md a partir da análise do projeto |
/model | Troca o modelo Claude usado na sessão |
/compact | Comprime o histórico da conversa quando o contexto fica longo |
/clear | Limpa a sessão para começar uma tarefa nova do zero |
/cost | Mostra quanto a sessão consumiu de uso |
Dois atalhos que valem decorar:
- Shift+Tab alterna o modo de aprovação (incluindo o modo de plano, em que ele só planeja sem editar).
claude -p "sua pergunta"roda uma pergunta pontual sem abrir a sessão interativa — útil em scripts.
E o básico de terminal vale: claude na pasta do projeto abre a sessão; Ctrl+C duas vezes encerra.
Quanto custa o Claude Code
O Claude Code em si não tem preço separado — você paga pela conta que o alimenta:
- Com assinatura Claude Pro ou Max, o uso do Claude Code está incluído no plano, dentro dos limites de uso. É o caminho mais simples para quem já assina.
- Com chave de API, você paga por token consumido, pré-pago. Compensa para uso leve, scripts e automações.
Preparamos um comparativo completo dos planos e do custo da API em reais, com cálculo de quando a API sai mais barata que a assinatura: Quanto custa o Claude no Brasil.
Claude Code vs Claude no navegador: quando usar cada um
| Situação | Melhor ferramenta |
|---|---|
| Escrever um e-mail, resumir um PDF, brainstorm | Chat no navegador |
| Explicar um trecho de código colado no chat | Chat no navegador |
| Corrigir bug em um projeto com dezenas de arquivos | Claude Code |
| Rodar testes e iterar até passar | Claude Code |
| Fazer refactor com revisão de diff | Claude Code |
| Automatizar tarefa de código em script | Claude Code (claude -p) |
Regra prática: se a tarefa precisa enxergar o projeto ou executar algo, é Claude Code. Se é uma conversa sobre conteúdo, o chat resolve.
Claude Code e OpenClaw: quem cuida do quê
O Claude Code é uma ferramenta de código, por sessão: você abre o terminal, trabalha, fecha. O OpenClaw é o assistente local sempre ligado, com canais como WhatsApp, Telegram e Slack, automações agendadas e escolha de modelo — inclusive modelos Claude.
Eles se complementam:
- No código, o Claude Code é imbatível como par de terminal.
- Na operação do dia a dia — triagem de mensagens, briefing matinal, entrega automática de produtos digitais — o OpenClaw roda 24/7 e conversa com você pelo WhatsApp.
- No meio, dá para usar as habilidades dos dois: as skills ensinam capacidades ao Claude em qualquer cliente, os plugins do Claude Code estendem a ferramenta de terminal e os hooks disparam ações em eventos.
Se a sua dúvida é “qual dos dois eu adoto”, fizemos um comparativo dedicado: OpenClaw vs Claude Code.
Erros comuns de quem está começando
- Rodar fora da raiz do projeto. Abra o
claudena pasta certa; fora dela, ele não enxerga o repositório. - Aprovar diffs sem ler. A aprovação existe por um motivo. Três segundos de leitura evitam uma hora de rollback.
- Ignorar o
CLAUDE.md. Sem ele, você reexplica as convenções do projeto em toda sessão. - Deixar o contexto crescer sem controle. Sessão longa, respostas piores: use
/compactquando a conversa ficar longa e/clearentre tarefas não relacionadas. - Pedir tarefas gigantes de uma vez. Divida em passos verificáveis. “Corrige o checkout inteiro” rende menos que “corrige a validação do CEP no checkout”.
- Não rodar os testes. O Claude Code executa testes de boa vontade — peça sempre antes do commit.
Perguntas frequentes
O que é o Claude Code?
O Claude Code é o assistente de programação com IA da Anthropic que roda no terminal, dentro da pasta do seu projeto. Ele lê e edita arquivos, executa comandos e testes, cria commits e mantém o contexto do repositório, trabalhando em linguagem natural e com aprovação explícita para cada ação sensível.
O Claude Code é gratuito?
O programa em si é gratuito para instalar, mas o uso consome uma conta Anthropic: assinatura Claude Pro ou Max (uso incluído no plano) ou chave de API cobrada por token, pré-paga. Não existe modo gratuito ilimitado.
Preciso saber programar para usar o Claude Code?
Você não precisa ser dev sênior, mas o mínimo de familiaridade com terminal (entrar em pastas, rodar comandos) e com o seu próprio projeto é essencial — inclusive para avaliar se as mudanças propostas fazem sentido antes de aprovar.
Como instalar o Claude Code no Windows?
Abra o PowerShell e rode irm https://claude.ai/install.ps1 | iex. O Claude Code roda nativamente no Windows 10 1809+ e também via WSL, que é a alternativa quando o projeto depende de ferramentas Linux. No Windows nativo, instalar o Git for Windows é recomendado para habilitar a ferramenta Bash — sem ele, o Claude Code usa o PowerShell para executar comandos.
Qual a diferença entre o Claude Code e o Claude no navegador?
O chat no navegador conversa sobre o que você cola nele; o Claude Code trabalha dentro do projeto: navega pelos arquivos, edita código, roda testes e comandos e faz commits. Use o chat para conversas sobre conteúdo e o Claude Code para trabalho real em um repositório.
Claude Code funciona sem internet?
Não. O programa roda no seu computador, mas o modelo Claude é executado na nuvem da Anthropic — sem conexão, não há geração de resposta.
O Claude Code é open source?
Não. O cliente é distribuído publicamente pela Anthropic, mas não é software livre. Se o seu critério é código aberto de ponta a ponta, alternativas como o OpenClaw (assistente local) e ferramentas da comunidade executam modelos abertos como os disponíveis via Ollama.
Como usar o Claude ou o Claude Code no WhatsApp?
O Claude Code em si não tem canal de mensagens. O caminho para conversar com IA pelo WhatsApp é conectar o modelo a um assistente com canal, como o Claude no WhatsApp com OpenClaw, que usa a API do Claude dentro de um assistente sempre ligado.
Próximo passo
Instale, rode /init e mande a primeira tarefa pequena hoje. Quando quiser ir além do terminal — um assistente que atende no WhatsApp, roda automações agendadas e continua trabalhando com você desligado — comece pelo guia completo do OpenClaw ou pela instalação passo a passo.