Skip to main content
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:
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

Para instalar Claude Code, abra um terminal e execute o comando para seu sistema. Se você nunca usou um terminal antes, o guia de terminal mostra como abrir um e colar o comando.
macOS, Linux, WSL:
Windows PowerShell:
Windows CMD:
Quando o instalador terminar, abra uma nova janela de terminal e execute claude --version. Uma instalação funcionando imprime um número de versão. Se seu shell disser que claude não foi encontrado ou não é reconhecido, o diretório de instalação ainda não está em seu PATH: consulte Corrija seu PATH.Se você vir The token '&&' is not a valid statement separator, você está no PowerShell, não no CMD. Se você vir 'irm' is not recognized as an internal or external command, você está no CMD, não no PowerShell. Seu prompt mostra PS C:\ quando você está no PowerShell e C:\ sem o PS quando você está no CMD.Se o comando de instalação falhar com syntax error near unexpected token '<', um 403, ou outro erro de curl, consulte Solucionar problemas de instalação para corresponder o erro a uma correção e para métodos alternativos de instalação.Git for Windows é recomendado no Windows nativo para que Claude Code possa usar a ferramenta Bash. Se Git for Windows não estiver instalado, Claude Code usa PowerShell como ferramenta de shell. Configurações WSL não precisam de Git for Windows.
As instalações nativas são atualizadas automaticamente em segundo plano para mantê-lo na versão mais recente.
Você também pode instalar com apt, dnf, ou apk no Debian, Fedora, RHEL e Alpine. Para confirmar que a instalação funcionou, execute:
O comando imprime um número de versão seguido por (Claude Code).

​
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:
Para contas de assinatura Claude ou Console, siga os prompts para concluir a autenticação no seu navegador. Se você tiver definido a variável de ambiente ANTHROPIC_API_KEY, Claude Code ignora o prompt de login e pede que você aprove a chave. Para trocar de contas mais tarde ou fazer nova autenticação, digite /login dentro da sessão em execução:
Você pode fazer login usando qualquer um destes tipos de conta: Depois de fazer login, suas credenciais são armazenadas e você não precisará fazer login novamente. Saiba mais em Gerenciamento de Credenciais.

​
Passo 3: Inicie sua primeira sessão

Abra seu terminal em qualquer diretório de projeto e inicie Claude Code:
Substitua /path/to/your/project pelo caminho do projeto em que você deseja trabalhar. Você verá o prompt do Claude Code com a versão, modelo atual e diretório de trabalho mostrados acima. 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:
Claude analisará seus arquivos e fornecerá um resumo. Você também pode fazer perguntas mais específicas:
Você também pode perguntar ao Claude sobre suas próprias capacidades:
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:
Claude Code encontra o arquivo apropriado e mostra a alteração. Se ele pedir antes de fazer a alteração, selecione Sim para aprovar. Com Claude Code v2.1.283 ou posterior, o modo auto é o modo de permissão inicial integrado para sessões de terminal interativas: um classificador revisa as ações em vez de você, e Claude edita a maioria dos arquivos e executa a maioria dos comandos sem pedir. Em versões anteriores, o modo auto é o modo de permissão inicial integrado apenas nos planos Pro, Max e Team. Para a sessão que você inicia logo após a instalação, consulte Primeira sessão após uma instalação ou atualização.
Suas configurações ou sua organização podem definir um modo de permissão inicial diferente. Qual modo de permissão uma sessão inicia lista o que faz. Pressione Shift+Tab a qualquer momento para alternar o modo de permissão da sessão em que você está.

​
Passo 6: Use Git com Claude Code

Claude Code torna as operações Git conversacionais:
Você também pode solicitar operações Git mais complexas:

​
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:
Ou corrija problemas existentes:
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
Escreva testes
Atualize documentação
Revisão de código
Fale com Claude como você falaria 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. Comandos shell são executados a partir do seu terminal para iniciar ou retomar Claude Code. Comandos de sessão são executados dentro do Claude Code após ele iniciar. Comandos shell Comandos de sessão Veja a referência CLI para a lista completa de comandos shell e a referência de comandos para a lista completa de comandos de sessão.

​
Dicas profissionais para iniciantes

Para mais, veja melhores práticas e fluxos de trabalho comuns.
Em vez de: “corrigir o bug”Tente: “corrigir o bug de login onde os usuários veem uma tela em branco após inserir credenciais incorretas”
Divida tarefas complexas em etapas:
Antes de fazer alterações, deixe Claude entender seu código:
  • Digite / para ver todos os comandos e skills disponíveis para você
  • Use Tab para conclusão de comando
  • Pressione ↑ para histórico de comando
  • Pressione Shift+Tab para alternar modos de permissão

​
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 /help ou pergunte “how do I…”
  • Documentação: Você está aqui! Navegue por outros guias
  • Cursos: Faça Claude Code 101 e outros cursos gratuitos no seu próprio ritmo em Claude Academy
  • Comunidade: Junte-se ao nosso Discord para dicas e suporte