Skip to main content
Este guia de início rápido aborda o Claude Code no seu terminal: como instalar a CLI, fazer login a partir da sua primeira sessão e usá-lo para tarefas comuns de desenvolvimento no seu próprio projeto.

​
Antes de começar

Certifique-se de que você tem:
Estes casos são abordados em outras páginas:

​
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:
No Windows, seu prompt mostra PS C:\ quando você está no PowerShell e C:\ sem o PS quando você está no CMD.Windows PowerShell:
Windows CMD:
O comando de instalação não mostra nenhum progresso enquanto baixa o Claude Code. 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.Se o comando de instalação falhar com syntax error near unexpected token '<', um 403, ou qualquer outro erro, 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: Inicie sua primeira sessão

Abra seu terminal em qualquer diretório de projeto e inicie o Claude Code:
Substitua /path/to/your/project pelo caminho do projeto em que você deseja trabalhar. O Claude Code solicita que você faça login no primeiro uso. Para contas de assinatura do Claude ou do Console, siga as instruções para concluir a autenticação no seu navegador. Se você definiu a variável de ambiente ANTHROPIC_API_KEY e aprovar a chave quando o Claude Code perguntar se deve usá-la, o Claude Code pula o prompt de 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. Saiba mais em Gerenciamento de credenciais. O prompt do Claude Code aparece com a versão, o modelo atual e o diretório de trabalho exibidos acima dele. Digite /help para ver os comandos disponíveis ou /resume para continuar uma conversa anterior. Para trocar de conta mais tarde ou autenticar novamente, digite /login dentro da sessão em execução.

​
Passo 3: Faça sua primeira pergunta

Experimente 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:
O Claude Code lê os arquivos do seu projeto conforme necessário. Você não precisa adicionar contexto manualmente.

​
Passo 4: Faça sua primeira alteração de código

Experimente uma tarefa pequena:
O Claude Code encontra o arquivo apropriado e mostra a alteração para você. Se ele perguntar antes de fazer a alteração, selecione Yes para aprovar. O modo de permissão da sessão define quais ações o Claude pode realizar sem perguntar a você primeiro. Pressione Shift+Tab a qualquer momento para alternar o modo de permissão da sessão em que você está.

​
Passo 5: Use o Git com o Claude Code

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

​
Passo 6: Corrija um bug ou adicione um recurso

Descreva o que você deseja em linguagem natural:
Ou corrija problemas existentes:

​
Passo 7: Teste outros fluxos de trabalho comuns

Experimente mais alguns prompts. Você pode pedir ao Claude para refatorar código, escrever testes, atualizar a documentação ou revisar suas alterações:
Converse com o Claude como você faria com um colega prestativo. Descreva o que você deseja alcançar, e ele ajudará você a chegar lá.

​
Comandos essenciais

Aqui estão os comandos mais importantes para uso diário, agrupados por onde você os executa.

​
Comandos shell

Execute estes a partir do seu terminal para iniciar ou retomar Claude Code. Veja a referência CLI para a lista completa de comandos shell.

​
Comandos de sessão

Execute estes dentro do Claude Code após ele iniciar. Veja 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: Consulte a configuração avançada para opções de instalação, atualizações manuais ou instruções de desinstalação.

​
Obtendo ajuda

  • Em Claude Code: digite /help ou faça uma pergunta do tipo “como faço para”
  • Documentação: navegue pelos outros guias neste site
  • Cursos: Faça Claude Code 101 e outros cursos gratuitos no seu próprio ritmo em Claude Academy
  • Comunidade: Junte-se ao servidor do Discord para dicas e suporte