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. If you see 'irm' is not recognized as an internal or external command, you’re in CMD, not PowerShell. Your prompt shows PS C:\ when you’re in PowerShell and C:\ without the PS when you’re in CMD.Native Windows setups require Git for Windows. Install it first if you don’t have it. WSL setups do not need 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