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

Para instalar Claude Code, use um dos seguintes métodos:

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

brew install --cask claude-code

winget install Anthropic.ClaudeCode

Você também pode instalar com apt, dnf, ou apk no Debian, Fedora, RHEL e Alpine.

Para confirmar que a instalação funcionou, execute:

claude --version

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:

claude

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:

/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 Cloud's Agent Platform ou Microsoft Foundry (provedores de nuvem empresariais)
• Um gateway de aplicativos Claude auto-hospedado, se sua organização executar um: seu administrador pré-configura a URL do gateway, e /login abre diretamente na tela Cloud gateway para você fazer login com SSO corporativo

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:

cd /path/to/your/project
claude

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:

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 encontra o arquivo apropriado e mostra a alteração. Se ele pedir antes de fazer a alteração, selecione Sim para aprovar.

O modo Auto é o modo de permissão inicial integrado para sessões de terminal interativas nos planos Pro, Max e Team: 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 outros planos, o modo Manual é o modo de permissão inicial integrado. 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.

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. 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.

Tente: "corrigir o bug de login onde os usuários veem uma tela em branco após inserir credenciais incorretas"

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

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

Próximos passos

Agora que você aprendeu o básico, explore recursos mais avançados:

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