O Claude Code é uma ferramenta de codificação com inteligência artificial da Anthropic que trabalha no terminal: ele entende o que você pede, lê os arquivos do projeto, edita código e roda comandos, sempre com a sua aprovação. Não é mais um chat que só devolve texto; é um agente que age dentro do seu projeto, com você no comando. Este guia explica, com base na documentação oficial, o que ele é, para quem serve, como instalar, quais são os comandos e recursos principais e por onde começar sem receio. Para aprender tudo isso na prática, do zero ao avançado, com laboratório, projeto final e certificado, use o Curso de Claude Code, que é gratuito. Este material é educativo e independente; não é documentação oficial da Anthropic.
Resposta rápida
- O Claude Code é um agente de IA da Anthropic que roda no terminal (e também no editor, no desktop e no navegador) e trabalha dentro do seu projeto.
- Diferente de um chat, ele age: lê arquivos, edita código e roda comandos, num ciclo, sob a sua aprovação.
- O jeito recomendado de instalar é o instalador nativo (um comando no terminal); depois você inicia com
claudedentro da pasta do projeto. - O acesso exige uma assinatura paga do Claude ou uma chave de API; o plano gratuito do Claude.ai não inclui o Claude Code.
O que é o Claude Code, na prática
Pense na diferença entre um consultor que manda um relatório por e-mail e um profissional que senta ao seu lado, abre os arquivos e faz o trabalho junto com você. O chat de IA é o consultor a distância; o Claude Code é o profissional ao lado. A documentação oficial o define como um agente que lê o seu código, edita arquivos, roda comandos e se integra às suas ferramentas. Ele opera num ciclo simples: entende o pedido, planeja, age com uma ferramenta (ler, editar, rodar um comando), observa o resultado e repete até concluir. A cada passo sensível, ele para e pede a sua aprovação. Entender esse ciclo é o que torna você um bom piloto da ferramenta.
Chat, autocomplete e agente: três coisas diferentes
Vale separar três categorias que costumam ser confundidas. Um chat de IA, como o site do ChatGPT ou do Claude, responde perguntas e devolve texto ou código para você copiar. Um autocomplete no editor, no estilo clássico do GitHub Copilot, sugere a próxima linha enquanto você digita. Um agente, como o Claude Code, resolve tarefas inteiras: abre o arquivo certo, aplica a mudança, roda os testes e mostra se funcionou. A palavra agente esconde essa virada: além de conversar, ele usa ferramentas para agir no seu projeto. Isso muda o tipo de trabalho que você delega e reforça por que a sua revisão continua essencial, porque quem decide e responde pelo resultado é você. Se quiser entender o conceito de agente com calma, o guia como usar inteligência artificial no trabalho ajuda a situar onde cada ferramenta encaixa.
O que o Claude Code faz de verdade
Na conversa do dia a dia, ele lê e edita os arquivos do projeto, roda comandos no terminal (instalar dependências, rodar testes, subir o servidor local), trabalha com git para versionar e comparar mudanças, e entende o projeto inteiro em vez de olhar só o trecho que você colou. Isso abre tarefas que um chat sozinho não resolve bem: encontrar onde um bug mora em dezenas de arquivos, aplicar a mesma correção em vários lugares, escrever testes e rodá-los, ou explicar uma base de código que você acabou de herdar. Para quem está construindo o hábito de versionar o trabalho, o guia como aprender programação do zero dá o pano de fundo que faz o agente render mais.
Para quem é o Claude Code
Serve a mais gente do que parece. Quem já programa ganha velocidade em tarefas repetitivas, refatorações e na leitura de projetos grandes. Quem está começando ganha um tutor paciente, que explica o código e ajuda a construir aos poucos. E quem só tem curiosidade sobre programação com IA tem aqui uma porta de entrada concreta. Em todos os casos, a postura é a mesma: usar o agente para entender e crescer, não para aceitar de olhos fechados. Se o seu objetivo é aprender uma linguagem enquanto usa o agente, combine este guia com como aprender Python do zero e o Curso de Lógica de Programação.
Onde o Claude Code roda
O terminal é a superfície principal, mas não a única. A documentação oficial cita várias formas de usar a mesma ferramenta, para você escolher a que combina com o seu fluxo.
| Superfície | Como funciona |
|---|---|
| Terminal (CLI) | O jeito nativo. Você inicia com o comando claude dentro da pasta do projeto. |
| Editor / IDE | Extensão para o VS Code e plugin para as IDEs da JetBrains (IntelliJ, PyCharm, WebStorm e outras). |
| Aplicativo de desktop | Interface gráfica para quem prefere não usar o terminal, com revisão visual das mudanças. |
| Navegador | Versão na web, sem instalar nada localmente. |
| Automação (CI e SDK) | Integrações como o GitHub Actions e um SDK para construir agentes sob medida. |
Pré-requisitos para instalar
A ferramenta roda no macOS 13 ou mais novo, no Windows 10 (build 1809) ou mais novo e em distribuições Linux como Ubuntu, Debian e Alpine. O recomendado é ter pelo menos 4 GB de RAM, processador x64 ou ARM64 e conexão à internet. No Windows, dá para rodar de forma nativa ou dentro do WSL; o Git para Windows é opcional, mas ajuda o agente a usar o Bash. Se você optar pela instalação por npm, a versão atual pede Node.js 22 ou mais novo. Como esses números mudam com as versões, confira sempre a página oficial de requisitos antes de instalar.
Como instalar o Claude Code
O caminho recomendado na documentação oficial é o instalador nativo, que não depende do Node. No Mac, no Linux ou no WSL, rode este comando no terminal:
curl -fsSL https://claude.ai/install.sh | bashNo Windows, abra o PowerShell e rode:
irm https://claude.ai/install.ps1 | iexQuem prefere um gerenciador de pacotes tem alternativas oficiais: no Mac, brew install --cask claude-code; no Windows, winget install Anthropic.ClaudeCode. E, se você já vive no ecossistema Node, também existe a instalação por npm (que exige Node.js 22 ou mais novo):
npm install -g @anthropic-ai/claude-codeNão use sudo com o npm global, porque isso costuma causar problemas de permissão. O instalador nativo tem uma vantagem prática: ele se atualiza sozinho em segundo plano, enquanto Homebrew, WinGet e npm pedem atualização manual.
Autenticar e iniciar a primeira sessão
Depois de instalar, o passo que muita gente pula é o mais importante: abrir o terminal já dentro da pasta do projeto e iniciar o agente ali, para ele enxergar os arquivos certos. Para começar, rode:
claudeNa primeira vez, ele abre o navegador para você entrar com a sua conta. O acesso exige uma assinatura paga (Pro, Max, Team ou Enterprise) ou uma conta do Console com créditos de API; o plano gratuito do Claude.ai não libera o Claude Code. Para conferir se a instalação está sã, use claude --version e claude doctor, que mostra um diagnóstico sem iniciar uma sessão. A partir daí, comece pequeno: peça um resumo do projeto, faça uma pergunta sobre um arquivo, proponha uma mudança simples que você consiga revisar.
Os comandos slash principais
Dentro da sessão, você conversa em linguagem natural, mas alguns comandos que começam com barra dão atalhos úteis. A tabela abaixo reúne comandos citados na referência oficial. A lista completa muda com as versões, então rode /help para ver o que está disponível na sua.
| Comando | Para que serve |
|---|---|
/help | Lista os comandos disponíveis. |
/init | Gera um CLAUDE.md inicial com o contexto do projeto. |
/clear | Limpa a conversa e começa uma sessão nova. |
/compact | Resume a conversa longa para liberar espaço de contexto. |
/model | Troca o modelo de IA usado na sessão. |
/permissions | Ajusta o que o agente pode fazer sozinho. |
/mcp | Gerencia as conexões com ferramentas externas (MCP). |
/config | Abre as configurações da ferramenta. |
/doctor | Mostra um diagnóstico da instalação e das configurações. |
CLAUDE.md: a memória do projeto
O CLAUDE.md é um arquivo de texto onde você deixa por escrito o que o agente precisa saber sobre o projeto: como o código é organizado, quais comandos rodar, o estilo a seguir, o que nunca fazer. O Claude Code lê esse arquivo no começo de cada sessão, então você explica uma vez e para de repetir. Ele pode existir em níveis diferentes: um arquivo pessoal do seu usuário, que vale para todos os seus projetos, e um arquivo dentro do repositório, compartilhado com o time. O comando /init cria um rascunho para você começar. Tratar bem esse arquivo é o que separa uma sessão que erra o alvo de uma que acerta de primeira.
Permissões e segurança desde o começo
Dois hábitos protegem o seu trabalho. O primeiro é entender os modos de permissão: por padrão o agente pergunta antes de editar arquivos e rodar comandos, e você escolhe o quanto de autonomia dar conforme a tarefa, de um modo que só lê até modos mais soltos para tarefas repetitivas de baixo risco. Caminhos sensíveis, como a pasta .git e arquivos de configuração do sistema, não são aprovados de forma automática. O segundo hábito é usar o git desde o início: com cada estado bom virando um commit, você tem uma rede de segurança para voltar atrás se algo der errado. Some a isso a regra de ouro, revisar cada mudança antes de aprovar, e você trabalha com o agente de forma tão ousada quanto segura.
MCP: conectar o agente às suas ferramentas
MCP é a sigla de Model Context Protocol, um padrão aberto para ligar a IA a ferramentas externas. Um servidor MCP funciona como uma ponte: ele dá ao Claude Code acesso a um banco de dados, a um repositório no GitHub, a uma API interna ou a outros serviços, para que o agente consulte e use esses recursos enquanto trabalha. Em vez de você copiar e colar dados na conversa, o agente enxerga a ferramenta diretamente. Você conecta só o que faz sentido e mantém o controle sobre o que ele pode acessar.
Subagentes e paralelismo
Subagentes são assistentes especializados que cuidam de um tipo de tarefa sem entupir a sua conversa principal com resultados de busca, logs ou conteúdo de arquivos. Cada subagente roda no próprio contexto, com um conjunto próprio de instruções, de ferramentas e de permissões. Isso ajuda em tarefas grandes: enquanto um subagente vasculha o projeto atrás de algo, a conversa principal continua limpa e focada no seu objetivo. É um recurso mais avançado, que faz mais sentido depois que você já pegou o básico da conversa com o agente.
Hooks: automação determinística
Hooks são comandos que você define para rodar em momentos específicos do trabalho do agente, por exemplo depois de cada edição de arquivo. Eles dão controle previsível: em vez de torcer para o modelo lembrar de formatar o código ou rodar um teste, o hook garante que aquilo sempre aconteça. Serve para formatar automaticamente, validar comandos, enviar avisos ou impor regras do projeto. Como os hooks executam comandos no seu sistema, use com cuidado e só com scripts em que você confia.
Claude Code, Copilot, Cursor e ChatGPT: o que cada um é
Essas ferramentas resolvem problemas parecidos de formas diferentes, e muita gente usa mais de uma. A comparação abaixo olha o que cada uma fundamentalmente é, sem entrar em recursos que mudam a cada mês. Confira cada produto antes de decidir.
| Ferramenta | O que é | Onde vive |
|---|---|---|
| Claude Code (Anthropic) | Agente que age no projeto: lê, edita, roda comandos e usa git. | Terminal, editor, desktop e navegador. |
| GitHub Copilot | Começou como autocomplete de código; hoje tem chat e modos de agente. | Dentro do editor (VS Code e outros) e do GitHub. |
| Cursor | Um editor de código com IA embutida por padrão. | O próprio editor (aplicativo). |
| ChatGPT (OpenAI) | Chat de propósito geral; devolve texto e código para você usar. | Site e aplicativo de chat. |
Se o seu interesse for o chat de propósito geral, o guia como usar o ChatGPT e o Curso de ChatGPT cobrem esse lado. Para aplicar IA no seu negócio, veja o Curso de Inteligência Artificial para Pequenos Negócios.
Quais modelos o Claude Code usa
O Claude Code roda sobre os modelos Claude, da Anthropic, organizados em linhas com objetivos diferentes: modelos mais potentes para raciocínio pesado e modelos mais rápidos e baratos para tarefas simples. Você troca o modelo da sessão com o comando /model. Como os nomes e as versões dos modelos mudam com frequência, este guia não crava versões: confira a opção /model na sua sessão ou a documentação oficial para ver quais estão disponíveis hoje e qual é o padrão.
Boas práticas de quem usa bem
Alguns hábitos separam quem só brinca de quem produz. Dê contexto: um bom CLAUDE.md e um pedido claro valem mais que dez tentativas vagas. Peça tarefas pequenas e verificáveis, em vez de um pedido gigante de uma vez. Revise sempre o diff antes de aprovar, do jeito que você revisaria o trabalho de um colega. Use git como rede de segurança e faça commits frequentes. E rode os seus testes; o agente pode escrever e rodar testes, mas quem confere se o resultado presta é você. Trate o Claude Code como um parceiro rápido que precisa de direção, não como um oráculo.
Erros comuns de quem está começando
O primeiro erro é iniciar o agente fora da pasta do projeto, o que o deixa sem enxergar os arquivos certos. O segundo é aprovar tudo no automático sem ler o que mudou, o que cedo ou tarde vira retrabalho. O terceiro é pedir demais de uma vez, uma tarefa enorme sem passos, e depois não entender o que ele fez. O quarto é não usar git, ficando sem como voltar atrás. E o quinto é esperar que ele acerte adivinhando: sem contexto no CLAUDE.md e sem um pedido claro, o resultado sai genérico. Corrigir esses cinco pontos já melhora muito a experiência.
Casos de uso reais
Na prática, o Claude Code aparece em tarefas concretas: entender um projeto que você acabou de herdar, pedindo um mapa dos arquivos e do fluxo principal; caçar e corrigir um bug que se espalha por vários arquivos; escrever testes para um trecho que estava sem cobertura; renomear ou reorganizar código com segurança; automatizar um passo chato do dia a dia; e aprender, pedindo que ele explique por que um trecho funciona daquele jeito. Nenhum desses casos dispensa a sua revisão, mas todos economizam o tempo que iria embora em tarefa mecânica.
Privacidade e o que o agente acessa
O Claude Code trabalha com os arquivos da pasta em que você o inicia e executa comandos que você aprova, então dá para limitar o alcance dele escolhendo bem onde rodar e o que permitir. Servidores MCP só acessam o que você conectar. Como qualquer ferramenta que roda comandos, ele merece os mesmos cuidados de sempre: não deixe credenciais soltas no projeto, revise o que ele propõe e use os modos de permissão a seu favor. Para as regras gerais de proteção de dados no Brasil, o guia o que é a LGPD, guia básico dá o panorama.
Limitações
O Claude Code acelera o trabalho, mas não substitui o seu julgamento. Ele pode errar, escrever código que parece certo mas não é, ou seguir por um caminho que você não queria; por isso a revisão do diff é obrigatória, não opcional. Ele não garante emprego, salário nem que o seu projeto vá dar certo, e este guia não faz nenhuma dessas promessas. Detalhes de comandos, preços e modelos mudam com frequência, então trate os exemplos aqui como um retrato do momento e confirme sempre na documentação oficial. Este material é educativo e independente, não é conteúdo oficial da Anthropic.
Fontes oficiais
Para conferir os fatos e acompanhar as mudanças na fonte primária:
- Documentação do Claude Code, visão geral (code.claude.com)
- Documentação do Claude Code, instalação e requisitos
- Anthropic, empresa que desenvolve o Claude e o Claude Code
Conclusão
O Claude Code é um agente de IA que trabalha dentro do seu projeto: lê, edita, roda comandos e usa git, sempre com a sua aprovação. Comece com o instalador nativo, inicie com claude dentro da pasta certa, dê contexto pelo CLAUDE.md, ajuste as permissões e revise cada mudança. Com esses hábitos, a ferramenta vira um parceiro rápido e seguro. Para dominar tudo isso na prática, do zero ao avançado, faça o Curso de Claude Code do ValorFinal, que leva você da primeira conversa até subagentes, MCP, hooks e automação, com jogos, diagramas, exame e certificado, sem custo. Veja também todos os cursos gratuitos, o guia o que é um algoritmo, o Curso de Informática Básica, a categoria de ferramentas de tecnologia e a página sobre como validamos os conteúdos.