Antes de começar
Certifique-se de que você tem:- Um terminal ou prompt de comando aberto
- Se você nunca usou o terminal antes, confira o guia de terminal
- Um projeto de código para trabalhar
- Uma assinatura Claude (Pro, Max, Teams ou Enterprise), conta do Claude Console, ou acesso através de um provedor de nuvem suportado
Este guia cobre o CLI do terminal. Claude Code também está disponível na web, como um aplicativo de desktop, em VS Code e IDEs JetBrains, no Slack, e em CI/CD com GitHub Actions e GitLab. Veja todas as interfaces.
Passo 1: Instale Claude Code
To install Claude Code, use one of the following methods:- Native Install (Recommended)
- Homebrew
- WinGet
macOS, Linux, WSL:Windows PowerShell:Windows CMD:If you see
The token '&&' is not a valid statement separator, you’re in PowerShell, not CMD. Use the PowerShell command above instead. Your prompt shows PS C:\ when you’re in PowerShell.Windows requires Git for Windows. Install it first if you don’t have it.Native installations automatically update in the background to keep you on the latest version.
Passo 2: Faça login em sua conta
Claude Code requer uma conta para usar. Quando você inicia uma sessão interativa com o comandoclaude, você precisará fazer login:
- Claude Pro, Max, Teams ou Enterprise (recomendado)
- Claude Console (acesso à API com créditos pré-pagos). No primeiro login, um workspace “Claude Code” é criado automaticamente no Console para rastreamento centralizado de custos.
- Amazon Bedrock, Google Vertex AI ou Microsoft Foundry (provedores de nuvem empresariais)
/login.
Passo 3: Inicie sua primeira sessão
Abra seu terminal em qualquer diretório de projeto e inicie Claude Code:/help para comandos disponíveis ou /resume para continuar uma conversa anterior.
Passo 4: Faça sua primeira pergunta
Vamos começar entendendo sua base de código. Tente um destes comandos:Claude Code lê seus arquivos de projeto conforme necessário. Você não precisa adicionar contexto manualmente.
Passo 5: Faça sua primeira alteração de código
Agora vamos fazer Claude Code fazer alguma codificação real. Tente uma tarefa simples:- Encontrar o arquivo apropriado
- Mostrar as alterações propostas
- Pedir sua aprovação
- 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.
Passo 6: Use Git com Claude Code
Claude Code torna as operações Git conversacionais:Passo 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:- Localizar o código relevante
- Entender o contexto
- Implementar uma solução
- Executar testes se disponíveis
Passo 8: Teste outros fluxos de trabalho comuns
Existem várias maneiras de trabalhar com Claude: Refatore códigoComandos essenciais
Aqui estão os comandos mais importantes para uso diário:| Comando | O que faz | Exemplo |
|---|---|---|
claude | Iniciar modo interativo | claude |
claude "task" | Executar uma tarefa única | claude "fix the build error" |
claude -p "query" | Executar consulta única, depois sair | claude -p "explain this function" |
claude -c | Continuar conversa mais recente no diretório atual | 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 |
Dicas profissionais para iniciantes
Para mais, veja melhores práticas e fluxos de trabalho comuns.Seja específico com seus pedidos
Seja específico com seus pedidos
Em vez de: “fix the bug”Tente: “fix the login bug where users see a blank screen after entering wrong credentials”
Use instruções passo a passo
Use instruções passo a passo
Divida tarefas complexas em etapas:
Deixe Claude explorar primeiro
Deixe Claude explorar primeiro
Antes de fazer alterações, deixe Claude entender seu código:
Economize tempo com atalhos
Economize tempo com atalhos
- 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 e skills
Próximos passos
Agora que você aprendeu o básico, explore recursos mais avançados:Como Claude Code funciona
Entenda o loop agêntico, ferramentas integradas e como Claude Code interage com seu projeto
Melhores práticas
Obtenha melhores resultados com prompting eficaz e configuração de projeto
Fluxos de trabalho comuns
Guias passo a passo para tarefas comuns
Estenda Claude Code
Personalize com CLAUDE.md, skills, hooks, MCP e muito mais
Obtendo ajuda
- Em Claude Code: Digite
/helpou pergunte “how do I…” - Documentação: Você está aqui! Navegue por outros guias
- Comunidade: Junte-se ao nosso Discord para dicas e suporte