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

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 claude.ai/install.sh | bash

Windows PowerShell:

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

Passo 2: 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..." 

Suas credenciais são armazenadas com segurança em seu sistema. Saiba mais em Gerenciamento de Credenciais.

Passo 3: 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 4: Fazer sua primeira alteração 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 alterações 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 alterações individuais ou habilitar o modo “Aceitar tudo” para uma sessão.

Passo 5: Usar Git com Claude Code

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

> que arquivos eu alterei?
> fazer commit das minhas alterações com uma mensagem descritiva

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

> criar uma nova branch chamada feature/quickstart
> mostrar os últimos 5 commits
> me ajudar a resolver conflitos de merge

Passo 6: 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 7: 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 alterações e sugerir melhorias

Lembre-se: O Claude Code é seu programador par de IA. Fale com ele como você 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:

ComandoO que fazExemplo
claudeIniciar modo interativoclaude
claude "tarefa"Executar uma tarefa únicaclaude "corrigir o erro de build"
claude -p "consulta"Executar consulta única, depois sairclaude -p "explicar esta função"
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 do Claude Code> exit

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

Dicas profissionais para iniciantes

O que vem a seguir?

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

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