Primeiros passos com Claude Code
Os primeiros passos com Claude Code levam poucos minutos: você instala a ferramenta, faz login, abre o terminal no projeto e começa a conversar em linguagem natural. Claude Code é a ferramenta de codificação agêntica da Anthropic, capaz de ler a base de código, editar arquivos e executar comandos a partir das suas instruções.
Este guia percorre cada etapa da configuração inicial com base no guia de início rápido oficial. Além disso, ele mostra as operações mais comuns no dia a dia de quem desenvolve software.
Se você ainda não conhece a ferramenta, comece pelo artigo o que é Claude Code.
O que você precisa antes dos primeiros passos com Claude Code
Antes de instalar, tenha um terminal disponível e um projeto de código para trabalhar. Qualquer linguagem serve, porque o agente lê e edita arquivos de texto de forma genérica.
Você também precisa de uma conta com acesso ao Claude Code. As opções são uma assinatura do Claude (Pro, Max, Team ou Enterprise), uma conta no Claude Console com créditos de API ou um provedor de nuvem suportado, como Amazon Bedrock, Google Cloud's Agent Platform (Vertex AI) ou Microsoft Foundry.
Segundo a página de configuração avançada, o plano gratuito do claude.ai não inclui o Claude Code. Por isso, confira o seu plano antes de começar, e o artigo sobre os planos do Claude ajuda nessa escolha.
A documentação oficial também lista requisitos mínimos, como macOS 13, Windows 10 1809, Ubuntu 20.04, 4 GB de RAM e conexão com a internet.
Este guia foca na interface de linha de comando, que é a mais completa. No entanto, o Claude Code também roda na web, como aplicativo desktop, em extensões para VS Code e JetBrains, no Slack e em pipelines de CI/CD com GitHub Actions e GitLab.
Instalação do Claude Code
Nos primeiros passos com Claude Code, a instalação recomendada usa o script nativo da Anthropic. Esse método configura a ferramenta e ativa atualizações automáticas em segundo plano.
Instalação nativa no macOS, Linux e WSL
No macOS, no Linux e no WSL, um único comando resolve a instalação:
curl -fsSL https://claude.ai/install.sh | bash
Depois que o instalador terminar, abra uma nova janela do terminal. Assim, o shell carrega o diretório de instalação no PATH.
Instalação no Windows
No Windows, o comando depende do terminal em uso. No PowerShell, execute:
irm https://claude.ai/install.ps1 | iex
Já no CMD, o processo baixa o instalador, executa e remove o arquivo em seguida:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Se aparecer a mensagem The token '&&' is not a valid statement separator, você está no PowerShell, e não no CMD. Nesse caso, o prompt começa com PS C:\, então use o comando da seção do PowerShell.
A documentação recomenda instalar o Git for Windows no Windows nativo, porque ele fornece o Git Bash para a ferramenta de shell do agente. Sem ele, o Claude Code usa o PowerShell para executar comandos, enquanto no WSL o Git for Windows não faz falta.
Homebrew e WinGet
Quem prefere o Homebrew no macOS pode instalar com brew install --cask claude-code. Esse cask segue o canal estável, que costuma ficar cerca de uma semana atrás e ignora versões com regressões graves.
Por outro lado, o cask claude-code@latest acompanha o canal mais recente e recebe cada versão assim que ela sai. Em ambos os casos, as instalações via Homebrew não se atualizam sozinhas, então execute brew upgrade claude-code periodicamente.
No Windows, o WinGet também funciona com winget install Anthropic.ClaudeCode. Da mesma forma, ele não atualiza de forma automática, e o comando winget upgrade Anthropic.ClaudeCode mantém a ferramenta em dia.
Verificando a instalação
Para confirmar que os primeiros passos com Claude Code deram certo, rode o comando abaixo em um terminal novo:
claude --version
Uma instalação correta imprime o número da versão seguido de (Claude Code). Caso o terminal diga que o comando não existe, o diretório de instalação ainda não está no PATH.
Para um diagnóstico mais completo, o comando claude doctor verifica a instalação e as configurações sem abrir uma sessão. Além disso, ele aponta avisos com sugestões de correção.
Login nos primeiros passos com Claude Code
O Claude Code exige uma conta para funcionar. Na primeira execução do comando claude, a ferramenta pede o login automaticamente:
claude
# o login aparece na primeira execução
Com uma assinatura ou uma conta do Console, você conclui a autenticação no navegador. Em seguida, a ferramenta guarda as credenciais localmente, e você não precisa repetir o login nas próximas sessões.
Dentro de uma sessão ativa, o comando /login permite autenticar de novo ou trocar de conta. Se a variável de ambiente ANTHROPIC_API_KEY estiver definida, o Claude Code pula o navegador e pede apenas a aprovação da chave.
Quem usa o Claude Console ganha um workspace chamado "Claude Code" na primeira autenticação. Com isso, o rastreamento de custos fica centralizado em um só lugar.
Já os usuários de provedores empresariais, como Bedrock, Agent Platform e Foundry, devem seguir as instruções específicas de integração da documentação oficial.
Abrindo a primeira sessão nos primeiros passos com Claude Code
Com a instalação e o login concluídos, navegue até o diretório do projeto e execute claude para abrir a sessão interativa:
cd /path/to/your/project
claude
A tela inicial mostra a versão, o modelo atual e o diretório de trabalho. A partir daí, o comando /help lista os comandos disponíveis, e /resume retoma uma conversa anterior.
O Claude Code lê os arquivos do projeto conforme a necessidade, então você não precisa adicionar contexto manualmente. Esse comportamento é a base do funcionamento agêntico, porque o agente explora a base de código antes de agir.
Explorando o projeto nos primeiros passos com Claude Code
O primeiro movimento recomendado é fazer perguntas exploratórias. Dessa forma, o agente entende a estrutura do código antes de qualquer modificação.
what does this project do?
what technologies does this project use?
where is the main entry point?
explain the folder structure
O agente analisa os arquivos e devolve um resumo da arquitetura, das tecnologias e dos pontos de entrada. Essa fase pesa ainda mais em projetos legados ou em bases de código que você ainda não conhece.
Você também pode perguntar sobre a própria ferramenta. Assim, descobre o que dá para delegar ao agente sem sair do terminal:
what can Claude Code do?
how do I create custom skills in Claude Code?
can Claude Code work with Docker?
Nos primeiros passos com Claude Code, essa conversa inicial economiza tempo depois. Afinal, um agente que conhece o projeto propõe mudanças mais coerentes com o código existente.
Primeira alteração no código e permissões
Nos primeiros passos com Claude Code, uma mudança simples já mostra o fluxo completo de edição:
add a hello world function to the main file
O agente localiza o arquivo adequado e mostra a alteração proposta. Se ele pedir confirmação antes de aplicar a mudança, escolha Yes para aprovar.
O que define quando o agente pergunta é o modo de permissão da sessão. A documentação sobre o funcionamento do Claude Code descreve quatro modos principais:
- Auto: um classificador revisa a maior parte das ações em segundo plano e bloqueia as arriscadas, em vez de perguntar a você.
- Manual: o agente pergunta antes de editar arquivos e de executar comandos de shell.
- Accept edits: o agente edita arquivos e roda comandos simples de sistema de arquivos sem perguntar, mas ainda pede aprovação para os demais comandos.
- Plan: o agente explora o código e propõe um plano, sem editar os arquivos do projeto.
Nas versões recentes, o modo auto é o modo inicial padrão das sessões interativas no terminal. Mesmo assim, as suas configurações ou a sua organização podem definir outro modo, e o atalho Shift+Tab alterna entre eles a qualquer momento.
Além disso, o Claude Code salva uma cópia dos arquivos antes de editá-los. Por isso, se algo der errado, pressionar Esc duas vezes volta a um estado anterior, ou você pode simplesmente pedir ao agente que desfaça a mudança.
Operações com Git em linguagem natural
Uma das funcionalidades mais úteis nos primeiros passos com Claude Code é executar operações Git por meio de linguagem natural. Em vez de memorizar flags e sintaxes, você descreve o que quer fazer:
what files have I changed?
commit my changes with a descriptive message
create a new branch called feature/quickstart
show me the last 5 commits
help me resolve merge conflicts
O agente interpreta a intenção, executa os comandos Git correspondentes e devolve o resultado de forma legível. Na prática, isso reduz o atrito em tarefas trabalhosas, como resolver conflitos de merge em projetos com histórico complexo.
Correção de bugs e novas funcionalidades
O agente localiza e corrige bugs a partir de descrições em linguagem natural. Você descreve o sintoma ou cola a mensagem de erro, e ele rastreia o problema pela base de código até a causa raiz:
fix the bug where users can submit empty forms
Para novas funcionalidades, o princípio é o mesmo. Basta descrever o comportamento desejado:
add input validation to the user registration form
Em seguida, o agente encontra o código relevante, entende o contexto, implementa a solução e roda os testes quando o projeto tem uma suíte disponível. Esse ciclo de implementação e verificação é o que diferencia o Claude Code de um simples gerador de código.
Outros fluxos de trabalho comuns
A refatoração aparece entre os usos mais frequentes. Por exemplo, você pode pedir a migração de callbacks para async/await em um módulo inteiro:
refactor the authentication module to use async/await instead of callbacks
write unit tests for the calculator functions
update the README with installation instructions
review my changes and suggest improvements
A escrita de testes também rende bem, principalmente para cobrir código legado que nunca teve testes. Da mesma forma, o agente mantém a documentação atualizada e revisa as suas alterações antes de você abrir um pull request.
Desde os primeiros passos com Claude Code, a orientação da Anthropic é tratar o agente como um colega desenvolvedor. Ou seja, descreva o objetivo com clareza, forneça contexto quando necessário e itere sobre os resultados.
Comandos essenciais nos primeiros passos com Claude Code
Para os primeiros passos com Claude Code, a documentação separa os comandos em dois grupos. Os comandos de shell iniciam ou retomam o Claude Code no terminal, enquanto os comandos de sessão funcionam dentro da ferramenta já aberta.
| Comando | O que faz |
|---|---|
claude |
Abre o modo interativo |
claude "task" |
Abre o modo interativo já com um prompt inicial |
claude -p "query" |
Executa uma consulta pontual e encerra |
claude -c |
Continua a conversa mais recente do diretório atual |
claude -r |
Retoma uma conversa anterior |
/clear |
Limpa o histórico da conversa atual |
/help |
Mostra os comandos disponíveis |
/exit ou Ctrl+D duas vezes |
Encerra o Claude Code |
A flag -p brilha em consultas rápidas dentro de scripts e pipelines, porque executa a tarefa e encerra sem manter uma sessão aberta. Já a flag -c retoma um trabalho em andamento sem que você precise explicar tudo de novo.
Repare que claude "task" não encerra ao final da tarefa. Na verdade, ele apenas abre a sessão interativa com a primeira instrução preenchida, e quem quer execução pontual deve usar -p.
Dicas para acelerar os primeiros passos com Claude Code
A qualidade das respostas depende diretamente da qualidade das instruções. Em vez de um pedido vago como "corrija o bug", descreva o problema com detalhes:
fix the login bug where users see a blank screen after entering wrong credentials
Para tarefas complexas, dividir o trabalho em etapas numeradas produz resultados mais consistentes:
1. create a new database table for user profiles
2. create an API endpoint to get and update user profiles
3. build a webpage that allows users to see and edit their information
Antes de pedir mudanças em um sistema desconhecido, deixe o agente explorar o código primeiro. Dessa forma, você evita alterações baseadas em suposições incorretas:
analyze the database schema
Alguns atalhos também agilizam a rotina nos primeiros passos com Claude Code. Digitar / mostra os comandos e skills disponíveis, Tab completa comandos, a seta para cima navega pelo histórico e Shift+Tab alterna os modos de permissão.
Outra dica é acompanhar o consumo de contexto, já que conversas longas ocupam espaço. O comando /context mostra o que está usando a janela, e o artigo sobre como economizar tokens no Claude traz estratégias complementares.
Como o Claude Code processa as solicitações
Depois dos primeiros passos com Claude Code, entender o modelo de execução ajuda a escrever instruções melhores. O Claude Code trabalha em um loop agêntico com três fases: coletar contexto, agir e verificar os resultados.
Essas fases se misturam ao longo da tarefa. Uma pergunta sobre o código pode exigir só a coleta de contexto, enquanto a correção de um bug passa pelas três fases várias vezes.
Para uma instrução como "corrija os testes que estão falhando", o agente pode rodar a suíte, ler a saída de erro, buscar os arquivos relevantes, editar o código e rodar os testes de novo. Cada ferramenta usada devolve informação nova, que orienta o passo seguinte.
Você também faz parte desse loop. A qualquer momento, Esc interrompe o agente, e uma correção digitada com Enter muda a direção sem cancelar a ação em curso.
Essa capacidade de encadear ações torna o Claude Code produtivo em tarefas que exigiriam vários ciclos manuais de escrita, teste e correção. Por isso, vale pensar em delegar objetivos, e não em ditar cada comando.
Continuidade entre sessões e o arquivo CLAUDE.md
O Claude Code salva cada conversa localmente, o que permite retomá-la depois com /resume, claude -c ou claude -r. Isso ajuda em projetos longos, nos quais o contexto acumulado tem valor.
Ainda assim, cada nova sessão começa com uma janela de contexto limpa, sem o histórico das anteriores. Para persistir informações, o caminho é o arquivo CLAUDE.md na raiz do projeto.
Padrões de código, convenções da equipe e comandos de build registrados nesse arquivo ficam disponíveis em todas as sessões futuras. Assim, você para de repetir as mesmas explicações a cada conversa.
Ainda nos primeiros passos com Claude Code, o comando /init gera um CLAUDE.md inicial para o projeto. Além disso, a memória automática guarda aprendizados que o agente registra enquanto você trabalha, como as suas preferências.
Próximos passos depois dos primeiros passos com Claude Code
Com o básico dominado, os próximos tópicos recomendados são o loop agêntico em detalhe, as boas práticas de configuração de projetos e os fluxos de trabalho comuns. Em seguida, vale estudar as extensões da ferramenta, como CLAUDE.md, skills, hooks e MCP.
O guia completo do Claude Code aprofunda esses recursos. Se a dúvida for sobre os produtos da Anthropic, o artigo sobre a diferença entre Claude, Claude Code e Cowork organiza o panorama.
A própria documentação oficial em code.claude.com também traz guias detalhados, exemplos e a referência completa da CLI. Portanto, mantenha esse endereço por perto.
Conclusão
Os primeiros passos com Claude Code seguem um roteiro direto: instalar, autenticar, abrir o projeto e conversar em linguagem natural. A curva de aprendizado é baixa para quem já conhece o terminal.
Os ganhos de produtividade aparecem rápido em tarefas como testes, refatorações, operações Git e correção de bugs. Contudo, eles dependem de instruções claras, de tarefas divididas em etapas e do hábito de deixar o agente explorar antes de modificar.
Com esses princípios, o Claude Code deixa de ser um sugeridor de trechos e vira um colaborador capaz de executar ciclos completos de desenvolvimento. Então, abra o terminal no seu projeto e comece pela primeira pergunta.
FAQ
O Claude Code funciona sem internet?
Não. A ferramenta depende dos modelos da Anthropic hospedados na nuvem, então toda operação exige conexão ativa.
O plano gratuito do Claude dá acesso ao Claude Code?
Não. É preciso um plano Pro, Max, Team ou Enterprise, uma conta do Console ou um provedor de nuvem suportado.
O que acontece se eu recusar uma alteração proposta?
O arquivo permanece como estava e o agente aguarda novas instruções. Você pode pedir outra abordagem ou limpar a conversa com /clear.
O modo auto é seguro?
Ele usa um classificador que bloqueia ações arriscadas, o que ajuda em tarefas bem definidas. Em operações de grande impacto, porém, o modo manual oferece mais controle.
Posso usar o Claude Code em projetos sem Git?
Sim. O Git é opcional, e o agente edita arquivos e executa comandos em qualquer diretório.
Como retomo o trabalho de uma sessão anterior?
Use claude -c para continuar a conversa mais recente do diretório, ou claude -r e /resume para escolher uma conversa anterior.
O Claude Code funciona com qualquer linguagem?
Sim. Ele trabalha com qualquer linguagem editável em arquivos de texto, incluindo C#, TypeScript, Python, Go e Rust.
Dá para usar o Claude Code em um monorepo?
Sim. Você pode iniciar a sessão em um subdiretório específico ou na raiz, para ter visão de todos os projetos.