#Claude Code: Tutorial Completo para Iniciantes

Este tutorial começa do começo de verdade. Não assume que você sabe o que é um LLM, como funciona o terminal, ou por que alguém programaria usando inteligência artificial. Se você já sabe tudo isso, pule para a Seção 4 e comece a colocar a mão na massa.

Para quem está chegando agora, o caminho é: entender o conceito, instalar a ferramenta, rodar os primeiros comandos e construir algo real. No final, você terá uma página pessoal funcionando no navegador — feita por você, com a ajuda de uma IA.

---

#Parte 1: Entendendo o Terreno

#O que é um LLM?

LLM significa Large Language Model — modelo de linguagem de grande escala. Na prática, é um programa treinado em bilhões de textos da internet: livros, artigos, fóruns, documentação técnica, código-fonte, conversas. Tudo isso.

A analogia mais honesta é a de um autocomplete superinteligente. Quando você digita uma mensagem no celular e ele sugere a próxima palavra, isso é um modelo de linguagem simples. Um LLM faz a mesma coisa — prever a próxima palavra — mas com tanta competência que o resultado parece raciocínio, parece compreensão, parece inteligência.

Parece. Mas não é — pelo menos não da forma como humanos entendem esses conceitos. Um LLM não "pensa" sobre seu problema. Ele calcula qual sequência de palavras tem maior probabilidade de ser útil, dado o texto que você forneceu. A diferença prática é que, quando ele erra, erra de formas que um humano jamais erraria — e com uma confiança inabalável.

Isso importa porque define como você deve usar a ferramenta. Um LLM é extraordinariamente competente para gerar código, explicar conceitos, identificar padrões e sugerir soluções. Mas não é infalível. Verificar o resultado faz parte do processo.

Para dar uma dimensão concreta: os LLMs mais avançados de 2026 foram treinados em datasets com trilhões de tokens. Token é a unidade básica que o modelo processa — grosso modo, uma palavra em inglês equivale a ~1 token, e em português algo entre 1 e 2 tokens por palavra. O volume de texto que esses modelos absorveram é maior do que qualquer ser humano poderia ler em mil vidas.

Esse volume bruto de treinamento é o que permite que um LLM escreva código em dezenas de linguagens, traduza entre idiomas, explique física quântica e redija contratos — tudo com o mesmo modelo. Não porque ele "aprendeu" cada assunto individualmente, mas porque os padrões estatísticos entre palavras capturam uma quantidade surpreendente de estrutura e conhecimento.

#Modelo vs Interface

Um detalhe que confunde muita gente: o modelo (o "cérebro") e a interface (como você acessa esse cérebro) são coisas diferentes.

O Claude é um modelo. Claude.ai é uma interface web para conversar com esse modelo. A API é outra interface — para desenvolvedores conectarem o modelo a seus próprios programas. E o Claude Code é mais uma interface, mas com uma diferença fundamental que muda tudo.

Quando você usa o Claude.ai ou o ChatGPT, a dinâmica é: você pergunta, a IA responde, você copia o resultado e cola onde precisa. É uma conversa. Útil, mas limitada pela fricção de copiar e colar, e pelo fato de que a IA não vê o contexto real do seu projeto.

Claude Code quebra essa dinâmica. Em vez de conversar sobre código, ele trabalha diretamente no código. Lê seus arquivos, entende a estrutura do projeto, edita o que precisa ser editado, roda comandos no terminal, testa se o resultado funciona. Tudo sem que você precise copiar ou colar nada.

A diferença de modelo é a seguinte: usar o ChatGPT ou o Claude.ai é como pedir conselho a um amigo por mensagem. Ele pode dar ótimas ideias, mas você precisa fazer todo o trabalho manual. Usar o Claude Code é como ter um colega sentado ao seu lado, com acesso ao seu computador, que executa as tarefas enquanto você dirige.

#Modelo vs Ferramenta Agêntica

Essa distinção merece mais atenção porque define uma categoria inteira de software.

Ferramentas como ChatGPT e Claude.ai são interfaces conversacionais. Você fala, elas respondem. O fluxo é: humano age, IA reage. Toda ação concreta (salvar arquivo, rodar comando, testar resultado) fica com você.

Ferramentas como Claude Code são agentes. Elas não apenas respondem — elas agem. Um agente pode decidir ler um arquivo para entender o contexto antes de responder. Pode rodar um comando para verificar se o código funciona. Pode editar três arquivos diferentes em sequência para implementar uma mudança. Pode perceber que uma dependência está faltando e instalá-la.

O ponto crucial: um agente toma decisões intermediárias. Você diz "adicione um botão de login nesta página" e ele decide sozinho quais arquivos abrir, o que modificar, qual biblioteca usar e como testar. Você descreve o destino; ele traça a rota.

Isso não significa que o agente sempre acerta. Significa que o tipo de interação é fundamentalmente diferente. Em vez de micro-gerenciar cada passo ("abra este arquivo, vá para a linha 42, mude X para Y"), você trabalha no nível de intenção ("quero que o botão faça isso") e revisa o resultado.

Na prática, isso muda quem precisa saber o quê. Com uma interface conversacional, você precisa saber como fazer algo para poder descrever os passos. Com um agente, basta saber o que você quer. O agente cuida do como. Essa inversão é o que torna ferramentas agênticas acessíveis para quem não tem formação técnica — e é o que torna este tutorial possível.

#O Momento Atual

A evolução foi rápida. Em 2023, a maioria dos desenvolvedores usava IA como chat — perguntava algo e copiava a resposta. Em 2024, editores de código com IA integrada (como Cursor e Copilot) se popularizaram. Em 2025, agentes de terminal como Claude Code mudaram a dinâmica novamente, operando diretamente no código com autonomia crescente.

Em 2026, já existem agentes experimentais que operam com autonomia quase total — o projeto OpenClaw é o exemplo mais visível dessa tendência. Para um panorama completo dessa evolução, vale ler o artigo A Evolução das Ferramentas de IA para Código: Do Chat ao Agente Autônomo.

No cenário atual, Claude Code é a ferramenta agêntica mais popular entre desenvolvedores profissionais. Não porque seja perfeita — tem limitações reais — mas porque acertou o equilíbrio entre autonomia e controle. O agente faz bastante sozinho, mas pede confirmação antes de ações destrutivas. Essa calibragem entre "fazer por você" e "perguntar antes" é o que gera confiança no uso diário.

---

#Parte 2: O Que é Claude Code?

Claude Code é uma ferramenta de linha de comando (CLI) criada pela Anthropic. Roda direto no terminal, usa o modelo Claude como cérebro e funciona como um agente de programação: lê seus arquivos, entende o contexto do projeto, edita código, roda comandos e toma decisões intermediárias sem que você precise guiar cada passo.

#Os números

De acordo com a pesquisa do Pragmatic Engineer, com 906 engenheiros de software entre janeiro e fevereiro de 2026, Claude Code é a ferramenta "mais amada" por 46% dos respondentes. É também responsável por cerca de 4% de todos os commits no GitHub — um número que parece pequeno até você calcular quantos milhões de commits isso representa.

#O que há de novo

A Anthropic tem adicionado funcionalidades em ritmo acelerado. Entre as mais relevantes:

• Remote Control — permite continuar uma sessão do Claude Code rodando no seu computador a partir do celular ou browser, via claude.ai/code. O trabalho continua local — a conexão é apenas de controle remoto.
• Voice Mode — programação por voz, útil para brainstorming e para quem prefere descrever em vez de digitar.
• Agent Teams — múltiplos agentes trabalhando em paralelo no mesmo projeto.
• Auto Mode — o agente opera com autonomia expandida, pedindo menos confirmações.

Cada uma dessas funcionalidades tem implicações práticas, mas para quem está começando, o mais importante é dominar o uso básico primeiro. As funcionalidades avançadas fazem mais sentido quando você já tem o fundamental sólido.

#Como o Claude Code "vê" seu projeto

Um ponto que vale destacar: quando você inicia o Claude Code dentro de uma pasta, ele analisa a estrutura dos arquivos, lê configurações, identifica a linguagem de programação e entende o contexto. Se a pasta tem um package.json, ele sabe que é um projeto JavaScript. Se tem um requirements.txt, sabe que é Python.

Essa leitura de contexto é o que permite dar instruções de alto nível como "adicione autenticação" em vez de especificar cada detalhe técnico. O agente já sabe qual framework está sendo usado, quais bibliotecas estão instaladas e qual é a estrutura do projeto.

#Posicionamento honesto

Claude Code não é a única opção. O Gemini CLI do Google é gratuito e competente. O Copilot da GitHub tem integração profunda com o ecossistema Microsoft. Existem alternativas — e vale explorar antes de se comprometer com um plano pago.

O que diferencia o Claude Code é a qualidade do modelo por trás dele (Claude) e a experiência de uso no terminal. Mas isso é uma avaliação, não um fato absoluto. A melhor ferramenta é a que funciona para o seu fluxo de trabalho.

#Pré-requisitos

Para seguir este tutorial, você precisa de:

• Um computador com macOS, Linux ou Windows
• Acesso ao terminal (Terminal no Mac/Linux, PowerShell ou WSL no Windows)
• Uma conta Anthropic com plano Pro ou superior (a partir de US$ 20/mês)

Não é necessário instalar Node.js. O instalador nativo cuida de tudo.

---

#Parte 3: Instalação

A instalação do Claude Code mudou. Antigamente era necessário ter Node.js instalado e usar o npm. Agora o instalador é nativo — um único comando que baixa, instala e configura tudo automaticamente, incluindo atualizações futuras.

#macOS, Linux e WSL

Abra o terminal e rode:

curl -fsSL https://claude.ai/install.sh | bash

É só isso. O script detecta seu sistema operacional, baixa a versão correta e coloca o executável no path do sistema.

#Windows (PowerShell)

Abra o PowerShell e rode:

irm https://claude.ai/install.ps1 | iex

#Windows (CMD)

Se preferir o Prompt de Comando:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

#Alternativas

Se você usa um gerenciador de pacotes, também funciona:

# Homebrew (macOS/Linux)
brew install --cask claude-code

# WinGet (Windows)
winget install Anthropic.ClaudeCode

No Windows, é necessário ter o Git for Windows instalado.

#Primeira execução

Com a instalação feita, rode:

claude

Na primeira vez, o Claude Code abre o navegador para autenticação. Faça login com sua conta Anthropic e autorize o acesso. Depois disso, o terminal está pronto para uso.

Se tudo correu bem, você verá o prompt do Claude Code esperando sua primeira instrução. Uma boa forma de testar é digitar algo simples como "Olá, quem é você?" e verificar se a resposta aparece.

A partir daqui, o Claude Code se atualiza automaticamente. Não é necessário rodar o instalador novamente quando uma nova versão é lançada.

#Outras formas de acessar

Além da CLI, o Claude Code também está disponível como aplicação web em claude.ai/code, como app desktop, e como extensão para VS Code e JetBrains. A essência é a mesma — o que muda é a interface.

---

#Parte 4: Primeiros Comandos {#primeiros-comandos}

O Claude Code está instalado. O terminal está aberto. Agora é hora de entender como a interação funciona na prática.

#Conversando

A forma mais simples de usar o Claude Code é fazer uma pergunta. Não precisa de sintaxe especial — escreva em português como se estivesse falando com alguém.

> O que é HTML?

O Claude Code vai responder com uma explicação clara e direta. Até aqui, funciona como qualquer chat. A diferença aparece quando você pede para ele fazer algo.

Repare que não foi necessário usar nenhum comando especial. Sem barra, sem prefixo, sem sintaxe. A linguagem natural é a interface. Você pode perguntar em português, em inglês, misturar os dois — o modelo entende.

#Criando um arquivo

Navegue até uma pasta vazia e peça:

> Crie um arquivo index.html com uma página de boas-vindas. Título "Minha Primeira Página", 
  um parágrafo de apresentação e fundo cinza claro.

O Claude Code não vai apenas mostrar o código na tela. Ele vai criar o arquivo no seu computador. Depois de executar, você pode verificar:

ls

O arquivo index.html está lá. Abra no navegador e a página aparece, exatamente como descrita.

Isso é o que diferencia um agente de um chat. O ChatGPT mostraria o código e diria "cole isso em um arquivo chamado index.html". O Claude Code cria o arquivo diretamente. Menos fricção, mais resultado.

#Editando um arquivo existente

Agora peça uma mudança:

> Mude a cor do título para azul escuro e aumente o tamanho da fonte.

O Claude Code lê o arquivo existente, identifica o que precisa mudar e faz a edição. Ele mostra um diff — uma comparação entre o que estava antes e o que ficou depois — para que você veja exatamente o que mudou antes de aceitar.

Esse conceito de diff é importante. Significa que você tem controle total. Nada é alterado sem que você veja e aprove a mudança. Se algo parecer errado, você pode rejeitar a edição e pedir de outra forma. É um processo colaborativo, não automático.

O diff usa cores para facilitar a leitura: linhas removidas aparecem em vermelho, linhas adicionadas em verde. Mesmo sem saber programar, fica intuitivo ver o que mudou.

#Rodando comandos no terminal

O Claude Code também pode executar comandos de terminal quando necessário. Se você pedir para ele criar um projeto Node.js, por exemplo, ele vai rodar npm init automaticamente. Se pedir para instalar uma biblioteca, ele roda o comando de instalação.

> Instale o pacote live-server para poder ver a página em tempo real.

Antes de executar qualquer comando de terminal, o Claude Code mostra o que pretende rodar e pede sua confirmação. Algo como:

Vou executar: npm install -g live-server
Permitir? (y/n)

Essa é uma barreira de segurança — nenhum comando roda sem permissão explícita. Você sempre tem a chance de avaliar antes de qualquer ação no sistema.

#O ciclo de trabalho

Na prática, a interação com o Claude Code segue um ciclo consistente:

1. Você descreve o que quer em linguagem natural
2. O agente propõe uma ação (criar arquivo, editar código, rodar comando)
3. Você revisa o que será feito (diff, comando, etc.)
4. Você aceita ou pede ajuste
5. O resultado aparece imediatamente

Esse ciclo se repete a cada interação. Com o tempo, ele se torna natural — como conversar com alguém que executa suas ideias em tempo real.

---

#Parte 5: Mini-Projeto — Sua Página Pessoal

Teoria sem prática é só informação. Agora você vai construir algo real: uma página pessoal/portfólio usando apenas HTML e CSS, guiada inteiramente pelo Claude Code.

Por que uma página pessoal? Porque é útil de verdade. Ao final deste exercício, você terá algo que pode publicar na internet e compartilhar com outras pessoas. Não é um "hello world" descartável — é um projeto com valor prático.

#Preparação

Crie uma pasta para o projeto e inicie o Claude Code:

mkdir ~/minha-pagina-pessoal
cd ~/minha-pagina-pessoal
claude

#O prompt inicial

Um bom prompt é específico sem ser rígido. Descreva o que você quer, dê contexto sobre o visual e deixe margem para a IA tomar decisões de implementação. A regra é: quanto mais contexto no primeiro pedido, menos iterações de correção depois.

> Crie uma página pessoal/portfólio com HTML e CSS em um único arquivo index.html.

  Conteúdo:
  - Nome: [Seu Nome]
  - Título profissional: [Sua Profissão]
  - Uma seção "Sobre mim" com 2-3 frases
  - Uma seção "Projetos" com 3 cards lado a lado (título, descrição curta, link fictício)
  - Uma seção de contato com links para email e LinkedIn
  - Rodapé com o ano atual

  Visual:
  - Design moderno e limpo
  - Fundo escuro com texto claro
  - Fonte sans-serif (use Google Fonts)
  - Layout responsivo que funcione em celular
  - Cores de destaque em tons de azul

O Claude Code vai gerar o arquivo completo. Abra no navegador para ver o resultado:

open index.html        # macOS
xdg-open index.html    # Linux
start index.html       # Windows

#Primeira iteração: ajustes visuais

O resultado provavelmente estará bom, mas não exatamente como você imaginou. Isso é normal — e é exatamente aqui que o processo fica interessante. Ajuste por iteração:

> Mude a cor de destaque de azul para um verde-esmeralda. Adicione um gradiente sutil 
  no fundo do header, indo de escuro para um tom levemente mais claro.

Cada pedido é uma iteração. O Claude Code lê o arquivo atual, entende o que precisa mudar e aplica as alterações mostrando o diff. Recarregue a página no navegador para ver o resultado. Não gostou? Peça outra coisa. Gostou parcialmente? Peça um ajuste específico. Esse fluxo de tentativa e refinamento é como profissionais trabalham com IA no dia a dia.

#Segunda iteração: adicionando personalidade

> Adicione uma foto circular no topo da página. Use um placeholder de 
  https://placehold.co/200x200 por enquanto. A foto deve ter uma borda fina na cor 
  de destaque e uma sombra suave.

A página começa a ganhar identidade. Cada iteração leva segundos — você descreve, o Claude Code executa, você revisa no navegador.

#Terceira iteração: interatividade

> Adicione um efeito hover nos cards de projeto: quando o mouse passar por cima, 
  o card sobe levemente e a sombra aumenta. Use transições suaves com CSS. 
  Também adicione um efeito de hover no link do header que sublinha suavemente.

Com CSS puro, sem JavaScript, a página ganha vida. Efeitos como esses são detalhes pequenos que fazem uma diferença enorme na percepção de qualidade.

#Quarta iteração: responsividade

Se a página ainda não estiver se comportando bem em telas menores, peça:

> Verifique se o layout funciona bem em telas de celular (360px de largura). 
  Os cards de projeto devem empilhar verticalmente em telas pequenas em vez 
  de ficar lado a lado.

O Claude Code vai ajustar as media queries do CSS para que o layout se adapte. Esse tipo de pedido é especialmente útil porque responsividade é um dos aspectos mais trabalhosos de implementar manualmente — e um dos que a IA resolve com mais facilidade.

#Resultado

Em menos de 10 minutos, você tem uma página pessoal funcional:

• Design moderno e responsivo
• Seções organizadas com conteúdo real
• Efeitos visuais com hover
• Funciona em qualquer navegador

Tudo feito descrevendo em português o que você queria. Nenhuma linha de código digitada manualmente.

Pare um momento e considere o que aconteceu. Você descreveu uma página em linguagem natural, iterou sobre o visual com pedidos simples e terminou com um resultado que poderia ser colocado no ar agora mesmo. O processo todo levou menos tempo do que assistir um episódio de série.

O arquivo está no seu computador. Você pode hospedá-lo gratuitamente no GitHub Pages ou no Netlify para que outras pessoas acessem. Isso é assunto para outro tutorial — mas o ponto é que o resultado é real, não um exercício descartável.

#Próximos passos

Se este tutorial fez sentido, há dois caminhos naturais:

O primeiro é expandir o que você aprendeu aqui. O artigo Seu Primeiro App com Claude Code: Do Zero ao Funcionando vai além de páginas estáticas e mostra como construir um aplicativo funcional com interatividade real.

O segundo é entender os comandos que tornam o Claude Code mais produtivo no dia a dia. O guia 10 Comandos Essenciais do Claude Code cobre os que você vai usar com mais frequência.

Para quem quer ir mais fundo e aprender a criar aplicativos completos do zero usando IA — desde a ideia até o deploy — o Curso Claude Code: Criador de Apps cobre o processo inteiro com aulas práticas e projetos reais.

O mais importante: você acabou de construir algo funcional usando uma ferramenta que, meses atrás, não existia. A velocidade com que essa tecnologia evolui significa que o melhor momento para começar é agora — e agora você já começou.

---

#Referências

1. Anthropic. Claude Code — Quickstart. Documentação oficial. Disponível em: code.claude.com/docs/en/quickstart

2. Anthropic. Claude Code — Remote Control. Documentação oficial. Disponível em: code.claude.com/docs/en/remote-control

3. Orosz, Gergely. AI Tooling in 2026. The Pragmatic Engineer, 2026. Disponível em: newsletter.pragmaticengineer.com/p/ai-tooling-2026

4. Wikipedia contributors. OpenClaw. Wikipedia, The Free Encyclopedia. Disponível em: en.wikipedia.org/wiki/OpenClaw