Início Rápido

Bem-vindo ao Claude Code!

Este guia de início rápido fará com que você use assistência de codificação com IA em apenas alguns minutos. Ao final, você entenderá como usar o Claude Code para tarefas comuns de desenvolvimento.

Antes de começar

Certifique-se de ter:

• Um terminal ou prompt de comando aberto
• Um projeto de código para trabalhar
• Uma conta Claude.ai (recomendado) ou Anthropic Console

Passo 1: Instalar o Claude Code

Instalação NPM

Se você tem Node.js 18 ou mais recente instalado:

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

Instalação Nativa

Alternativamente, experimente nossa nova instalação nativa, agora em beta.

macOS, Linux, 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

Passo 2: Fazer login na sua conta

O Claude Code requer uma conta para usar. Quando você iniciar uma sessão interativa com o comando claude, precisará fazer login:

claude
# Você será solicitado a fazer login no primeiro uso

/login
# Siga as instruções para fazer login com sua conta

Você pode fazer login usando qualquer tipo de conta:

• Claude.ai (planos de assinatura - recomendado)
• Anthropic Console (acesso à API com créditos pré-pagos)

Uma vez logado, suas credenciais são armazenadas e você não precisará fazer login novamente.

Quando você autentica o Claude Code pela primeira vez com sua conta do Anthropic Console, um workspace chamado “Claude Code” é automaticamente criado para você. Este workspace fornece rastreamento e gerenciamento centralizado de custos para todo o uso do Claude Code em sua organização.

Você pode ter ambos os tipos de conta sob o mesmo endereço de email. Se precisar fazer login novamente ou trocar de conta, use o comando /login dentro do Claude Code.

Passo 3: Iniciar sua primeira sessão

Abra seu terminal em qualquer diretório de projeto e inicie o Claude Code:

cd /caminho/para/seu/projeto
claude

Você verá o prompt do Claude Code dentro de uma nova sessão interativa:

✻ Bem-vindo ao Claude Code!

...

> Tente "criar um util logging.py que..." 

Após fazer login (Passo 2), suas credenciais são armazenadas no seu sistema. Saiba mais em Gerenciamento de Credenciais.

Passo 4: Fazer sua primeira pergunta

Vamos começar entendendo sua base de código. Experimente um destes comandos:

> o que este projeto faz?

Claude analisará seus arquivos e fornecerá um resumo. Você também pode fazer perguntas mais específicas:

> que tecnologias este projeto usa?

> onde está o ponto de entrada principal?

> explique a estrutura de pastas

Você também pode perguntar ao Claude sobre suas próprias capacidades:

> o que o Claude Code pode fazer?

> como uso comandos de barra no Claude Code?

> o Claude Code pode trabalhar com Docker?

O Claude Code lê seus arquivos conforme necessário - você não precisa adicionar contexto manualmente. Claude também tem acesso à sua própria documentação e pode responder perguntas sobre seus recursos e capacidades.

Passo 5: Fazer sua primeira mudança de código

Agora vamos fazer o Claude Code fazer alguma codificação real. Experimente uma tarefa simples:

> adicionar uma função hello world ao arquivo principal

O Claude Code irá:

1. Encontrar o arquivo apropriado
2. Mostrar as mudanças propostas
3. Pedir sua aprovação
4. Fazer a edição

O Claude Code sempre pede permissão antes de modificar arquivos. Você pode aprovar mudanças individuais ou habilitar o modo “Aceitar tudo” para uma sessão.

Passo 6: Usar Git com Claude Code

O Claude Code torna as operações Git conversacionais:

> que arquivos eu mudei?

> fazer commit das minhas mudanças com uma mensagem descritiva

Você também pode solicitar operações Git mais complexas:

> criar um novo branch chamado feature/quickstart

> mostrar os últimos 5 commits

> me ajudar a resolver conflitos de merge

Passo 7: Corrigir um bug ou adicionar um recurso

Claude é proficiente em depuração e implementação de recursos.

Descreva o que você quer em linguagem natural:

> adicionar validação de entrada ao formulário de registro de usuário

Ou corrigir problemas existentes:

> há um bug onde usuários podem enviar formulários vazios - corrija isso

O Claude Code irá:

• Localizar o código relevante
• Entender o contexto
• Implementar uma solução
• Executar testes se disponíveis

Passo 8: Testar outros fluxos de trabalho comuns

Há várias maneiras de trabalhar com Claude:

Refatorar código

> refatorar o módulo de autenticação para usar async/await em vez de callbacks

Escrever testes

> escrever testes unitários para as funções da calculadora

Atualizar documentação

> atualizar o README com instruções de instalação

Revisão de código

> revisar minhas mudanças e sugerir melhorias

Lembre-se: O Claude Code é seu programador par de IA. Fale com ele como falaria com um colega prestativo - descreva o que você quer alcançar, e ele ajudará você a chegar lá.

Comandos essenciais

Aqui estão os comandos mais importantes para uso diário:

Comando	O que faz	Exemplo
claude	Iniciar modo interativo	claude
claude "tarefa"	Executar uma tarefa única	claude "corrigir o erro de build"
claude -p "consulta"	Executar consulta única, depois sair	claude -p "explicar esta função"
claude -c	Continuar conversa mais recente	claude -c
claude -r	Retomar uma conversa anterior	claude -r
claude commit	Criar um commit Git	claude commit
/clear	Limpar histórico de conversa	> /clear
/help	Mostrar comandos disponíveis	> /help
exit ou Ctrl+C	Sair do Claude Code	> exit

Veja a referência CLI para uma lista completa de comandos.

Dicas profissionais para iniciantes

Seja específico com suas solicitações

Em vez de: “corrigir o bug”

Tente: “corrigir o bug de login onde usuários veem uma tela em branco após inserir credenciais erradas”

Use instruções passo a passo

Divida tarefas complexas em etapas:

> 1. criar uma nova tabela de banco de dados para perfis de usuário

> 2. criar um endpoint de API para obter e atualizar perfis de usuário

> 3. construir uma página web que permite aos usuários ver e editar suas informações

Deixe Claude explorar primeiro

Antes de fazer mudanças, deixe Claude entender seu código:

> analisar o esquema do banco de dados

> construir um dashboard mostrando produtos que são mais frequentemente devolvidos por nossos clientes do Reino Unido

Economize tempo com atalhos

• Use Tab para completar comandos
• Pressione ↑ para histórico de comandos
• Digite / para ver todos os comandos de barra

O que vem a seguir?

Agora que você aprendeu o básico, explore recursos mais avançados:

Fluxos de trabalho comuns

Guias passo a passo para tarefas comuns

Referência CLI

Domine todos os comandos e opções

Configuração

Personalize o Claude Code para seu fluxo de trabalho

Obtendo ajuda

• No Claude Code: Digite /help ou pergunte “como eu…”
• Documentação: Você está aqui! Navegue por outros guias
• Comunidade: Junte-se ao nosso Discord para dicas e suporte