Guia de Início Rápido
Bem-vindo ao Claude Code!
Este guia de início rápido o colocará usando assistência de codificação alimentada por IA em poucos 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
- Se você nunca usou o terminal antes, confira o guia de terminal
- Um projeto de código para trabalhar
- Uma assinatura Claude (Pro, Max, Team ou Enterprise), conta do Claude Console, ou acesso através de um provedor de nuvem suportado
Passo 1: Instale Claude Code
To install Claude Code, use one of the following methods:
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
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.
Git for Windows is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.
brew install --cask claude-code
Homebrew offers two casks. claude-code tracks the stable release channel, which is typically about a week behind and skips releases with major regressions. claude-code@latest tracks the latest channel and receives new versions as soon as they ship.
winget install Anthropic.ClaudeCode
You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine.
Passo 2: Faça login em sua conta
Claude Code requer uma conta para usar. Inicie uma sessão interativa com o comando claude e você será solicitado a fazer login no primeiro uso:
claude
Para contas de assinatura Claude ou Console, siga os prompts para concluir a autenticação no seu navegador. Para trocar de contas mais tarde ou fazer nova autenticação, digite /login dentro da sessão em execução:
/login
Você pode fazer login usando qualquer um destes tipos de conta:
- Claude Pro, Max, Team 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)
Depois de fazer login, suas credenciais são armazenadas e você não precisará fazer login novamente.
Passo 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.
Passo 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 create custom skills in Claude Code?
can Claude Code work with Docker?
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:
add a hello world function to the main file
Claude Code irá:
- Encontrar o arquivo apropriado
- Mostrar as alterações propostas
- Pedir sua aprovação
- Fazer a edição
Passo 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
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:
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
Passo 8: Teste outros fluxos de trabalho comuns
Existem várias maneiras de trabalhar com Claude:
Refatore código
refactor the authentication module to use async/await instead of callbacks
Escreva testes
write unit tests for the calculator functions
Atualize documentação
update the README with installation instructions
Revisão de código
review my changes and suggest improvements
Comandos 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 |
/clear |
Limpar histórico de conversa | /clear |
/help |
Mostrar comandos disponíveis | /help |
exit ou Ctrl+D |
Sair do Claude Code | exit |
Veja a referência CLI para uma lista completa de comandos.
Dicas profissionais para iniciantes
Para mais, veja melhores práticas e fluxos de trabalho comuns.
Tente: "corrigir o bug de login onde os usuários veem uma tela em branco após inserir credenciais incorretas"
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 da web que permite aos usuários ver e editar suas informações
Deixe Claude explorar primeiro
Antes de fazer alterações, deixe Claude entender seu código:
analisar o esquema do banco de dados
construir um painel mostrando produtos que são devolvidos com mais frequência por nossos clientes do Reino Unido
Economize tempo com atalhos
- Digite
/para ver todos os comandos e skills - Use Tab para conclusão de comando
- Pressione ↑ para histórico de comando
- Pressione
Shift+Tabpara alternar modos de permissão
Próximos passos
Agora que você aprendeu o básico, explore recursos mais avançados:
Entenda o loop agêntico, ferramentas integradas e como Claude Code interage com seu projeto
Obtenha melhores resultados com prompting eficaz e configuração de projeto
Guias passo a passo para tarefas comuns
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