Claude Code para Iniciantes: Tutorial Completo para Comecar em 2026

Voce ouviu falar do Claude Code, viu gente criando projetos inteiros pelo terminal e pensou: "como eu comeco?" Este tutorial vai te levar do zero ate estar produtivo -- sem assumir que voce sabe programar, sem pular etapas e sem jargao desnecessario.

O Claude Code e, hoje, a ferramenta mais poderosa para quem quer usar inteligencia artificial direto no computador. Nao e um chatbot numa aba do navegador. E um assistente que mora no seu terminal, le seus arquivos, executa comandos e constroi projetos reais. E voce vai aprender a usar tudo isso nos proximos minutos.

1. O que e o Claude Code (e por que todo mundo esta usando)

O Claude Code e uma ferramenta de linha de comando (CLI) criada pela Anthropic. Em termos simples: voce abre o terminal do seu computador, digita claude e comeca a conversar com uma IA que pode fazer coisas no seu computador.

A diferenca entre o Claude Code e o chat do Claude no navegador (claude.ai) e fundamental:

Caracteristica	Claude Web (claude.ai)	Claude Code (terminal)
Interface	Navegador	Terminal / linha de comando
Le arquivos do PC	Nao (so uploads)	Sim, qualquer arquivo
Edita arquivos	Nao	Sim, diretamente
Executa comandos	Nao	Sim (git, npm, scripts...)
Cria projetos	Gera codigo para copiar	Cria os arquivos direto no PC
Contexto maximo	200K tokens	1 milhao de tokens
Extensivel com skills	Nao	Sim, centenas de skills

O Claude Code e o que transforma a IA de "ferramenta de pergunta e resposta" em assistente de trabalho real. Ele nao te diz como fazer -- ele faz junto com voce, no seu projeto, nos seus arquivos.

Quem esta usando

Desenvolvedores usam para escrever codigo, rodar testes e fazer deploys. Profissionais de marketing usam para criar landing pages, configurar tracking e gerar copy. Designers usam para prototipar interfaces. Gestores usam para automatizar relatorios. A ferramenta nao tem um publico-alvo unico -- qualquer pessoa que trabalha num computador pode se beneficiar.

2. Requisitos antes de comecar

Antes de instalar, confira se voce tem tudo pronto:

• Sistema operacional: macOS, Linux ou Windows (via WSL). O Claude Code roda nativamente em Mac e Linux. No Windows, voce precisa do Windows Subsystem for Linux (WSL) instalado
• Node.js versao 18 ou superior: o Claude Code e instalado via npm, o gerenciador de pacotes do Node.js. Se voce nao tem o Node instalado, baixe em nodejs.org
• Conta na Anthropic: voce precisa de uma conta com creditos de API ou um plano Claude Pro (US$20/mes) ou Max (US$100-200/mes)
• Terminal: no Mac, use o Terminal nativo ou iTerm2. No Linux, qualquer emulador de terminal funciona

Verificando tudo de uma vez

3. Como instalar o Claude Code passo a passo

A instalacao e um unico comando. Abra o terminal e execute:

Opcao 1: via npm (recomendado)

Opcao 2: via Homebrew (apenas macOS)

Se voce esta no macOS e ja usa Homebrew, a opcao 2 e conveniente. Caso contrario, npm funciona em qualquer sistema.

4. Primeiro uso: autenticacao e configuracao

Com o Claude Code instalado, e hora de abrir pela primeira vez. Navegue ate uma pasta qualquer (pode ser seu Desktop) e digite:

O Claude Code vai abrir seu navegador com uma pagina de login da Anthropic. Faca login com sua conta (ou crie uma se ainda nao tem). Apos autorizar, o terminal vai mostrar que voce esta conectado.

Metodos de autenticacao

• Plano Pro/Max (recomendado para iniciantes): se voce assina o Claude Pro ou Max, a autenticacao e feita pelo navegador automaticamente. Mais simples, sem configuracao extra
• API Key: para quem tem creditos de API separados. Voce configura a chave via variavel de ambiente ANTHROPIC_API_KEY

Para a maioria dos iniciantes, o plano Pro (US$20/mes) e o caminho mais direto. Voce faz login uma vez e pronto -- o Claude Code lembra da sua sessao.

5. Interface: como funciona o terminal interativo

Quando o Claude Code inicia, voce ve algo assim:

A interface e limpa. Voce tem um prompt (>) onde digita suas instrucoes em linguagem natural. Nao precisa de sintaxe especial, nao precisa de codigo. Basta escrever o que voce quer.

Elementos da interface

• Prompt >: onde voce digita. Aceita texto livre, nao precisa ser "tecnico"
• Working directory: a pasta onde o Claude Code esta operando. Ele le e cria arquivos nessa pasta
• Model: qual modelo esta sendo usado (Sonnet por padrao, Opus para tarefas complexas)
• Respostas do Claude: aparecem diretamente no terminal, com formatacao colorida
• Permissoes: quando o Claude quer executar algo (criar arquivo, rodar comando), ele pede sua autorizacao antes

6. Comandos basicos que voce precisa conhecer

O Claude Code tem comandos internos que comecam com /. Voce nao precisa decorar todos -- basta saber que existem e consultar quando precisar. Aqui estao os essenciais para comecar:

Comando	O que faz	Quando usar
/help	Mostra todos os comandos disponiveis	Quando estiver perdido
/clear	Limpa todo o historico da conversa	Para comecar um assunto novo do zero
/compact	Resume a conversa para economizar tokens	Quando a conversa ficar muito longa
/cost	Mostra quanto voce gastou em tokens na sessao	Para controlar gastos
/model	Troca entre modelos (Sonnet, Opus, Haiku)	Quando precisar de mais potencia ou economia
/init	Cria o arquivo CLAUDE.md do projeto	Ao comecar um projeto novo

Na pratica

Esses 6 comandos cobrem 90% do que voce precisa no dia a dia. Conforme for usando, voce descobre os outros naturalmente.

7. Seu primeiro projeto: criando algo do zero

A melhor forma de aprender e fazendo. Vamos criar um projeto simples: uma pagina web pessoal. Abra o terminal, navegue ate onde quer criar o projeto e inicie o Claude Code:

O que vai acontecer:

1. O Claude Code vai analisar seu pedido
2. Ele vai propor criar um arquivo index.html (e talvez um style.css)
3. Ele vai pedir sua permissao para criar os arquivos
4. Voce autoriza e ele cria tudo
5. Pronto -- os arquivos estao na pasta meu-site/

Voce pode abrir o index.html no navegador e ver o resultado imediatamente. Nao gostou de algo? Continue a conversa:

Note que o Claude Code editou o arquivo existente -- ele nao gerou um novo. Ele sabe que o index.html ja existe, le o conteudo atual e aplica apenas as mudancas necessarias. Isso e o diferencial: ele trabalha com seu projeto real, nao com codigo generico.

Outros projetos para praticar

• "Crie um calculador de IMC em HTML e JavaScript" -- projeto simples com logica
• "Crie um README.md profissional para meu projeto X" -- uso nao-codigo
• "Analise os arquivos desta pasta e explique o que cada um faz" -- o Claude Code le a pasta inteira e explica
• "Crie um script que renomeia todas as fotos desta pasta com a data de hoje" -- automacao

8. Entendendo contexto e tokens (janela de 1M)

Tokens sao a "unidade de medida" da IA. Cada palavra que voce envia e cada palavra que o Claude responde consome tokens. Entender isso ajuda voce a usar o Claude Code de forma mais eficiente e economica.

O que e a janela de contexto

A janela de contexto e a "memoria de trabalho" do Claude Code. Tudo que voce disse, tudo que ele respondeu e todos os arquivos que ele leu ficam nessa janela. O Claude Code tem uma janela de 1 milhao de tokens -- isso e equivalente a aproximadamente:

• 750.000 palavras (mais de 10 livros inteiros)
• Um projeto inteiro com milhares de linhas de codigo
• Dezenas de arquivos lidos simultaneamente

Na pratica, voce raramente vai esgotar essa janela. Mas conversas muito longas consomem mais tokens e podem ficar mais lentas (e caras). Por isso existem os comandos /compact e /clear.

Como economizar tokens

• Seja especifico: "Crie uma landing page para vender um curso de fotografia, com hero, beneficios e CTA" e melhor que "Crie um site"
• Use /compact: quando a conversa passar de 100K tokens, compacte. O Claude resume o historico sem perder o contexto importante
• Use /clear para novos assuntos: se voce terminou um projeto e vai comecar outro, limpe a conversa
• Escolha o modelo certo: Sonnet (padrao) e mais rapido e barato. Opus e mais potente mas custa mais. Haiku e o mais economico para tarefas simples

9. Instalando skills para potencializar

Ate aqui, voce esta usando o Claude Code "cru" -- ele e poderoso, mas generico. Skills transformam ele em um especialista sob demanda.

O que sao skills

Skills sao arquivos Markdown (SKILL.md) que contem instrucoes especializadas. Quando voce instala uma skill de "auditoria SEO", por exemplo, o Claude Code passa a ter conhecimento profundo de SEO tecnico, on-page, schema markup e tudo mais. Ele nao esta "inventando" -- esta seguindo instrucoes de especialistas.

Como instalar

Skills ficam na pasta ~/.claude/skills/ (para acesso global em todos os projetos) ou .claude/skills/ (para um projeto especifico). A instalacao e literalmente copiar pastas:

Suas skills aparecem junto com os comandos nativos. Voce digita /auditoria-seo e o Claude Code ja sabe exatamente o que fazer, quais criterios analisar e como formatar o resultado.

Criar vs comprar skills

Voce pode criar suas proprias skills -- basta escrever um arquivo Markdown com instrucoes. Mas criar skills de qualidade exige pesquisa profunda de cada dominio, testes extensivos e manutencao constante. Para a maioria dos profissionais, faz mais sentido usar skills prontas e focar o tempo em trabalho produtivo.

O Mega Bundle do minhaskills.io traz 748+ skills prontas cobrindo SEO, Google Ads, Meta Ads, copywriting, email marketing, analytics e muito mais. O Mega Bundle tem 748+ skills para React, Next.js, APIs, bancos de dados, DevOps e dezenas de outras tecnologias. O Mega Bundle custa R$19.

10. Voice mode: usando por voz

O Claude Code tambem aceita entrada por voz. Em vez de digitar, voce fala e o Claude Code transcreve e executa suas instrucoes.

Como ativar

No terminal com o Claude Code aberto, pressione a tecla de ativacao de voz (geralmente configurada via /terminal-setup). O Claude Code entra em modo de escuta, voce fala sua instrucao e ele processa como se voce tivesse digitado.

Claude Code - Voice Mode

> [voice mode ativo]

Voce: "Crie uma funcao JavaScript que valida email e adicione no arquivo utils.js"

Transcribing... Processing...
Claude cria a funcao e adiciona no arquivo

Quando usar voz

• Instrucoes longas: mais rapido falar 2 paragrafos do que digitar
• Multitask: voce pode falar com o Claude Code enquanto faz outra coisa
• Brainstorming: ideias fluem melhor quando voce fala do que quando digita
• Acessibilidade: para quem tem dificuldade de digitacao

O voice mode nao substitui a digitacao para tudo. Comandos curtos (/clear, /cost) sao mais rapidos de digitar. Mas para instrucoes complexas, voz e um ganho real de produtividade.

11. Proximos passos

Voce ja sabe instalar, autenticar, usar comandos basicos e criar seu primeiro projeto. Aqui esta o caminho para ir alem:

Semana 1: pratique o basico

• Crie 3-5 projetos pequenos para ganhar fluencia
• Experimente pedir coisas fora da sua area (se e de marketing, peca codigo; se e dev, peca copy)
• Use /cost para entender seu padrao de consumo

Semana 2: personalize

• Use /init para criar o CLAUDE.md nos seus projetos -- isso da contexto permanente ao Claude Code
• Instale skills especificas para sua area de atuacao
• Explore o comando /model para entender a diferenca entre Sonnet e Opus

Semana 3: integre no fluxo de trabalho

• Comece a usar o Claude Code para tarefas reais do seu dia a dia, nao so pratica
• Combine com Git para versionar seus projetos
• Teste o voice mode em sessoes longas

Semana 4: otimize

• Crie suas proprias skills para tarefas repetitivas
• Configure atalhos de terminal
• Explore integracao com VS Code e outras ferramentas

O segredo e usar todos os dias. Mesmo que seja so para uma tarefa pequena. Em 30 dias de uso diario, o Claude Code vira uma extensao natural do seu fluxo de trabalho.