Claude Code para iniciantes: o que é, quanto custa, como instalar e os primeiros comandos

Dá pra criar seu primeiro projeto de verdade sem saber escrever uma linha de código

Fala aí, beleza? Se você nunca abriu um terminal na vida, essa frase acima soa meio maluca, eu sei…

Mas é exatamente isso que o Claude Code faz: ele é o Claude rodando dentro do terminal, olhando os arquivos do seu projeto e escrevendo o código a partir de uma descrição em português

A própria documentação oficial diz, com todas as letras, que não é preciso saber programar pra usar: você descreve o que quer, ele escreve o código e pede sua permissão antes de criar ou alterar qualquer arquivo

Neste post a gente vê o que é, quanto custa, como instalar no seu sistema e os primeiros comandos, do jeito mais mastigado possível pra quem tá começando agora 🙂

O que é o Claude Code (e por que ele é diferente do Claude do navegador):

O Claude que você já conhece vive numa aba do navegador

Você pergunta, ele responde um texto, você copia o código e cola no seu editor

O Claude Code muda essa dinâmica: ele roda no terminal, dentro da pasta do seu projeto, e mexe nos arquivos por você

Ele não devolve um bloco de código pra você copiar, ele cria o arquivo, edita o que já existe e segue em frente

E calma que não é um monstro solto na sua máquina: antes de criar ou alterar arquivo, ele pede sua permissão

Você dá Enter pra aprovar, e é aí que mora o controle todo

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

E precisa de outra assinatura?

Não

A mesma assinatura cobre o Claude na web, no desktop, no mobile e o Claude Code no terminal

Os limites de uso também são compartilhados entre o Claude e o Claude Code, então é uma conta só, um limite só, vários lugares de uso

O que você precisa antes de instalar o Claude Code:

Antes do comando, o checklist honesto

1. Um plano pago

O Claude Code não está no plano Free

Hoje são cinco planos disponíveis: Free, Pro, Max, Team e Enterprise

Pra usar o Claude Code você precisa de Pro, Max, um assento premium de Team ou Enterprise, ou uma conta do Console

Pra quem tá começando, o Pro resolve:

A diferença do Max pro Pro é o volume de uso: o Max tem dois níveis, 5x e 20x o uso do Pro por sessão

E aqui vale entender COMO esse limite funciona, porque é a dúvida número um de quem assina

Os limites são redefinidos numa janela contínua de 5 horas, e os planos pagos ainda têm um limite semanal por cima disso

Ou seja: não é ilimitado, mas também não é aquele bloqueio do dia inteiro se você estourar num pico de uso

2. Requisitos de sistema

Os requisitos são bem tranquilos, não precisa de PC da Nasa haha

• macOS 13.0 ou superior
• Ubuntu 20.04+ / Debian 10+
• Windows 10 ou superior (com WSL 1, WSL 2 ou Git for Windows)
• 4 GB ou mais de RAM
• conexão com a internet

3. Saber abrir o terminal

Parece bobo, mas se você nunca programou, esse é o passo que trava

No macOS: Cmd + Espaço, digita Terminal e dá Enter

No Linux: Ctrl + Alt + T, ou busca por "Terminal" no menu de aplicativos

No Windows você já tem o PowerShell e o Prompt de Comando (CMD) instalados, e daqui a pouco a gente vê qual é qual

4. Git for Windows (se você estiver no Windows)

Aqui vai um detalhe que economiza dor de cabeça depois

No Windows nativo, o Git for Windows é recomendado pro Claude Code conseguir usar a ferramenta Bash

Sem ele instalado, o Claude Code cai pro PowerShell como shell

Funciona? Funciona, mas o comportamento muda

E o Node.js, precisa?

Essa é a confusão mais comum de todas, então bora matar ela agora

O Node.js só é exigido na instalação por npm

O binário nativo (aquele do comando oficial que a gente vai rodar já já) NÃO invoca o Node

Então se você nunca instalou Node na vida, relaxa, dá pra seguir normalmente pelo caminho nativo

Como instalar o Claude Code passo a passo:

Os comandos abaixo são os do Windows, que é onde a documentação separa dois caminhos diferentes

Se você está no macOS ou no Linux, o caminho é o da documentação oficial de setup

1. Descubra se você está no PowerShell ou no CMD. Olha o começo da linha onde você digita: se aparecer PS C:\, você está no PowerShell; se aparecer C:\ sem o PS na frente, você está no CMD

2. No PowerShell, rode o comando oficial:

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

O erro comum deste passo: se aparecer 'irm' is not recognized..., você não está no PowerShell, está no CMD

3. No CMD (Prompt de Comando), o comando é outro:

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

O erro comum deste passo: se aparecer The token '&&' is not a valid statement separator, é o contrário, você está no PowerShell e colou o comando do CMD

Basicamente, o erro te diz onde você está. Errou o comando? Só trocar pelo outro e seguir 😀

4. Abra o terminal na pasta do seu projeto e rode o comando claude. Pode ser um projeto novo, uma pasta vazia mesmo, ou um projeto que já existe

Se preferir, dá pra apontar o caminho direto:

claude /caminho/do/seu/projeto

5. Faça o login. Na primeira execução, o Claude Code abre uma janela do navegador pra você entrar com a sua conta Claude

Se um dia precisar sair e autenticar de novo, é o /logout dentro do próprio prompt do Claude Code

Se travar em algum ponto do meio, esse guia de instalação do Claude Code destrincha o processo com mais calma

E as atualizações?

Essa parte é de graça: as instalações nativas se atualizam sozinhas em segundo plano, pra manter a versão mais recente

Você não precisa fazer nada, nem lembrar de nada

Alternativas de instalação: npm, IDE e app de desktop:

Se o caminho principal travou, ou se você simplesmente não quer nem ver a cara de um terminal, tem outras portas de entrada

Instalação pelo npm

Se você já tem Node instalado, dá pra instalar por aqui:

npm install -g @anthropic-ai/claude-code

Tome cuidado com uma coisa: o instalador nativo é o caminho recomendado, e a via npm consta como DEPRECIADA na documentação

Os requisitos dessa via também são mais chatos: Node.js 18+ pra instalação npm, e a partir da v2.1.198 o pacote npm exige Node.js 22 ou superior

E aqui a atualização não é automática, você atualiza na mão:

npm install -g @anthropic-ai/claude-code@latest

Dentro do seu editor

O plano Pro ou Max também cobre o Claude Code dentro de IDEs suportadas

Isso inclui o VS Code, o Cursor e outros forks do VS Code, além das IDEs JetBrains como IntelliJ e PyCharm

Mesma assinatura, ambiente mais familiar pra quem já usa editor

App de desktop (sem terminal)

Tem também um app de desktop do Claude, pra quem quer usar o Claude Code sem encarar a linha de comando

O download fica em claude.com/download, com versão universal pro macOS (Intel e Apple Silicon) e Windows x64, além de um instalador ARM64 separado

Depois de instalar e entrar na conta, é só clicar na aba Code lá no topo

Um detalhe importante no Windows: o Git precisa estar instalado pras sessões locais funcionarem

Os primeiros comandos do Claude Code que todo iniciante deve conhecer:

Dentro da sessão, os comandos começam com barra

São pouquinhos os que importam no começo, se liga:

• /help lista os comandos disponíveis. Esqueceu tudo? Começa por ele
• /init gera um CLAUDE.md inicial, que é o arquivo onde o Claude guarda o contexto do seu projeto
• /memory refina esse arquivo depois, conforme o projeto cresce
• /plan entra no modo de planejamento, antes de uma mudança grande
• /clear zera o contexto da conversa (calma que a conversa anterior continua em disco, você não perde nada)
• /resume retoma uma conversa anterior
• /logout sai da conta pra você autenticar de novo

Se eu tivesse que escolher dois pra você decorar hoje, seriam o /init e o /plan

O /init dá contexto pro Claude sobre o que é o seu projeto

O /plan faz ele te mostrar o plano ANTES de sair mexendo, o que é ouro pra quem tá começando e ainda não sabe ler o que está sendo alterado

Atalhos de teclado que economizam tempo

E não é só comando de barra, não: dentro da sessão tem atalho de teclado também, e são esses aqui que você vai usar todo dia

• Shift+Tab troca o modo de permissão da sessão
• Tab completa comandos
• Seta para cima acessa o histórico
• Esc interrompe o Claude no meio da execução (esse aqui salva vidas)
• exit ou Ctrl+D duas vezes em prompt vazio encerra a sessão

E qual terminal usar?

O Claude Code funciona em Bash, Zsh, PowerShell ou CMD

Mas a documentação é honesta: ele funciona MELHOR em Bash ou Zsh

Traduzindo pro mundo real: Bash e Zsh são o padrão de macOS e Linux, e no Windows você tem PowerShell e CMD nativos, com o Bash entrando via Git for Windows

Como é usar o Claude Code do zero na prática:

No vídeo abaixo eu faço esse caminho inteiro do zero, e alguns detalhes só aparecem quando a gente senta e roda de verdade

Eu começo pela teoria de propósito: entender o que a ferramenta é antes de instalar muda tudo

Ela é uma ferramenta de codificação agêntica, ou seja, você pede em linguagem natural e a IA lê ou inicia o projeto e entrega o código

No vídeo eu listo o que já vi ela fazer: navegar pelo código do projeto pra ter contexto geral, criar e editar arquivos, executar comandos de terminal, fazer commits, criar e rodar testes e corrigir bugs

Depois de instalada, o comando fica disponível no terminal, e existem alternativas pra quem tem receio da linha de comando

As formas de uso que eu mostro são as duas mais comuns: pelo terminal e integrado a um editor tipo o VS Code

O tropeço que eu já tomei no Windows

Eu instalei no Windows rodando o comando no PowerShell aberto como administrador

Depois eu confiro se deu certo rodando o comando de versão: se aparecer a versão em vez de erro, tá tudo certo

Só que já me ferrei uma vez aqui: a instalação não deixou o comando disponível no terminal, porque a variável de ambiente que aponta pro binário não foi criada

Tive que criar na mão e reabrir o terminal

Na minha experiência, esse problema é bem específico do Windows, não vejo acontecer nos outros sistemas

Se for o seu caso, vale dar uma olhada nos erros comuns na instalação antes de sair reinstalando tudo

A primeira execução, tela por tela

Eu abro o terminal já na pasta do projeto (pode ser nova ou já existente) antes de iniciar a ferramenta

Na primeira execução vem a configuração inicial: escolher o tema visual, e tem até uma opção pensada pra daltônicos, achei massa esse cuidado

Depois vem o login, e eu escolho o mais simples na minha visão, a autenticação pelo navegador

A própria ferramenta avisa que ela pode errar, e eu faço questão de destacar isso no vídeo

Ela também pede autorização pra trabalhar na pasta que você escolheu

Meu primeiro teste é sempre bobo de propósito: eu pergunto no prompt o que existe no diretório, só pra provar que ela está viva e respondendo

Integrando ao VS Code

Dá pra usar o terminal embutido do VS Code numa boa

Mas instalando a extensão a experiência fica bem mais amigável, com uma interface de chat integrada ao editor

Eu instalo, aparece um ícone no VS Code e é ele que abre essa interface

E os mesmos comandos do terminal funcionam ali dentro, não muda nada pra você

A vantagem prática: não precisa manter o terminal aberto do lado, dá pra trabalhar direto no editor

O primeiro projeto, na real

Eu peço em português mesmo: uma calculadora de IMC com HTML, CSS e JavaScript, com uma interface bonita

E aqui tem uma coisa que todo iniciante estranha: no modo padrão, ela pergunta antes de CADA edição

O desenvolvimento fica pausado a cada permissão, o que no começo até ajuda a entender o que tá rolando, mas cansa depois de um tempo (e sim, existe outra forma de trabalhar)

No fim ela entrega um resumo do que executou pra criar o projeto

E dá pra abrir o raciocínio (thinking) e ver COMO ela planejou cada funcionalidade, isso é muito massa pra aprender

Abro o projeto no navegador e a calculadora funciona, calculando o resultado a partir do peso

É um passo a mais que outros editores com agente embutido, porque aqui você instala e depois integra ao editor

Mas o resultado é o mesmo: um projeto funcionando a partir de um prompt em português

O que dá pra fazer com o Claude Code sem saber programar:

A documentação oficial diz que não é preciso saber programar pra usar

Na prática, isso abre quatro usos bem concretos pra quem tá começando:

Criar um primeiro projeto do zero. Você descreve a ideia em português ("uma calculadora de IMC com HTML, CSS e JavaScript") e ele monta os arquivos, pedindo permissão a cada um

Entender um código que você não escreveu. Abre a sessão na pasta do projeto e pergunta o que aquele arquivo faz. Como ele navega pelo código pra ter contexto, a resposta vem sobre o SEU projeto, não sobre um exemplo genérico da internet

Corrigir um erro que você nem sabe ler. Cola a mensagem de erro no prompt e pede pra ele investigar. Aquele texto vermelho e assustador vira uma explicação em português

Automatizar tarefa repetitiva. Renomear um monte de arquivo, ajustar a mesma coisa em vários lugares, aquele tipo de trabalho chato que ninguém sente falta

Em todos os casos vale a mesma régua: ele pede permissão antes de mexer nos arquivos

Então o poder de veto continua sendo seu, sempre

Por onde começar hoje:

Se você leu até aqui e quer sair do papel, o caminho é curtinho

1. Assine o Pro (US$ 20/mês, com o Claude Code incluso)
2. Rode o comando de instalação do SEU terminal, PowerShell ou CMD, sem misturar os dois
3. Abra o terminal na pasta de um projeto pequeno e rode claude
4. Faça o login pela janela do navegador
5. Dentro da sessão, roda /init e depois /help

E aí a régua honesta pra quem tá começando: comece pequeno

Não jogue seu projeto de trabalho inteiro nele no primeiro dia

Use o /plan antes de mudanças grandes e leia o que ele propõe ANTES de dar Enter na permissão

A ferramenta avisa que pode errar, e a documentação não esconde isso

O que faz a diferença entre usar bem e se ferrar é justamente essa leitura de 10 segundos antes de aprovar

Curtiu? Instala aí e faz o teste com um projetinho bobo hoje mesmo, é o jeito mais rápido de a ficha cair 😀

Até o próximo post!

Matheus Battisti