Pular para o conteúdo principal
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

To install Claude Code, use one of the following methods: 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: 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á 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.
Depois de fazer login (Passo 2), suas credenciais são armazenadas em seu sistema. Saiba mais em Gerenciamento de Credenciais.

​
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?
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: 
add a hello world function to the main file
Claude Code irá:
  1. Encontrar o arquivo apropriado
  2. Mostrar as alterações propostas
  3. Pedir sua aprovação
  4. 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: 
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
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
ComandoO que fazExemplo
claudeIniciar modo interativoclaude
claude "task"Executar uma tarefa únicaclaude "fix the build error"
claude -p "query"Executar consulta única, depois sairclaude -p "explain this function"
claude -cContinuar conversa mais recente no diretório atualclaude -c
claude -rRetomar uma conversa anteriorclaude -r
Comandos de sessão
ComandoO que fazExemplo
/clearLimpar histórico de conversa/clear
/helpMostrar comandos disponíveis/help
/exit ou Ctrl+DSair do Claude Code/exit
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:
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
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
  • Digite / para ver todos os comandos e skills
  • 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
  • Comunidade: Junte-se ao nosso Discord para dicas e suporte