Guia · 5 min de leitura

Claude Code para iniciantes: o que é e como começar

Atualizado em · Infra Treinamentos

Resposta curta

O Claude Code é o agente de programação da Anthropic. Você descreve em português o que quer, e ele lê o seu projeto, escreve e altera arquivos, roda comandos e mostra cada mudança para você aprovar. Funciona no terminal, no aplicativo de desktop, no navegador (claude.ai/code) e dentro do VS Code e das IDEs JetBrains. Para usar, é preciso um plano pago da Claude (Pro, Max, Ultra, Team ou Enterprise) ou créditos de API: o plano gratuito não inclui o Claude Code.

O que é o Claude Code (e por que não é só um chat)

No chat, a IA responde e você copia e cola. O Claude Code trabalha dentro da pasta do seu projeto: abre os arquivos que precisa, propõe a mudança, edita, roda o comando de teste e confere o resultado. Esse ciclo de planejar, executar e conferir até terminar é o loop agêntico.

Você continua no controle. Antes de alterar um arquivo ou rodar um comando, ele pergunta, e você aprova ou recusa. O modo de permissão define o que ele pode fazer sem perguntar, e a tecla Shift+Tab troca esse modo a qualquer momento da sessão.

Onde ele funciona

O mesmo Claude Code aparece em vários lugares, todos com a mesma conta:

  • No terminal, a forma original e a de mais controle
  • No aplicativo de desktop da Claude
  • No navegador, em claude.ai/code, com as sessões rodando na nuvem
  • Dentro do VS Code e das IDEs JetBrains
  • No Slack e em automações do GitHub Actions e do GitLab

Qual plano precisa

O Claude Code exige uma assinatura paga da Claude (Pro, Max, Ultra, Team ou Enterprise) ou uma conta no Claude Console com créditos de API. Na tabela de planos da própria Claude, o gratuito aparece sem o Claude Code.

Nos planos Pro e Max o uso tem um limite por sessão de cinco horas e um limite semanal, e esses limites são compartilhados entre a Claude e o Claude Code: o que você usa no chat conta no mesmo saldo. Para aprender, o Pro costuma bastar; quem usa o dia inteiro e esbarra no limite passa para o Max.

Um cuidado que pega muita gente: se existir a variável ANTHROPIC_API_KEY no seu computador e você aceitar usá-la quando o Claude Code perguntar, ele passa a cobrar pela API, por uso, e não pela assinatura.

Como instalar, passo a passo

Abra o terminal e cole o comando do seu sistema. A instalação nativa é a recomendada e se atualiza sozinha. O comando não mostra progresso enquanto baixa: espere terminar. No Windows, o terminal mostra PS C:\ quando você está no PowerShell e só C:\ quando está no CMD.

Mac, Linux e WSL
curl -fsSL https://claude.ai/install.sh | bash
Windows · PowerShell
irm https://claude.ai/install.ps1 | iex
Windows · CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Conferir, num terminal novo
claude --version

Se aparecer um número de versão, está instalado. No Windows, vale instalar também o Git for Windows, que o Claude Code usa para rodar comandos.

Sua primeira sessão

Entre na pasta do projeto e chame o Claude Code. Na primeira vez ele pede para você entrar com a sua conta da Claude, pelo navegador; depois disso não pede mais.

Abrir no projeto
cd caminho/do/seu/projeto
claude
Primeiros pedidos (pode escrever em português)
o que esse projeto faz?
explique a estrutura de pastas
quais tecnologias ele usa?
Comandos do dia a dia
claude        abre o Claude Code na pasta atual
claude -c     continua a última conversa desta pasta
/help         mostra os comandos (dentro da sessão)
/clear        começa uma conversa nova
/exit         sai do Claude Code

Comece pedindo para ele entender o projeto antes de mexer. Depois peça uma mudança pequena, como uma função ou um texto da tela, e aprove só depois de ler o que ele mostrou.

Como pedir bem: o que separa quem trava de quem entrega

Seja específico. Em vez de "conserte o bug", diga qual é o bug, onde aparece e o que deveria acontecer. Tarefa grande vira lista de passos: primeiro a tabela no banco, depois a rota da API, depois a tela.

Deixe ele explorar antes de mudar ("analise o banco de dados e me explique as tabelas") e revise cada alteração antes de aprovar. Pedido bem escrito, o contexto certo do projeto e revisão: isso é engenharia de prompt e de contexto, e é o que define se o resultado sai certo de primeira.

Os cuidados de segurança que quase ninguém ensina

O Claude Code mexe no seu computador de verdade. Trate-o como alguém com acesso à sua máquina:

  • Nunca cole senhas, chaves de API ou dados de clientes no pedido; segredo fica em variável de ambiente e fora do Git
  • Leia o que ele vai fazer antes de aprovar, principalmente comandos que apagam arquivos ou mexem no servidor
  • Use Git: com cada mudança registrada, qualquer erro volta em segundos
  • Desconfie de instruções escondidas em arquivos e páginas que ele lê: é o ataque chamado prompt injection

Do Claude Code ao sistema no ar

O Claude Code resolve a parte de construir. O que transforma um projeto em sistema de verdade vem depois: domínio, servidor, banco de dados, pipeline de publicação e a proteção de dados, chaves e custos. É aí que a maioria dos cursos para, e é o caminho que a Jornada do Escolhido percorre do começo ao fim: Construa, Publique e Proteja.

Aprenda Claude Code do primeiro comando ao seu sistema no ar e protegido.

Começar a JornadaLote Fundador · R$ 197 no Pix ou até 12x de R$ 19,42

Perguntas frequentes

O Claude Code é gratuito?

Não. É preciso um plano pago da Claude (Pro, Max, Ultra, Team ou Enterprise) ou uma conta no Claude Console com créditos de API. O plano gratuito da Claude não inclui o Claude Code.

Preciso saber programar para usar o Claude Code?

Para começar, não: você descreve o que quer em português. Mas entender o básico de terminal, Git e de como um site funciona evita travar e ajuda a revisar o que ele faz. É o que a etapa Base da Jornada do Escolhido ensina antes do Claude Code.

O Claude Code entende português?

Sim. Você pode pedir, perguntar e revisar em português, e ele responde em português.

Qual a diferença entre o Claude Code e o chat da Claude?

O chat conversa e escreve respostas para você copiar. O Claude Code é um agente: trabalha dentro do seu projeto, lê e altera os arquivos, roda comandos e usa o Git, pedindo sua aprovação antes de agir.

O uso do Claude Code gasta o mesmo limite do chat?

Sim. Nos planos Pro e Max, os limites de uso (por sessão de cinco horas e por semana) são compartilhados entre a Claude e o Claude Code.

Onde aprender Claude Code do zero, em português?

Na Jornada do Escolhido, da Infra Treinamentos, o módulo 08 (Claude Code: do zero ao app) ensina do primeiro comando a um app completo, e os módulos seguintes levam esse app para o ar e o protegem.

Onde você aprende na Jornada

  • 08Claude Code: do zero ao appIAO agente de código mais poderoso do mercado, no VS Code e no terminal: CLAUDE.md, modo de planejamento, loops do agente, commits a cada passo e permissões que você controla. Você sai com um app com login funcionando. Etapa 2, Construa · 16 aulas.
  • 07Engenharia de prompt e de contextoIAEngenharia de prompt na prática: como pedir para a IA entregar certo de primeira, com objetivo, contexto, exemplos e critério de pronto. Sua biblioteca de prompts e a memória do projeto. Etapa 2, Construa · 13 aulas.
  • 03Linux e linha de comandoTIA tela preta que todo servidor e toda IA de código usam: pastas, arquivos, usuários e permissões, serviços (systemd), logs e os comandos do dia a dia. É aqui que o medo acaba. Etapa 1, Base · 9 aulas.
  • 05Git e GitHub: versionamento e pipeline de códigoTIVersionar, voltar no tempo e nunca perder trabalho. Seu GitHub vira portfólio. E o arquivo .env que nunca pode subir. Etapa 1, Base · 9 aulas.
  • 22Segredos, chaves de API e cadeia de suprimentosSegurançaChaves fora do código e do histórico, rotação, pacotes confiáveis e como avaliar um MCP ou skill de terceiros antes de instalar. Etapa 4, Proteja · 8 aulas.

Termos deste guia

Fontes

Conferido nas fontes oficiais em 17/11/2026. Planos, limites e comandos mudam: na dúvida, vale a página oficial.

Aprenda Claude Code do primeiro comando ao seu sistema no ar e protegido.

A Jornada do Escolhido tem 32 módulos e 353 aulas curtas, do zero ao seu sistema no ar, com domínio, servidor e segurança. Lote Fundador: R$ 197 no Pix ou até 12x de R$ 19,42, com 7 dias de garantia.