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

​
Antes de começar

Certifique-se de que você tem:
  • Um terminal ou prompt de comando aberto
  • Um projeto de código para trabalhar
  • Uma conta Claude.ai (recomendado) ou Claude Console

​
Etapa 1: Instalar Claude Code

​
Instalação via NPM

Se você tem Node.js 18 ou mais recente instalado: 
npm install -g @anthropic-ai/claude-code

​
Instalação Nativa

Alternativamente, tente nossa nova instalação nativa, agora em beta.
Homebrew (macOS, Linux): 
brew install --cask claude-code
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

​
Etapa 2: Faça login em sua conta

Claude Code requer uma conta para usar. Quando você inicia uma sessão interativa com o comando claude, você precisará fazer login: 
claude
# Você será solicitado a fazer login no primeiro uso

/login
# Siga os prompts para fazer login com sua conta
Você pode fazer login usando qualquer tipo de conta: Após fazer login, suas credenciais são armazenadas e você não precisará fazer login novamente.
Quando você autentica Claude Code com sua conta Claude Console pela primeira vez, um workspace chamado “Claude Code” é criado automaticamente para você. Este workspace fornece rastreamento centralizado de custos e gerenciamento para todo o uso de Claude Code em sua organização.
Você pode ter ambos os tipos de conta sob o mesmo endereço de email. Se você precisar fazer login novamente ou trocar de contas, use o comando /login dentro de Claude Code.

​
Etapa 3: Inicie sua primeira sessão

Abra seu terminal em qualquer diretório de projeto e inicie Claude Code: 
cd /path/to/your/project
claude
Você verá a tela de boas-vindas do Claude Code com as informações da sua sessão, conversas recentes e atualizações mais recentes. Digite /help para comandos disponíveis ou /resume para continuar uma conversa anterior.
Após fazer login (Etapa 2), suas credenciais são armazenadas em seu sistema. Saiba mais em Gerenciamento de Credenciais.

​
Etapa 4: Faça sua primeira pergunta

Vamos começar entendendo sua base de código. Tente um destes comandos: 
> what does this project do?
Claude analisará seus arquivos e fornecerá um resumo. Você também pode fazer perguntas mais específicas: 
> what technologies does this project use?

> where is the main entry point?

> explain the folder structure
Você também pode perguntar ao Claude sobre suas próprias capacidades: 
> what can Claude Code do?

> how do I use slash commands in Claude Code?

> can Claude Code work with Docker?
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.

​
Etapa 5: Faça sua primeira alteração de código

Agora vamos fazer Claude Code fazer alguma codificação real. Tente uma tarefa simples: 
> add a hello world function to the main file
Claude Code irá:
  1. Encontrar o arquivo apropriado
  2. Mostrar as alterações propostas
  3. Pedir sua aprovação
  4. Fazer a edição
Claude Code sempre pede permissão antes de modificar arquivos. Você pode aprovar alterações individuais ou ativar o modo “Aceitar tudo” para uma sessão.

​
Etapa 6: Use Git com Claude Code

Claude Code torna as operações Git conversacionais: 
> what files have I changed?

> commit my changes with a descriptive message
Você também pode solicitar operações Git mais complexas: 
> create a new branch called feature/quickstart

> show me the last 5 commits

> help me resolve merge conflicts

​
Etapa 7: Corrija um bug ou adicione um recurso

Claude é proficiente em depuração e implementação de recursos. Descreva o que você quer em linguagem natural: 
> add input validation to the user registration form
Ou corrija problemas existentes: 
> there's a bug where users can submit empty forms - fix it
Claude Code irá:
  • Localizar o código relevante
  • Entender o contexto
  • Implementar uma solução
  • Executar testes se disponíveis

​
Etapa 8: Teste outros fluxos de trabalho comuns

Existem várias maneiras de trabalhar com Claude: Refatorar código 
> refactor the authentication module to use async/await instead of callbacks
Escrever testes 
> write unit tests for the calculator functions
Atualizar documentação 
> update the README with installation instructions
Revisão de código 
> review my changes and suggest improvements
Lembre-se: Claude Code é seu programador de par de IA. Fale com ele como você faria com um colega prestativo - descreva o que você quer alcançar, e ele o ajudará a chegar lá.

​
Comandos essenciais

Aqui estão os comandos mais importantes para uso diário:
ComandoO que fazExemplo
claudeIniciar modo interativoclaude
claude "task"Executar uma tarefa únicaclaude "fix the build error"
claude -p "query"Executar consulta única, depois sairclaude -p "explain this function"
claude -cContinuar conversa mais recenteclaude -c
claude -rRetomar uma conversa anteriorclaude -r
claude commitCriar um commit Gitclaude commit
/clearLimpar histórico de conversa> /clear
/helpMostrar comandos disponíveis> /help
exit ou Ctrl+CSair de Claude Code> exit
Veja a referência CLI para uma lista completa de comandos.

​
Dicas profissionais para iniciantes

Em vez de: “fix the bug”Tente: “fix the login bug where users see a blank screen after entering wrong credentials”
Divida tarefas complexas em etapas:
> 1. create a new database table for user profiles

> 2. create an API endpoint to get and update user profiles

> 3. build a webpage that allows users to see and edit their information
Antes de fazer alterações, deixe Claude entender seu código:
> analyze the database schema

> build a dashboard showing products that are most frequently returned by our UK customers
  • Pressione ? para ver todos os atalhos de teclado disponíveis
  • Use Tab para conclusão de comando
  • Pressione ↑ para histórico de comando
  • 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 Claude Code para seu fluxo de trabalho

Claude Code na web

Execute tarefas de forma assíncrona na nuvem

​
Obtendo ajuda

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